How to Use Claude for Minecraft Mods | Building Automation and Development Support
When you search for ways to use Claude with Minecraft, you'll find two distinctly different projects. One is an in-game Mod that auto-generates builds from natural language, and the other is a skill for developing Mods themselves using Claude Code. This article separates the two and covers everything you need: prerequisites, setup steps, and how to choose between them based on your use case — with practical examples.
The phrase "claude minecraft mod" actually refers to two distinct categories. One is a Mod that lets Claude handle building inside the game, where players simply give text instructions and castles or townscapes are automatically generated. The other is a system for developing Mods using Claude Code, where AI assists with implementing blocks, items, and more. The former is a tool for players; the latter is a tool for creators.
The in-game building Mod runs with just Fabric Loader and a Claude API key. Type something like "build a medieval castle with four towers" using the /claude command, and Claude generates a series of /fill and /setblock Minecraft commands that execute in sequence. The biggest advantage is that large-scale builds that would take tens of minutes by hand can be completed with a single sentence.
The development skill supports both NeoForge and Fabric loaders and can be installed with the /plugin command. It can generate code that integrates with popular Mods like JEI, AE2, and Create, making it well-suited for serious Mod development within the broader ecosystem. As a general rule: choose the former for saving time while playing, and the latter for creating Mods to distribute.
目次 (8)
- Two Meanings of "Claude × Minecraft Mod"
- ① In-Game Building Mod: Auto-Building with the /claude Command
- Building Mod Setup Steps
- ② Developing Mods with Claude Code: NeoForge/Fabric-Compatible Skill
- Ecosystem Integration: JEI, AE2, and Create
- How to Install the Development Skill
- Which Should You Choose? Use Case Guide
- Costs and Caveats
Two Meanings of "Claude × Minecraft Mod"
Searching for "claude minecraft mod" leads to two entirely different projects. One is a Mod that delegates building to Claude inside the game; the other is a system for developing Mods themselves using Claude Code. The former is aimed at players, with text-based build instructions taking center stage. The latter is aimed at developers, generating implementation code for blocks, items, and more. Since the two differ in required setup and usage, it is important to first determine which one fits your goal. This article covers both tracks separately, explaining each one's setup and best use cases in turn.
① In-Game Building Mod: Auto-Building with the /claude Command
BrettFBaron/claude-minecraft-mod, published on GitHub, is a Fabric Mod that automatically generates Minecraft builds from natural language instructions. Once installed, typing something like /claude build a medieval castle with four towers in-game causes Claude to generate a series of Minecraft commands such as /fill and /setblock. The Mod saves these to an MCS file (an intermediate script file that executes the generated command sequence in order) and runs them one by one to construct the structure. The greatest appeal of this Mod is that large-scale builds that would take tens of minutes by hand are completed with a single sentence.
Building Mod Setup Steps
The requirements are Minecraft 1.20.6, Fabric Loader 0.15.10 or later, Fabric API, Java 21 or higher, and a Claude API key. You can create an account and sign in at the Anthropic Console (console.anthropic.com), then generate an API key from the "API Keys" menu. Installation proceeds in the following order:
- Install Fabric for Minecraft 1.20.6
- Download the Mod's JAR file from the releases page
- Place the JAR in the
.minecraft/modsfolder - Configure your Claude API key (see below)
- Launch Minecraft with the Fabric profile
There are three ways to configure the API key: setting the environment variable CLAUDE_API_KEY (recommended), typing /claude-key <your-key> in-game, or directly editing .minecraft/config/claudemod/config.properties, which is auto-generated on first launch. If you want to change the model being used, you can also set the CLAUDE_MODEL environment variable.
② Developing Mods with Claude Code: NeoForge/Fabric-Compatible Skill
The other track supports those who want to create Mods. chouzz/minecraft-mod-dev is a plugin (skill) for Claude Code that supports both NeoForge and Fabric loaders. It guides you through the entire development lifecycle — from adding blocks, items, and entities to migrating to version 1.21 and beyond — while automatically referencing the latest documentation. Prioritizing modern practices like Data Components and Data Generation is what sets it apart from traditional handwritten tutorials. It auto-detects your project structure and returns code aligned with the latest specs for each loader.
Ecosystem Integration: JEI, AE2, and Create
The strength of this skill lies in its assumption of interoperability with popular Mods. It can generate code that integrates with JEI (Just Enough Items) for recipe display, AE2 (Applied Energistics 2) for storage networks, and Create for mechanical systems. For example, ask it to "make a machine block that works with AE2 storage and shows its recipe in JEI," and it will present everything in one go: checking the API docs, AE2 integration, JEI registration, and Data Components support. Its practical value lies in designing not just isolated code snippets, but the full connection to existing Mods. Source: Minecraft Mod Dev Claude Code Skill.
How to Install the Development Skill
There are two ways to add this skill to Claude Code. To install via command:
- Add the marketplace with
/plugin marketplace add chouzz/minecraft-mod-dev - Install with
/plugin install minecraft-mod-dev@chouzz-plugins
To install via GUI, run /plugin, add it from the Marketplaces tab, then install from the Discover tab. The skill activates automatically when you create new blocks or items, integrate with ecosystem Mods, or migrate to version 1.21 or later. It is designed to surface the appropriate guidance based on context, without needing to be explicitly invoked.
Which Should You Choose? Use Case Guide
Players who want to speed up large-scale building as a leisure activity should go with ① the Building Mod; developers who want to distribute or publish their own Mod should go with ② the Claude Code skill. The two are not mutually exclusive — a combination approach, such as using ② to create custom blocks and then placing them with ① the Building Mod, is entirely viable. However, note that ① requires command permissions on the server side (cheats enabled), and in multiplayer, admin approval will be needed. At the prototype stage, it is safest to first verify behavior in single-player.
Costs and Caveats
① The Building Mod requires a Claude API key and charges on a pay-per-use basis. Even a single instruction consumes more tokens the more complex the structure, so it is safest to start with a small build to get a feel for both behavior and cost. ② The Claude Code skill runs on Claude Code, so it can be used with a Pro or Max subscription and does not necessarily require pay-per-use API billing. Since API keys can easily end up in config files or chat logs, be sure to manage them via environment variables in shared server or multiplayer environments, and know how to reissue them if needed. The Mod's version requirements (such as 1.20.6) change rapidly, so always check the latest README in each repository before installing — a mismatch will cause crashes on startup.
