インストール・ビルド手順

Komugi は Go 言語で書かれた軽量・高速な Minecraft Bedrock Edition (統合版) 向けのリレーサーバーです。単一の実行可能バイナリとしてビルドして動作します。

動作要件

• Go: 1.22 以上 (ビルド時に必要)
• OS: Linux, macOS, または Windows (Linux 推奨)
• ネットワーク:
  • 受信用 UDP ポート (既定: 19132)
  • 転送先 Bedrock サーバーへの UDP 通信
  • Xbox Live 認証用のアウトバウンド HTTPS (初回認証時)
• SQLite3: ユーザー情報・ログを保存する場合に必要 (Go のモダンな Pure Go / cgo-free ドライバを使用しているため外部ライブラリのインストールは不要)

手順

1. リポジトリのクローン

   Git を使用してソースコードを取得します。

   git clone https://gitlab.com/another_route/komugi.git
   cd komugi

2. 依存関係のダウンロード

   Go modules の依存関係を同期します。

   go mod download

3. バイナリのビルド

   リポジトリに含まれる build.sh スクリプトを実行するか、直接 go build を実行します。

   build.sh (推奨)

   chmod +x ./build.sh
   ./build.sh

   go build

   go build -o komugi ./cmd/komugi

   ビルドが成功すると、カレントディレクトリに実行可能ファイル komugi が生成されます。

4. 動作確認

   ヘルプメッセージを表示してビルドが正常に完了したことを確認します。

   ./komugi --help

次のステップ

バイナリのビルドが完了したら、次は接続先サーバーのアドレスなどを指定する 環境設定 (.env) に進んでください。