LightStaff
一款适用于 Paper 和 Folia 服务器的现代化管理员工具插件。LightStaff 为管理员提供了一套简洁的管理员模式工具集,用于调查工作:快捷栏工具、隐身、冻结、检查、传送、恢复、审计日志以及灵活的存储方案。
基于 Paper 1.19.4 和 Java 17 构建,同时运行时路径已准备好适配更新的 Paper 版本。
展示
管理员模式快捷栏
默认设置下,管理员会获得一个紧凑的调查用快捷栏,具有清晰的名称、描述和操作栏状态。
管理员模式工具
进入管理员模式的管理员将获得一个可配置的快捷栏:
| 槽位 |
工具 |
用途 |
0 |
隐身 (Vanish) |
对普通玩家隐藏自身,但对拥有权限的管理员可见。 |
1 |
击退 (Push) |
将玩家推开以实现快速间隔或控制。 |
2 |
检查器 (Inspector) |
打开只读的物品栏视图,包含护甲和副手物品。 |
4 |
冻结 (Freeze) |
停止移动、聊天、命令、伤害豁免以及物品栏操作。 |
6 |
飞行 (Flight) |
在调查期间切换飞行状态。 |
8 |
退出 (Exit) |
离开管理员模式并恢复保存的玩家状态。 |
每个工具都在 tools.yml 中进行配置:启用状态、槽位、权限、材质回退列表、冷却时间、显示名称、描述、声音、音量和音调。
存储选项
选择适合服务器的后端:
sqlite 用于简单的本地生产环境
json 用于可读的本地文件
mysql 用于网络化部署
mariadb 用于 MariaDB 部署
战斗感知型管理员模式
LightStaff 可以阻止处于战斗标记中的玩家进入管理员模式。此检查是可配置的,并支持:
- 战斗插件使用的元数据键
- PlaceholderAPI 占位符
- 受信任管理员的绕过权限
功能
- 带有物品栏、护甲、副手、经验值、游戏模式和飞行恢复的管理员模式进入/退出
- 持久化的隐身和冻结状态
- 只读物品栏检查
- 处理断开连接的冻结命令和冻结工具
- 管理员传送命令
- 管理员白名单绕过模式
- 会话恢复命令
- 管理操作的审计日志
- 可配置的操作栏
- 可配置的命令、插件和工具消息
- 可配置的存储:SQLite、JSON、MySQL、MariaDB
- 支持 Paper 和 Folia 调度器
- 用于跨版本兼容性的材质回退列表
要求
- Java 17 或更高版本
- Paper
1.19.4+
- 可选:PlaceholderAPI
- 可选:CombatLogX、PvPManager、DeluxeCombat、CombatPlus 或通过元数据或 PlaceholderAPI 暴露的战斗插件
安装
- 从 GitHub Releases 下载最新的 jar 文件。
- 将其放入服务器的
plugins 文件夹中。
- 启动服务器一次。
- 编辑
plugins/LightStaff/ 中生成的文件。
- 运行
/lightstaff reload 或重启服务器。
配置
LightStaff 将配置分为三个文件:
| 文件 |
用途 |
config.yml |
插件行为、存储、战斗检查、冻结行为、白名单模式、审计日志 |
tools.yml |
管理员工具设置、槽位、权限、材质、名称、描述、声音 |
messages.yml |
前缀、命令消息、插件消息、操作栏标签 |
存储
默认设置:
storage:
type: "sqlite"
可用值:
storage:
type: "sqlite" # sqlite, json, mysql, mariadb
JSON 存储写入以下位置:
plugins/LightStaff/data/sessions.json
plugins/LightStaff/data/moderation_states.json
战斗拦截
combat:
block_lightstaff_entry: true
bypass_permission: "lightstaff.combat.bypass"
metadata_keys:
- "combatlogx_in_combat"
- "in_combat"
- "combatTagged"
placeholderapi:
enabled: true
placeholders:
- "%combatlogx_in_combat%"
- "%pvpmanager_in_combat%"
combat_values:
- "yes"
- "true"
- "1"
- "tagged"
拥有配置好的绕过权限的玩家即使处于战斗标记中也可以进入管理员模式。
冻结断开消息
单行:
freeze_ban_message: "You disconnected while frozen."
多行:
freeze_ban_message:
- "You disconnected while frozen."
- "Open a ticket if this was a mistake."
命令
| 命令 |
描述 |
/lightstaff, /ls, /staffmode, /sm |
切换管理员模式 |
/lightstaff reload |
重新加载配置、工具和消息 |
/lightstaff status [player] |
显示管理员/隐身/冻结/会话状态 |
/lightstaff recover <player> |
恢复保存的管理员模式会话 |
/vanish [player] |
为自己或其他玩家切换隐身 |
/freeze <player> [reason] |
切换冻结 |
/freeze on <player> [reason] |
冻结玩家 |
/freeze off <player> |
解除玩家冻结 |
/unfreeze <player> |
解除玩家冻结 |
/stafftp <player> |
传送到在线玩家 |
/staffwhitelist |
切换管理员白名单绕过模式 |
权限
| 权限 |
描述 |
lightstaff.use |
使用管理员模式 |
lightstaff.reload |
重新加载配置 |
lightstaff.recover |
恢复卡住的会话 |
lightstaff.status |
查看状态 |
lightstaff.vanish |
使用隐身 |
lightstaff.vanish.others |
隐身其他玩家 |
lightstaff.freeze |
冻结玩家 |
lightstaff.freeze.staff |
冻结管理员用户 |
lightstaff.inspect |
检查物品栏 |
lightstaff.inspect.staff |
检查管理员用户 |
lightstaff.fly |
使用飞行工具 |
lightstaff.push |
使用击退工具 |
lightstaff.stafftp |
使用管理员传送 |
lightstaff.whitelist.toggle |
切换管理员白名单模式 |
lightstaff.whitelist.bypass |
绕过管理员白名单模式 |
lightstaff.combat.bypass |
在战斗标记状态下进入管理员模式 |
lightstaff.creative |
在管理员模式下使用创造模式行为 |
lightstaff.see |
看到隐身的管理员 |
lightstaff.alerts |
接收管理员加入/离开警报 |
lightstaff.admin |
由 LightStaff 处理的超级管理员通配符 |
lightstaff.* |
完整的 LightStaff 访问权限 |
LightStaff
A modern staff utility plugin for Paper and Folia servers. LightStaff gives moderators a clean staff mode toolset for investigations: hotbar tools, vanish, freeze, inspection, teleporting, recovery, audit logging, and flexible storage.
Built against Paper 1.19.4 with Java 17, while keeping the runtime path ready for newer Paper builds.
Showcase
Staff Mode Hotbar
The default setup gives staff a compact investigation hotbar with clear names, lore, and actionbar state.
Staff Mode Tools
Staff entering Staff Mode receives a configurable hotbar:
| Slot |
Tool |
Purpose |
0 |
Vanish |
Hide from regular players while staying visible to staff with permission. |
1 |
Push |
Move players away for quick spacing or control. |
2 |
Inspector |
Open a read-only inventory view with armor and offhand. |
4 |
Freeze |
Stop movement, chat, commands, damage bypasses, and inventory actions. |
6 |
Flight |
Toggle flight while investigating. |
8 |
Exit |
Leave Staff Mode and restore the saved player state. |
Every tool is configured in tools.yml: enabled state, slot, permission, material fallback list, cooldown, display name, lore, sound, volume, and pitch.
Storage Choices
Pick the backend that fits the server:
sqlite for simple local production use
json for readable local files
mysql for networked setups
mariadb for MariaDB deployments
Combat-Aware Staff Mode
LightStaff can block players from entering Staff Mode while combat tagged. The check is configurable and supports:
- metadata keys used by combat plugins
- PlaceholderAPI placeholders
- a bypass permission for trusted staff
Features
- Staff Mode enter/exit with inventory, armor, offhand, exp, gamemode, and flight restoration
- Persistent vanish and freeze state
- Read-only inventory inspection
- Freeze command and freeze tool with disconnect handling
- Staff teleport command
- Staff whitelist bypass mode
- Session recovery command
- Audit logging for moderation actions
- Configurable actionbar
- Configurable command, plugin, and tool messages
- Configurable storage: SQLite, JSON, MySQL, MariaDB
- Paper and Folia scheduler support
- Material fallback lists for cross-version compatibility
Requirements
- Java 17 or newer
- Paper
1.19.4+
- Optional: PlaceholderAPI
- Optional: CombatLogX, PvPManager, DeluxeCombat, CombatPlus, or another combat plugin exposed through metadata or PlaceholderAPI
Installation
- Download the latest jar from GitHub Releases.
- Put it in your server
plugins folder.
- Start the server once.
- Edit the generated files in
plugins/LightStaff/.
- Run
/lightstaff reload or restart the server.
Configuration
LightStaff separates configuration into three files:
| File |
Purpose |
config.yml |
Plugin behavior, storage, combat checks, freeze behavior, whitelist mode, audit logging |
tools.yml |
Staff tool setup, slots, permissions, materials, names, lore, sounds |
messages.yml |
Prefix, command messages, plugin messages, actionbar labels |
Storage
Default:
storage:
type: "sqlite"
Available values:
storage:
type: "sqlite" # sqlite, json, mysql, mariadb
JSON storage writes to:
plugins/LightStaff/data/sessions.json
plugins/LightStaff/data/moderation_states.json
Combat Blocking
combat:
block_lightstaff_entry: true
bypass_permission: "lightstaff.combat.bypass"
metadata_keys:
- "combatlogx_in_combat"
- "in_combat"
- "combatTagged"
placeholderapi:
enabled: true
placeholders:
- "%combatlogx_in_combat%"
- "%pvpmanager_in_combat%"
combat_values:
- "yes"
- "true"
- "1"
- "tagged"
Players with the configured bypass permission can enter Staff Mode even while tagged.
Freeze Disconnect Message
Single line:
freeze_ban_message: "You disconnected while frozen."
Multiple lines:
freeze_ban_message:
- "You disconnected while frozen."
- "Open a ticket if this was a mistake."
Commands
| Command |
Description |
/lightstaff, /ls, /staffmode, /sm |
Toggle Staff Mode |
/lightstaff reload |
Reload config, tools, and messages |
/lightstaff status [player] |
Show staff/vanish/freeze/session status |
/lightstaff recover <player> |
Recover a saved Staff Mode session |
/vanish [player] |
Toggle vanish for yourself or another player |
/freeze <player> [reason] |
Toggle freeze |
/freeze on <player> [reason] |
Freeze a player |
/freeze off <player> |
Unfreeze a player |
/unfreeze <player> |
Unfreeze a player |
/stafftp <player> |
Teleport to an online player |
/staffwhitelist |
Toggle staff whitelist bypass mode |
Permissions
| Permission |
Description |
lightstaff.use |
Use Staff Mode |
lightstaff.reload |
Reload configuration |
lightstaff.recover |
Recover stuck sessions |
lightstaff.status |
View status |
lightstaff.vanish |
Use vanish |
lightstaff.vanish.others |
Vanish other players |
lightstaff.freeze |
Freeze players |
lightstaff.freeze.staff |
Freeze staff users |
lightstaff.inspect |
Inspect inventories |
lightstaff.inspect.staff |
Inspect staff users |
lightstaff.fly |
Use flight tool |
lightstaff.push |
Use push tool |
lightstaff.stafftp |
Use staff teleport |
lightstaff.whitelist.toggle |
Toggle staff whitelist mode |
lightstaff.whitelist.bypass |
Bypass staff whitelist mode |
lightstaff.combat.bypass |
Enter Staff Mode while combat tagged |
lightstaff.creative |
Use creative-mode behavior in Staff Mode |
lightstaff.see |
See vanished staff |
lightstaff.alerts |
Receive staff join/leave alerts |
lightstaff.admin |
Admin wildcard handled by LightStaff |
lightstaff.* |
Full LightStaff access |
评论 0
登录后参与评分
还没有评论,来抢沙发吧