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
Plugin

Extended access

Why this level

  • The skills help the agent edit code, server configuration and server console commands.
All reasons and checks

jahrome907/minecraft-agent-skills

Install

Manual install

claude --plugin-dir ./plugins/minecraft-codex-skills

Run it from a clone of the repository; or copy the folders you need from `.claude/skills/` into the project.

Access and checks

How we review

Extended 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.

Plugins

MC 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.

MCP serverExtended access138Repository stars

Softaworks Agent Toolkit

Softaworks Agent Skills

A marketplace of skills, subagents and commands for coding agents: development, documentation, planning and workplace communication

PluginExtended access2.7KRepository stars

A set of skills from real work: npm supply-chain audit, CLI building, Obsidian plugin release and an AGENTS.md hierarchy

SkillExtended access115Repository stars

15 skills for Claude Code and Codex: Laravel, Docker, UI, debugging, tests and docs in four ready plugin bundles

PluginExtended access69Repository stars

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

PluginBroad access9.6KRepository stars

19 skills for Claude Code, Codex and Antigravity CLI: Grok and Exa search, Context7 docs, Serena and task hand-offs between agents

PluginExtended access65Repository stars

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

Report a problem