How ayanpr/minecraft-purge works
Purge is a Bukkit/Purpur server plugin that runs a timed Purge event. Administrators start, end, cancel, or configure the event through commands; the manager drives the announcement and active phases, while event handlers enforce combat and gameplay rules. Immunity requests and grants affect player state and privileges. The README also documents world restrictions, command blocking, cooldowns, configurable messages and sounds, plus optional TAB, LuckPerms, and Minepacks integration. Edges reflect shown calls or README-described behavior; unsampled handler details are represented only where documented.
Main entry points: Main.kt Plugin entry and handlers · PurgeManager.kt Purge orchestration · PurgeDependency.kt Plugin integrations · PurgeCommandExecutor.kt Command execution
Components 19
Plugin control
- Plugin entry and handlers
src/main/kotlin/dev/josantonius/minecraft/purge/Main.kt - Command execution
src/main/kotlin/dev/josantonius/minecraft/purge/command/PurgeCommandExecutor.kt - Command suggestions
src/main/kotlin/dev/josantonius/minecraft/purge/command/PurgeTabCompleter.kt
Purge lifecycle
- Purge orchestration
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeManager.kt - Lifecycle status
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeStatus.kt - Countdown bars
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeBossBar.kt - Purge sounds
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeSound.kt
Player rules
- Immunity policy
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeImmunity.kt - Player registry
src/main/kotlin/dev/josantonius/minecraft/purge/PurgePlayer.kt - Player event state
src/main/kotlin/dev/josantonius/minecraft/purge/PurgePlayerEntity.kt
Integrations and settings
- Purge settings
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeConfig.kt - Plugin integrations
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeDependency.kt - Message templates
src/main/resources/messages.yml - Runtime configuration
src/main/resources/config.yml
Other components
- Minecraft server
- Players and admins
- TAB plugin
- LuckPerms
- Minepacks
Connections 24
- Minecraft server → Plugin entry and handlers: loads plugin
README.md - Plugin entry and handlers → Command execution: registers executor
src/main/kotlin/dev/josantonius/minecraft/purge/Main.kt - Plugin entry and handlers → Command suggestions: registers completer
src/main/kotlin/dev/josantonius/minecraft/purge/Main.kt - Players and admins → Command execution: issues commands
README.md - Command execution → Purge orchestration: dispatches actions
src/main/kotlin/dev/josantonius/minecraft/purge/command/PurgeCommandExecutor.kt - Command execution → Immunity policy: changes immunity
src/main/kotlin/dev/josantonius/minecraft/purge/command/PurgeCommandExecutor.kt - Purge orchestration → Lifecycle status: updates phase
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeManager.kt - Purge orchestration → Countdown bars: updates countdowns
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeManager.kt - Purge orchestration → Purge sounds: plays cues
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeManager.kt - Purge orchestration → Player registry: tracks players
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeManager.kt - Purge orchestration → Plugin integrations: restores settings
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeManager.kt - Plugin entry and handlers → Purge orchestration: checks lifecycle
src/main/kotlin/dev/josantonius/minecraft/purge/Main.kt - Plugin entry and handlers → Immunity policy: enforces combat rules
src/main/kotlin/dev/josantonius/minecraft/purge/Main.kt - Immunity policy → Player registry: updates privileges
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeImmunity.kt - Player registry → Player event state: stores records
src/main/kotlin/dev/josantonius/minecraft/purge/PurgePlayer.kt - Immunity policy → Plugin integrations: applies integrations
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeImmunity.kt - Plugin entry and handlers → Purge settings: loads settings
src/main/kotlin/dev/josantonius/minecraft/purge/Main.kt - Purge settings → Runtime configuration: reads values
- Purge sounds → Purge settings: gets sound names
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeSound.kt - Plugin entry and handlers → Message templates: uses templates
- Plugin integrations → TAB plugin: sets prefix
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeDependency.kt - Plugin integrations → LuckPerms: changes permissions
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeDependency.kt - Plugin integrations → Minepacks: changes death drops
src/main/kotlin/dev/josantonius/minecraft/purge/PurgeDependency.kt - Players and admins → Plugin entry and handlers: plays purge