Compatibility
Minecraft: Java Edition
Platforms
Tags
Creators
Details
Licensed ARR
Published 2 months ago
⚡ 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 <player> [reason] | Permanently ban a player |
| /tempban <player> <time> [reason] | Temporarily ban a player |
| /unban <player | ip> |
| /extend-ban <player> <time> | Extend a temporary ban |
| /reduce-ban <player> <time> | Reduce a temporary ban |
| /ipban <player | ip> [reason] |
| /tempipban <player | ip> <time> [reason] |
| /unipban <player | ip> |
🔇 Mute Commands
| Command | Description |
|---|---|
| /mute <player> [reason] | Permanently mute a player |
| /tempmute <player> <time> [reason] | Temporarily mute a player |
| /unmute <player> | Remove a mute |
| /extend-mute <player> <time> | Extend a temporary mute |
| /reduce-mute <player> <time> | Reduce a temporary mute |
⚠️ Warn Commands
| Command | Description |
|---|---|
| /warn <player> [reason] | Warn a player |
| /tempwarn <player> <time> [reason] | Temporarily warn a player |
| /unwarn <player> [reason] | Remove warning(s) |
| /extend-warn <player> <time> | Extend a temporary warning |
| /reduce-warn <player> <time> | Reduce a temporary warning |
🚫 Kick Commands
| Command | Description |
|---|---|
| /kick <player> [reason] | Kick a player |
| /kickall <reason> | Kick all non-exempt players |
🧩 Punishment Utility Commands
| Command | Description |
|---|---|
| /punish <player> <preset> | Punish a player using a configured preset |
| /change-reason <id> <new reason> | Change the reason for a punishment history entry |
🛠️ Staff Utility Commands
| Command | Description |
|---|---|
| /alts <player> | 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 <player> | 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 <player> | View player inventory |
| /invsee <player> | Alias for /inventory |
| /enderchest <player> | View player ender chest |
| /ecsee <player> | Alias for /enderchest |
🧭 Teleport Commands
| Command | Description |
|---|---|
| /tp <target> | Teleport to an online/offline target |
| /tp <x> <y> <z> | Teleport to coordinates |
| /tp <player> <target> | Teleport one player to another |
| /tp <player> <x> <y> <z> | 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 |