Skip to content

Zhou-Shilin/MineClawd

Repository files navigation

MineClawd Mascot

MineClawd

Bring OpenClaw into Minecraft! The Minecraft Agent that actually do things.

Mascot: Yuki

Modrinth Wiki

MineClawd.mp4

Warning

MineClawd is an experimental project. It can execute generated JavaScript in-game. Treat OP access and API credentials as sensitive, and only use this mod in environments you trust.

MineClawd is an Architectury mod that brings the power of AI to Minecraft, letting you modify the game using natural language.

Supported platforms on branch 1.21.1 (v1.3.0):

  • NeoForge 1.21.1
  • Fabric 1.21.1 (pending KubeJS Fabric support)

What it can do

Turn your words into reality, instantly.

MineClawd is like a magic wand for your world. You do not need to know how to code - just tell the game what you want, and watch it happen!

  • Dream it, Say it, Play it: Want a sword made of cookies? A helmet that gives you night vision? Or maybe you want it to rain diamonds? Just describe it in the chat!

  • No Restarts Needed: Forget about closing the game to add mods. New blocks, items, and recipes are created right before your eyes in real-time.

  • Unleash Your Imagination: Ever wanted to give your cat a suit of armor? Or walk on clouds that spawn under your feet? With MineClawd, your wildest ideas are just a sentence away.

Features

  • Natural language control: ask for gameplay help, world edits, automation, or admin tasks directly in chat.
  • Real actions, not fixed macros: MineClawd can inspect state and adapt steps while it works.
  • Persistent automation support: it can write and update server-side logic for commands, recipes, drops, listeners, and tick behavior.
  • Session management built for long tasks: create, list, resume, and remove sessions without losing context.
  • Persona system: switch between default, yuki, or your own custom souls.
  • Rich chat UX: readable progress updates and Markdown/MineDown formatted replies in-game.
  • Multi-provider LLM support: OpenAI-compatible endpoints and Google Vertex AI.
  • Practical guardrails: optional tool-call limits, debug logs, and OP-only command access.

Quick Start

Moved to https://docs.baimoqilin.com

Build

From the project root:

./gradlew collectJars

Release jars are collected into build/libs/:

  • mineclawd-neoforge-1.3.0.jar (NeoForge 1.21.1)

Security

  • MineClawd can execute generated KubeJS JavaScript and run commands.
  • Restrict OP access.
  • Use least-privilege API keys and rotate them if exposed.

Credits

  • Project Author: Zhou-Shilin (BaimoQilin)
  • Coding Support: OpenAI Codex
  • Libraries and Upstream Projects:
    • Architectury API and Architectury Loom by the Architectury contributors.
    • Fabric Loader, Fabric API, and Yarn mappings by FabricMC contributors.
    • NeoForge and Forge maintainers/contributors.
    • KubeJS by the KubeJS maintainers and contributors.
    • YetAnotherConfigLib (YACL) by isXander and contributors.
    • Mod Menu by TerraformersMC contributors.
    • Better Modlist contributors.
    • MineDown Adventure by Phoenix616 and contributors.
    • Adventure (Kyori) by kyori and contributors.
    • Gson by Google.

License

Apache License 2.0. See LICENSE.

About

Bring OpenClaw into Minecraft! The Minecraft Agent that actually do things.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages