Staff Suite | Server Moderation System v2.2.0

StaffSuite Changelog – Major Bug Fix, Proxy Sync, Multi-Lang & QoL Update​

General Fixes​

• Fixed a large number of small internal bugs across backend and proxy.
• Improved addon reload stability and prevented duplicate plugin identifier conflicts.
• Fixed staff items being movable into inventories or ender chests through exploits.
• Corrected world-change behaviour so staff abilities like fly stay enabled.

---

New Multi-Language System​

• Added full multi-language support.
• You can now select your preferred lang file directly in config.yml.
• All messages, GUI titles, item names, lores and prompts now pull from the selected lang file.
• Every new feature and every future feature uses the same multi-language framework.
• Lang files are fully modular and hot-reloadable on /staffsuitereload.

---

Proxy & Network Improvements​

Velocity & Bungee Integration​

• Fixed missing Component imports in Velocity plugin.
• Improved proxy → backend and backend → proxy message routing.
• Fixed cooldown sync for punishments, vanish, staff chat and focus.
• Cleaned up proxy message formatting with MiniMessage support.

Network-Wide Update System​

• Added /staffsuite update all.
  This command now:
  • Updates every backend server.
  • Updates the proxy.
  • Sends clear success/failure messages back to the executor.
• Backends and proxy now support chained update signals.

Proxy Licensing & Update Checks​

• Fixed proxy license check running when no backend existed.
• Added safer fallback logic to avoid blocking updates.
• Improved debug messages around proxy license validation.

---

Security Addon / Contraband​

• Fixed contraband system removing the barrier item from Staff GUI.
  It now remains untouched.

---

Hotbar Tool Fixes​

• Fixed select tool, freeze tool and punish tool being broken or inconsistent.
• Reworked target selection hitbox logic to remove all false negatives.
• Updated tool metadata locking so hotbar items can’t break or duplicate.
• Resolved issue where the hotbar tools didn’t detect selected players correctly.

---

Sound Fixes​

• Fixed click sounds playing for every item, even when not in staff mode.
• StaffSuite now only plays sound effects while actually in staff mode or using staff tools.

---

Player Selection & Tools​

• Added new message: "You already have this person selected".
  Fully customisable in lang files.
• Fixed “You must look at a player” false warning when a player was already selected.
• Fixed selection persistence between worlds, vanish, and GUI interactions.
• Discipline, freeze and teleport tools now properly recognise selected targets.

---

Punishment Viewer / LiteBans Integration​

• Added compatibility for old punishments in LiteBans tables.
• Fixed incorrect column names such as:
  • name
  • muted_by_uuid
  • warned_by_uuid
• Updated punishment viewer to read legacy and modern LiteBans schema without errors.
• Fixed SQL queries causing crashes during player lookups.

---

Random Teleport Improvements​

• Random TP now cycles through players so you no longer teleport to the same player repeatedly.
• Fixed random TP breaking when item material was changed in config.
• Improved region-safety logic for Folia and Paper.

---

Customization Enhancements​

• Added ability to change punishment icons in config.
• Added config option allowing vanished or staff mode players to pick up items.
• Added silent chest opening while vanished (no sound, no animation for others).

---

Staff Mode Fixes​

• Default staff mode now respects the config default (not last used).
• Staff mode flight no longer disables on world change.
• Hunger no longer decreases in adventure staff mode.
• Staff items can no longer be moved or stored (inventory locks improved).
• Fixed random TP hotbar item interaction.
• Fixed ability exploits through /ec and other bypass commands.

---

Vanish & Tablist​

• Fixed spectator mode showing in tab while vanished.
• Ensured vanish auto-enables when entering spectator staff mode.
• Improved vanish sync across worlds and regions.
• Enhanced tablist integration so:
  • Vanished players stay hidden.
  • No ghost-names remain after reconnects.
  • Spectator mode does not reveal vanish status.

---

Addon Loading​

• Fixed duplicate identifier errors for:
  • StaffSuiteSecurityAddon
  • StaffSuiteInventoryAddon
  • StaffSuiteAnalyticsAddon
• Addon loader no longer tries to load .paper-remapped jars during reload.

---

Other Fixes​

• Improved discipline tool hit-validation in adventure mode.
• Fixed cross-world behaviours for vanish, fly and hunger protection.
• Improved legacy punishment record loading.
• Added fallback checks for missing GUI state after reloads.

• Added full LiteBans integration
• Rebuilt and fixed Ban Manager
• Added MiniMessage formatting support
• General stability improvements and bug fixes

Changelog​

• Fixed various bugs and stability issues
• Added option to disable IP address logging in punishment history and Discord webhooks
• Added inventory-restore export system allowing items to be placed into shulker boxes (to the admin or the player)
• Expanded PlaceholderAPI support with new placeholders:
  • %staffsuite_staffmode_enabled%
  • %staffsuite_staffmode_mode%
  • %staffsuite_vanished%
  • %staffsuite_frozen%
  • %staffsuite_punishments_total%
  • %staffsuite_punishments_bans%
  • %staffsuite_punishments_mutes%
  • %staffsuite_punishments_warns%
  • %staffsuite_punishments_kicks%
  • %staffsuite_staff_online%
  • %staffsuite_staff_online_network%
• Added full permission nodes per staff action and per punishment type
• Added support for handling offline players through /staff <player> including banning offline players
• Items inside the GUI now automatically turn enchanted when toggled on for easier visual feedback

Improved folia support

Added better ban ladder customization and added staff chat webhook + customizable placeholder outputs

Hotfix for 1.21 sounds breaking plugin

| %staffsuite_staffmode_enabled% | true if the player is currently in staff mode. |
| %staffsuite_staffmode_mode% | The display name of the active staff mode (spectator/adventure/creative). Returns offline when the player is not online. |
| %staffsuite_vanished% | true when the player is vanished. |
| %staffsuite_frozen% | true if the player is currently frozen. |
| %staffsuite_punishments_total% | Count of all punishments issued by the staff member. |
| %staffsuite_punishments_bans% | Number of bans issued by the staff member. |
| %staffsuite_punishments_mutes% | Number of mutes issued by the staff member. |
| %staffsuite_punishments_warns% | Number of warns issued by the staff member. |
| %staffsuite_punishments_kicks% | Number of kicks issued by the staff member. |

Minor bug fixes, QOL changes.

• Contraband menu now returns to staff menu on exit
• Improved /staff cross-server lookups with remote profile selection and clearer addon placement guidance
• Enhanced security addon alerts with detailed banned token reporting and blocked-word management command