notoriety

# 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 ` - 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 ` - View reputation status - `/noty history ` - 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> ` - 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: ```kotlin val api = notoriety.api val color = api.getNameColor(player.uniqueId) api.addAlignment(player.un