Notoriety

A Paper plugin that brings a classic MMORPG-style notoriety system to Minecraft. Players are dynamically categorized based on their actions, creating a self-regulating community where crime has consequences.

Features

Reputation System

Players are classified into three states based on their behavior:

| Status | Color | Condition |
|--------|-------|-----------|
| Innocent | Blue | Alignment ≥ 0, PKCount = 0 |
| Criminal | Gray | Alignment < 0, PKCount = 0 |
| Murderer | Red | PKCount ≥ 1 |

Ownership Protection

• Blocks placed by innocent players are automatically protected
• Breaking or stealing from others' property is a crime
• 5-second grace period to undo accidental actions
• Owned blocks are protected from explosions (Creeper, TNT, etc.)

Three-State Trust System

• TRUST - Grant full access to your property
• UNSET - Default state; guild members get automatic trust
• DISTRUST - Block access even from guild members

Guild System

Form groups with automatic trust relationships:

• Guild members automatically trust each other (unless DISTRUST is set)
• Player display format: Title PlayerName [GuildTag]
• 16 customizable tag colors
• Three roles: Master, Vice Master, Member
• Guild chat channel for private communication
• Application system (join guilds without invitation)

Territory System

Guilds can claim protected land:

• Requires minimum 5 guild members
• 1 chunk per 5 members
• Non-members cannot place/break blocks or access containers
• Beacon auto-placed at territory center
• Entry/exit notifications
• Guild master receives territory status on login

Inspect System

Investigate block ownership and territory information:

• /inspect - Toggle inspect mode
• /noty inspect tool - Get inspection stick
• Shows owner, placement time, trust status, and territory info

Chat System

Multiple communication channels:

• Local - 50-block range (default)
• Global - Server-wide with ! prefix
• Guild - Members only with @ prefix
• Whisper - Private 1-on-1 messages
• Romaji to Hiragana conversion for Japanese players

Villager & Golem System

• Villagers shout when they witness crimes
• Iron Golems attack criminals on sight
• Golems teleport to criminals if too far away
• Enhanced golem stats when attacking criminals

Bounty System

• Place bounties on murderers
• Claim rewards by defeating wanted players
• Leaderboard display via signs

5-Tier Penalty System

| Severity | Penalty | Examples |
|----------|---------|----------|
| Severe | -50 | Kill villager (with bed), Theft, Kill golem |
| Moderate | -20 | Kill animal (witnessed) |
| Minor | -10 | Destroy property, Kill villager (no bed) |
| Petty | -5 | Destroy villager bed/workstation |
| Trivial | -1 | Attack player/villager, Harvest crops |

Commands

Main Commands

• /noty status [player] - View reputation status
• /noty history [player] - View crime history
• /inspect - Toggle inspect mode
• /noty inspect tool - Get inspection stick

Trust Commands

• /trust add <player> - Trust a player (TRUST)
• /trust distrust <player> - Distrust a player (DISTRUST)
• /trust remove <player> - Reset trust (UNSET)
• /trust list - View trust relationships
• /trust check <player> - Check trust status with a player

Guild Commands

• /guild create <name> <tag> [description] - Create a guild
• /guild disband - Disband your guild (Master only)
• /guild invite <player> - Invite a player
• /guild accept/decline <guild> - Accept/decline invitation
• /guild kick <player> - Remove a member (Master only)
• /guild leave - Leave your guild
• /guild promote/demote <player> - Change member roles
• /guild transfer <player> - Transfer leadership
• /guild tagcolor <color> - Change tag color

Guild Application Commands

• /guild apply <guild> - Apply to join a guild
• /guild applications - View received applications (Master/Vice Master)
• /guild applications accept <player> - Accept application
• /guild applications reject <player> - Reject application

Territory Commands

• /guild territory set - Set territory center (Master only)
• /guild territory info - View territory information
• /guild territory remove - Remove territory (Master only)

Chat Commands

• /w <player> <message> - Send whisper
• /r <message> - Reply to last whisper
• /romaji on/off - Toggle romaji conversion

Bounty Commands

• /bounty set <player> <amount> - Set a bounty
• /bounty list - View all bounties
• /bounty check <player> - Check specific bounty

Requirements

• Minecraft 1.21.1+
• Paper Server
• Java 21+
• Vault (optional, for economy features)

Configuration

Supports both SQLite and MySQL databases. Multi-language support with Japanese and English localization.

API

Provides a developer API for third-party plugin integration:

val api = notoriety.api
val color = api.getNameColor(player.uniqueId)
api.addAlignment(player.uniqueId, 50)

Events

| Event | Description |
|-------|-------------|
| PlayerColorChangeEvent | When player status changes |
| PlayerCrimeEvent | When a crime is committed |
| PlayerGoodDeedEvent | When a good deed is performed |
| BountyClaimedEvent | When a bounty is claimed |
| GuildCreateEvent | When a guild is created |
| GuildMemberJoinEvent | When a member joins a guild |
| GuildMemberLeaveEvent | When a member leaves a guild |
| GuildApplicationEvent | When a guild application is submitted |
| TerritoryClaimEvent | When territory is claimed |
| TerritoryReleaseEvent | When territory is released |
| TerritoryEnterEvent | When entering a territory |
| TerritoryLeaveEvent | When leaving a territory |