Eaglercraftサーバーの作り方
ローカルのPaperから、ブラウザで接続できるWSSアドレスまでを構築する最新手順です。
1. 用途に合う構成を選ぶ
共有ワールドは一時的なプレイヤー主催セッション向けです。常設ワールド、プラグイン、モデレーションには独立して動く専用サーバーが適します。
初心者は公式Paperテンプレート、既存Javaサーバーの運営者は現在の構成へEaglerXServerを追加します。
| 目的 | 構成 | 理由 |
|---|---|---|
| プライベートテスト | 公式Paperテンプレート | 互換性のある基本構成 |
| 既存のSpigot | EaglerXServer プラグイン | 現在のワールドとプラグイン構成を維持できます。 |
| サーバーネットワーク | BungeeCord または Velocity | 複数のバックエンドへ振り分ける |
| 短時間のセッション | 共有ワールド | 専用サーバーの管理が不要 |
2. インストール前に最新版を確認する
2026年7月25日に公式GitHubで確認した最新版は、2026年5月7日公開のEaglerXServer v1.1.0です。JARは8,774,817バイトで、Java 17以降が必要です。
ブラウザクライアントはu53、ゲートウェイはv1.1.0で別の番号です。公式releaseページか公式テンプレート以外から取得しないでください。
3. 接続の仕組みを理解する
ブラウザは通常のMinecraft TCPへ直接接続できません。EaglerXServerがWebSocketを受け取り、Javaサーバーまたはプロキシへ渡します。HTTPSページではWSSが必要です。
Javaバックエンドは非公開にし、信頼できるリバースプロキシでTLSを終端します。実IPが必要な場合だけinject_addressを設定します。
4. 手順どおりにセットアップする
既存のワールドを先にバックアップします。新しいフォルダーで作業し、変更した設定はすべてコピーして残します。
- Java 17以降を導入
java -versionで対応する64ビットJavaを確認します。 - 公式の方法を選択
公式Paperテンプレートか公式EaglerXServer v1.1.0 JARを使います。 - 設定ファイルを生成
一度起動し、EULAを確認して生成されたファイルを編集します。 - リスナーを設定
WebSocket、制限、互換性、必要時のinject_addressを設定します。 - 安全なWSSを追加
リバースプロキシでTLSを終端しWebSocketを転送します。 - 外部テストとバックアップ
別回線からWSSを試し、復元できるバックアップを作ります。
5. 安全なWSSアドレスを設定する
HTTPSページからのws://は混在コンテンツとして遮断されます。有効な証明書とドメインを使い、UpgradeとConnectionヘッダーを転送します。
自宅回線ではルーターのポート転送が必要な場合があり、キャリアグレードNATの背後にあることもあります。外部からの接続が難しい場合は、永続的なWebSocketに対応するホストを使ってください。
モバイル回線など外部ネットワークから公開ホスト名を試してください。localhost成功だけではDNS、TLS、ファイアウォールを確認できません。
6. 層ごとにテストする
一度に変更する層は一つにし、リバースプロキシとサーバーのログを確認します。ブラウザーのコンソールで、TLS と WebSocket の失敗を Minecraft プロトコルの失敗と区別できます。
| 症状 | 層 | 確認 |
|---|---|---|
| 接続拒否 | Listener | プロセスが設定したプライベートポートで待ち受けていることを確認します。 |
| 混在コンテンツ | TLS | ws:// を wss:// に置き換え、証明書を確認します。 |
| 502 / 切り替え失敗 | Proxy | WebSocketヘッダーを転送する |
| バージョンエラー | Protocol | ViaVersionの互換性を確認する |
| ローカルのみ | NAT / DNS | 外部からテスト |
| プレイヤーIPが違う | Proxy | inject_addressを確認 |
7. 公開前に安全対策とバックアップを行う
公開ゲートウェイには自動アクセスが来ます。認証、権限、更新、復元可能なバックアップを公開前に用意します。
- 非公開コミュニティにはホワイトリストまたは認証プラグインを使います。
- 管理者権限のないアカウントでサービスを実行し、必要なポートだけを公開します。
- 公開ゲートウェイのレートを制限し、管理パネルは非公開にします。
- ワールド、プラグイン、設定をバックアップし、復元テストを行います。
- 更新前に公式リリースを確認し、ロールバック用のコピーを残します。
よくある質問
公式情報源
- EaglerXServer — 要件と設定
- EaglerXServer v1.1.0 — 確認済みリリース
- 公式Paperテンプレート — 初心者向けの基本構成