ServerChanは、MinecraftサーバーにAIアシスタントを導入するModです。チャットを理解し、ゲーム内イベントに反応し、権限に応じてコマンドを実行することもできます。小規模なSMPから大規模な公開サーバーまで、スパムなしで会話を盛り上げます。
- AIチャット統合 - OpenAI互換API（OpenAI、Azure、ローカルLLMなど）を使用したインテリジェントな会話
- スマート応答システム - オプションの意図チェッカーでAIが応答すべきタイミングを判断し、スパムを防止
- ゲームイベント認識 - プレイヤーの参加/退出、死亡などのサーバーイベントに反応
- コマンド実行 - 関数呼び出しによるMinecraftコマンドの実行（権限制御付き）
- マルチローダー対応 - Fabric、Forge、NeoForge、Spigot/Paperで動作
- マルチバージョン対応 - Minecraft 1.12 - 1.21に対応
- 高度な設定 - プロンプト、モデル、応答動作などをカスタマイズ可能
- 多言語対応 - 英語、中国語、日本語のi18nサポート内蔵
| バージョン | Java | Fabric | Forge | NeoForge | Spigot/Paper |
|---|---|---|---|---|---|
| 1.12.x | 8 | — | ❌ | — | ✅ |
| 1.13.x | 8 | — | ❌ | — | ✅ |
| 1.14.x | 8 | ✅ | ❌ | — | ✅ |
| 1.15.x | 8 | ✅ | ❌ | — | ✅ |
| 1.16.x | 8 | ✅ | ✅ | — | ✅ |
| 1.17.x | 16 | ✅ | ✅ | — | ✅ |
| 1.18.x | 17 | ✅ | ✅ | — | ✅ |
| 1.19.x | 17 | ✅ | ✅ | — | ✅ |
| 1.20.x | 21 | ✅ | ✅ | ✅ | ✅ |
| 1.21.x | 21 | ✅ | ✅ | ✅ | ✅ |
— は該当バージョンでローダーが存在しないことを示します（Fabricは1.14から、NeoForgeは1.20から）。
- Modrinth または CurseForge からローダーに対応したjarをダウンロード
mods/フォルダ（Spigot/Paperの場合はplugins/）にjarを配置- サーバーを起動して設定ファイルを生成
- APIキーと必要な設定を追加（下記の設定セクションを参照）
- サーバーを再起動または
/reloadでチャット開始
設定ファイルの場所：
- Fabric/Forge/NeoForge:
config/serverchan.yaml - Spigot:
plugins/ServerChan/config.yml
| オプション | 説明 |
|---|---|
openaiApiKey |
OpenAI APIキー（または互換プロバイダー） |
openaiBaseUrl |
APIベースURL（デフォルト: https://api.openai.com/v1）重要: /v1パスを含める必要があります |
| オプション | デフォルト | 説明 |
|---|---|---|
model |
gpt-5.1 |
応答に使用するモデル |
temperature |
1.0 |
応答のランダム性（0.0 - 2.0） |
contextSize |
20 |
コンテキストに保持するメッセージ数 |
botColor |
b |
ボットチャットのMinecraftカラーコード |
timeZone |
UTC |
メッセージタイムスタンプのタイムゾーン |
locale |
ja |
ボットメッセージの言語 |
意図チェッカーは、小型/高速モデルを使用してAIが応答すべきかを判断します。
| オプション | デフォルト | 説明 |
|---|---|---|
useIntentionChecker |
true |
スマート応答フィルタリングを有効化 |
intentionCheckerModel |
gpt-4o-mini |
意図チェック用モデル (個人的な推奨: Cerebras経由でqwen3-235b-a22b-2507) |
responseProbabilityThreshold |
0.5 |
応答をトリガーする最小確率 |
useFastPathIntentionChecker |
false |
応答生成を早期開始 |
intentionCheckerApiKey |
(空) | 別のAPIキー（空の場合はメインキーを使用） |
intentionCheckerBaseUrl |
(空) | 別のベースURL（空の場合はメインURLを使用）設定する場合は/v1パスを含める必要があります |
| オプション | デフォルト | 説明 |
|---|---|---|
enableGameEvents |
true |
ゲームイベントに反応 |
enableJoinLeaveEvents |
true |
プレイヤーの参加/退出に反応 |
enableDeathEvents |
true |
プレイヤーの死亡に反応 |
| オプション | デフォルト | 説明 |
|---|---|---|
inheritCmdSourcePermission |
true |
AIがトリガーしたプレイヤーの権限を継承してコマンドを実行 |
サーバーの雰囲気に合わせてシステムプロンプトをカスタマイズできます：
intentionCheckingSystemMessage- AIが応答するタイミングを制御responseGenerationSystemMessage- AIの性格と動作を制御
example/フォルダにサンプルプロンプトファイルがあります。例えば、example/OnlyMyRedstone-system-prompt.txtにはOnlyMyRedstoneコミュニティサーバーで使用されている完全な応答生成設定が含まれています。これらのファイルを複製して、あなたのサーバーに合わせてアレンジしてください。
すべてのコマンドにはオペレーター権限（レベル4）が必要です。
| コマンド | 説明 |
|---|---|
/serverchan reload |
設定をリロード |
/serverchan reset |
メッセージコンテキスト/メモリをクリア |
/serverchan kill |
OpenAIクライアント接続をリセット |
/serverchan disable |
ServerChanの応答を一時停止（メッセージは処理されません） |
/serverchan enable |
ServerChanの応答を再開 |
- プレイヤーがチャットでメッセージを送信
- 意図チェッカー（有効な場合）が応答が適切かどうかを評価
- 応答が必要な場合、メインモデルが返答を生成
- AIはオプションで関数呼び出しによるコマンド実行が可能
- 応答が全プレイヤーにブロードキャストされる
AIは会話コンテキストを維持し、設定されたコンテキストサイズ内の以前のメッセージを参照できます。
- Minecraft Server 1.12 - 1.21（互換性マトリックスを参照）
- Fabric、Forge、NeoForge、またはSpigot/Paperのいずれか（バージョンにより利用可能性が異なります）
- OpenAI APIキー（またはAzure OpenAI、Ollamaなどの互換プロバイダー）
# リポジトリをクローン
git clone https://github.com/himekifee/ServerChan.git
cd ServerChan
# 特定のMinecraftバージョン用にビルド
./gradlew build -PmcVer=1.21
# マージjar（全ローダーを1つに）をビルド
./gradlew build mergeJars -PmcVer=1.21ビルドされたjarはbuild/libs/（またはマージjarの場合はbuild/forgix/）にあります。
ローカル開発用に、Modをビルドして実際のMinecraftサーバーを起動し、正しくロードされることを確認するテストスクリプトが提供されています：
# 全プラットフォームでビルドとテスト（Dockerが必要）
./dev-test.sh 1.21
# ビルドのみ、サーバーテストをスキップ
./dev-test.sh --build-only 1.21
# 特定のプラットフォームのみテスト
./dev-test.sh --fabric 1.21
./dev-test.sh --forge 1.21
./dev-test.sh --neoforge 1.21
./dev-test.sh --paper 1.21サーバーテストの実行にはDockerが必要です。
コントリビュートは大歓迎です！IssueやPull Requestをお気軽にどうぞ。ServerChanの使い方を聞かせてください。
- リポジトリをフォーク
- フィーチャーブランチを作成（
git checkout -b feature/amazing-feature） - 変更をコミット（
git commit -m 'Add amazing feature'） - ブランチにプッシュ（
git push origin feature/amazing-feature） - Pull Requestを開く
Discordサーバーに参加して、コミュニティとの交流、ヘルプの取得、ServerChanの設定共有をしましょう！
このプロジェクトはGNU General Public License v3.0の下でライセンスされています。詳細はLICENSEファイルを参照してください。
- Universal Mod Template by thebuildcraft
- YAML設定にConfigLibを使用
- Architectury Loom、Forgix、Manifoldを使用
Cerebrasのスポンサーではありませんが、CIテストと自分のサーバーの意図チェッカーモデルに彼らの推論APIを使用しています。非常に高速です！20メッセージのコンテキストで、意図チェックは約1秒以内に完了し、完全な応答は約2-5秒で返ってきます。これは20秒以上かかることが多い他のLLMプロバイダーと比較すると、基本的に瞬時です。このようなリアルタイムチャットアプリケーションにはCerebrasが最適です。CerebrasからAPIクレジットやその他のサポートに興味がある方は、お気軽にIssueを開いてください。