# Numen (言出法随)

> An embodied AI agent that runs inside Minecraft as a mod: it explores the world, makes its own decisions and takes action to get tasks done.

## Table of Contents

- [Abilities](https://numen.dwinovo.cn/intro/abilities.md): Your agent's skills, and the tools added through MCP servers and plugins.
- [Architecture Overview](https://numen.dwinovo.cn/develop.md): Numen's three layers: Minecraft, the Lua and Java APIs opened to the large language model, and the model that writes Lua programs.
- [Brain](https://numen.dwinovo.cn/intro/brain.md): Set up a model provider for Numen, or let an external agent such as Claude Code or Codex drive it.
- [Commands](https://numen.dwinovo.cn/intro/commands.md): Type / in the chat box to use commands that manage the agent's context, goals, skills and usage.
- [Dependencies](https://numen.dwinovo.cn/develop/dependencies.md): Which modules Numen is made of, how they depend on each other, and which artifact developers should depend on.
- [Evaluation](https://numen.dwinovo.cn/deep-dive/evaluation.md): How Numen evaluates the quality of its harness.
- [Getting Started](https://numen.dwinovo.cn/intro/quick-start.md): Install Numen, then get going in three steps: set up a model, summon an agent, and talk to it in plain language.
- [How Does AI Control a Server Player?](https://numen.dwinovo.cn/deep-dive/controlling.md): From tool registration to Lua: why we didn't hand the AI a keyboard, why the tools kept piling up, why a command line wasn't enough, and why Numen finally chose a Turing-complete scripting language.
- [Personality](https://numen.dwinovo.cn/intro/persona.md): Give your agent a persona, a skin and a voice.
- [Plugins](https://numen.dwinovo.cn/develop/plugins.md): Writing plugins for Numen: register new Lua APIs with the agent and teach it to use other mods.
- [Skills](https://numen.dwinovo.cn/develop/skills.md): Writing skills for Numen, teaching the agent to use the abilities it already has to get a certain kind of task done.
- [What Is It in Minecraft?](https://numen.dwinovo.cn/deep-dive/what-it-is.md): Numen is a server-side player that AI controls: how it started as a setup-free Voyager, why we dropped mineflayer, and how we settled on a server-side player.
- [What is Numen?](https://numen.dwinovo.cn/intro.md): Numen is an embodied agent that runs inside Minecraft. It lives in the game as a mod, continually explores the Minecraft world, makes its own decisions, and takes action to get tasks done.