Перейти к содержимому
Mineforgian

LiteStaff

Advanced yet efficient and lightweight staff management plugin

Загрузки
164
Подписчики
4
Обновлён
28 июня 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 25 апреля 2026 г.

⚡ 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

Ченджлог

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 /unban or /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

  • /history is now its own command instead of an alias for /infractions.
  • /history <player|id> now opens the punishment history menu directly.
  • /infractions still opens the full infractions menu.
  • Vanish action controls now use permissions instead of only config values.

New Permissions

  • litestaff.history
  • litestaff.vanish.break
  • litestaff.vanish.place
  • litestaff.vanish.hit
  • litestaff.vanish.interact
  • litestaff.vanish.pickup
  • litestaff.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 /logs causing 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.
  • /logs still 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.extend
    • litestaff.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 /logs filter the command appears under
  • Custom categories are supported and appear in the /logs filter cycle

Fixed / Improved

  • punishmentlist now includes warns, not just bans and mutes
  • kickall remains excluded from punishment/history logging behavior and only appears in staff action logs if enabled

Permissions Added

  • litestaff.logs
  • litestaff.punishmentlist
  • litestaff.warn.extend
  • litestaff.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 (60 ticks) so it appears lower in chat.
  • Update notification color formatting now uses proper Bukkit color translation (ChatColor.translateAlternateColorCodes).

Added

  • Added /kickall command.
  • Added permission node: litestaff.kick.kickall.

Permissions

  • Changed normal /kick permission:
    • Old: litestaff.kick
    • New: litestaff.kick.kick
  • Added kick permission group:
    • litestaff.kick.*
      • litestaff.kick.kick
      • litestaff.kick.kickall

Kickall Behavior

  • /kickall respects litestaff.exempt.kick (exempt players are skipped).
  • /kickall kick 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 invsee behavior so staff with litestaff.invsee.edit can 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 IPBAN and IPUNBAN history 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.showip can now see the real IP on the IP-ban screen where permission can be evaluated.
  • Players without litestaff.showip continue to see masked IP.

Version

  • Bumped plugin version to 1.3.1

Комментарии

Загружаем…