AdvancedWarn - Custom Warning System! - AdvancedWarn - 自定义警告系统

> 本项目目前处于暂停开发状态，作者正在对项目进行整体重写，暂无预计完成时间。

💡关于 AdvancedWarn

AdvancedWarn (AW) 是一款高度可自定义的服务器警告系统。你可以使用基于类别的惩罚机制，根据违规严重程度对玩家执行多种处罚，以强化服务器规则。AW 包含多个 GUI 界面、玩家举报、查看管理员的警告历史、离线警告、简便的命令/权限等功能。通过这套完善的警告系统，让你的管理团队更好地执行规则。

🎮核心特性

• 创建多个 GUI 界面
• 基于类别的警告系统
• 完全自定义所有内容
• 通过 GUI 查看管理员的警告历史
• 对玩家的警告进行增加、扣除、清空或设置
• 查看自己的警告记录
• 举报系统
• 防止管理员在短时间内重复警告同一玩家
• 防止玩家在短时间内重复提交举报
• 警告离线玩家
• 执行无限数量的惩罚
• 在一次警告中执行多个惩罚
• 支持多语言
• 100% 可自定义的消息文本
• 支持 Minecraft 1.7, 1.8, 1.9, 1.10, 1.11, 1.12, 1.13 及 1.14+ 版本

🔧创建警告类别

创建类别非常简单。找到你的 categories.yml 文件，格式如下：

categories:
  hack:
    reason: Hacking in-game
    punishments:
      - tempban %player% 7d Use of Hacked Client
      - tempban %player% 14d Use of Hacked Client
      - (ban %player% Third Offense; Use of Hacked Client,banip %player% Use of Hacked Client)

• hack 是类别名称。例如使用命令 /warn <玩家名> hack。建议所有类别名称都使用小写。
• 每个惩罚行对应一次警告。第一次警告将执行第一个惩罚。
• 要执行多个惩罚，请参照上面第三个惩罚的示例：用括号 () 包裹整行，命令之间用英文逗号 , 分隔，不要加空格。
• 你可以根据需要创建任意数量的类别。

🔧自定义 GUI

GUI 界面 100% 可自定义。一个示例如下

gui:
  main-page:
    title: '&4Warn GUI'
    slots: 54
    close-button: 50
    items:
      '1':
        item-name: '&6&lCheating'
        item-material: DIAMOND_SWORD
        enchanted: true
        lore:
          - '&6Click to warn for Cheating!'
        item-slot: 12
        run: CATEGORY
        category: cheat
      '2':
        item-name: '&a&lSpam'
        item-material: GRASS_BLOCK
        enchanted: true
        lore:
          - '&aClick to warn for Spam!'
        item-slot: 16
        run: CATEGORY
        category: spam
      '3':
        item-name: '&b&lHacking Categories'
        item-material: DIAMOND_BLOCK
        enchanted: true
        lore:
          - '&bClick to view different Hack Categories!'
        item-slot: 32
        run: OPEN-GUI
        gui: hack-categories

你可以为 /warn 命令创建自定义 GUI。编辑 gui.yml 文件即可。在上面的示例中，我们创建了一个 54 格、包含 3 个物品的 GUI。每个物品可以执行不同的操作：显示消息、执行类别警告、运行玩家命令、运行控制台命令、打开另一个自定义 GUI 或执行 BungeeCord 的 /server 命令。

GUI 操作类型

打开一个 GUI

run: GUI
value: <gui-name>

执行一个类别警告

run: CATEGORY
value: <category-name>

显示消息

run: MESSAGE
value:
  - 在此输入多行消息

执行玩家命令

run: PLAYER-CMD
value:
  - "feed"

执行控制台命令

run: CONSOLE-CMD
value:
  - "heal %player%"

仅用于装饰 (无功能)

run: COSMETIC

执行 BungeeCord 的 /server 命令

run: SERVER
value: <SERVER-NAME>

在 1.12 及以下版本使用 GUI 的注意事项

• 必须使用 1.13+ 的方块 ID 名称，不能使用数字 ID（例如使用 polished_granite，而不是 1:2）。
• 1.13+ 方块 ID 列表可以在此处找到。
• 示例：使用 lime_stained_glass_pane 代替 160:5。
• 如果找不到物品，将默认使用 BARRIER 方块。

请注意，此功能仍处于 BETA 测试阶段。 我们已将大约 1000 个 Minecraft 物品编码转换为 1.14 的方块 ID 系统。有可能遗漏或错误输入了某些物品。如果你发现某个方块无法工作，请尽快联系我。

使用 HeadDataBase

如果你的服务器安装了 HeadDataBase 插件，你可以使用其中的任何物品作为 GUI 图标。

只需在 item-material 中使用 HDB[<物品ID>] 格式即可。

示例

item-material: HDB[1138]

其中 1138 是 HeadDataBase 插件中的物品 ID。

想要支持其他头颅插件的方块？请发送该插件的链接给我，我可能会添加支持。

多槽位物品

你可以将一个物品放置在多个槽位中，而无需复制粘贴配置。只需将 item-slot 的值设置为用方括号包裹的数字列表。

示例

item-slot: [1,2,3,4,5,6,7,8,9,19,20,21,22,24,25,26,27]

🎮命令列表

• /warn <player> <category> <custom-reason>
• /warn add <player> <amount> <category>
• /warn take <player> <amount> <category>
• /warn set <player> <amount> <category>
• /warn clear <player> <category>
• /warn info <player>
• /warn history <player>
• /report <player> <reason>
• /report all
• /report check
• /report remove <player> <line number>
• /warnings <optional-player> - 查看警告
• /aw reload
• /aw clear logs <player> - 删除该玩家保存的所有日志
• /aw clear logs all - 删除数据文件中的所有日志
• /aw clear all <player> - 删除该玩家的所有信息
• /aw clear file - 清空 data.yml 文件中的所有内容

🎮权限节点

推荐给普通管理员

• aw.help - 允许使用 /warn help
• aw.warn - 允许使用 /warn
• aw.receivebroadcast - 查看警告广播消息
• aw.checkwarns.others - 查看他人的警告
• aw.info - 查看警告信息
• aw.report.staff - 允许管理员使用举报相关命令
• aw.report.check - 允许管理员查看举报
• aw.report.remove - 允许管理员移除举报

推荐给高级管理员

• aw.receivebroadcast.extra - 查看额外的广播消息
• aw.warn.add - 允许使用 /warn add
• aw.warn.set - 允许使用 /warn set
• aw.warn.take - 允许使用 /warn take
• aw.warn.clear - 允许使用 /warn clear
• aw.history - 查看管理员的警告历史
• aw.protect - 允许使用 /protect

推荐给玩家

• aw.checkwarns - 查看自己的警告
• aw.report - 允许使用 /report

管理员权限

• aw.admin - 重载配置等
• aw.* - 获得所有权限
• aw.staff.* - 获得所有推荐给管理员的权限
• aw.admin.* - 获得所有推荐给高级管理员和管理员的权限
• aw.player.* - 获得所有推荐给玩家的权限

🔧配置文件说明

AdvancedWarn 共有 5 个不同的 YML 配置文件。data.yml 不应手动修改。

settings.yml 主要设置

• language：支持 4 种语言：English、German、French 或 Spanish。我已尽力翻译，但由于我只懂英语，翻译可能有误。如果有人能提供正确的翻译，请联系我修正。
• logMoreInfo：启用后，可以使用 /warn info 和 /warn history 命令。更多信息（如时间、警告者、被警告者、警告类别等）将被记录到 data.yml 中。如果数据积累过多，可以从 data.yml 中删除这些信息。使用 /aw 命令查看操作方法。
• broadcast-all-commands：启用后，拥有 aw.receivebroadcast.extra 权限的玩家将在管理员使用以下命令时收到提醒：/warn set、/warn take、/warn add 或 /warn clear。
• stop-multi-warns：启用后，将阻止管理员在短时间内重复警告同一玩家，防止因单一事件触发多次惩罚。seconds 对应再次警告该玩家前需要等待的时间。
• total-warns：此设置仅对类别警告生效。启用后，如果所有类别的警告总数达到限制，将执行设定的惩罚。

❓常见问题 (FAQ)

问：我的配置文件没有保存/重载，如何修复？

答：如果你编辑了配置但游戏内没有变化，说明配置存在错误。最常见的错误是遗漏了引号（" "）或有多余的引号。同时，请检查缩进！将你的配置与上面的示例配置进行比较。你可以使用此链接来测试你的 YML 格式和缩进。

问：消息文本没有改变，如何更改它们？

答：（同上）如果你编辑了配置但游戏内没有变化，说明配置存在错误。最常见的错误是遗漏了引号（" "）或有多余的引号。同时，请检查缩进！将你的配置与上面的示例配置进行比较。你可以使用此链接来测试你的 YML 格式和缩进。

问：为什么我的类别不工作？

答：如果类别名称包含大写字母，可能会导致问题。同时请检查你的语法！

问：如果在 1.12 或更低版本上运行此插件会怎样？

答：所有功能都应该能正常工作。如果你使用 GUI，请确保只使用 1.13+ 的方块 ID 名称！

插件没有按照你期望的方式工作？ 请在通过 Discord、Spigot 或讨论页面联系我，然后再留下评论。留下带有错误信息的评论并不会让我更努力地解决问题。