---
title: "CodeCraft: Turn the Claude Code interface into a Minecraft-style HUD"
url: "https://claudemods.dev/en/builds/built-a-minecraft-skin-for-my-claude-code-728e36"
source: "https://github.com/mkpvishnu/claude-mods"
source_type: "github"
repo: "https://github.com/mkpvishnu/claude-mods"
author: "Funny_Language4830"
author_handle: "Funny_Language4830"
stars: 3
category: "Multi-agent orchestration"
categories: ["agents", "cost", "games", "hud", "input", "memory", "notifications", "tools", "workflow"]
tags: ["MIT", "hud", "minecraft", "Theme", "Open source", "Plugin", "Interface", "Fun"]
permission_level: 2
scan_complete: true
install: "claude plugin marketplace add mkpvishnu/claude-mods\nclaude plugin install codecraft@claude-mods"
added: "2026-10-03T20:04:36.971Z"
updated: "2026-10-03T10:56:42Z"
locale: "en"
content_locale: "en"
---

# CodeCraft: Turn the Claude Code interface into a Minecraft-style HUD

CodeCraft is a free, open-source Claude Code mod that redraws the interface as a Minecraft-style HUD. Hearts represent the context window, hunger represents usage limits, armor represents work safety, and it adds a hotbar of items, villager subagents, and 60 achievements.

## Description

CodeCraft is a free, open-source (MIT) Claude Code mod built using the new Mods feature in Claude Code 2.1.288+, redrawing the entire interface as a Minecraft-style HUD. Every HUD element maps to real session state: ten hearts represent the context window, and low health prompts /compact; hunger represents the five-hour usage limit; armor represents work safety (4 points for all-green tests after the last edit, 3 points for committed, 3 points for pushed). Experience and levels come only from verifiable work: tests running green, turning a red run green, and committing when tests are all green; ordinary tool calls give no experience. The hotbar shows the tools used in the current turn, each personified as an item: search is a pickaxe, read is a book, edit is a brick, shell commands are redstone; subagents appear as villagers. A boss health bar appears when a shell command exceeds 5 seconds, counting down toward timeout. Chat is like a game server: it shows [Claude: ran npm test], failed calls have death messages (such as "

## Install

```
claude plugin marketplace add mkpvishnu/claude-mods
claude plugin install codecraft@claude-mods
```

## Original README

I built CodeCraft, a free and open-source mod for Claude Code that redraws the interface as a Minecraft-style HUD. I built it with Claude Code, using the new Mods feature (Claude Code 2.1.288+). What it does Every piece of the HUD shows something real about your session: Hearts are your context window. Ten hearts is a fresh session, and you get a warning to /compact when health runs low. Food is your five-hour usage limit. Armor shows how safe your work is: tests green since your last edit (4 points), work committed (3), commits pushed (3). XP and levels only come from verified work: green test runs, turning a red run green, commits made with the tests green. Plain tool calls earn nothing. The hotbar shows the tools used in the current turn, each as an item: a pickaxe for search, a book for reads, bricks for edits, redstone for shell commands. Subagents show up as villagers. The boss bar appears when a shell command runs past 5 seconds, draining toward its timeout. The chat reads like a game server: [Claude: ran npm test], failed calls get death messages ("npm was shot by Skeleton (exit 1)"), and you get "has made the advancement [Diamonds!]" when you commit with green tests. Advancements: there are 60 across 5 tabs, 6 of them hidden, saved across sessions and earned by real work. A first green test, a merged PR, git bisect, working 7 days in a row. /advancements opens a tree screen like the game's. Try it (free, MIT licensed) In Claude Code: /plugin marketplace add mkpvishnu/claude-mods /plugin install codecraft@claude-mods Repo: https://github.com/mkpvishnu/claude-mods submitted by /u/Funny_Language4830 [link] [comments]
