Repolode
投稿する
yc-software

yc-software/minecraft-agent-harness

Mineflayer経由でLLMエージェントをMinecraftのプレイヤーとして動かし、セッションの永続化、エージェントごとのシェルサンドボックス、複数エージェントのチームに対応します。

GitHub で見る
スター
158
フォーク
16
未解決の Issue
1
最終コミット
9 日前

これは何？

minecraft-agent-harnessは言語モデルをMinecraftサーバーに接続し、通常のプレイヤーのようにプレイできるようにします。歩行、採掘、クラフト、建築、戦闘、チャットなどの操作にはMineflayerを使い、モデルのセッション管理にはpiを使います。Claude、GPT、Gemini、OpenRouterに加え、OpenAI Responses API互換のエンドポイントを利用できます。

エージェントの状態は名前ごとのフォルダに保存されるため、同じ名前で再起動すればセッションを再開できます。各エージェントにはE2B、Docker、またはローカルフォルダを使ったシェル環境が用意され、メモの保存や、ゲーム内のツールを呼び出すスクリプトの作成に利用できます。エージェントのチームは単一のJSONファイルで定義でき、エージェント同士でダイレクトメッセージを送ったり、任意でマシンを共有したりできます。

開発用のPaper 1.21.6サーバー、Docker Composeの構成、ルールと審判役を含むBed Warsのサンプルが付属しています。Vision対応は実験的なオプションとして利用できます。

主な機能

  • 01Claude、GPT、Gemini、OpenRouter、またはOpenAI Responses互換のエンドポイントに接続できます。
  • 02同じ名前を使えば、再起動後もエージェントのセッションを再開できます。
  • 03E2B、Docker、またはローカルフォルダ経由で各エージェントにシェル環境を提供します。
  • 04複数エージェントのチームを1つのJSONファイルで定義でき、エージェント間のダイレクトメッセージにも対応します。
  • 05Paperサーバーを含むDocker Composeの構成が付属しています。

ユースケース

  • Minecraftのワールド内で行動するLLMエージェントの実験。
  • チャットで連携するAIプレイヤーのチームの実行。
  • 審判役を交え、Bed Warsなどのゲームでエージェントの振る舞いをテスト。
  • エージェントがシェルサンドボックスを使ってゲーム内ツール向けのスクリプトを作成する方法の研究。

クイックスタート

  1. 1

    依存関係をインストールする

    npm ci
  2. 2

    envファイルをコピーし、使用するモデルプロバイダーのAPIキーを追加する

    cp .env.example .env
  3. 3

    開発用Minecraftサーバーを起動する（Java 21が必要）

    npm run server
  4. 4

    別のターミナルで、目標を指定してエージェントを起動する

    npm start -- --objective "Gather wood and build a small shelter near spawn"

使う前に知っておきたいこと

  • Node 22.19以降、モデルプロバイダーのAPIキー、Minecraftサーバーが必要です。
  • デフォルトでは、エージェントのシェルはローカルフォルダーで動作し、コマンドはあなたのユーザー権限で実行されます。DockerまたはE2Bが利用可能な場合、あるいは --sandbox none を指定した場合はこの限りではありません。
  • Visionサポートは実験的な機能です。
  • まだ新しいプロジェクトで、スター数は100です。まだ荒削りな部分があることをご了承ください。

収録されている特集

オープンソースの AI エージェント・フレームワークとアプリ

トピック

#ai-agents#llm#minecraft#mineflayer#multi-agent#sandbox#agent-harness

よくある質問

minecraft-agent-harness とは？
Mineflayer経由でLLMエージェントをMinecraftのプレイヤーとして動かし、セッションの永続化、エージェントごとのシェルサンドボックス、複数エージェントのチームに対応します。 minecraft-agent-harnessは言語モデルをMinecraftサーバーに接続し、通常のプレイヤーのようにプレイできるようにします。歩行、採掘、クラフト、建築、戦闘、チャットなどの操作にはMineflayerを使い、モデルのセッション管理にはpiを使います。Claude、GPT、Gemini、OpenRouterに加え、OpenAI Responses API互換のエンドポイントを利用できます。
minecraft-agent-harness は無料で使えますか？ライセンスは？
minecraft-agent-harness は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
minecraft-agent-harness は今もメンテナンスされていますか？
活発にメンテナンス中。minecraft-agent-harness の最終コミットは 2026年10月29日 です。
minecraft-agent-harness は何に使えますか？
Minecraftのワールド内で行動するLLMエージェントの実験。 チャットで連携するAIプレイヤーのチームの実行。 審判役を交え、Bed Warsなどのゲームでエージェントの振る舞いをテスト。 エージェントがシェルサンドボックスを使ってゲーム内ツール向けのスクリプトを作成する方法の研究。
minecraft-agent-harness のインストール方法は？
依存関係をインストールする: npm ci envファイルをコピーし、使用するモデルプロバイダーのAPIキーを追加する: cp .env.example .env 開発用Minecraftサーバーを起動する（Java 21が必要）: npm run server 別のターミナルで、目標を指定してエージェントを起動する: npm start -- --objective "Gather wood and build a small shelter near spawn"
minecraft-agent-harness はどこで入手できますか？
ソースコードとインストール手順は GitHub にあります：https://github.com/yc-software/minecraft-agent-harness

概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。

関連プロジェクト