docs: the management protocol's activity and heartbeat notifications

Co-Authored-By: Claude Sonnet 5.5 <[email protected]>
This commit is contained in:
AkirabaneandClaude Sonnet 5.5 committed 2026-11-02 14:35:38 +01:00
1 parent 8d0122354f
commit 35bdb3d076
2 files changed
+9 -3

No files matched your search

+2 -2
View File
@@ -79,8 +79,8 @@ addition; a change to one starts `/api/v2`, served beside `/api/v1`.
- **Backups**: restore a single dimension.
- **Mods on a dedicated server**: list, turn on and off, and their settings, once native mods can be built for the
server ([mods.md](../mods.md), [native-mods.md](../native-mods.md#multiplayer)).
- **Vanilla's management protocol**: `serversettings/*` (the live settings not yet done), the notifications of
the server's activity and the world upgrade, and the status heartbeat (the others are sent). The methods answer
- **Vanilla's management protocol**: `serversettings/*` (the live settings not yet done) and the world
upgrade's notifications (the others are sent). The methods answer
an internal error saying so; a kick's translatable message is sent as its key.
- **Compatibility tests**: golden replies per endpoint, and a `server.toml` from each release line.
+7 -1
View File
@@ -521,7 +521,13 @@ runtime or new dependency. Server-sent events can replace the polling later if a
sets one (checked against its type and bounds, logged and set only when the value changes) and
`notification/gamerules/updated` follows every change, by that method or by `/gamerule`
(`Game::set_game_rule`);
- planned: the rest of `serversettings/*`, the activity and world-upgrade notifications and the heartbeat.
- `server/activity`: a login attempt (the game records `login_activity` in its login gate, as
`ServerActivityMonitor.reportLoginActivity` is called when a login starts), told at most once in thirty
seconds and lost otherwise, as the monitor clears its flag whatever it did; and `server/status`, the
heartbeat: every `status-heartbeat-interval` seconds (none at 0, the first after as many) the status
`server/status` answers, up or not, to whoever is connected;
- planned: the rest of `serversettings/*` and the world-upgrade notifications (after `WorldUpgrader`'s server
side).
## 9. Benchmark plan (bots against vanilla and Paper)