yc-software / minecraft-agent-harness
Run language-model agents in Minecraft with Mineflayer tools, persistent sessions and shell sandboxes.
Why this job: works in the areas we cover, but does not say which job it does
What it does
Point an LLM at a Minecraft server and give it something to do. It plays through Mineflayer, so it walks, mines, crafts, builds, fights and chats like a regular player. pi handles the model session. We've run Bed Wars matches with it, and a survival server with 50 agents on it at once.
Get started
npm ci
cp .env.example .env
# add the API key for your model provider
npm run server
# Paper 1.21.6 on localhost:25565, offline mode- Maintenance
- Active
- Last commit 11 days ago
- Stars
- 188
- +66 this week
- Licence
- MIT
- Allows business use
- Downloads for
- None listed
- No release files
- Latest version
- None yet
- No releases
- Built with
- JavaScript
- 100% of the code
Is it looked after?
- Contributors
- 1
- Last 90 days
- Issues
- 0% closed
- 1 still open
- Pull requests
- 0 merged
- 0 waiting
- Releases
- None
- Never published
- Contributing guide (opens in new tab)
- No security policy
- No code of conduct
More: languages, topics and project record
Languages
- JavaScript 100%
- Shell <1%
- Dockerfile <1%
Topics
- agent-harness
- ai-agents
- llm
- minecraft
- mineflayer
- multi-agent
Project record
- JobOther AI tools
- StatusNew to our list
- Commits1
- Forks23
- Watching2
- CreatedOct 29, 2026
- First seen by usNov 7, 2026
- CheckedNov 9, 2026