Komugi ドキュメント

高パフォーマンス・高耐障害性を備えた Minecraft 統合版 (Bedrock Edition) 向け Go 言語製リレーサーバー。

主な機能と特徴

シームレスな中継と復帰

クライアントとバックエンドサーバーの間に位置し、パケットを透過的に中継。サーバー再起動時や一時切断時もクライアントを切断せず、Limbo 待機や自動復帰を行います。

ゲーム内独自機能

/f3 による Java 版風デバッグオーバーレイ、/cb によるチャンク境界線表示、/tps や /ping のレイテンシ計測、/shop_alert による取引監視などをクライアントMODなしで実現します。

高速なパケットロギング

SQLite (WAL モード + バッチ書込) や日別ファイルローテーション、標準出力をサポート。切断・移動パケットの核心を低負荷で記録・追跡します。

管理・エージェント連携 CLI

UNIX ドメインソケット経由のリアルタイムステータス表示 (komugi status) や SQLite ログ検索 (komugi logs) を完備。JSON / JSONL 出力により AI エージェントとの連携も容易です。

セットアップ: サーバーのインストール、環境変数 (.env) 設定、初回起動と Xbox 認証
使い方ガイド: ゲーム内コマンド一覧、ショップアラート、デバッグツール
運用・管理: ログ運用、CLI ステータス監視、リソースパック中継、障害対処
リファレンス: .env.example から自動生成される全環境変数一覧
開発者向け: 内部アーキテクチャ、ビルド・テスト手順、コントリビューション
AI・エージェント向け (/llms.txt): LLM やコーディングエージェントが機械可読で参照できるインデックスと全ドキュメント統合ファイル (/llms-full.txt)