⚡ LiteStaff

A lightweight staff moderation system for Paper servers
Fast punishments, staff tools, live GUIs, customizable messages, Simple Voice Chat moderation, offline player tools, and privacy-safe moderation workflows.

---

🌟 Core Features

🔧 Punishments

• Permanent and temporary bans, IP bans, mutes, voice mutes, and warns
• Simple Voice Chat voice mute support with optional independent or regular-mute-linked mode
• Kicks and kickall
• Extend/reduce active bans, mutes, voice mutes, and warns (IP bans excluded)
• Change punishment reasons by history ID
• Punish players using configurable presets
• Random 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
• Online Alts GUI - Shows online players sharing the same IP address
• 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 and third-party command logs
• Inventory viewer
• Ender chest viewer
• Offline inventory viewer using saved database snapshots
• Offline ender chest viewer using saved database snapshots

🛠️ Staff Tools

• Staff mode with built-in tools for staff hub, vanish, random teleport, inventory inspect, freeze, staff list, infractions, alt check, click interval scan, and leaving staff mode
• Freeze/unfreeze with logout protection
• 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
• Alt check command and online shared-IP menu
• Suspicious same-IP join alerts for staff to see
• Staff-mode click interval scan for autoclicker checks
• Online, offline, coordinate, selector, and player-to-player teleport support
• /tphere support for bringing players to you
• @here selector for online players in your current world
• @everyone selector for all known players, including offline players
• Offline teleport queue for players who are not online
• Update checker notifications

🎙️ Voice Chat

• Simple Voice Chat softdepend support
• Voice mutes block muted players from speaking in Simple Voice Chat
• Voice mute message shown when muted players try to talk
• Config option to use voice mutes independently
• Config option to connect voice mutes to regular chat mutes
• Independent mode adds separate voice mute commands and infractions history
• Connected mode makes regular /mute control both chat and voice

🎨 Customization

• Fully customizable messages.yml
• Customizable plugin prefix
• Customizable plugin theme color
• Hex color support
• Legacy color code support
• Customizable staff/admin chat formats
• Customizable staff join/leave notifications
• Customizable punishment announcements
• Customizable punishment screens in screens.yml
• Configurable voice mute message
• Configurable time format for displayed durations
• Configurable third-party commands to include in staff logs

🔒 IP Privacy

• litestaff.showip controls real IP visibility
• Without permission, IPs are masked as ###.###.###.###
• Applies across commands, menus, announcements, staff list, punishment list, alt checks, same-IP alerts, and IP displays

💾 Storage

• SQLite support
• MySQL support
• database.enabled controls local/MySQL storage
• Server-tagged punishment history
• Active punishment status scoped per server
• Saved player inventory snapshots
• Saved player ender chest snapshots
• Pending offline teleport storage
• 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.

Simple Voice Chat is optional. Voice mute punishments can still be stored without it, but voice packets can only be blocked when Simple Voice Chat is installed.

---

📥 Installation

1. Download LiteStaff
2. Drop LiteStaff-X.X.X.jar into your server's plugins/ folder
3. Optional: install Simple Voice Chat if you want voice mute enforcement
4. Start the server to generate files
5. Configure plugins/Litestaff/config.yml
6. Configure plugins/Litestaff/messages.yml
7. Configure plugins/Litestaff/screens.yml
8. 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

🎙️ Voice Mute Commands

Command	Description
/voicemute [reason]	Permanently voice mute a player
/tempvoicemute [reason]	Temporarily voice mute a player
/voiceunmute [reason]	Remove a voice mute
/extend-voicemute	Extend a temporary voice mute
/reduce-voicemute	Reduce a temporary voice 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 [reason]	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 [player]	Check alt accounts by IP, or open the online shared-IP menu
/vanish [player]	Toggle vanish
/fly [player]	Toggle flight
/staffmode	Toggle staff mode
/freeze	Freeze/unfreeze a player
/staffchat [message]	Toggle or send staff chat
/adminchat [message]	Toggle or send admin chat
/chat <on	off
/inventory	View player inventory
/enderchest	View player ender chest

🧭 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
/tp @here	Teleport online players in your world to a target
/tp @everyone	Teleport all known players, including offline players, to a target
/tphere	Teleport a player to you
/tphere @here	Teleport online players in your world to you
/tphere @everyone	Teleport all known players, including offline players, to you

📊 GUI / Admin Commands

Command	Description
/staffhub	Open staff hub
/stafflist	Open live staff list
/alts	Open online shared-IP alt menu
/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

Displayed duration format is configurable in config.yml.

---

🔑 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
litestaff.mute.voice	Use /voicemute	OP
litestaff.mute.tempvoice	Use /tempvoicemute	OP
litestaff.mute.voiceunmute	Use /voiceunmute	OP
litestaff.mute.voice.extend	Use /extend-voicemute	OP
litestaff.mute.voice.reduce	Use /reduce-voicemute	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.staffchat	Use /staffchat	OP
litestaff.adminchat	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 or voice 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.suspicious	Receive suspicious same-IP join 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.voicemute	Receive voice mute notifications	OP
litestaff.notify.voiceunmute	Receive voice 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