genMC knowledge base
How genMC works: the studios and every function, working together with your agent, sharing, limits and answers to common problems.
Start hereFirst stepsConnect an agentKeyboard shortcutsTroubleshooting
Getting started
- What is genMC?
A Minecraft studio in the browser that you and your AI agent use together: skins, builds and more, live in one tab.
- First steps
Make your first skin and your first build, connect an agent and take the result into Minecraft – in ten minutes.
- Finding your way around
The header, document row, agent column, dock and timeline that the studios share, plus settings, language and dark mode.
Skin studio
- Skin studio basics
Classic and Slim models, the base and outer layer, 3D, 2D and split view, body parts and saved skins.
- Painting and colors
Pencil, eraser, face fill, colors and presets, and how to mark areas for your agent.
- Styles and skin options
Let your agent restyle a skin (Simple, Balanced, Graphic, Strong shading) or prepare several options to choose from.
- Import, export and renderings
Import a PNG or a player's skin, export the Minecraft PNG, render images, and what the invisible marker in exports is.
- Timeline, versions and checkpoints
Undo and redo, play back a skin's history, compare versions, revert a single change and save named checkpoints.
Build studio
- Build studio basics
Projects, the growing plot, the full Java block library, textures and how you and your agent share the work.
- Camera, flight and slicer
Look around, fly through your build, use the view cube and cut it open with the slicer.
- Marking blocks for your agent
Brush, Surface and Smart marking, adding and removing marks, and how marks travel with your requests.
- Structure, materials and effort
Browse, hide and isolate the parts of a build, get a bill of materials with stacks and shulker boxes, and estimate the survival effort.
- Walk mode, tours and videos
Walk through your build like in Minecraft, play the agent's room tour and render it as an MP4 video.
- Redstone
Redstone just works in the 3D view – click a lever or button and lamps light, pistons push and doors open, like in Minecraft Java, in real game ticks.
- Timeline, replay and undo
Look at earlier versions and replay how a build grew without disturbing your agent; restore, undo and redo when you mean it.
- Export, import and Minecraft
Download a build as JSON, .schem for WorldEdit, .mcfunction for datapacks, PNG or tour video – and bring JSON back in.
Agents
- How agents work with genMC
What an agent can do in genMC, the two ways it connects (site tools and the MCP relay), and the safeguards that keep you in control.
- Connect an agent
Pair Claude, ChatGPT, Claude Code, Codex or another MCP client with your studio tab using a short code – step by step, with troubleshooting.
- Requests, marks and Finish
Send requests with marks and photos, follow the agent's progress, read the statuses and end a session with Finish.
- Guide for agents
The rules and the working loop for AI agents in genMC – revisions, requests, previews, named parts, renders and Finish.
- Agent tool reference
Every tool a connected agent can call, generated from the running studio code.
Account, sharing & privacy
- Accounts and sign-in
Why an account is optional, how to sign in with an e-mail code or Google, and what happens to your work when you sign in or out.
- Gallery, publishing and secret links
Publish skins and builds to the public gallery, remix other people's work, report problems, and share a build privately with a secret link.
- Storage and privacy
Where your work is saved, what stays private, what the developer can see, and how saving conflicts are handled.
Help & reference
- Keyboard shortcuts
Every keyboard shortcut of the skin studio, the build studio, flight, walk mode, the agent input and this knowledge base.
- Limits
All sizes, counts and rate limits in one place – skins, builds, history, requests, agents, publishing and accounts.
- Troubleshooting
Solutions for the most common problems – agent connection, queued requests, saving conflicts, lost work, exports and performance – and how to send feedback.
- Glossary
Short definitions of the terms used in genMC and in this knowledge base.
For agents
Agents read this knowledge base with the tool genmc_docs: in every studio through WebMCP, and through the genMC MCP server without pairing. Plain HTTP works too:
GET /api/docs?q=secret+link
GET /api/docs?article=connect-agent&format=md