Repository navigation
SMP-Core 1.0.0 is the first stable release: the plugin suite that ran a production survival server, now
generalized for any Paper server and licensed under the Apache License 2.0.
It covers a player-driven economy (auction house, buy orders, shop, sell prices), homes, teleports, friends,
duels, per-player settings, staff tooling, moderation and chat filtering, for a single server or a Velocity
network. A single server needs no database; a network shares state through MySQL or MariaDB.
Getting started. From a clone, ./setup.sh creates a runnable server on macOS or Linux: Paper, the plugins,
checksum-verified dependencies, the menu datapack, a documented branding.yml and a start script. Or drop the jars below into
plugins/ with ProtocolLib and Vault.
Supported versions. One set of jars for Paper 1.21.7 to 1.21.11 with Java 21. Paper 1.21.11 passes every
automated test, single server and network; 1.21.7 to 1.21.10 boot clean and pass the release, menu lock and
command routing tests. Velocity 3.5.1 is tested for networks.
What 1.0.0 means. Every plugin is at 1.0.0 and built on the Paper API. Two optional features read server
internals and turn themselves off with a warning when those change: PizzaTune's chunk-rate tuning and the
locator-bar filter. Permissions are pizzasmp.* and declared. Branding, tier names and sell prices are
configuration, not one server's values.
Licensing. Apache 2.0 from this release on; earlier releases remain under MIT. Each jar carries LICENSE and
NOTICE, and PizzaProxyGuard also bundles the MariaDB driver under its LGPL-2.1 license.
Known limits. Folia and Paper 26.x are not supported yet. Network features are in beta: cross-server /home
is not supported, and a home on another backend is refused by name. PizzaSpawnRules is active only on ports 25566
and 25569. See UPCOMING.md.
Upgrading from 1.0.0-beta
- Paper 1.21.7 or newer is required (every plugin declares
api-version: '1.21.7'). - Replace every SMP-Core jar and restart. The database schema and new columns are applied on start; data is kept.
- Move LuckPerms grants to the renamed nodes:
sethome.usetopizzasmp.home.use,sethome.adminto
pizzasmp.home.admin,sethome.maxhomes.5topizzasmp.homes.5,essentials.eco*topizzasmp.admin.eco,
essentials.flytopizzasmp.flight,mycommand.punish/unpunish/forgive/bancheckto the
pizzasmp.nodes of the same name,maintenance.bypasstopizzasmp.maintenance.stay, and
pizzaruleguard.alertstopizzasmp.ruleguard.alerts. - Optional: grant
pizzasmp.priority.<1-9>to set rank priority without relying on group names, and
pizzasmp.chatguard.ownerfor ChatGuard's owner exemption. /sellusesconfigs/sell/prices.ymlif you have one; otherwise the bundled defaults in
plugins/PizzaNetworkCore/sell-prices.yml.- Networks: set
sync.server-nameon every backend so homes record where they were set.
Changes since 1.0.0-beta
Added
- Rank priority can be set with
pizzasmp.priority.1topizzasmp.priority.9(1 is highest) on any server; it
decides full-server joins, staff checks and per-player view distance. The original group names still work. pizzasmp.chatguard.ownermarks a player as the owner for ChatGuard, independent of group names.- Every permission the suite checks is declared in its
plugin.yml, so permission plugins list it with its
intended default. - A startup banner: the first SMP-Core plugin to enable prints the suite version, license and installed modules,
once per server start. - A documented
branding.yml(name, tagline, region, Discord link, tier names, color palette and message tokens)
is written on first start; before, a fresh install had no branding file to edit./branding setruns its
optional operator script only when the script exists. setup.sh: one command creates a runnable server on macOS or Linux (Java 21 check, Paper, the plugins built or
downloaded, checksum-verified ProtocolLib and Vault, optional LuckPerms, the menu datapack, a brand profile and
start.sh). It replacessetup/setup-server.sh, which did not work from the published layout.- A Gradle build that works from a clean clone:
./gradlew buildcompiles every plugin with dependencies from public
repositories and collects the jars inbuild/dist/. - Continuous integration: every push and pull request builds the suite and boots it on Paper, failing on any plugin
error (tools/ci/boot-check.sh). /susopens the inventory review panel by default; its Search button opens a player-name dialog on supported
Java clients, while/sus <player>provides direct lookup on Java and Bedrock. Suspect summaries group retained
flags by check name, so staff can see reasons such as FastBreak rather than a generic anticheat label.- PizzaChatGuard chat log: public chat and private messages with player, UUID and UTC time, one file per day,
blocked messages marked (chat-log.enabled,chat-log.retention-days, default 90). - Storage has two backends, Database and File.
storage.backend: auto(the default) uses the database when one is
configured and reachable, sharing PizzaNetworkCore's connection when a plugin has no database block of its own,
and files otherwise. Each plugin imports its files into the database once, never overwriting existing rows. - PizzaNetworkCore runs without a database server: with no database configured it stores everything in an embedded
database file. A configured database is always used, and never swapped for the file during an outage. - EnderchestExpander and PizzaRuleGuard support Database and File storage. In Database mode expanded ender chests
follow players between servers; the server holding a chest keeps a short hold until its final save, so a fast
server switch never loads a stale copy. RuleGuard's offense log goes to the shared event table. - Homes use that storage: the database when connected (shared by every backend), the SetHome files otherwise.
Existing SetHome files are imported on the first database start, and delete backups follow the same storage. - Home names can contain spaces (
/sethome my base,/home my base). - Staff home tools:
/homes <player>opens any player's homes, online or offline (left-click teleports,
right-click deletes with a confirmation and a backup);/admindelhomeand/gtpwork on the same data. - Staff auction tools (
/ah admin <player>): view, return or remove a player's listings. Returned items go
to an item mailbox, delivered on join or immediately when the player is online. - The database schema is applied on every start, so a fresh database needs no manual import.
- Mutes apply to Simple Voice Chat when it is installed: a muted player's microphone is silenced in proximity
and group chat, with a "You are muted" notice. - Proxy admission control: a login or a switch onto the gameplay backend waits (it looks like a slow login) while
the backend is down or booting, the database is unreachable, the player's data is still held elsewhere, or three
players are already joining; waiting players are admitted in arrival order. Too long a wait ends on a screen
naming the reason. - Canopy Session Gateway support:
network/scripts/build-network-dialogs.shmerges the menu and limbo datapacks so every
backend has identical registries, andnetwork/scripts/check-backend-parity.shchecks backends for the
differences a configuration-free switch cannot tolerate. - One disconnect screen layout for the proxy's own messages, with a brand line and a UTC reference, and restyled
Velocity error messages (network/configs/proxy/lang/messages-overrides.properties). - Full-stop maintenance (
/limbomaint start) checks first and refuses, changing nothing, unless the relaunch
script exists, the database answers and, with players online, the limbo has checked in within 20 seconds
(a heartbeat PizzaLimbo now writes). A second start while one is running is refused, and players still on the
server halfway through the transfer are asked to move again. - Login failsafes for synced player state. Logins are refused while the database is unreachable
(sync.failsafe.deny-login-when-database-down). A player whose state cannot be loaded yet, or whose previous
server has not finished saving them, is held (no item changes, damage or commands) and retried until it loads;
nothing is saved for a held player, so a stale local copy never replaces the stored one. - PizzaChatGuard filter levels (
level: off, light, normal, strong) with separate word lists, a phrase list and
exempt players, managed from a/chatguardpanel (pizzasmp.chatguard.manage).mode: listedfilters only the
players inonly-players. Matching folds lookalike letters, leetspeak, accents, invisible characters and
stretched or spaced-out spellings; slurs ofslur-substring-min-lengthletters or more also match inside words. - Player moderation profile (
/moderation <player>): status, active punishments, chat log and anticheat flags,
with unmute, unban, freeze and inventory actions; a Find Player button opens any profile by name. /suskeeps anticheat suspect history until staff review it: flags stay listed after a player logs out,
pizzasmp.sus.managedismisses or restores them (Grim's own history is never changed), and staff in spectator
can teleport to a suspect from the review./sus <player>opens retained details by name, and/susworks
without PizzaNetworkCore.- The mining audit records each distinct hidden ore discovery with its location for review (
cluster-radius-blocks
groups one vein,log-discoveries). It is low-confidence evidence, never an automatic punishment. /atrackframes its target smoothly and returns the staff member to their exact starting point, also after a
crash or disconnect during the session.- Configurable kick and ban screens (
kick-screen,ban-screen). Without a brand configured, titles and ban
screens are neutral, and Discord and appeal lines appear only when a brand Discord is set. death.force-drops(default true) makes items drop on death even when another plugin would keep them, unless the
keepInventory game rule is on.pizzasmp.flightkeeps survival flight granted by other plugins.join-quit-messages.silencehides the game's join and quit messages when another plugin announces them./nv(alias/nightvision) is registered by PizzaAdminTools.homes.show-locked-slots(default false): the home menus show only the slots a player can use; set it to show
locked slots and the Show More control.- PizzaProxyGuard: a maintenance MOTD (
plugins/pizzaproxyguard/maintenance.motd) while the lockout is active,
optional disconnection of players already online during it (maintenance.evict-online), a restarting screen,
kick-fallback-to-limboto disconnect instead of holding players in the limbo when a backend goes away, and a
readiness file (admission.ready-file) so admission works without a network database.
Changed
- Every plugin declares
api-version: '1.21.7', the first Paper release with the dialog API the suite uses. On
Paper 1.21.6 the plugins are refused with an API version message instead of failing with a missing class. - Region maintenance shows one green warning everywhere a held player sees it (PizzaNetworkCore's hold hotbar,
PizzaLimbo's hotbar and PizzaAdminTools' frozen notice): "WARNING: Your Region Is Undergoing Maintenance. Do Not
Teleport Or Your Location Will Be Lost." Existingmaintenance_hold.messagesettings are kept. - Homes record the server they were set on (PizzaNetworkCore
sync.server-name). On a network,/hometo a home
on another backend names that server instead of teleporting to the same coordinates in this server's world.
Cross-server/homeis not supported yet; homes from earlier versions carry no server and work as before. - Remaining legacy permission names are gone:
mycommand.punish,mycommand.unpunish,mycommand.forgiveand
mycommand.bancheck(usepizzasmp.punish,pizzasmp.unpunish,pizzasmp.forgive,pizzasmp.bancheck),
maintenance.bypass(usepizzasmp.maintenance.stay), andpizzaruleguard.alerts(now
pizzasmp.ruleguard.alerts). - The command map is read through the Paper API instead of reflection.
- License changed from MIT to Apache 2.0. Releases before 1.0.0 remain under MIT.
- Every permission the suite checks for its own features uses the
pizzasmp.prefix. Renamed:sethome.useto
pizzasmp.home.use,sethome.admintopizzasmp.home.admin,sethome.maxhomes.5topizzasmp.homes.5,
essentials.eco(and itsgive,take,set,resetnodes) topizzasmp.admin.eco, andessentials.flyto
pizzasmp.flight;essentials.invseeno longer grants/invsee. Move LuckPerms grants to the new names when
upgrading.pizzasmp.commandfilter.teleportkeeps/tppast the non-staff command filter. - Every inventory menu is locked by one shared mechanism instead of per-menu title checks: no click or drag can
take an item out of a menu or put one in, except the deposit slots of/sell, order delivery and the auction
listing slot. - Duels are marked as a preview feature in their menus, challenge notices and documentation.
- The duel loot window is timed from the moment the loser's items drop, shows a live countdown, and
/leaveends it
early. Duels with nothing to collect (snapshot loadouts) end at once instead of holding the winner. - The join send ramp is off by default: its view-distance steps made clients re-render every chunk several times on
join. Enableoptimizations.join-send-ramponly on a constrained uplink. /warpwithout a destination shows its usage.- Every plugin carries the suite version (
1.0.0-beta) instead of its own version number. - RTP arrival animations are off by default (
rtp.animation.enabled). /ah sell <price>lists the item without opening the auction menu.- The Totem Particles setting hides only other players' totem particles; totem sounds and your own pop
animation stay. - ProtocolLib is a required dependency of PizzaNetworkCore.
- PizzaUtils is retired:
/pinglives in PizzaNetworkCore.
Removed
- PizzaAdminTools no longer replaces the client brand shown in F3. It reflected into server internals and showed
one server's name on every install; the server's own brand now shows. PizzaNetworkCore/pom.xml: it resolved its dependencies from a server'splugins/folder and could not
build from a clean clone.- PizzaNetworkCore's second homes implementation and its unused
homestable. PizzaAdminTools owns every home
command. - About 60 unreachable methods in PizzaNetworkCore (roughly 1,300 lines).
- The unfinished join queue and
/queuetest,/pizzadebug, and the placeholder plugin list in
PizzaAdminTools.
Fixed
- A fresh install had no sell prices, so
/sellpaid nothing. PizzaNetworkCore ships default prices and writes
them toplugins/PizzaNetworkCore/sell-prices.ymlon first start;configs/sell/prices.ymlstill overrides. pizzasmp.spawneditwas declared by two plugins, which logged a warning at startup.- A fresh single-server install logged warnings for normal conditions: local file storage, no branding profiles,
the bundled shop and absent hub worlds. They are informational now; the storage warning remains on servers behind
a proxy, where unshared data matters. The shop message no longer names a script that is not part of the suite. - Subscription tier names follow
branding.yml(tiers.plus,tiers.plusplus, otherwise the brand name plus
"+" and "++") everywhere, including PizzaAdminTools' perks, subscription menus and messages, which showed one
server's tier names. Withoutbranding.yml, the short name and tiers default to the neutral brand. - Items dragged into a PizzaPunishment moderation menu were lost when it closed; drags into those menus are now
blocked like clicks. - PizzaSpawnRules declared Folia support but scheduled through the Bukkit scheduler, which fails on Folia. It now
uses Paper's global region and player schedulers (no plugin in the suite uses the Bukkit scheduler) and no longer
declares Folia support, since its zone checks read players from the global tick. - Server switches no longer race the final save. The server a player is on holds their state row and releases it
in the same write as the final save; the next server waits for that release (or for the hold to expire after a
crash) before loading. - Joining with no database answer no longer starts the player from the server's local copy and then saves that
copy over their real state. - The Vault balance mirror no longer writes PizzaEconomy's own reading back to the balance table, which could store
0 after a failed read. - Staff can punish a player who has only played on another backend: names resolve through the shared players table.
- PizzaPunishment enforces mutes and bans itself on every server: mutes block chat and private messages without
LibertyBans, bans are checked at login, and a player banned elsewhere is kicked. In Database mode records are
merged on save, so two servers punishing at the same time no longer overwrite each other. - Without LibertyBans,
/unban,/unmute,/kickand/historyre-dispatched themselves until the server's
command limit (65,536 runs) stopped them. - Cross-server
/msg,/tell,/tpa,/tpahereand their replies: a PizzaAdminTools gate answered "The user is not
online" for anyone on another backend before PizzaNetworkCore's network lookup ran. - The economy silently did nothing without Vault, and Vault was not declared as a load dependency. Vault is now a
soft dependency, a missing Vault is reported at startup, and the README lists it as required. - PizzaProxyGuard: the jar now bundles the MariaDB driver (Velocity has no library loader), so the cross-server chat
relay and maintenance gating can start; without database credentials it no longer attempts connections. - The network example config is regenerated from the current defaults (it still carried the removed join queue).
- Ender chest changes made since the last autosave were lost at server shutdown: queued saves were cancelled and
open chests were never saved. Shutdown now runs queued saves and writes open chests. - The staff transaction history (
/txlog) queried columns that do not exist, so audited market events never showed. - On a server without the SetHome plugin, players could not use
/homeor/sethome: the home permission was
never declared. It is nowpizzasmp.home.use(default true), withpizzasmp.home.adminfor staff (op). - A home file that cannot be read is never overwritten by the next save, and a database outage cannot erase homes.
- Typed and dispatched commands (for example from menu plugins) now run the same code. Previously about 30
commands had two diverging implementations. /shop reloadis reachable; typed/shop reloadused to open the shop./ah <item> <enchantment>searches work: spell correction no longer turns enchantment words into item names./ah <player>and/orders <player>filter by seller or creator, and bare/ahand/ordersopen the
default view./bal,/msg,/reply,/invsee,/wild,/randomtpand the hub setup commands are registered, so they work
without Essentials./afkcheckspizzasmp.use.afkon every path, and teleport requests are refused during a duel for
cross-server targets too./invseeacceptspizzasmp.admin.invsee, the node the admin console checks.- A duel opponent no longer stays frozen after the other player disconnects and reconnects mid-match.
- Unmuting by name or UUID releases every overlapping active mute for that player, not only the newest.
/home,/sethomeand the home menus no longer reveal themselves to players without home access, and/moderation
completes player names.- PizzaProxyGuard no longer takes session leases when no network database is configured.