Dwinovo/minecraft-numen

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.

これは何か

Numen（中国語: 言出法随）は、ゲーム内に具現化AIエージェントを直接埋め込むMinecraft Modです。エージェントはプレイヤーキャラクターとして動作し、世界を認識し、LuaベースのAPIを通じて大規模言語モデル（LLM）によって駆動できます。実際には、Modをインストールし、LLMサービス（OpenAI、Anthropic、または互換性のあるAPI）を設定し、ボットを召喚し、自然言語で話しかけると、ボットが何をすべきかを決定し、Minecraftアクション（移動、採掘、建築、対話など）を実行します。

なぜ重要か

具現化インテリジェンス: チャットのみのボットとは異なり、エージェントは実際にMinecraftの世界を操作し、LLM駆動のロボティクスとプランニングの研究に具体的なテストベッドを提供します。
オープンソースで拡張可能: ModはLGPL-3.0であり、プラグインシステムを提供しているため、開発者は新しいLuaアクション（例: 他のModからのアクション）をLLMに公開できます。
ハイブリッド展開: APIキーを介してLLMをローカルで実行することも、外部の「MCP」ブレイン（Claude Code、Cursorなど）にModを接続して推論を別の場所で行い、トークンコストを節約することもできます。

誰が使うか

ユーザータイプ	得られるもの
Minecraftプレイヤー	建築、探索、タスク自動化を支援する自己駆動型のコンパニオンが欲しい人。
AI研究者 / ホビイスト	具現化LLMエージェント、プロンプトエンジニアリング、マルチモーダルインタラクション（音声、テキスト、スキンカスタマイズ）を実験するためのサンドボックスを探している人。
Mod開発者	自分のModをLLMで制御したい人。エージェントが呼び出せる新しいLua関数を登録するプラグインを書けます。
教育者	知覚-行動ループ、プランニング、プロンプト駆動ロボティクスなどの概念を、おなじみのゲーム環境でデモンストレーションしたい人。

始め方

インストール: CurseForgeで「Numen」を検索し、使用しているMinecraftバージョン（例: 1.20.1-Fabric）用のModをインストールします。
ゲームに入る: ゲーム内でG（新しいバージョンではN）を押してコントロールパネルを開きます。
モデルを設定: OpenAIまたはAnthropicを選択し、APIキーを貼り付け、オプションでカスタム「パーソナリティ」やスキンを設定します。
ボットを召喚: 名前を付けてボットを召喚し、チャットを開始します。Yでテキスト入力、Vで音声入力、R+マウスホイールで複数のボットを切り替えられます。
拡張: pluginsフォルダにプラグインをドロップして、新しいLuaアクション（例: Touhou Little Maid Modの制御）を公開します。リポジトリのpluginsディレクトリとウェブサイトのドキュメントでテンプレートを参照してください。

技術的なハイライト

3層アーキテクチャ:
1. Minecraftコア - エージェントは実際のプレイヤーエンティティを制御します。
2. Lua API - LLMが呼び出せる一連の原子的アクション（認識、移動、採掘、建築、対話）のセット。スキルの読み込み用の小さなJava APIがあります。
3. LLMサンドボックス - Luaスクリプトがサンドボックス内で実行され、単一の呼び出しで多くの原子的アクションを調整します。
モデル非依存: OpenAIまたはAnthropicのHTTPプロトコルに従う任意のサービスをサポート。エンドポイントURLを入力するだけです。
MCPサーバーモード: ModがMinecraft-Chat-Protocolサーバーとして機能し、外部のAIクライアントがエージェントを駆動して、推論をデバイス外で行えます。
音声I/O: パネル設定によるオプションの音声入出力。
マルチエージェントチャット: アバターをドラッグしてグループチャットを作成。@メンションで返信を指定できます。

コミュニティとサポート

QQグループ: 1121662678
Discord: https://discord.gg/FpDCV327vX
公式ウェブサイト: https://numen.dwinovo.cn (ドキュメント、アーキテクチャ図、プラグインガイド)
問題トラッカー: バグや機能リクエストはGitHub Issuesを使用してください。

上記の情報はすべて、リポジトリのREADMEから直接引用されています。