shaokeyibb/paper-plugins-skill

Paper Plugins Skill is a skill package for Codex, an AI coding tool, that gives it focused guidance for building plugins for Paper, a popular server variant of Minecraft. Instead of relying only on what the AI already knows about Minecraft plugin development, which can be outdated, the skill loads specific reference material that points the AI toward current, Paper-only patterns and away from older Bukkit or Spigot approaches. Once installed, the skill covers the practical steps of Paper plugin work: setting up a project with Gradle, choosing between the two plugin descriptor file formats, registering commands with Paper's command system, formatting text shown to players using Adventure components, storing custom data on items and blocks, and handling background scheduling in a way that works correctly with Folia, a Paper variant built for running across multiple threads. It also includes a checklist for reviewing a plugin before release, covering things like keeping slow operations off the main server thread. The skill is organized as one main file describing its workflow and rules, plus a folder of separate reference files for individual topics, which are only loaded when the current task actually needs them. You install it into Codex with a single command that points at the GitHub repository, and you can either ask for it by name or simply describe a Paper plugin task and let Codex bring in the relevant guidance on its own. The project targets developers writing Paper plugins in Java or Kotlin who want an AI assistant that follows current, version-aware conventions rather than generic or outdated ones, and it is released under the MIT license.