Repolode
mindcraft-bots

mindcraft-bots/mindcraft

Mineflayerを基盤にLLMで動くMinecraftボット。各AIエージェントがゲームをプレイし、プレイヤーとチャットできます。

スター
5,972
フォーク
985
未解決の Issue
63
最終コミット
11 日前

これは何?

Mindcraftは、Minecraft Java Edition内でAIエージェントを動かすためのフレームワークです。Mineflayer製のボットに大規模言語モデルを接続することで、エージェントがワールドを認識し、プレイヤーとチャットしたり、資源の採集やアイテムのクラフトといったゲーム内の操作を実行したりできます。

エージェントはJSONプロファイルで設定します。プロファイルでは、チャットモデル、別個のコードモデル、任意のビジョンモデル、埋め込みや音声の設定に加え、性格を指定するプロンプトや例を設定できます。OpenAI、Gemini、Anthropic、DeepSeek、Ollama経由のローカルモデルなど、多数のLLMプロバイダーに対応しています。localhost上のLANワールドで動かすことも、Microsoftアカウントでオンラインサーバーに接続することもでき、あらかじめ定義した目標を実行するタスクランナーも備えています。

LLMがマシン上でコードを書いて実行できるため、コード生成はデフォルトで無効になっています。READMEでは、リモートサーバーに接続する前にDocker内で実行することを推奨しています。

主な機能

  • 01LLMをMineflayer製ボットに接続し、Minecraft Java Editionをプレイできます。
  • 02OpenAI、Gemini、Anthropic、DeepSeek、Ollamaなど、多数のモデルプロバイダーに対応しています。
  • 03チャット、コーディング、ビジョン、埋め込みにそれぞれ別のモデルを指定できます。
  • 04タスク用JSONファイルでインベントリや目標を指定し、定義済みのタスクを実行できます。
  • 05別々のプロファイルファイルを使って、複数のエージェントを同時に実行できます。

ユースケース

  • 身体性のあるゲーム環境で、複数のLLMエージェントが協調する方法を研究する。
  • ゲーム内キャラクターとして、異なるLLMがどのように振る舞うかを試す。
  • エージェントの性能評価に向けて、スクリプト駆動または目標駆動のMinecraftタスクを構築する。
  • 外部APIを呼び出さずに、Ollama経由でローカルモデルを使ったMinecraftエージェントを実行する。

クイックスタート

  1. 1

    Node.js をインストールします(v18 または v20 LTS を推奨)

  2. 2

    最新リリースをダウンロードするか、リポジトリを clone します

  3. 3

    keys.example.json を keys.json に名前変更し、API キーを追加します

  4. 4

    プロジェクトディレクトリで依存関係をインストールします

    npm install

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

  • 対応する LLM プロバイダーの API キーが必要です。デフォルトは OpenAI です。
  • Minecraft Java Edition のインストールが必要です。v1.21.11 までサポートしています。
  • コーディングを有効にすると、LLM がマシン上でコードを書いて実行できるため、その設定をオンにした状態でパブリックサーバーに接続しないでください。

収録されている特集

トピック

よくある質問

mindcraft とは?
Mineflayerを基盤にLLMで動くMinecraftボット。各AIエージェントがゲームをプレイし、プレイヤーとチャットできます。 Mindcraftは、Minecraft Java Edition内でAIエージェントを動かすためのフレームワークです。Mineflayer製のボットに大規模言語モデルを接続することで、エージェントがワールドを認識し、プレイヤーとチャットしたり、資源の採集やアイテムのクラフトといったゲーム内の操作を実行したりできます。
mindcraft は無料で使えますか?ライセンスは?
mindcraft は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
mindcraft は今もメンテナンスされていますか?
活発にメンテナンス中。mindcraft の最終コミットは 2026年10月27日 です。
mindcraft は何に使えますか?
身体性のあるゲーム環境で、複数のLLMエージェントが協調する方法を研究する。 ゲーム内キャラクターとして、異なるLLMがどのように振る舞うかを試す。 エージェントの性能評価に向けて、スクリプト駆動または目標駆動のMinecraftタスクを構築する。 外部APIを呼び出さずに、Ollama経由でローカルモデルを使ったMinecraftエージェントを実行する。
mindcraft のインストール方法は?
Node.js をインストールします(v18 または v20 LTS を推奨) 最新リリースをダウンロードするか、リポジトリを clone します keys.example.json を keys.json に名前変更し、API キーを追加します プロジェクトディレクトリで依存関係をインストールします: npm install
mindcraft はどこで入手できますか?
ソースコードとインストール手順は GitHub にあります:https://github.com/mindcraft-bots/mindcraft

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

関連プロジェクト