extra services

docs/03_Configuration.md

@@ -10,7 +10,11 @@
 {
     "server": {
         "id": null,
-        "role": "lobby"
+        "role": "lobby",
+        "public_address": null,
+        "public_port": null,
+        "lobby_role": "lobby",
+        "lobby_role_prefix": "lobby_"
     },
     "redis": {
         "url": null,
@@ -59,6 +63,10 @@
 |---|---|---|
 | `id` | `null` | Optional fixed server id. If null, auto-generated as `<role>-<8 hex chars>` (e.g. `lobby-3f2a91bd`) on every boot. Set this when you want a stable id across restarts. |
 | `role` | `"lobby"` | Logical role of this server. Used to filter via `ServerRegistry.getServersByRole(...)`. Examples: `lobby`, `bridge_duel`, `arena`. Use snake_case. |
+| `public_address` | `null` | Hostname/IP other servers will hand to players when transferring them HERE via `/send` / `/hub`. Null = auto-detect system hostname. **Set this explicitly on hosted setups** where auto-detect gives the wrong answer (typically `127.0.0.1` or a private LAN name). |
+| `public_port` | `null` | Port for the same. Null = Hytale's `DEFAULT_PORT` (currently 5520). |
+| `lobby_role` | `"lobby"` | Role string `/hub` and shutdown handoff look for first. |
+| `lobby_role_prefix` | `"lobby_"` | If no server matches `lobby_role`, accept any role starting with this prefix (e.g. `lobby_eu`, `lobby_na`). |
 
 ### redis