minecraft-plugin-development
Installation
SKILL.md
Minecraft Plugin Development
Use this skill for Minecraft server plugin work in the Paper, Spigot, and Bukkit ecosystem.
This skill is especially useful for gameplay-heavy plugins such as combat systems, wave or boss encounters, war or team modes, arenas, kit systems, cooldown-based abilities, scoreboards, and config-driven game rules.
For grounded implementation patterns drawn from real Paper plugins, load these references as needed:
references/project-patterns.mdfor high-level architecture patterns seen in real gameplay pluginsreferences/bootstrap-registration.mdforonEnable, command wiring, listener registration, and shutdown expectationsreferences/state-sessions-and-phases.mdfor player session modeling, game phases, match state, and reconnect-safe logicreferences/config-data-and-async.mdfor config managers, database-backed player data, async flushes, and UI refresh tasksreferences/maps-heroes-and-feature-modules.mdfor map rotation, hero or class systems, and modular feature growthreferences/minigame-instance-flow.mdfor arena instances, countdowns, loot refreshes, wave systems, visibility isolation, and entity-to-game ownershipreferences/persistent-progression-and-events.mdfor long-running PvP servers with profiles, perks, buffs, quests, economy, custom domain events, and extension registriesreferences/build-test-and-runtime-validation.mdfor Maven or Gradle packaging, shaded dependencies, generated resources, soft dependencies, config validation commands, and first-round server test plans