⚡ 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

1. Download LiteStaff
2. Drop LiteStaff-X.X.X.jar into your server's plugins/ folder
3. Start the server to generate files
4. Configure plugins/Litestaff/config.yml
5. Configure plugins/Litestaff/messages.yml
6. Configure plugins/Litestaff/screens.yml
7. 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