⚡ LiteStaff

A powerful, lightweight staff moderation system for Paper servers
Streamline your moderation workflow with modern, efficient tools

---

🌟 Features

🔧 Punishment System

• Permanent Bans - Ban troublemakers forever
• Temporary Bans - Time-based bans with auto-expiry
• IP Bans - Block by IP address
• Mutes - Permanent & temporary mutes
• Kicks - Remove players instantly
• Extend/Reduce - Adjust active punishments on the fly
• Punishment IDs [new] - Ban, mute, and kick actions now generate unique IDs

🚀 Advanced Features

• Alt Detection - Find alt accounts by IP
• Infractions GUI - Beautiful, auto-updating punishment interface
• Punishment History - Complete, paginated punishment records
• Infraction ID Lookup [new] - Open infractions directly with /infractions <id>
• Server-tagged History [new] - History entries show which server applied the punishment
• Server-local Status [new] - Active ban/mute status in infractions is scoped to the current server
• Staff Exempt System [new] - Clear exempt permissions for punishment protection
• Dual Database Support - SQLite or MySQL
• Async Operations - Zero server lag
• Customizable Screens - Fully configurable ban/mute/kick messages

🛠️ Staff Utilities

• Staff Mode [new] - Staff state where staff gains a lot of fun items!
• Freeze Command [new] - Allows staff to freeze players.
• Vanish Mode - Hide from players with fake join/leave messages
• Vanish Controls [new] - Config options for vanished players: break/place/hit/interact/pickup/drop
• Hide From Player Count [new] - Vanished players can be hidden from server list player count
• Flight Control - Toggle flight for yourself or others
• Staff Chat - Private communication channels
• Admin Chat - Elevated staff communication
• Cross-server Staff/Admin Chat Sync [new] - Optional database sync with toggle in config
• Chat Management - Mute, unmute, and clear global chat
• Staff Hub - Centralized GUI for all staff tools
• Inventory Viewer [new] - /invsee with armor + offhand layout panel
• Ender Chest Viewer [new] - /ecsee
• Editable Invsee/Ecsee [new] - Separate edit permissions for inventory/chest editing (live updates while menu is open)
• Teleport Utilities [new] - Unified /tp command supports self TP, player-to-player TP, and offline saved-location TP
• Staff Mode Vanish Restore [new] - Leaving staff mode restores your previous vanish state instead of forcing vanish
• Live Two-Way Invsee/Ecsee Sync [new] - Target changes are reflected live to staff viewers while menus are open

---

! Important !

Other plugins like Essentials will collide with LiteStaff. If you want to use LiteStaff commands, disable conflicting permissions from those plugins using a permissions plugin like LuckPerms.

---

📥 Installation

1. Download your desired version of LiteStaff at the top of this page
2. Drop LiteStaff-X.X.jar into your server's plugins/ folder
3. Start your server (files will generate)
4. Configure in plugins/Litestaff/config.yml and punishments.yml
5. Restart or use /litestaff reload

---

💬 Commands

🚫 Ban Commands

Command	Description	Example
/ban <player> <reason>	Permanent ban	/ban Griefer123 Griefing spawn
/tempban <player> <time> <reason>	Temporary ban	/tempban Hacker 7d Using xray
/unban <player>	Remove a ban	/unban Griefer123
/extend-ban <player> <time>	Extend existing ban	/extend-ban Hacker 3d
/reduce-ban <player> <time>	Reduce ban duration	/reduce-ban Hacker 1d

🔇 Mute Commands

Command	Description	Example
/mute <player> <reason>	Permanent mute	/mute Spammer Spam in chat
/tempmute <player> <time> <reason>	Temporary mute	/tempmute Toxic 1h Toxic behavior
/unmute <player>	Remove mute	/unmute Spammer
/extend-mute <player> <time>	Extend existing mute	/extend-mute Toxic 30m
/reduce-mute <player> <time>	Reduce mute duration	/reduce-mute Toxic 15m

🌐 IP & Alt Management

Command	Description	Example
/ipban <player|ip> <reason>	IP ban	/ipban Evader Alt account
/unipban <ip>	Remove IP ban	/unipban 127.0.0.1
/alts <player>	Check for alt accounts	/alts Suspicious123

⚙️ Staff Utilities

Command	Description	Example
/kick <player> <reason>	Kick from server	/kick AFK Too long idle
/vanish [player]	Toggle vanish mode	/vanish or /vanish Player
/fly [player]	Toggle flight	/fly or /fly Player
/staffmode [new]	Toggle staff mode	/staffmode
/freeze <player> [new]	Freeze/unfreeze a player	/freeze Player
/staffchat [message]	Staff chat	/staffchat or /staffchat Hello team
/adminchat [message]	Admin chat	/adminchat or /adminchat Admin msg
/chat <on|off|clear>	Manage global chat	/chat off
/invsee <player> [new]	View player inventory	/invsee Player
/ecsee <player> [new]	View player ender chest	/ecsee Player
/tp <target> [new]	Teleport to online player or offline saved location	/tp Player
/tp <player> <target> [new]	Teleport one player to another (or offline saved location)	/tp ModA PlayerB

📊 GUI Commands

Command	Description
/staffhub	Open staff control panel
/infractions <player|id>	View player's punishment history

🔄 Other

Command	Description
/litestaff reload	Reload configuration

---

⌚ Time Format

Examples:

• 30m = 30 minutes
• 2h = 2 hours
• 7d = 7 days
• 2w = 2 weeks
• 1M = 1 month
• 1y = 1 year
• Combined: 1d12h30m = 1 day, 12 hours, 30 minutes

---

🔑 Permissions

Click to expand permission list

🌐 Master Permission

Permission	Description	Default
litestaff.*	All LiteStaff permissions	OP

🚫 Ban Permissions

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.unipban	Use /unipban	OP

🔇 Mute Permissions

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

💬 Chat Permissions

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 command	OP
litestaff.chat.bypass	Chat when chat is disabled	OP

👻 Vanish Permissions

Permission	Description	Default
litestaff.vanish	Use /vanish	OP
litestaff.vanish.others	Vanish other players	OP
litestaff.vanish.seeothers	See vanished players	OP

✈️ Flight Permissions

Permission	Description	Default
litestaff.fly	Use /fly on yourself	OP
litestaff.fly.others	Toggle flight for others	OP

🧭 Teleport Permissions [new]

Permission	Description	Default
litestaff.tp	Use /tp	OP
litestaff.tp.offline	Use offline saved-location target in /tp	OP
litestaff.tp.others	Use /tp <player> <target>	OP

🛠️ Other Staff Permissions

Permission	Description	Default
litestaff.kick	Use /kick	OP
litestaff.altcheck	Use /alts	OP
litestaff.infractions	Use /infractions	OP
litestaff.staffhub	Use /staffhub	OP
litestaff.staffmode [new]	Use /staffmode	OP
litestaff.freeze [new]	Use /freeze	OP
litestaff.invsee [new]	Use /invsee	OP
litestaff.invsee.edit [new]	Edit inventories in /invsee	OP
litestaff.ecsee [new]	Use /ecsee	OP
litestaff.ecsee.edit [new]	Edit enderchests in /ecsee	OP
litestaff.showip [new]	See real IP addresses in command output	OP

🛡️ Exempt Permissions [new]

Permission	Description	Default
litestaff.exempt.*	Cannot be banned or muted	OP
litestaff.exempt.ban	Cannot be banned	OP
litestaff.exempt.mute	Cannot be muted	OP

👑 Admin

Permission	Description	Default
litestaff.reload	Use /litestaff reload	OP

---

🎨 Configuration

Database Setup

In config.yml:

# Litestaff Configuration
# Plugin by itz_luxl

server-id: "server-1" # [new]

# Database Settings
database:
  type: SQLITE # SQLITE or MYSQL
  mysql:
    host: localhost
    port: 3306
    database: litestaff
    username: root
    password: password

no-permission: "&cYou don't have permission to do that!"

# Staff Chat Settings
staff-chat:
  format: "&bStaff &8>> &7{player}&f: &b{message}"
  database-sync: # [new]
    enabled: false
    receive-format: "&bStaff &8>> &7[{server}] {player}&f: &b{message}"

admin-chat:
  format: "&cAdmin &8>> &7{player}&f: &c{message}"
  database-sync: # [new]
    enabled: false
    receive-format: "&cAdmin &8>> &7[{server}] {player}&f: &c{message}"

vanish:
  fake-leave-join: true
  fake-leave-message: "&e{player} left the game"
  fake-join-message: "&e{player} joined the game"
  hide-from-player-count: true # [new]
  allow-break: false # [new]
  allow-place: false # [new]
  allow-hit: false # [new]
  allow-interact: false # [new]
  allow-pickup: false # [new]
  allow-drop: false # [new]

# Fly Toggle Messages
fly:
  enabled: "&aFlight enabled!"
  disabled: "&cFlight disabled!"

# Chat Management
chat:
  clear-message: "&7Chat has been cleared by &e{player}"
  clear-lines: 100
  mute-message: "&7Chat has been &cmuted&7 by &e{player}"
  unmute-message: "&7Chat has been &aunmuted by &e{player}"