A community-written online textbook on Technical Minecraft.
Read tutorials, mechanics deep-dives, and source-code walkthroughs. All openly written and reviewed.
Visit the Site | Browse Raw Articles | More GTMC Projects
English | 中文
Graduate Texts in Minecraft (GTMC) is an open knowledge base for the technical side of Minecraft: redstone, game mechanics, and engine internals. Anyone can read it, and the community writes and reviews it together.
You'll find three kinds of articles:
- Tutorials: step-by-step walkthroughs for builders.
- Explanations: how in-game mechanics actually work, from first principles.
- Code Analysis: annotated readings of the game's source.
They span the whole stack of technical play: production builds like tree farms, mechanical redstone and component behavior, slime-tech flying machines, and the timing and wiring that hold them together. On the engine side, articles dig into micro-timing, block updates and update order, chunk loading and loading tickets, and entity AI and movement, backed by source reading where it matters. Tooling chapters cover the staples of a technical setup (Carpet, Litematica, and the masa suite), so newcomers and veterans both have a way in.
The fastest way to start is to visit the site. Want to contribute? You can draft articles and open pull requests right from the site. Reviews and merge conflicts are handled on GitHub.
Note
This is a monorepo. You can find the website frontend in apps/web, the Go PDF renderer in tools/pdfgen, and content submodules in content/. Other GTMC projects are at github.com/orgs/techmc-wiki.
git clone https://github.com/techmc-wiki/gtmc.git
cd gtmc
vp install # uses the pinned pnpm version
cp apps/web/.env.example apps/web/.env # add GitHub OAuth, database URL, etc.
pnpm dev # http://localhost:3000Common scripts:
pnpm dev # Start the dev server
pnpm build # Full production build (content + Next.js)
pnpm check # vp check (oxfmt + oxlint) + tsc --noEmit
pnpm test # Run the Vitest suite once
pnpm typecheck # Run the Next.js-aware TypeScript checkProperty lookup supports selecting multiple enum values in one filter; entries matching any selected value are included. An empty selection leaves the filter inactive. Long property values are summarized; expand the labels or remaining states to see the full data.