Thirst - 简易口渴系统

Thirst 是一款为 Minecraft 引入口渴机制的插件，它高度可配置且运行轻量，力求在不影响游戏流畅度的前提下，为生存模式增添真实的饮水需求。玩家需要定期饮水，否则将面临负面效果。几乎所有机制，从显示方式、消耗速度到豁免规则，都可以通过配置文件自由调整。

💡核心特性

• 真实口渴系统：采用百分比机制，当口渴值过低时，会对玩家施加可配置的药水效果或伤害。
• 极致轻量与高效：对服务器性能影响极小，运行流畅。
• 高度可配置：
• 自定义口渴值的显示方式（如动作栏、记分板、Boss 血条）。
• 自定义所有提示信息与死亡消息。
• 自定义可以回复口渴值的物品及其回复量。
• 设置哪些玩家（如创造模式、OP 玩家）或哪些世界/区域可以忽略口渴效果。
• 精细控制口渴值的下降速度与时机。
• 查看功能：支持使用指令查看自己或其他玩家（甚至离线玩家）的当前口渴值。
• PlaceholderAPI 支持：可与其他插件联动，在文本中显示口渴相关变量。
• 环境乘数系统：可根据玩家所处的生物群系、穿戴的盔甲、是否在奔跑、以及昼夜/天气状况，动态调整口渴值的下降速度。
• 详细的配置文档：配置文件内包含详尽的说明与注释。

🎮指令列表

• /thirst - 显示插件基本信息。
• /thirst help - 显示帮助信息。
• /thirst view - 查看自己的口渴值。
• /thirst view [player] - 查看指定玩家的口渴值。
• /thirst list [effect:food:biomes] - 列出所有有效的药水效果、食物物品或生物群系。
• /thirst reload - 重载 config.yml 和 thirst_data.yml 的配置与数据。
• /thirst update - 手动安装更新（需在配置中启用更新器）。

🎮权限节点

• thirst.command - 允许使用 /thirst 基础指令。
• thirst.command.help - 允许使用 /thirst help。
• thirst.command.view - 允许使用 /thirst view 查看自己。
• thirst.command.view.other - 允许使用 /thirst view [player] 查看他人。
• thirst.command.list - 允许使用 /thirst list。
• thirst.ignore - 使玩家完全免疫口渴效果。
• thirst.* - 拥有所有权限。

🔧配置要点

配置文件 (config.yml) 结构清晰，每个选项都有类型说明和注释。以下是一些关键部分的概述：

常规设置

• Remove-Thirst：每次 Thirst-Delay 时扣除的口渴值量（整数，建议 ≤100）。
• Thirst-Delay：扣除口渴值的间隔时间（秒，支持小数，默认 36 秒扣 1%，约三天扣完 100%）。
• Critical-Thirst-Percent：口渴值低于此百分比时视为“危急”，会显示警告信息。
• Thirst-Quenching-Items：定义可回复口渴的物品及回复量。格式：物品名:元数据=回复百分比（元数据可选），例如 POTION=20、GOLDEN_APPLE:1=100。
• Ignore-Creative / Ignore-OP：是否让创造模式玩家或 OP 玩家免疫口渴。
• Drink-Block-Water：玩家在水中游泳时是否每秒回复 2% 口渴值。
• Remove-When-AFK：玩家挂机时是否继续扣除口渴值。
• Allow-Item-Consumption：当口渴值为 100% 时，是否允许玩家消耗 Thirst-Quenching-Items 列表中定义的物品。

显示设置

• Display-Type：口渴值显示方式。可选：ACTION（动作栏）、SCOREBOARD（记分板）、COMMAND（仅指令查看）、BOSSBAR（Boss 血条）。
• Always-Showing：是否始终显示。若为 false，则只在口渴值变化时短暂显示。
• Bar-Color / Bar-Style / Use-Bar-Progress：当使用 Boss 血条显示时的颜色、样式和是否随口渴百分比变化。

乘数系统

可配置不同条件下口渴值下降速度的倍率。正值加快消耗，负值减慢消耗，0 为无影响。

• Biomes：按生物群系设置。格式如 DESERT.5（在沙漠中消耗快 5 秒）。
• Armor：按穿戴的盔甲设置。格式如 LEATHER.5（穿全套皮革盔甲消耗快 5 秒）。
• Sprint：奔跑时的额外消耗速度。
• Day / Night：白天/夜晚时的额外消耗速度。
• Sunny / Rain：晴天/雨天时的额外消耗速度。

效果设置

• Enabled：是否启用低口渴值时的负面效果。
• Potions：定义触发的效果。格式：效果名.持续时间(秒).效果等级.触发最大百分比.触发最小百分比。
• 例如：CONFUSION.30.1.10.0 表示当口渴值在 0% 到 10% 之间时，给予 30 秒的混乱 I 效果。
• 伤害效果格式特殊：DAMAGE.伤害间隔(秒).伤害量(半颗心为1).最大百分比.最小百分比。

消息与变量

所有消息均可自定义，并支持以下变量

• %player% - 玩家名。
• %percent% - 带有颜色代码的当前口渴百分比。
• %thirstbar% - 由 10 个符号组成的视觉化口渴条（例如 ::::::::::）。
• %thirstmessage% - 替换为 ThirstMessage 中定义的内容。
• %removespeed% - 当前口渴值下降的速度（秒/次）。查看离线玩家时此变量无效。

禁用区域与数据库

• Disabled-Worlds：在此列表中的世界将完全禁用口渴机制。
• Disabled-Regions：在此列表中的 WorldGuard 区域将禁用口渴机制（需安装 WorldGuard）。
• Enable-Sql：是否启用 MySQL 数据库来同步多个服务器间的玩家口渴数据。

❓PlaceholderAPI 支持

安装 PlaceholderAPI 后，插件会自动挂接并提供以下占位符（前缀为 gkthirst）：

• %gkthirst_thirstmessage% - 显示配置中定义的口渴消息。
• %gkthirst_thirstbar% - 显示玩家的口渴条。
• %gkthirst_thirstpercent% - 显示带有颜色代码的玩家当前口渴百分比。
• %gkthirst_thirstremovalspeed% - 显示玩家口渴值的当前下降速度（秒/次）。
• %gkthirst_thirstremovalamount% - 显示每次下降所扣除的口渴值量。

✨注意事项与常见问题

配置与使用

• 效果与物品格式：务必使用 /thirst list 指令来确认有效的药水效果名和物品名，再将其填入配置。
• 重置所有玩家数据：需要停止服务器，删除 plugins/Thirst/thirst_data.yml 文件，然后重启。
• 修改单个玩家数据：可以停止服务器，直接编辑 thirst_data.yml 中对应玩家 UUID 下的数据，然后重启。
• 记分板显示限制：当 Display-Type 设为 SCOREBOARD 时，记分板标题 (Scoreboard-Title) 不能超过 16 个字符，显示内容不能超过 32 个字符（变量替换后的最终长度）。
• 口渴下降速度下限：最快不能低于 0.01 秒（100 毫秒）每次扣除。

兼容性与已知情况

• 药水类型区分：由于 Minecraft 本身不区分不同药水（如治疗、伤害）的物品元数据，因此无法为不同类型的药水设置不同的口渴回复值。所有药水瓶 (POTION) 均被视为同一种物品。
• 与 FeatherBoard 的兼容性：启动时可能出现找不到文件的错误提示，这不会影响 Thirst 插件本身的功能，但可能导致 FeatherBoard 中的部分其他占位符失效。此问题无法由本插件修复。
• 依赖项：本插件需要以下依赖库，但它们会自动下载，无需手动安装：
• PlaceholderAPI (可选，用于占位符功能)
• Yamler (用于配置处理)
• AutoUpdaterAPI (用于自动更新)
• bStats (用于匿名统计)

支持与反馈

• 报告漏洞或提出建议：请在 Spigot 资源页面的讨论区发帖，或使用插件内提供的 Trello 看板链接提交。
• 自动更新：默认启用。可在配置中通过 Enable-Updater 设置关闭，但仍可通过 /thirst update 手动更新。