AfkPlus - AFK增强

AfkPlus Fabric Mod for Minecraft

基本描述：

• 一个基于 beabfc 的 AfkDisplay 的分支项目。他已授权我继续开发此模组，详情请查看我的“已归档问题”面板。
• 在玩家列表中显示哪些玩家处于 AFK 状态，查看原因、持续时间和时间。
• 完全可配置，并支持 Placeholder API，其中包括所有 Placeholder API 格式节点，例如：原生支持黄色或粗体。（你甚至可以在 AFK 原因中包含一个 URL！）
• 模组现在可用于单人游戏和集成服务器（开放到局域网）。
• 新功能] 截至 2024 年 12 月，模组已基本重写，成为一个基于 [Fallen-Breath 的模板模组 架构的多版本项目。
• 新功能] 模组现在是我的新库模组 [CoreLib 的依赖项，并且更多颜色系统也已分叉到我的 More Color API 模组中。
• 它们都包含在 AfkPlus JAR 文件中。

模组重写与新功能

• 整个模组生态系统已迁移到多版本架构，以便使用单一分支更快地将模组移植到版本 1.19.2-1.21.4+。
• 配置不再使用 TOML，并已转换为数据驱动的、基于 CoreLib 的 JSON 配置系统；其工作方式类似于 Pat 的模组生态系统。
• 大多数玩家/服务器事件现在由 CoreLib 接口管理；只有少数 AFK 特定的例外。
• 所有命令现在都由 CoreLib 接口注册和管理。
• 所有抽象的文本占位符 API 格式化和额外的颜色标签现在由 More Color API 管理。请参阅 /morecolors 命令。
• 所有新的抽象时间日期/持续时间格式化接口由 CoreLib 管理。
• 完全重写了基于抽象的 AfkPlayer / Afk 玩家列表系统；而不是通过 Mixin 类管理。这应有助于解决任何严格的模组兼容性问题，并避免丑陋的代码。
• 从 CoreLib 到 AfkPlus 的整个模组生态系统都拥有 API / 事件系统，供其他模组实现并在其自己的模组中兼容。
• AfkPlus 为 Vanish、Carpet Mod 和 Styled Player List 添加了 API 兼容性处理。每个模组的集成程度根据兼容性需求而有所不同。
• 添加了几个 message 选项，并将 afkKick 和 disableDamage 系统分叉到它们自己的配置类别中。有关更多默认信息，请参阅下面的配置。
• 根据请求添加了几个其他烦人的问题、错误和功能，例如能够通过各种配置选项完全配置 Gone for: XXX 消息。

功能

• 添加了一个占位符 %afkplus:afk%，让你可以为 AFK 玩家提供一个非常基本的 '[AFK]' 标签。
• 添加了一个占位符 %afkplus:name%/%afkplus:display_name%，以便你可以在其他模组（如 [Styled Playerlist](https://modrinth.com/mod/styledplayerlist "Styled Playerlist")）中将其用作 '%player:displayname%' 占位符的替代品。

请注意，此方法旨在与 Styled Playerlist 下的 LuckPerms 前缀完全兼容，因为玩家列表更新的标准方法会失败，或者如果你愿意，可以简单地使用 %afkplus:afk% 为现有名称添加格式。

• 添加了一个占位符 %afkplus:duration%，以便你可以获取某人 AFK 以来的时间，并可配置格式前缀。
• 添加了一个占位符 %afkplus:time%，以便你可以获取某人 AFK 的时间/日期，并可配置格式前缀。
• 添加了一个占位符 %afkplus:reason%，以便你可以获取某人 AFK 的原因，并可配置格式前缀。
• 添加了一个占位符 %afkplus:invulnerable%，以便你可以为所有用户显示“禁用伤害”状态，类似于 "[AFK]" 占位符标签，但更像是一个“附加项”。
• 有一个特殊的配置选项 'prettyDuration'，用于以更人性化的格式配置 AFK 持续时间，而不是默认的 (HH:mm:ss.mss) 格式。不过每种方法都有其优点。（Styled Nicknames 或 Styled Chat 在这里值得一提）
• 为管理员提供了几个模组/数据包冲突警告，以帮助他们更好地决定要安装哪些模组。
• 添加了一个 "disableDamage" 配置，使 AFK 玩家在 15 秒冷却后免疫伤害。现在默认强制执行一个新的可配置的全服务器消息。
• 添加了一个 "disableDamageCooldown" 配置，允许管理员调整玩家进入 AFK 后应用的默认“计时器”。我强烈建议不要将其设置为 '0'，除非你认为你的玩家不会滥用此特权。
• 添加了一个 "whenDamageDisabled" 配置，以便你可以自定义玩家被标记为无敌时显示的消息。
• 添加了一个 "whenDamageEnabled" 配置，以便你可以自定义玩家被取消无敌标记时显示的消息。
• 现在还会检查玩家是否处于旁观者模式，而不仅仅是创造模式，以管理你的 AFK/禁用伤害状态。
• ~~添加了几个玩家可用于 AFK 原因的颜色节点。请参阅 /afkex 以获取显示示例。~~
• ~~brown, cyan, darkbrown, darkpink, lightblue, lightbrown, lightgray, lightpink, lime, magenta, purple, salmon,~~
• ~~bluetiful, burntorange, canary, coolmint, copper, powderblue, royalpurple, shamrock, ticklemepink, ultramarine_blue~~
• 添加了一个 "bypassSleepCount" 配置，以便你可以允许标记为 Afk 的玩家绕过睡眠要求。
• 添加了一个 "bypassInsomnia" 配置，以便你可以允许标记为 Afk 的玩家阻止幻翼生成。
• 为玩家添加了一个 "/noafk" 命令，以阻止自己被标记为 Afk。
• 添加了一个 "displayDuration" 配置选项，以便你可以在 whenReturn 期间启用/禁用 "Gone for XX minutes, XX seconds"。
• 添加了额外的处理，允许将 "afkTimeoutString" 设置为 ""，并将 "defaultReason" 传递为 ""，以获得更多“原始” AfkDisplay 的感觉。
• 添加了一个 "AFK 踢出" 系统，用于在配置的时间后自动将 AFK 玩家踢出服务器。它有几个配置选项：
• afkKickEnabled - (true/false) 启用 AFK 自动踢出管理器。
• afkKickNonSurvival - (true/false) 允许踢出创造/旁观者玩家。
• afkKickTimer - 超过 timeoutSeconds（累加）的时间，当玩家被从服务器移除时，所以如果 timeoutSeconds 是 240，而 afkKickTimer 设置为 3600，他们实际被踢出的时间是在 3840，或者最长 64 分钟。
• afkKickSafePermissions - (权限 3) 默认被标记为“安全”免受自动踢出的权限级别。(Luck Perms: afkplus.kick.safe)
• 注意；如果玩家拥有 afkPlusCommandPermissions (Luck Perms: afkplus.afkplus)，他们也将被标记为免受自动踢出，但这个新配置允许你单独配置这些权限。
• afkKickMessage - 发送给被踢出玩家的消息，作为他们被移除的原因。（当 displayDuration 启用时添加持续时间）
• whenKicked - 当玩家因 AFK 被踢出时广播到服务器的消息。（当 displayDuration 启用时添加持续时间）
• 注意：此功能 不会 自动踢出 Carpet Mod 机器人，因为“假”玩家不会被服务器计时。
• 此功能在单人游戏/开放到局域网中 不起作用，需要专用服务器环境才能正常运行。

命令（通过 Luck Permissions 或 afk_plus 配置的权限）

• '/afkplus' 使用 AfkPlusCommandPermissions（默认：4）设置默认限制。(权限: afkplus.afkplus)
• 显示模组版本信息。
• '/afkplus reload' 命令。(权限: afkplus.afkplus.reload)
• 这允许管理员在服务器运行时重新加载配置。
• ~~'/afkplus ex' 命令。(权限: afkplus.afkplus.ex)~~
• ~~这显示一个简单的“格式化测试”，向用户展示可用的基本文本节点，并允许他们通过点击颜色/格式进行复制/粘贴。~~
• '/afkplus set [玩家] [原因]' 命令。(权限: afkplus.afkplus.set)
• 这允许任何管理员设置玩家的 AFK 状态，并且还会移除他们的 NoAFK 状态。
• '/afkplus clear [玩家]' 命令。(权限: afkplus.afkplus.clear)
• 这允许任何管理员清除玩家的 AFK 状态。
• '/afkplus damage enable [玩家]' 命令。(权限: afkplus.afkplus.damage.enable)
• 这允许管理员强制启用 AFK 玩家在连接时受到伤害的能力。
• '/afkplus damage disable [玩家]' 命令。(权限: afkplus.afkplus.damage.disable)
• 这允许管理员在强制移除后恢复玩家使用“禁用伤害”的能力。
• '/afkplus info [玩家]' 命令。(权限: afkplus.afkplus.info)
• 这允许任何管理员检查玩家的 AFK 状态，并显示他们 AFK 以来的时间和持续时间。
• '/afkplus update [玩家]' 命令。(权限: afkplus.afkplus.update)
• 这允许任何管理员强制更新玩家的玩家列表。
• '/afkinfo [玩家]' 使用 AfkInfoCommandPermissions（默认：2）设置默认限制，(权限: afkplus.afkinfo)
• 与 '/afkplus info [玩家]' 功能相同，但可用于模组、玩家，或根据你希望人们查看的方式配置。
• ~~'/afkex' 使用 AfkExCommandPermissions（默认：0）设置默认限制。(权限: afkplus.afkex)~~
• ~~这显示一个简单的“格式化测试”，向用户展示可用的基本文本节点，并允许他们通过点击颜色/格式进行复制/粘贴。~~
• '/afk [原因]' 使用 AfkCommandPermissions（默认：0）设置默认限制。(权限: afkplus.afk)
• 这允许任何用户使用 [原因] 来设置他们的 AFK 状态。
• [新] '/noafk' 使用 noAfkCommandPermissions（默认：0）设置默认限制。(权限: afkplus.noafk)
• 这允许任何用户将自己设置为一种状态，在该状态下他们不会根据配置的超时值进入 Afk。
• [新] 'afkKickSafePermissions'（默认：3）设置默认权限，以将 AFK 玩家标记为免受踢出。(权限: afkplus.kick.safe)

潜在的已知冲突（请自行选择）

• afk display 数据包（Vanilla Tweaks 数据包，更改玩家列表显示）—— 模组会检查名称中包含任何“afk”的数据包。
• AfkDisplay —— 因为这是 AfkPlus 所基于的模组，并且提供更少的功能。
• AntiLogout (/afk 命令，超时处理)
• Auto AFK (/afk 命令，超时处理)
• Sessility (超时处理)
• Playtime-Tracker (超时处理)
• SvrUtil (/afk 命令，其余部分是安全的)

配置示例

配置位于服务器配置文件夹内的 afkplus.json 文件中。

```json lines

{

"___comment": "AfkPlus-1.21.4-1.7.4-SNAPSHOT 配置",

"config_date": "Fri, 3 Jan 2025 00:05:08 -0500",

"afk_plus": {

"_comment01": "# 允许你禁用 /afk 命令来标记自己为 AFK，带有可选的 [原因] (默认: true)",

"enableAfkCommand": true,

"_comment02": "# 允许你禁用 /noafk 命令来标记自己为 NoAFK，这会禁用超时 (默认: true)",

"enableNoAfkCommand": true,

"_comment03": "# 允许你禁用 /afkinfo 命令，以允许玩家查看某人的 AFK 状态（时间、持续时间、原因）。(默认: true)",

"enableAfkInfoCommand": true,

"_comment04": "# /afk 默认命令权限，可通过 Luck Perms (afkplus.afk) 节点配置 (默认: 0)",

"afkCommandPermissions": 0,

"_comment05": "# /noafk 默认命令权限，可通过 Luck Perms (afkplus.noafk) 节点配置 (默认: 0)",

"noAfkCommandPermissions": 0,

"_comment06": "# /afkinfo 默认命令权限，可通过 Luck Perms (afkplus.afkinfo) 节点配置（通常用于模组）(默认: 2)",

"afkInfoCommandPermissions": 2,

"_comment07": "# /afkplus 默认命令权限，可通过 Luck Perms (afkplus.afkplus 带 .subcommands) 节点配置 (默认: 3)",

"afkPlusCommandPermissions": 3,

"_comment08": "# 一个基本的冷却时间配置，有助于防止人们刷 /afk 命令 (默认: 5 秒)",

"afkCommandCooldown": 5,

"_comment09": "# 一个布尔切换，用于启用/禁用模组中的调试日志消息",

"debugMode": false

},

"packet": {

"_comment01": "# 玩家无操作后被判定为 AFK 的时间。设置为 -1 以禁用自动 AFK 检测。(默认: 240)",

"_comment02": "# --注意；原始 AfkDisplay 的默认超时设置为 180 秒。",

"timeoutSeconds": 240,

"_comment03": "# 将移动的玩家视为不再 AFK（启用简单的绕过方法，如 AFK 池）(默认: false)",

"resetOnMovement": false,

"_comment04": "# 将环顾四周的玩家视为不再 AFK (默认: false)",

"resetOnLook": false,

"_comment05": "# 将仅挥剑的玩家视为 AFK (默认: false)",

"ignoreAttacks": false,

"_comment06": "# 使 Afk 玩家不计入睡眠百分比检查 (默认: true)",

"bypassSleepCount": true,

"_comment07": "# 使 Afk 玩家阻止幻翼生成尝试。(默认: true)",

"bypassInsomnia": true,

"_comment08": "# 默认的“超时”AFK 原因 (默认: \"timeout\")",

"afkTimeoutString": "timeout",

"_comment09": "# 用于“ignoreAttacks”检测的默认 AFK 超时消息",

"afkTimeoutIgnoreAttack": "only swinging their sword"

},

"disable_damage": {

"_comment01": "# 在玩家进入 AFK 后 disableDamageCooldown 秒后禁用伤害 (默认: false)",

"disableDamage": false,

"_comment02": "# 启用“DisableDamage”功能的冷却计时器。(默认: 15 秒)",

"_comment03": "# - 警告！请注意，将此值设置过低可能会鼓励不良的玩家行为。",

"disableDamageCooldown": 15,

"_comment04": "# 当 AFK 玩家被标记为无敌时的消息内容。",

"_comment06": "# (默认: \"%player:displayname% is marked as Invulnerable.\")",

"whenDamageDisabled": "%player:displayname% is marked as Invulnerable.",

"_comment08": "# 当 AFK 玩家不再被标记为无敌时的消息