SoulFireでMinecraftサーバーのボット試験を組み立てる

CLI実装と公式GUIを分けて見る

SoulFireはサーバーテスト、自動化、開発向けに自動ボットを展開するJava製ツールです。このリポジトリに入るのはCLIとサーバー実装で、公式GUIクライアントはSoulFireClientという別リポジトリにあります。したがって、GitHubから取得した本体だけでGUIが同梱されると考えると導入判断を誤ります。

READMEにはオンラインモードとオフラインモードのサーバー、Java EditionとBedrock Editionの双方、ほぼすべてのMinecraftバージョンへの対応が記載されています。正確な対応版はドキュメントに委ねられているため、接続対象の版を先に照合します。

セッションごとの負荷を制御する

各セッションでボット数、参加遅延などを設定でき、プロファイルの保存と読み込みにも対応します。複数クライアントを一度に参加させる試験では、人数だけでなく遅延を記録して、接続集中と通常参加を分けて観察できます。プロファイルのファイル形式や保存場所はREADMEに説明がありません。

Microsoftアカウントは認証情報とデバイスコードに対応し、オフラインアカウントも使えます。HTTP、SOCKS4、SOCKS5プロキシを利用できますが、アカウントとプロキシのインポート手順は外部ドキュメントです。資格情報を実験用に分離し、実在ユーザーの情報を流用しない運用が必要です。

内蔵プラグインとA*経路探索

AutoRespawn、AutoJump、ClientSettingsなどの内蔵プラグインがあり、コンソールコマンドも実行できます。コマンド一覧はGUIまたはCLIでhelpを実行するか、公式コマンド文書で確認します。READMEはプラグインの完全な一覧や個別設定値までは示していません。

経路探索はA*を基盤とし、斜め移動、パルクール、ブロックの採掘、ブロックの設置を扱うと説明されています。試験では目的地への到達だけでなく、採掘や設置が許される範囲、障害物での停止、サーバー側のイベントログを確認すると、単なる接続試験と行動試験を分けられます。

Java 25からソースを組み立てる

ソースビルドの手順はJava 25以上を用意し、GitHubからソースを取得してプロジェクトディレクトリで`./gradlew build`を実行する流れです。生成物は`client-launcher/build/libs`または`dedicated-launcher/build/libs`に置かれます。READMEにはこれ以外のビルドオプションは記載されていません。

インストールガイド、対応バージョン、CLIモードは公式サイトの文書へリンクされています。導入後は`help`で実際のコマンドを確認し、デモページの表示と自分のサーバー接続を別々に試します。Nightlyビルドを使う場合は開発版であることを記録し、プラグインの互換性を固定した版で再確認します。

SDKとプラグインAPIの更新リスク

開発者APIではプラグインAPIとmixinを使って独自プラグインを作成できます。TypeScriptとPythonのSDKはgRPC-Webで接続し、ボットイベントのストリーミング、ボット単位の操作発行、ローカル専用サーバーのプロビジョニングを扱います。SDKのサンプルコードやAPIの細部はREADMEにありません。

SoulFireは破壊的変更を含む可能性があるため、READMEはプラグインをSoulFireの版に固定するか、変更時に更新するよう求めています。採用時は`gradlew build`の結果、SDK接続、イベント受信、停止操作を対象版で試し、プラグインがサーバー状態を意図せず変更しないことを確認します。

許可、AGPL-3.0、運用境界

READMEは所有するサーバー、またはテスト許可を得たサーバーだけで使うよう警告しています。ホスティング事業者が自動ボット試験を認めるかも利用者の責任です。開発者は無許可利用の責任を負わないと明記しているため、技術的に接続できることを利用権限の根拠にしてはいけません。

ライセンスはAGPL-3.0です。公開アクセス可能なサーバーで改変版を動かす場合のソース提供条件を含むため、社内利用や配布形態を法務と確認します。向くのは許可済み環境で挙動を再現できる開発・試験担当者で、他者のサーバーを対象にした自動操作には向きません。

検証サーバーで見る具体的な挙動

最初の試験では、所有者が管理するMinecraftサーバーを一つ用意し、オンラインモードとオフラインモードを混ぜずに確認します。ボット数を1、複数、上限付近へ段階的に変え、join delay、認証結果、切断理由、サーバーのTPSやログを同じ時刻で保存します。HTTP、SOCKS4、SOCKS5を使う場合は接続元と失敗時の再試行も分けて記録します。

次にAutoRespawnや経路探索を一つずつ有効化し、採掘、設置、斜め移動、パルクールで想定外のブロック変更が起きないかを確認します。GUIのhelpとCLIのhelpが同じコマンドを示すか、プロファイルを保存して再起動後に復元できるかも試します。結果をSoulFireの版とプラグイン版に結び付ければ、更新時にどの機能を再試験すべきかが明確になります。

編集部の結論

自分が管理するMinecraftサーバーの負荷試験や開発用自動化を、CLIまたはGUIで組み立てたい人に向きます。公開サーバーへ接続する前に、所有者の許可、ホスティング規約、アカウント種別、プロキシ経路を確認してください。まず専用の検証サーバーでボット数と参加遅延を固定し、ログ、切断、サーバー負荷を観察するのが先です。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes