
⚡ LiteStaff
A lightweight staff moderation system for Paper servers
Fast punishments, staff tools, live GUIs, customizable messages, and privacy-safe moderation workflows.
🌟 Core Features
🔧 Punishments
- Permanent and temporary bans, mutes, and warns
- IP bans, temporary IP bans, and IP unbans
- Kicks and kickall
- Extend/reduce active bans, mutes, and warns(ipban exlcuded)
- Change punishment reasons by history ID
- Punish players using configurable presets
- Unique punishment IDs
- Full infractions history with server tags
- Configurable punishment screens
- Configurable multi-line punishment announcements
- Configurable default punishment reason
- Configurable ban appeal link
📊 Staff GUIs
- StaffHub - Central staff menu
- StaffList - Live staff overview
- Infractions GUI - Auto-updating punishment overview
- History GUI - Direct auto-updating punishment history view
- PunishmentList - Live active bans, IP bans, mutes, and warns
- Logs Menu - Live staff action logs with filters
- Inventory viewer
- Ender chest viewer
🛠️ Staff Tools
- Staff mode
- Freeze/unfreeze with logout protection
- Freeze exempt permission
- Vanish with fake join/leave messages
- Permission-based vanish action controls
- Config fallback for vanished player action defaults
- Flight control
- Staff chat and admin chat
- Optional cross-server staff/admin chat sync
- Chat mute/unmute/clear
- Muted-player blocked command list
- Inventory and ender chest viewing/editing
- Online, offline, coordinate, and player-to-player teleport support
- Update checker notifications
🎨 Customization
- Fully customizable messages.yml
- Customizable plugin prefix
- Customizable plugin theme color
- Hex color support
- Legacy color code support
- {theme} placeholder support
- Customizable staff/admin chat formats
- Customizable staff join/leave notifications
- Customizable punishment announcements
- Customizable punishment screens in screens.yml
🔒 IP Privacy
- litestaff.showip controls real IP visibility
- Without permission, IPs are masked as ###.###.###.###
- Applies across commands, menus, announcements, staff list, punishment list, and IP displays
💾 Storage
- SQLite support
- MySQL support
- database.enabled controls local/MySQL storage
- Server-tagged punishment history
- Active punishment status scoped per server
- Optional cross-server staff/admin chat sync
! Important !
Other plugins using the same commands may conflict with LiteStaff and cause one of them to override the other.
📥 Installation
- Download LiteStaff
- Drop LiteStaff-X.X.X.jar into your server's plugins/ folder
- Start the server to generate files
- Configure plugins/Litestaff/config.yml
- Configure plugins/Litestaff/messages.yml
- Configure plugins/Litestaff/screens.yml
- Restart or run /litestaff reload
💬 Commands
🚫 Ban Commands
| Command | Description |
|---|---|
| /ban [reason] | Permanently ban a player |
| /tempban [reason] | Temporarily ban a player |
| /unban <player | ip> |
| /extend-ban | Extend a temporary ban |
| /reduce-ban | Reduce a temporary ban |
| /ipban <player | ip> [reason] |
| /tempipban <player | ip> [reason] |
| /unipban <player | ip> |
🔇 Mute Commands
| Command | Description |
|---|---|
| /mute [reason] | Permanently mute a player |
| /tempmute [reason] | Temporarily mute a player |
| /unmute | Remove a mute |
| /extend-mute | Extend a temporary mute |
| /reduce-mute | Reduce a temporary mute |
⚠️ Warn Commands
| Command | Description |
|---|---|
| /warn [reason] | Warn a player |
| /tempwarn [reason] | Temporarily warn a player |
| /unwarn [reason] | Remove warning(s) |
| /extend-warn | Extend a temporary warning |
| /reduce-warn | Reduce a temporary warning |
🚫 Kick Commands
| Command | Description |
|---|---|
| /kick [reason] | Kick a player |
| /kickall | Kick all non-exempt players |
🧩 Punishment Utility Commands
| Command | Description |
|---|---|
| /punish | Punish a player using a configured preset |
| /change-reason | Change the reason for a punishment history entry |
🛠️ Staff Utility Commands
| Command | Description |
|---|---|
| /alts | Check alt accounts by IP |
| /vanish [player] | Toggle vanish |
| /v [player] | Alias for /vanish |
| /fly [player] | Toggle flight |
| /staffmode | Toggle staff mode |
| /staff | Alias for /staffmode |
| /staffm | Alias for /staffmode |
| /sm | Alias for /staffmode |
| /freeze | Freeze/unfreeze a player |
| /staffchat [message] | Toggle or send staff chat |
| /sc [message] | Alias for /staffchat |
| /adminchat [message] | Toggle or send admin chat |
| /ac [message] | Alias for /adminchat |
| /chat <on | off |
| /inventory | View player inventory |
| /invsee | Alias for /inventory |
| /enderchest | View player ender chest |
| /ecsee | Alias for /enderchest |
🧭 Teleport Commands
| Command | Description |
|---|---|
| /tp | Teleport to an online/offline target |
| /tp | Teleport to coordinates |
| /tp | Teleport one player to another |
| /tp | Teleport a player to coordinates |
| /teleport | Alias for /tp |
| /goto | Alias for /tp |
| /tpoffline | Alias for /tp |
| /otp | Alias for /tp |
| /tpoff | Alias for /tp |
| /offtp | Alias for /tp |
| /tp2p | Alias for /tp |
| /ptp | Alias for /tp |
| /tele2p | Alias for /tp |
| /teleportplayer | Alias for /tp |
| /sendto | Alias for /tp |
📊 GUI / Admin Commands
| Command | Description |
|---|---|
| /staffhub | Open staff hub |
| /stafflist | Open live staff list |
| /infractions <player | id> |
| /history <player | id> |
| /punishmentlist | Open live active punishment list |
| /bans | Alias for /punishmentlist |
| /mutes | Alias for /punishmentlist |
| /warns | Alias for /punishmentlist |
| /logs | Open live staff action logs |
| /litestaff reload | Reload configuration |
| /ls reload | Alias for /litestaff reload |
⌚ Time Format
Examples:
- 30m = 30 minutes
- 2h = 2 hours
- 7d = 7 days
- 2w = 2 weeks
- 1mo = 1 month
- 1y = 1 year
- 1d12h30m = 1 day, 12 hours, 30 minutes
🔑 Permissions
🌐 Master
| Permission | Description | Default |
|---|---|---|
| litestaff.* | All LiteStaff permissions | OP |
🚫 Ban / IP Ban
| Permission | Description | Default |
|---|---|---|
| litestaff.ban.* | All ban permissions | OP |
| litestaff.ban.ban | Use /ban | OP |
| litestaff.ban.tempban | Use /tempban | OP |
| litestaff.ban.unban | Use /unban | OP |
| litestaff.ban.extend | Use /extend-ban | OP |
| litestaff.ban.reduce | Use /reduce-ban | OP |
| litestaff.ban.ipban | Use /ipban | OP |
| litestaff.ban.tempipban | Use /tempipban | OP |
| litestaff.ban.unipban | Use /unipban | OP |
🔇 Mute
| Permission | Description | Default |
|---|---|---|
| litestaff.mute.* | All mute permissions | OP |
| litestaff.mute.mute | Use /mute | OP |
| litestaff.mute.tempmute | Use /tempmute | OP |
| litestaff.mute.unmute | Use /unmute | OP |
| litestaff.mute.extend | Use /extend-mute | OP |
| litestaff.mute.reduce | Use /reduce-mute | OP |
⚠️ Warn
| Permission | Description | Default |
|---|---|---|
| litestaff.warn.* | All warn permissions | OP |
| litestaff.warn.warn | Use /warn | OP |
| litestaff.warn.tempwarn | Use /tempwarn | OP |
| litestaff.warn.unwarn | Use /unwarn | OP |
| litestaff.warn.extend | Use /extend-warn | OP |
| litestaff.warn.reduce | Use /reduce-warn | OP |
🚫 Kick
| Permission | Description | Default |
|---|---|---|
| litestaff.kick.* | All kick permissions | OP |
| litestaff.kick.kick | Use /kick | OP |
| litestaff.kick.kickall | Use /kickall | OP |
💬 Chat
| Permission | Description | Default |
|---|---|---|
| litestaff.chat.* | All chat permissions | OP |
| litestaff.chat.staff | Use /staffchat | OP |
| litestaff.chat.admin | Use /adminchat | OP |
| litestaff.chat.manage | Use /chat | OP |
| litestaff.chat.bypass | Chat while global chat is disabled | OP |
👻 Vanish
| Permission | Description | Default |
|---|---|---|
| litestaff.vanish | Use /vanish | OP |
| litestaff.vanish.others | Vanish other players | OP |
| litestaff.vanish.seeothers | See vanished players | OP |
| litestaff.vanish.break | Break blocks while vanished | FALSE |
| litestaff.vanish.place | Place blocks while vanished | FALSE |
| litestaff.vanish.hit | Hit entities or players while vanished | FALSE |
| litestaff.vanish.interact | Interact with blocks/entities while vanished | FALSE |
| litestaff.vanish.pickup | Pick up items while vanished | FALSE |
| litestaff.vanish.drop | Drop items while vanished | FALSE |
✈️ Flight
| Permission | Description | Default |
|---|---|---|
| litestaff.fly | Toggle flight for yourself | OP |
| litestaff.fly.others | Toggle flight for other players | OP |
🧭 Teleport
| Permission | Description | Default |
|---|---|---|
| litestaff.tp | Use /tp | OP |
| litestaff.tp.offline | Use offline saved-location teleport | OP |
| litestaff.tp.others | Teleport other players | OP |
📊 Menus / Logs
| Permission | Description | Default |
|---|---|---|
| litestaff.staffhub | Use /staffhub | OP |
| litestaff.stafflist | Use /stafflist | OP |
| litestaff.infractions | Use /infractions | OP |
| litestaff.history | Use /history | OP |
| litestaff.punishmentlist | Use /punishmentlist | OP |
| litestaff.logs | Use /logs | OP |
🛠️ Staff Tools
| Permission | Description | Default |
|---|---|---|
| litestaff.altcheck | Use /alts | OP |
| litestaff.staff.member | Marks player as staff/tracked in staff list | OP |
| litestaff.staffmode | Use /staffmode | OP |
| litestaff.freeze | Use /freeze | OP |
| litestaff.invsee | Use /inventory | OP |
| litestaff.invsee.edit | Edit inventories in /inventory | OP |
| litestaff.ecsee | Use /enderchest | OP |
| litestaff.ecsee.edit | Edit ender chests in /enderchest | OP |
| litestaff.showip | See real IP addresses | FALSE |
| litestaff.update.notify | Receive update notifications | OP |
| litestaff.reload | Use /litestaff reload | OP |
| litestaff.punish | Use /punish | OP |
| litestaff.changereason | Use /change-reason | OP |
🛡️ Exempt
| Permission | Description | Default |
|---|---|---|
| litestaff.exempt.* | All punishment exemptions | OP |
| litestaff.exempt.ban | Cannot be banned | OP |
| litestaff.exempt.mute | Cannot be muted | OP |
| litestaff.exempt.warn | Cannot be warned | OP |
| litestaff.exempt.kick | Cannot be kicked | OP |
| litestaff.exempt.freeze | Cannot be frozen | OP |
🔔 Notifications
| Permission | Description | Default |
|---|---|---|
| litestaff.notify.* | Receive all LiteStaff notifications | OP |
| litestaff.notify.staffjoin | Receive staff join notifications | OP |
| litestaff.notify.staffleave | Receive staff leave notifications | OP |
| litestaff.notify.ban | Receive ban notifications | OP |
| litestaff.notify.unban | Receive unban notifications | OP |
| litestaff.notify.mute | Receive mute notifications | OP |
| litestaff.notify.unmute | Receive unmute notifications | OP |
| litestaff.notify.warn | Receive warn notifications | OP |
| litestaff.notify.unwarn | Receive unwarn notifications | OP |
| litestaff.notify.kick | Receive kick notifications | OP |
| litestaff.notify.ipban | Receive IP-ban notifications | OP |
| litestaff.notify.tempipban | Receive temporary IP-ban notifications | OP |
| litestaff.notify.unipban | Receive IP-unban notifications | OP |
Ченджлог
2.0.2Релиз26.1.1, 26.1.2, 26.2 · 28 июня 2026 г.
minor bug fixes - thank you for your patience <3
2.0.1Релиз26.1, 26.1.1, 26.1.2 · 17 июня 2026 г.
litestaff 2.0.1
LiteStaff 2.0.1 is a focused bugfix and quality update for IP bans, punishment history, active ban menus, and vanish permissions.
Fixed
- Fixed IP bans not showing in the active bans menu.
- Fixed IP bans behaving separately from regular bans in staff menus.
- Fixed IP bans still showing as ongoing in history after
/unbanor/unipban. - Fixed
/ipunban/ IP unban entries showing in player punishment history when they should not. - Fixed active punishment list handling for IP-only bans.
Changed
/historyis now its own command instead of an alias for/infractions./history <player|id>now opens the punishment history menu directly./infractionsstill opens the full infractions menu.- Vanish action controls now use permissions instead of only config values.
New Permissions
litestaff.historylitestaff.vanish.breaklitestaff.vanish.placelitestaff.vanish.hitlitestaff.vanish.interactlitestaff.vanish.pickuplitestaff.vanish.drop
Notes
The existing vanish.allow-* config options still work as default fallback values for staff who do not have the vanish action permissions set manually.
2.0.0Релиз26.1, 26.1.1, 26.1.2 · 5 июня 2026 г.
LiteStaff 2.0.0 Changelog
New Features
- Added messages.yml for customizable plugin messages.
- Added customizable plugin prefix.
- Added configurable plugin theme color.
- Added support for hex colors and legacy color codes.
- Added {theme} placeholder support across messages, screens, menus, and UI elements.
- Added staff leave notifications.
- Added permission-based notification audiences.
- Added punishment notify permissions using litestaff.notify..
- Added /tempipban.
- Added /change-reason .
- Added /punish .
- Added configurable punishment presets.
- Added muted-player blocked command list.
- Added freeze exempt permission: litestaff.exempt.freeze.
- Added configurable default punishment reason.
- Added configurable ban appeal link in config.yml.
- Added multi-line punishment announcements.
Command Changes
- Renamed /invsee to /inventory.
- /invsee is now an alias for /inventory.
- Renamed /ecsee to /enderchest.
- /ecsee is now an alias for /enderchest.
- Added many aliases for /inventory and /enderchest.
- Added many aliases for IP-ban commands.
- /unban can now remove active IP bans when the target resolves to an IP ban.
- Added alias normalization so old aliases use the main command handler and tab completion.
Punishments
- Added temporary IP bans with /tempipban.
- Fixed temp IP bans showing as permanent.
- IP-ban screens now support {duration}.
- Added tempipban punishment announcements.
- Added litestaff.notify.tempipban.
- Prevented normal bans and IP bans from stacking on the same target.
- Punishment announcements no longer force the LiteStaff prefix.
- Punishment announcements are now customizable as multiple lines in messages.yml.
- Added configurable punishment default reason.
Config Changes
- Renamed punishments.yml to screens.yml.
- Moved ban-appeal-link to config.yml.
- Added messages.yml.
- Added theme.color.
- Changed database mode to database.enabled.
- database.enabled: false uses SQLite.
- database.enabled: true uses MySQL.
- Moved punishment hover setting to punishments.hover-enabled.
- Removed configurable update-checker message.
- Removed configurable chat clear line count.
- Moved staff/admin chat messages to messages.yml.
- Moved staff join/leave notify messages to messages.yml.
Inventory / Ender Chest
- /inventory GUI now says Inventory.
- /enderchest GUI now says EnderChest.
Staff Mode / Freeze
- Added litestaff.exempt.freeze.
- Staff mode inventory inspect now uses /inventory.
- Staff mode messages are more customizable.
- Freeze messages are now customizable in messages.yml.
Vanish
- Removed the vanish indicator. (Was not functional)
- Removed hide-from-player-count behavior. (Now set as default)
- Kept vanish options for fake join/leave, breaking, placing, hitting, interacting, pickup, and drop.
Theme / Menus
- Menus now follow the configured theme more consistently.
- Staff mode tools now follow the configured theme.
- Several menu item names and lore now support theme formatting.
- Infractions and staff menus better follow the plugin theme.
Fixes
- Fixed /tempipban behaving like a permanent IP ban visually.
- Fixed temp IP-ban announcements using the normal IP-ban notify path.
- Fixed punishment announcements always using the LiteStaff prefix.
- Fixed old IP-ban screen configs with hardcoded Permanent not showing temp durations.
- Fixed possible inventory/enderchest dupe edge cases involving target pickup/drop.
- Fixed /unban so it can remove IP bans when appropriate.
- Fixed reload coverage for config, messages, and screens.
Removed
- Removed punishments.yml.
- Removed vanish indicator.
- Removed hide-from-player-count option.
- Removed update-checker message customization.
- Removed configurable chat clear line count.
1.4.2Релиз26.1, 26.1.1, 26.1.2 · 28 мая 2026 г.
LiteStaff 1.4.2
Fixes
- Fixed
/logscausing extra offline-player/profile lookups before commands ran. - Staff action logs now only save after a LiteStaff command actually succeeds.
- Reduced main-thread lag from command logging on servers sharing the same database.
- Fixed failed infractions ID lookups from being treated as successful logged actions.
Notes
- This does not change how commands work for staff.
/logsstill respects the config options for which LiteStaff commands should be logged.
1.4.1Релиз26.1, 26.1.1, 26.1.2 · 28 мая 2026 г.
LiteStaff v1.4.1
Changes
- StaffList now shows which server each staff member was last seen on.
1.4.0Релиз26.1, 26.1.1, 26.1.2 · 28 мая 2026 г.
LiteStaff 1.4.0
Overview
This update adds new staff-management menus, configurable staff action logging, a combined active punishment list, and warning duration controls.
Added
Staff Action Logs
- Added
/logs - Added permission:
litestaff.logs - Added a live-updating logs menu for LiteStaff command actions
- Added log filters:
- All
- Punishment
- Staff
- Chat
- Inventory
- Teleport
- Admin
- Logs only LiteStaff commands
- Logging can be enabled or disabled per command in
config.yml - Each logged command can have a configurable category in
config.yml
PunishmentList
- Added
/punishmentlist - Added permission:
litestaff.punishmentlist - Added a live-updating combined active punishment menu
- Replaces the old separate Active Bans and Active Mutes menu flow
- Includes active:
- Bans
- Mutes
- Warns
- Added sorting/filter options:
- All
- Bans
- Mutes
- Warns
Warning Duration Controls
- Added
/extend-warn <player> <time> - Added
/reduce-warn <player> <time> - Added permissions:
litestaff.warn.extendlitestaff.warn.reduce
- Added both permissions under
litestaff.warn.*
Changed
StaffHub
- Redesigned the StaffHub menu
- Removed less useful toggle buttons:
- Toggle Vanish
- Toggle Fly
- Toggle Staff Chat
- Toggle Admin Chat
- StaffHub now focuses on key staff menus:
- Staff List
- PunishmentList
- Logs
Logging Config
- Categories control which
/logsfilter the command appears under - Custom categories are supported and appear in the
/logsfilter cycle
Fixed / Improved
punishmentlistnow includes warns, not just bans and muteskickallremains excluded from punishment/history logging behavior and only appears in staff action logs if enabled
Permissions Added
litestaff.logslitestaff.punishmentlistlitestaff.warn.extendlitestaff.warn.reduce
Notes • This update adds a new staff_logs database table. • Existing punishments, infractions, history, staff list behavior, and IP censoring behavior are preserved. • Plugin version bumped to 1.4.0.
1.3.2Релиз26.1, 26.1.1, 26.1.2 · 26 мая 2026 г.
LiteStaff 1.3.2
Patch Notes
Fixed
- Fixed corrupted menu symbols (mojibake) in GUI titles.
- Standardized affected menu separators to render correctly as
». - Fixed affected titles in:
- Infractions main menu
- Infractions history menu
- Infractions back-navigation title
- Invsee title
- ECSee title
Changed
- Update checker join notification is now delayed by ~3 seconds (
60ticks) so it appears lower in chat. - Update notification color formatting now uses proper Bukkit color translation (
ChatColor.translateAlternateColorCodes).
Added
- Added
/kickallcommand. - Added permission node:
litestaff.kick.kickall.
Permissions
- Changed normal
/kickpermission:- Old:
litestaff.kick - New:
litestaff.kick.kick
- Old:
- Added kick permission group:
litestaff.kick.*litestaff.kick.kicklitestaff.kick.kickall
Kickall Behavior
/kickallrespectslitestaff.exempt.kick(exempt players are skipped)./kickallkick screen reason is fixed to:All players were kicked
1.3.1Релиз26.1, 26.1.1, 26.1.2 · 23 мая 2026 г.
LiteStaff 1.3.1
Bug Fix Update
This release focuses on fixes from recent testing.
Fixed: Invsee Editing (litestaff.invsee.edit)
- Fixed
invseebehavior so staff withlitestaff.invsee.editcan use their own inventory (bottom inventory) while viewing/editing a target inventory. - Editing restrictions for protected target slots are still enforced as intended.
Fixed: IP Ban / Unban History Logging
- Fixed
IPBANandIPUNBANhistory tracking so actions are logged properly in infractions history for the correct target player (when player names are used). - This ensures IP punishment actions are visible in moderation history where expected.
Fixed: IP Ban Screen + litestaff.showip
- Fixed IP ban screen permission behavior.
- Players with
litestaff.showipcan now see the real IP on the IP-ban screen where permission can be evaluated. - Players without
litestaff.showipcontinue to see masked IP.
Version
- Bumped plugin version to
1.3.1
Комментарии
Загружаем…