Eaglercraftサーバーの作り方
ローカルのPaperから、ブラウザで接続できるWSSアドレスまでを構築する最新手順です。
1. 用途に合う構成を選ぶ
Shared Worldは一時的なプレイヤー主催セッション向けです。常設ワールド、プラグイン、モデレーションには独立して動く専用サーバーが適します。
初心者は公式Paperテンプレート、既存Javaサーバーの運営者は現在の構成へEaglerXServerを追加します。
| Goal | Route | Reason |
|---|---|---|
| Private test | 公式Paperテンプレート | Compatible baseline |
| Existing Spigot | EaglerXServer plugin | Keep world and plugins |
| Server network | BungeeCord or Velocity | Route several backends |
| Short session | Shared World | No dedicated administration |
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. 手順どおりにセットアップする
Back up the world and configuration before changing the server.
- 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ヘッダーを転送します。
Home connections may require router forwarding and may be behind carrier-grade NAT. Use a host that supports persistent WebSockets when inbound access is unavailable.
モバイル回線など外部ネットワークから公開ホスト名を試してください。localhost成功だけではDNS、TLS、ファイアウォールを確認できません。
6. 層ごとにテストする
Change one layer at a time and inspect browser, reverse-proxy, and server logs.
| Symptom | Layer | Check |
|---|---|---|
| Connection refused | Listener | Confirm the private port |
| Mixed content | TLS | Use wss:// and a valid certificate |
| 502 / upgrade failed | Proxy | Forward WebSocket headers |
| Version error | Protocol | Check ViaVersion compatibility |
| Local only | NAT / DNS | Test externally |
| Wrong player IP | Proxy | Review inject_address |
7. 公開前に安全対策とバックアップを行う
公開ゲートウェイには自動アクセスが来ます。認証、権限、更新、復元可能なバックアップを公開前に用意します。
- Use authentication or a whitelist.
- Run as a non-administrator and expose only required ports.
- Rate-limit the gateway and keep admin panels private.
- Back up worlds, plugins, and configuration, then test restoration.
- Use official releases and keep a rollback copy.
よくある質問
Official sources
- EaglerXServer — 要件と設定
- EaglerXServer v1.1.0 — verified release
- 公式Paperテンプレート — beginner baseline