Caliditas - a temperature mechanics for Minecraft - Caliditas - 温度机制插件

Caliditas（拉丁语意为“温度”）是一款为 Minecraft Spigot 服务器设计的插件，它提供了一个复杂、沉浸式且易于配置的温度系统。想象一下，在雪山之巅建造一座带有壁炉的小屋，或在寒冷的冬夜躲进洞穴烤火取暖。现在，下界将变得异常炎热，你需要钻石盔甲和水瓶来抵御高温；沙漠中若不戴帽子可能会中暑，而穿着铁质盔甲太久甚至会灼伤皮肤。为了获得最佳体验，建议使用“大型生物群系”世界生成选项！

💡重要须知

• 若遇到任何问题，请务必检查并使用插件的最新版本。
• 若服务器 CPU 负载过高，请在配置文件中禁用 Birning Furnaces（燃烧的熔炉）功能。开发者正在修复此问题。
• Caliditas 0.1.x 版本与新的 0.2.x 版本不兼容。升级时请删除旧的配置文件。

🎮温度机制简介

温度机制基于玩家的体温运作。玩家的正常基础体温被视为 36.6°C。体温可分为 7 种状态：低于正常体温 3 级（freezing（冻结）、cold（寒冷）、chill（微寒））和高于正常体温 3 级（warm（温暖）、hot（炎热）、melting（熔化）），中间为 normal（正常）。每种状态都可以为玩家施加可配置的效果（例如失明、中毒）。

体温会根据玩家所在的生物群系逐渐趋近于该群系的目标体温。这个过程会受到各种因素的影响而改变，例如站在火堆旁可以御寒，而喝水或游泳则可以防止过热。

核心概念：因素与条件

• 因素：每个因素都会对玩家的体温变化产生影响。您可以创建任意数量的自定义因素。
• 条件：每个因素都附带一个条件，这是一个布尔表达式。只有当条件为“真”时，该因素才会对玩家生效。
• 标志：条件是靠“标志”来构建的。标志是玩家在特定情况下获得的“标记”（例如下雨时获得 RAINING_OR_SNOWING_ON_PLAYER 标志）。标志列表是预定义的，但每个生物群系也可以提供独特的标志。

✨内置特色功能

• 动态火堆：玩家可以向火中投掷木棍等材料，使其长时间燃烧（仅限 Minecraft 1.15.2 及以上版本）。
• 永恒熔炉：当提供燃料时，熔炉可以永久燃烧。此功能仅在熔炉内没有可冶炼物品时激活，以防止被利用。
• 高度可配置：以上功能均可按需禁用。
• 开发者支持：插件提供了简单的 API 供其他开发者集成。

🔧创建自定义温度因素

要创建自定义因素，请在世界文件夹下的 factors 文件夹内创建一个扩展名为 .factor 的新文件。您也可以复制现有的文件作为模板。

文件格式示例：

{
  "factorName": "BOOTS_PROTECTING_FROM_COLD",
  "tempChange": 0.35,
  "tempUnit": "CELSIUS",
  "condition":
  """
  !(LOWER_BODY_IN_WATER)
  & (COLD_BIOME & WEARING_LEATHER_BOOTS)
  """
}

• factorName：定义在 locale_xx_xx.json 中的本地化键名，用于在游戏中显示因素名称。
• tempChange：当此因素激活时，应用于玩家目标体温的数值变化量。
• tempUnit：tempChange 的单位，可以是 CELSIUS（摄氏度）或 FAHRENHEIT（华氏度）。不影响游戏内显示方式。
• condition：一个多行字符串，表示布尔表达式。条件为真时，该因素会对特定玩家生效。

如何编写条件表达式

条件使用简化的布尔表达式，支持以下运算符

• & ：逻辑 与
• | ：逻辑 或
• ! ：逻辑 非
• (， ) ：括号用于分组

条件示例：

• LOWER_BODY_IN_WATER & DRY_BIOME
• 仅当玩家脚部在水中 且 处于干燥生物群系时生效。
• !(LOWER_BODY_IN_WATER) & COLD_BIOME & WEARING_IRON_BOOTS
• 仅当玩家脚部 不 在水中、处于寒冷生物群系 且 穿着铁靴时生效。
• !(LOWER_BODY_IN_WATER | UPPER_BODY_IN_WATER) & SNOWY_BIOME & WEARING_DIAMOND_LEGGINGS
• 仅当玩家脚部或头部 都不 在水中、处于雪原生物群系 且 穿着钻石护腿时生效。

🔧配置温度效果

温度效果根据玩家所处的体温状态施加。您可以在世界文件夹内的 temp_effects.json 文件中进行配置。

效果配置示例：

{
  "effectType": "CONFUSION",
  "tempState": "HOT",
  "durationSeconds": 5,
  "effectAmplifier": 1
}

• effectType：Bukkit 的药水效果类型名称（如 POISON, BLINDNESS）。
• tempState：触发此效果的体温状态（如 HOT, FREEZING）。
• durationSeconds：效果持续时间（秒）。
• effectAmplifier：效果强度等级（遵循 Bukkit 定义）。

🎮可用标志列表（摘要）

标志代表玩家在特定时刻所处的状态，由服务器每刻（tick）更新。部分标志在触发条件消失后仍会持续数秒，持续时间在 flags_duration.json 中定义。

装备与着装

• WEARING_NO_HELMET / WEARING_NO_CHESTPLATE / WEARING_NO_LEGGINGS / WEARING_NO_BOOTS
• WEARING_LEATHER_HELMET、WEARING_DIAMOND_CHESTPLATE、WEARING_IRON_BOOTS 等（支持所有原版盔甲材质，自定义服装也遵循 WEARING_{物品名} 模式）。

维度与生物群系

• THE_VOID、THE_END、NETHER
• COLD_BIOME、SNOWY_BIOME、WARM_BIOME、MODERATE_BIOME、DRY_BIOME、OCEAN

热源相关

• INFLUENCED_BY_ANY_HEAT_SOURCE、STANDING_IN_LAVA、STANDING_NEAR_LAVA、HEAT_FROM_TORCH
• STANDING_ON_HEAT_SOURCE、STANDING_NEAR_HEAT_SOURCE、STANDING_AROUND_HEAT_SOURCE（影响强度递减）

玩家状态与环境

• RAINING_OR_SNOWING_ON_PLAYER、LOWER_BODY_IN_WATER、UPPER_BODY_IN_WATER、FLOATING_IN_WATER
• SPRINTING、SWIMMING、SNEAKING、WALKING、SLEEPING、FLYING
• MINING、PLACING_BLOCKS
• UNDER_ROOF、IN_OPEN_SPACE、IN_CLOSED_SPACE
• HIGH_ALTITUDE、LOW_ALTITUDE
• DAY、NIGHT、MIDNIGHT、NOON
• STORM、THUNDERING

消耗品与药水

• POTION_{药水效果名} （饮用后获得）
• CONSUMED_{物品类型} （例如 CONSUMED_COOKIE）
• CONSUMED_POTION_{药水物品类型} （例如 CONSUMED_POTION_WATER）
• CONSUMED_FOOD_OR_DRINK （任何食物或饮料消耗后都会获得此标志）

🔧命令列表

• /cali enable <true/false> - 在服务器上全局启用/禁用温度系统。
• /cali unit <celsius/fahrenheit> - 设置你偏爱的温度显示单位。
• /cali status - 显示自己的体温状态和生效中的因素。
• /cali status <玩家名> - 显示指定玩家的体温状态和因素。
• /cali immune <true/false> - 使自己免疫温度变化和效果。
• /cali immune <玩家名> <true/false> - 使指定玩家免疫温度变化和效果。
• /cali bar <true/false> - 启用/禁用自己的温度显示条。
• /cali bar <玩家名> <true/false> - 启用/禁用指定玩家的温度显示条。
• /cali barmode <status/temperature> - 切换自己温度条的显示模式（状态文字/具体温度）。
• /cali flags - 显示自己当前拥有的标志（调试用）。
• /cali reload - 重载 Caliditas 的所有 JSON 配置文件。

🔧权限节点

玩家基础权限

• caliditas.temperature - 为玩家启用温度系统。
• caliditas.user - 推荐权限，包含以下所有玩家命令权限并启用温度系统。

玩家命令权限

• caliditas.bar - 允许使用 /cali bar。
• caliditas.barmode - 允许使用 /cali barmode。
• caliditas.info - 允许查看命令帮助。
• caliditas.status - 允许使用 /cali status（查看自己）。
• caliditas.unit - 允许使用 /cali unit。

管理员权限

• caliditas.admin - 推荐管理员权限，包含所有 caliditas.user 权限及以下权限。
• caliditas.bar.other - 允许使用 /cali bar <玩家名>。
• caliditas.immune - 允许使用 /cali immune（对自己）。
• caliditas.immune.other - 允许使用 /cali immune <玩家名>。
• caliditas.flagsDebug - 允许使用 /cali flags。
• caliditas.reload - 允许使用 /cali reload。
• caliditas.status.other - 允许使用 /cali status <玩家名>。
• caliditas.switcher - 允许使用 /cali enable。

⭐开发说明

此插件最初是开发者为自己创作的，源于对这类游戏机制的喜爱，随后决定分享给社区。插件目前仍处于测试阶段，欢迎报告任何您认为需要改进的地方或提出新功能建议。插件已提供一个简单的 API 供集成。

感谢您的支持！