Minecraft version
Cluster-wide, not per-world — every world shares one proxy and one lobby (players hop between them), so they all have to speak the same protocol version. A client on a newer version than the cluster's target simply can't connect to any world, not just one.
Saving only changes the target for new worlds. "Migrate" pushes it to every currently-running world and restarts each one so it re-downloads the right jar.
Declare a world
Worlds
| Name | Type | Phase | Version | Host | Address | Access |
|---|
Add a host
Issues a short-lived join token, then run folia-host-join.sh on the target host with it.
Hosts
| Name | Status | CPU (used/cap) | Memory GB (used/cap) | Address |
|---|
Add a catalog entry
Writes to the operator override file, which always wins over the bundled catalog for this id — no mgmt release needed to add a plugin, bump a download URL to a new version, or flip verified once you've actually checked the download. A world that already declares this plugin picks up the change on its next restart (folia-nexa-node re-fetches the manifest every time — see PLAN.md §9).
Curated plugin catalog
Vetted external plugins (pinned versions) plus in-house plugins, bundled with mgmt and extendable via an operator override file. Select these by id in a world's plugin list — see PLAN.md §14.
| Id | Category | Source | Version | Status | Homepage |
|---|
Curated data pack catalog
Vanilla data packs (e.g. Matcha) staged into a world's save folder before first boot, bundled with mgmt and extendable via an operator override file. Select these by id in a world's data pack list.
| Id | Category | Source | Version | Status | Homepage |
|---|
Server list MOTD & icon
Shown in the multiplayer server list before joining. Polled by the proxy every few seconds — no restart needed.
Discord chat bridge
Bridges in-game chat with Discord, world-aware — a message can go to its own world's channel and/or one combined server-wide channel. Requires folia-nexa-bot running for the Discord→game direction (needs the message_content intent enabled); the proxy handles game→Discord on its own via plain webhooks.
Add a player directly
Skips Discord entirely and approves immediately — use this if Discord OAuth/the bot isn't set up yet.
Access requests
Discord-authenticated requests (or players added directly above) — approved players are pushed to the proxy's access gate and any world with its whitelist enabled.
| Discord user | Minecraft user | Status |
|---|
Create operator account
Users
| Username | Role |
|---|