SnHub changelog

LuckPerms group sync no longer loses a change, and no longer swallows a genuine one.

Changes

• Durable outbox: every LuckPerms change of a synced group that the network database has not confirmed yet is kept in plugins/SnHub/lp-outbox.db (local SQLite). It survives a database outage, a restart, a full buffer and a reload that turns the sync off, and is deleted only once the network database confirms the write.
• Changes are recorded even while the network database is down, boot included, and sent as soon as it answers.
• Resend with a growing delay (from network.poll-interval-seconds up to the new network.retry-max-seconds, default 60), one probe at a time while the database keeps failing. A stored change keeps its original time, so it never overwrites a newer change another hub wrote.
• A network that is down reconnects on its own with the same growing delay (before, only /snhub reload did): one warning when it goes down, one info line when it is back.
• No more drop on overflow: past 10,000 pending changes SnHub only warns.
• Exact echo guard: a change this hub applied from the network is never written back, and a change an admin makes right after it, even to the same player and group, still syncs. The old time window (up to 30 s) is gone.
• /snhub network status shows how many LuckPerms changes are still unsent.
• Conservative rules unchanged: only the configured groups, never default nor context nodes; a group is only removed by a newer removal; import stays additive; only what LuckPerms observed is written.

Config and lang (merged automatically on boot)

• config.yml: new network.retry-max-seconds (5-3600, default 60).
• lang/messages_en.yml: new messages.network.status-outbox; new default text for messages.network.status-reason-down (an existing value is kept).

Known limitations

• The last write wins by each hub's own clock: keep the hubs' clocks in sync (NTP).
• The other 1.0.0 limitations still apply (server id auto-detection, game rules after a restart, keep-in-TAB on Paper 1.20.0-1.20.4).

API: no API impact (API_VERSION stays 1.0.0).

Requirements unchanged: Java 21+, Paper 1.20.x or 1.21.x, SnLib.jar 1.41.0 or newer, a Sn bundle license key.

Adds a public developer API (API_VERSION 1.0.0) so other plugins can integrate with SnHub.

API (API_VERSION 1.0.0)

• Service: SnHubAPI, resolved through the Bukkit ServicesManager or SnHubProvider (resolve it when needed, do not cache it).
• Cancellable events (fired before the action): PvpModeEnterEvent, HubItemUseEvent (Ender Butt, Bow Teleport and the hide-players toggle), PlayerVisibilityToggleEvent.
• Read-only queries: player hub state (mode, hiding players), PvP check, spawn location, this hub's server id, live hubs of the network, live player count of a proxy server.
• api-events.enabled in config.yml switches event dispatch off; queries stay available.
• Docs: the SnHub API page on the GitBook.

Known limitations

• HubItemUseEvent does not fire for items that only run items.yml actions (selector, hubs, rules and custom items): SnLib runs those clicks itself with no veto hook.
• The 1.0.0 limitations still apply (server id auto-detection, the LuckPerms echo window, game rules after a restart, keep-in-TAB on Paper 1.20.0-1.20.4).

Requirements unchanged: Java 21+, Paper 1.20.x or 1.21.x, SnLib.jar 1.41.0 or newer, a Sn bundle license key.

First stable release of SnHub, the all-in-one hub plugin.

Features

• Fixed spawn on every join, respawn and void fall; instant /spawn.
• Configurable hotbar items (any slot, optional permission) running SnLib actions: open menus, connect to servers, run commands.
• Modality selector menu with live per-server player counts (no PlaceholderAPI needed); live hub selector.
• Hub fun items: Ender Butt, Bow Teleport, double jump, launch pads, hide players (hidden players stay in TAB on Paper 1.20.5+).
• Sword PvP mode with a countdown, configurable armor and sword, and a legacy (1.8) or modern (1.9+) combat style.
• Hub protections, one toggle each: weather, time, mobs, damage, hunger, blocks, items, messages; /snhub build bypass.
• Optional MySQL multi-hub network: LuckPerms group sync across hubs (store purchases reach every lobby), auto-populated hub registry and selector, shared configuration push/pull.

Requirements: Java 21+, Paper 1.20.x or 1.21.x, SnLib.jar 1.41.0 or newer, a Sn bundle license key. A Velocity/BungeeCord proxy for server switching, counts and the network.

Known limitations

• With network.server-id: auto the server id comes from the proxy's GetServer reply; set network.server-id explicitly on each hub to skip auto-detection.
• A second LuckPerms change to the same player and group within about 30 s of a sync from another hub may stay local; repeat it if needed.
• Game rules SnHub switches off are not restored after a restart: use /gamerule.
• On Paper 1.20.0-1.20.4 hidden players also leave the TAB list (one console WARN).