WarningManager - 自动惩罚与动态组惩罚系统

WarningManager 是一款小巧而实用的插件，旨在帮助管理员更好地管理玩家。它允许管理员以记录原因的方式对玩家发出警告，便于追踪玩家的过往行为。无论是选拔管理成员、决定处罚措施，还是单纯威慑玩家遵守规则，它都非常有用。插件设计轻量高效，不易引发控制台错误，并能快速适配新版 Minecraft，确保服务器主无需担心兼容性问题。同时，WarningManager 提供了丰富的权限节点和可自定义的选项，让管理员能全面掌控插件、管理团队与玩家。

💡主要特性

• 控制台支持：可通过服务器控制台执行所有命令。
• 数据库同步：支持 MySQL，可在多个服务器间同步警告记录。
• 离线玩家支持：可对未在线的玩家进行操作。
• 高效管理：指令简洁，响应迅速。
• 高度可配置：可通过配置文件自定义消息、前缀、惩罚等。
• 热重载：支持使用 /wreload 重载配置，无需重启服务器。
• 自动惩罚系统：可根据警告次数自动执行预设命令。
• 快速更新：及时适配新版 Minecraft。
• 时间记录：自动记录每条警告的日期与时间。
• 分组警告系统：可为不同类型的违规行为（如黑客、广告、破坏等）设置独立的警告组和动态惩罚。

🎮命令与权限

所有命令都需要对应权限才能执行。拥有 warnings.* 权限将获得所有命令的访问权。

主要命令

• /warn <group> <player> [reason]
• 权限：warnings.warn
• 用途：警告一名玩家。可指定警告组和原因。
• /check <player>
• 权限：warnings.check
• 用途：查看指定玩家的所有警告记录及警告总数。
• /reset <player>
• 权限：warnings.reset
• 用途：重置指定玩家的所有警告记录和计数。
• /delete <group> <player> <warningNumber>
• 权限：warnings.delete
• 用途：删除指定玩家的某条特定警告（需提供警告组和警告编号）。
• /whelp
• 权限：warnings.help
• 用途：查看 WarningManager 的命令菜单。
• /wreload
• 权限：warnings.reload
• 用途：重新加载插件的配置文件。

被动权限

• warnings.notify
• 无对应命令。当 broadcast-message 设置为 false 时，拥有此权限的玩家会在有人被警告时收到通知。

命令示例：/check

执行 /check <玩家名> 后，插件会显示该玩家的所有警告详情，包括日期、时间、原因和操作者。如果玩家因累计警告触发了自动惩罚系统（例如，广告类警告达到1次后自动禁言），该惩罚会立即执行。

🔧配置文件详解

配置文件为 YAML 格式，编辑时请注意

• 使用 4个空格 进行缩进，切勿使用 Tab 键。
• 以 # 开头的行是注释。
• 缩进层级非常重要。

以下是主要配置项说明

MySQL 数据库设置

用于在多服务器间同步警告数据。

mysql:
  enabled: false
  host: host
  database: database
  port: 3306
  username: username
  password: password
  table: warnings

消息与显示设置

# 插件消息前缀
prefix: '&8[&6WarningManager&8] '
# 警告广播消息。可用变量：%TARGET%, %REASON%, %SENDER%
broadcast-message: '&6Player &c%SENDER% &6has warned &c%PLAYER% &6for &c%REASON%'
# 为 true 时向全服广播，为 false 时仅通知有 warnings.notify 权限的玩家
broadcast-reason: true
# 未提供原因时的默认原因
default-reason: 'Follow all the rules!'
# 发送给被警告玩家的消息。设为 'none' 则忽略。可用变量：%SENDER%, %REASON%, %WARNINGS%
player-message: '&6You now have &7%WARNINGS% &6warnings.'

自动惩罚系统

这是插件的核心功能。你可以为不同的警告组（如 general, hack, advertise）设置阶梯式惩罚。变量：%PLAYER%, %SENDER%, %REASON%, %WARNINGS%。

punishments:
  general:
    2:
      command: "kill %PLAYER%"
    5:
      command: "kick %PLAYER% %REASON% (%WARNINGS%) - %SENDER%"
  grief:
    1:
      command: "kick %PLAYER% Greifing is not allowed! (%WARNINGS%) - %SENDER%"
    3:
      command: "ban %PLAYER% Greifing is not allowed!"
  hack:
    1:
      command: "ban %PLAYER% Hacking is not tolerated! - %SENDER%"
  advertise:
    1:
      command: "mute %PLAYER%"

添加新警告组：在 punishments: 下缩进2个空格，输入组名后跟冒号（如 mygroup:），回车后缩进4个空格，按 警告次数: command: "命令" 的格式编写。编辑后执行 /wreload 即可生效。

时间格式

# /check 中显示的日期格式。变量：%WEEKDAY%, %YY%, %MM%, %DD%
date-format: '%WEEKDAY% %MM%-%DD%-%YY%'
# 是否使用24小时制（军事时间）。false 为12小时制（带 am/pm）
military-time: false

✨链接与支持

• GitHub：插件代码已开源，欢迎查看或贡献。
• 链接：WarningManager on GitHub
• 插件统计：本插件使用 Plugin Metrics 收集匿名使用数据以帮助改进。
• 捐赠支持：如果您觉得本插件有用，并愿意支持开发者的工作，可以考虑进行捐赠。