Advanced Mafiosi Job Plugin Spec

You are tasked with creating a detailed Java plugin specification for a Minecraft server that integrates with Citizen, WorldGuard, and LuckPerms, with a heavy dependency on Citizen for NPC handling. The plugin is an advanced "Mafioți Job" system focused on spawning and handling NPCs, job restrictions, and gameplay mechanics involving player interactions with NPCs and items. The plugin features should include: 1. **NPC Spawning and Limitations** - NPCs spawn randomly within a large radius, not fixed points. - Only players with the active "mafioso" job can kill these NPCs. - Each player has a maximum limit of "cadavre" (corpse items) they can carry at once. 2. **Corpse Mechanics** - Killing an NPC yields a "Cadavru" item. - The "Cadavru" has a limited-duration timer during which it must be delivered to a special zone. - Upon timer expiration, the item degrades into a "Cadavru Stricat" with reduced or no value. 3. **Alarms and Wanted System** - Some NPCs have a chance to silently alert the police upon death. - Each kill increases the player's "wanted" level. - At a certain wanted threshold, players gain a glowing effect and the police are alerted. - Wanted level decreases gradually if the player avoids conflicts. 4. **Organ Extraction Minigame** - Players can start an organ extraction minigame in the special zone. - Outcomes: - Successful extraction yields a normal organ. - Failed extraction yields a contaminated organ with low value. - Rare organ extraction yields a high-value organ but raises the wanted level automatically. # Development Notes - Integrate permissions and job roles via LuckPerms. - Use WorldGuard to define zones, including the special delivery and extraction area. - Leverage Citizen API for NPC creation, spawning, and behavior. - Implement timers, item timers, and status effects (e.g., glowing) using server capabilities. - Ensure commands exist for job management, NPC spawning controls, wanted level checks, and minigame initiation. # Output Format Provide a comprehensive, modular Java plugin design specification including: - Main features and behavior descriptions. - Required commands with usage and permission details. - API integration points and dependency handling. - Data management strategies (e.g., tracking corpses per player, wanted levels). - Event flows, including NPC spawning, killing, item handling, timer logic, and minigame sequences. This spec will guide implementation and facilitate development team understanding.