ray's admin utils

插件

· 作者 vrkrayy

AdminPunish 插件,允许管理员使用 /punish 命令(封禁、临时封禁、踢出和监禁)

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

最新 2.4.0 · 1.21.11 · Paper / Spigot

一键开服(送7天)

AdminPunish 一个轻量级、自包含的 Paper 1.21.1 服务器惩罚系统。 无需依赖。无需数据库设置。将 jar 放入服务器,重启后,你的管理团队即可立即获得完整的惩罚工具包。

概述 AdminPunish 是一个仅限 OP(管理员)使用的惩罚插件,通过单一统一的命令界面涵盖所有常见的管理操作。所有数据均本地存储在 JSON 文件中,重启后持久保存,并按 UUID 索引,因此玩家记录在改名后依然存在。该插件是直接由经过实战检验的 Skript 脚本移植而来的 Java 版本,在保留原有行为的同时,获得了编译代码的性能和可靠性。

功能 永久封禁 (Permanent Ban) 发出无限期封禁。被封禁的玩家会被立即踢出,断开连接屏幕显示原因、执行的管理员以及申诉提示。在通过 /unban 解除之前,每次尝试登录都会强制执行封禁。 临时封禁 (Temporary Ban) 使用紧凑的时间格式发出限时封禁:30s, 15m, 12h, 7d, 2w。发出封禁时玩家被踢出,并在尝试登录时被阻止,屏幕上显示剩余时间。当封禁到期时,下次玩家尝试连接时会自动解除,无需人工干预。 踢出 (Kick) 断开在线玩家的连接,并显示格式化原因屏幕。此操作会向所有在线玩家广播。 编号警告 (Numbered Warnings) 发出按玩家顺序编号的警告并永久存储。收到警告的玩家会收到可见的聊天通知,随后在三秒后被踢出,并显示带有警告编号、原因和执行管理员的警告屏幕。可以使用 /warnings 完整查看警告记录,并使用 /clearwarnings 清除。 监狱 (Jail) 在不预先配置任何监狱位置的情况下,将玩家冻结在其当前位置。被关押的玩家切换到冒险模式,每秒收到一次持久的动作栏消息,并受到完全限制:

  • 头部旋转允许,但块级别移动被阻止
  • 所有传送被阻止,包括末影珍珠、 chorus fruit(合唱果实)、/tp 命令和静止室牵引
  • 取消末影珍珠投掷
  • 破坏和放置方块被阻止
  • 所有物品栏交互被阻止
  • 丢弃和拾取物品被阻止
  • 战斗双向被阻止——被关押的玩家无法被击中,也无法击中他人
  • 非 OP 的被关押玩家无法使用命令

如果被关押的玩家断开连接,系统将自动发出 30 分钟的临时封禁并向服务器广播。下次登录时检查封禁:如果已过期,监狱状态也会清除,玩家可以自由加入;如果未过期,他们会在登录界面被阻止,并显示剩余时间。当管理员发出 /unjail 时,玩家恢复为生存模式,并收到释放通知。

命令

命令 描述
/punish <player> ban [reason] 永久封禁一名玩家
/punish <player> tempban <duration> [reason] 临时封禁一名玩家
/punish <player> kick [reason] 踢出一名在线玩家
/punish <player> warn [reason] 发出编号警告
/punish <player> jail [reason] 在当前位置关押一名玩家
/unban <player> 解除任何活动封禁
/unjail <player> 释放一名被关押的玩家
/warnings <player> 查看玩家的完整警告历史
/clearwarnings <player> 清除玩家的所有警告

所有命令都支持在线玩家名称的 Tab 补全。/unban 和 /unjail 还会从存储的 UUID 缓存中建议名称,允许通过名称针对离线玩家。 /punish tempban 的时间格式:在正整数后附加单位字符。支持的单位有 s(秒)、m(分钟)、h(小时)、d(天)和 w(周)。示例:30m, 12h, 7d, 2w。

权限 所有命令都需要 adminpunish.use 权限,默认授予 OP。无需配置文件;在任何标准 Paper 服务器上开箱即用。

数据存储 所有记录均以人类可读的 JSON 文件格式存储在插件的数据文件夹内:

  • bans.json — 按 UUID 键控的活动和过期封禁记录
  • warnings.json — 按 UUID 键控的警告历史记录列表
  • jail.json — 按 UUID 键控的活动监狱记录
  • players.json — 每次加入时填充的 UUID 到名称和名称到 UUID 的缓存

每次更改后立即将记录写入磁盘。不涉及调度程序或批量写入延迟。

兼容性

  • 服务器软件:Paper 1.21.1(API 版本 1.21)
  • Java 版本:Java 21
  • 依赖项:无 —— Gson 已阴影打包进 jar 中
  • 软依赖项:无

安装

  1. 下载 AdminPunish-2.4.0.jar
  2. 将其放入服务器的 plugins/ 文件夹
  3. 重启服务器

无需配置。插件在第一次重启后立即生效。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源