LightStaff

插件

· 作者 flennium

适用于 Paper 和 Folia 服务器的员工实用插件。LightStaff 为版主提供了一套简洁的调查工具集

0 本站下载 0 关注 更新于 5 个月前

最新 1.0.0 · 26.1.2 · Bukkit / Folia

一键开服(送7天)

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 暴露的战斗插件

安装

  1. 从 GitHub Releases 下载最新的 jar 文件。
  2. 将其放入服务器的 plugins 文件夹中。
  3. 启动服务器一次。
  4. 编辑 plugins/LightStaff/ 中生成的文件。
  5. 运行 /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 访问权限

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源