Minecraft Agent Skills plugin
13 skills for Codex and Claude Code cover Minecraft modding, plugins, datapacks, resource packs and server administration.
- 199 ★ on the repository
- Last commit
- MIT
Extended access
Why this level
- The skills help the agent edit code, server configuration and server console commands.
Install
- Works in
Manual install
claude --plugin-dir ./plugins/minecraft-codex-skillsRun it from a clone of the repository; or copy the folders you need from `.claude/skills/` into the project.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The skills help the agent edit code, server configuration and server console commands.
This is third-party code. Review the repository files before installing.
What it does
The set is split into narrow skills: `minecraft-modding` for NeoForge, Fabric and Forge 1.20.1, `minecraft-plugin-dev` for Paper, Bukkit and Spigot, `minecraft-datapack`, `minecraft-resource-pack`, `minecraft-world-generation` and `minecraft-multiloader` for Architectury projects. `minecraft-testing` covers JUnit, MockBukkit and GameTests, and `minecraft-ci-release` handles Modrinth and CurseForge publishing. Operations skills follow: `minecraft-server-admin`, `minecraft-worldedit-ops` with safe selections and schematics, and `minecraft-essentials-ops` for EssentialsX configuration. The version comes from project settings: Minecraft 26.x is supported, with examples for 1.21.x.
Who it is for. Authors of Minecraft mods, plugins and datapacks and server administrators who work with a coding agent.
Good fit when
- A Paper 1.21.11 command must be fixed without upgrading the server.
- A recipe is added to a 26.3 datapack and the file structure is checked.
- A Velocity proxy configuration is reviewed and a list of changes is returned.
- A mod for Fabric and NeoForge is built from one codebase and published to Modrinth.
Not a fit when
- You build a game on an engine other than Minecraft.
- You need in-game behaviour checks: scripts only validate file structure.
- Client mods for Bedrock Edition.
Example request
Fix this Paper 1.21.11 command without upgrading the server and add a MockBukkit unit test.Limitations
Bundled validators catch structural errors and common mistakes, while builds and in-game behaviour need your own testing. The `minecraft-imagegen` skill needs an image-generation tool from the host or an already connected integration; the set does not add one. Raw folders and the plugin must not be enabled together, or skills duplicate. The review was done against Minecraft 26.3 and Java 25 in October 2026.
How to disable. Delete the copied folders from the project `.agents/skills/` or `.claude/skills/`, or disable the `minecraft-codex-skills` plugin. The repository `AGENTS.md` should not be copied into projects.
FAQ
How do I install the set in Claude Code?
For the plugin run `claude --plugin-dir ./plugins/minecraft-codex-skills`. Or copy the folders you need from `.claude/skills/` into the same project directory.
Can I take only some of the skills?
Yes. Copy only the selected skill folders; the rest are not needed.
Which Minecraft versions does the set support?
Minecraft 26.x is stated, with examples for 1.21.x and Forge 1.20.1. The agent takes the version from your project settings.
What does `minecraft-worldedit-ops` do?
It guides safe work with WorldEdit selections, schematics and brushes.
How do I avoid duplicate skills?
Choose one route: copied folders or the plugin. Loading both exposes the same skills twice.
Discussion
No questions or reviews yet.
Related
PluginsMC AI Coding Assistant Tool
MC-AI-Coding-Assistant-Tool
A local MCP server for Minecraft modding: loader rules, documentation, mappings, crash triage and in-game playtesting for agents.
Softaworks Agent Toolkit
Softaworks Agent Skills
A marketplace of skills, subagents and commands for coding agents: development, documentation, planning and workplace communication
A set of skills from real work: npm supply-chain audit, CLI building, Obsidian plugin release and an AGENTS.md hierarchy
15 skills for Claude Code and Codex: Laravel, Docker, UI, debugging, tests and docs in four ready plugin bundles
Universal Modder
universal-modder
A plugin and skills for mods to games on your PC: engine recon, code analysis, fal assets, testing in the running game and a showcase video
19 skills for Claude Code, Codex and Antigravity CLI: Grok and Exa search, Context7 docs, Serena and task hand-offs between agents
README in short
Thirteen skills ship in three forms: for Codex, for Claude Code and as a plugin, and `npm run sync:skills` keeps the copies in sync. Checks cover structure and common mistakes.
README badge
Original SKILL.md
--- name: minecraft-modding description: "Create, modify, debug, or migrate Minecraft mods for current NeoForge or Fabric 26.x, legacy 1.21.x, and Forge 1.20.1. Use for loader-based gameplay code and assets; use minecraft-multiloader when one codebase must target both modern loaders." --- # Minecraft Modding Skill ## Overview Supported platforms: | Platform | MC Version | Java | Build System | |---|---|---|---| | **NeoForge** | 26.x current; 1.21.11 examples retained | Java 25 current; Java 21 on 1.21.x | Gradle + ModDevGradle | | **Forge** | 1.20.1 legacy lane | Java 17 | Gradle + ForgeGradle 6 | | **Fabric** | 26.x current; 1.21.11 examples retained | Java 25 current; Java 21 on 1.21.x | Gradle + Fabric Loom | | **Architectury** (multiloader) | 26.x or 1.21.x | Match Minecraft | Gradle + Architectury Loom | Always confirm the platform and Minecraft version from `gradle.properties` or `build.gradle` before writing any mod-specific code. Minecraft 26.1 introduced Java 25 and unobfuscated game executables. For 26.x projects, start from the current loader generator or example mod and preserve its build layout. Do not copy the 1.21.11 mapping, Loom plugin, remapping task, or Java 21 snippets in this skill into a 26.x project. Fabric 26.x uses the non-remapping Loom path and official names; NeoForge 26.x should start from the current NeoForge generator. The detailed API references cover legacy 1.21.x examples unless a section explicitly says 26.x. ### Routing Boundaries - `Use when`: the task is Java/Kotlin mod code, registry/event work, networking, datagen wiring, and loader APIs. - `Do not use when`: the task is command-only vanilla logic (`minecraft-commands-scripting`) or pure datapacks (`minecraft-datapack`). - `Do not use when`: the task targets Paper/Bukkit plugins (`minecraft-plugin-dev`). --- ## 1. Identifying the Platform ```bash # NeoForge project signature grep -r "net.neoforged" gradle.properties build.gradle settings.gradle 2>/dev/null | head -5 # Forge 1.20.1 project signature grep -r "net.minecraftforge" gradle.properties build.gradle settings.gradle 2>/dev/null | head -5