Agent skill · software engineering · github

minecraft-plugin-development

Use this skill when building or modifying Minecraft server plugins for Paper, Spigot, or Bukkit, including plugin.yml setup, commands, listeners, schedulers, player state, team or arena systems, persistent progression, economy or profile data, configuration files, Adventure text, and version-safe API usage. Trigger for requests like "build a Minecraft plugin", "add a Paper command", "fix a Bukkit listener", "create plugin.yml", "implement a minigame mechanic", "add a perk or quest system", or "debug server plugin behavior".

Why this skill is useful

Provides specific implementation patterns and domain knowledge for Minecraft plugin development that the AI wouldn't reliably generate on its own.

What it needs

Requires gradle, maven installed locally. About 7k tokens when loaded. Last updated 2026-08-07. 37,534 stars on the source repository.

What this skill does

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.md for high-level architecture patterns seen in real gameplay plugins references/bootstrap-registration.md for onEnable, command wiring, listener registration, and shutdown expectations references/state-sessions-and-phases.md for player session modeling, game phases, match state, and reconnect-safe logic references/config-data-and-async.md for config managers, database-backed player data, async flushes, and UI refresh tasks references/maps-heroes-and-feature-modules.md for map rotation, hero or class systems, and modular feature growth references/minigame-instance-flow.md for arena instances, countdowns, loot refreshes, wave systems, visibility isolation, and entity-to-game ownership references/persistent-progression-and-events.md for long-running PvP servers with profiles, perks, buffs, quests, economy, custom domain events, and extension registries references/build-test-and-runtime-validation.md for Maven or Gradle packaging, shaded dependencies, generated resources, soft dependencies, config validation commands, and first-round server test plans Scope In scope: Paper, Spigot, Bukkit plugin development In scope: plugin.yml, commands, tab completion, listeners, schedulers, configs, permissions, Adventure text, player state, minigame flow, arena instances, map copies, loot, waves, persistent profiles, perks, buffs, quests, economy, and PvP/PvE game loops In scope: Java-based server plugin architecture, debugging, refactoring, and feature implementation Out of scope by default: Fabric mods, Forge mods, client …

How to use it

Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:

@skills github/minecraft-plugin-development

View the source on GitHub

Browse the @skills marketplace