explaingit

airirang/airirang-builder

Analysis updated 2026-06-24

0TypeScriptAudience · developerComplexity · 3/5LicenseSetup · moderate

TLDR

Turns a single chat instruction or .obj mesh into a Minecraft datapack that builds the whole structure in one /function call, exposed to AI clients via MCP.

Mindmap

mindmap
  root((airirang-builder))
    Inputs
      OBJ mesh files
      Preset models
      Chat instructions
    Outputs
      Minecraft datapack
      mcfunction files
      Voxel structures
    Use Cases
      Build castles from chat
      Convert 3D models to blocks
      Generate datapacks via Claude
    Tech Stack
      TypeScript
      Node.js
      MCP
      Minecraft Java
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a Minecraft Java datapack from a .obj mesh in one command

USE CASE 2

Wire Claude Desktop to an MCP server that builds structures inside Minecraft

USE CASE 3

Voxelize and greedy-mesh-compress a custom 3D model into /fill commands

USE CASE 4

Spawn preset medieval buildings (house, inn, mill) into a Java world

What is it built with?

TypeScriptNode.jsMCPMinecraft

How does it compare?

airirang/airirang-builderaisurfer/mcp_ui_app_examplearxpoetica/lilypond-interface
Stars00
LanguageTypeScriptTypeScriptTypeScript
Last pushed2025-12-29
MaintenanceQuiet
Setup difficultymoderatemoderatemoderate
Complexity3/53/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs Node 20+, Minecraft Java 1.20.5 to 1.21.x, and an MCP-aware client like Claude Desktop configured before quick-build works end to end.

Apache 2.0, free to use, modify, and ship commercially, with patent grant and attribution required.

In plain English

AIrirang Builder is a tool that turns a single chat instruction into a complete Minecraft structure. Instead of asking an AI agent to place blocks one by one, you describe what you want and the tool produces a datapack that builds the whole thing in seconds inside the game. The README is explicit that this is not an official Minecraft product and is not approved by or associated with Mojang or Microsoft. The core idea is a pipeline that runs end to end in one step. The tool reads a 3D mesh file in .obj format, converts it into Minecraft voxels, compresses those voxels into Minecraft /fill commands using a method called greedy meshing, and then wraps the result into a Java Edition datapack you can drop into a world. The flagship tool is called quick-build, and it does the full chain in a single call. Once the datapack is installed, you run /reload followed by /function airirang:<id> in Minecraft and the structure appears. The project connects to AI clients through an open standard called MCP, short for Model Context Protocol. You register the tool with Claude Desktop by adding a short snippet to a config file, and after a restart the client sees seven new tools: list-presets, voxelize-preset, voxelize-custom, generate-mcfunction, execute-build, quick-build, and list-builds. A standalone command-line interface is also available for users who do not want to go through an AI client. The package bundles five free medieval models from Quaternius released under CC0, including a house, an inn, a mill, and a sawmill. You can also pass your own .obj file. Requirements are Node 20 or newer and Minecraft Java Edition between version 1.20.5 and 1.21.x. Settings let you change the namespace, pick a block override map (for example using spruce planks for wood), set a pitch correction for the mesh, and choose whether to fill the interior. The README compares the approach to a competing project that uses a bot to place each block individually, claiming faster builds, deterministic accuracy, and far fewer AI tokens per build. Compression benchmarks cited include around 95 percent reduction on a realistic building and 80 percent on a more complex lattice. The project is Apache 2.0 licensed and bundles no Mojang assets.

Copy-paste prompts

Prompt 1
Set up airirang-builder as an MCP server in Claude Desktop on macOS and test it with the inn preset
Prompt 2
Use airirang-builder quick-build to convert this custom castle.obj into a datapack with spruce planks as the wood override
Prompt 3
Add a new preset model to airirang-builder by dropping a .obj into the presets dir and wiring it into list-presets
Prompt 4
Explain how the greedy-meshing step in airirang-builder compresses voxels into Minecraft /fill commands

Frequently asked questions

What is airirang-builder?

Turns a single chat instruction or .obj mesh into a Minecraft datapack that builds the whole structure in one /function call, exposed to AI clients via MCP.

What language is airirang-builder written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

What license does airirang-builder use?

Apache 2.0, free to use, modify, and ship commercially, with patent grant and attribution required.

How hard is airirang-builder to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is airirang-builder for?

Mainly developer.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.