Easy LLM

Below is the Japanese README.

Easy LLM

Easy LLM is a Fabric mod that makes Minecraft data available to external LLM systems via WebSocket.

With this mod, you can implement AI agents that understand the state of Minecraft and act together with players.

You can implement and develop AI agents for Minecraft by using the repository below.

Detailed instructions on how to use this mod are also provided, so please refer to them.

• Easy LLM Agent: URL will be added later

Features

• Sends player and world information
• Supports multiple WebSocket endpoints

Requirements

• Minecraft 1.21
• Fabric Loader
• Fabric API

Installation

1. Place easy-llm-fabric-1.0.0+mc1.21.jar in the mods folder of your server or singleplayer/LAN host.
2. Install Fabric API in the same environment.
3. Configure WebSocket endpoints through easyllm.json or in-game commands.

• config/easyllm.json is generated automatically on first launch.

Configuration

Config file:

• config/easyllm.json

Main commands:

• /obsTick <interval>
• /obsWs list
• /obsWs add <ws://host:port>
• /obsWs remove <ws://host:port>

Examples:

• /obsTick 5
• /obsWs list
• /obsWs add ws://host.docker.internal:7891
• /obsWs add ws://127.0.0.1:7892
• /obsWs remove ws://127.0.0.1:7892

Notes

• Install this mod on the server side, or on the host side for singleplayer/LAN hosting.

License

All Rights Reserved.
Unauthorized reproduction and redistribution are strictly prohibited.

Easy LLM (JP)

Easy LLM は、Minecraft の情報を WebSocket 経由で外部の LLM から利用できるようにする Fabric MOD です。

この MOD を利用することで、Minecraft の状況を理解しながらプレイヤーと一緒に行動できる AI エージェントを実装できます。

以下のリポジトリを利用することで、Minecraft を一緒に遊べる AI エージェントを実装・開発できます。
この MOD の詳細な使用方法も記述されているため、参照してください。

• Easy LLM Agent: URLは後程追加します

主な機能

• プレイヤー情報とワールド情報の送信
• 複数の WebSocket 接続先に対応

動作環境

• Minecraft 1.21
• Fabric Loader
• Fabric API

導入方法

1. easy-llm-fabric-1.0.0+mc1.21.jar をサーバー、またはシングルプレイ/LAN ホスト側の mods フォルダに配置します。
2. 同じ環境に Fabric API を導入します。
3. easyllm.json またはゲーム内コマンドで WebSocket 接続先を設定します。（config/easyllm.json は初回起動時に生成されます。）

設定

設定ファイル:

• config/easyllm.json

主なコマンド:

• /obsTick <interval>
• /obsWs list
• /obsWs add <ws://host:port>
• /obsWs remove <ws://host:port>

使用例:

• /obsTick 5
• /obsWs list
• /obsWs add ws://host.docker.internal:7891
• /obsWs add ws://127.0.0.1:7892
• /obsWs remove ws://127.0.0.1:7892

注意

• この MOD はサーバー側、またはホスト側に導入してください。

ライセンス

All Rights Reserved.
Unauthorized reproduction and redistribution are strictly prohibited.