SimpleHunger

简易饥饿系统

简易饥饿系统为 Hytale 添加了一个轻量级的生存机制层，包含饥饿、口渴、食物价值、饮水价值以及一个紧凑的径向 HUD。

该模组为服务器构建了一个简洁的替代式生存系统，使服务器无需依赖旧的 HUD 路由设置即可拥有食物和饮水玩法。它还提供了一个小型兼容 API，使其他模组能够读取或修改饥饿和口渴值。

功能特性

• 饥饿值会随时间降低。
• 口渴值会随时间降低。
• 食物物品根据可配置的价值恢复饥饿值。
• 饮水物品根据可配置的价值恢复口渴值。
• 内置对生食和熟食价值的支持。
• 对瓶子及其他饮水物品提供直接的配置饮水处理。
• 便携式简易饥饿水壶物品。
• 用于显示饥饿和水分状态的紧凑垂直径向 HUD。
• 饥饿、濒死、口渴、脱水、饱食和水合状态效果。
• 可选的睡觉时暂停功能。
• 可选的闲置暂停功能。
• 可选的基于生物群系的饥饿和口渴修正。
• 供其他模组使用的简单兼容 API。

HUD

简易饥饿系统使用其自身的现代 HUD 入口：

simplehunger.survival.hud

默认的 HUD 显示两个小型径向指示器：

• 鸡腿图标用于表示饥饿值
• 水滴图标用于表示口渴值

HUD 位于普通游戏 UI 上方的左下角区域附近。具体的 UI 布局存储在：

Common/UI/Custom/HUD/SimpleHunger/SystemHud.ui

配置

模组在服务器首次启动后会创建其配置文件。安装模组后，重启一次服务器，然后编辑生成的配置文件。

主要配置文件：

HungerConfig.json
Foods.json
Drinks.json
BiomeModifiers.json

各文件的用途：

• HungerConfig.json 控制最大饥饿值、最大口渴值、衰减速率、饥饿伤害、口渴伤害、阈值、睡眠暂停、闲置暂停以及饱食设置。
• Foods.json 控制每种食物物品恢复多少饥饿值。
• Drinks.json 控制每种饮水物品恢复多少口渴值。
• BiomeModifiers.json 控制可选的生物群系对饥饿和口渴衰减的倍率。

命令

/sh

显示简易饥饿的命令帮助。

/shconfig

打开游戏内的配置/数值页面。

/shversion

显示已安装的简易饥饿系统版本和 HUD 模式。

食物和饮水价值

食物和饮水价值按物品 ID 进行配置。

示例行为：

• 熟食恢复更多饥饿值
• 生食可以恢复较少的量
• 浆果可以恢复少量饥饿值
• 装满的水壶可以恢复口渴值

服务器所有者可以在 Foods.json 和 Drinks.json 中添加或修改数值，而无需重建模组。

兼容性

简易饥饿系统暴露了：

com.simplehunger.api.SimpleHunger

其他模组可以通过正常的 Java 访问或反射使用此 API 来：

• 读取饥饿值
• 设置饥饿值
• 增加饥饿值
• 读取口渴值
• 设置口渴值
• 增加口渴值
• 注册食物价值
• 注册饮水价值

这旨在供诸如吸血鬼或狼人系统等种族/职业/玩法模组使用，这些模组需要替换或修改正常的饮食行为。

安装

将 jar 文件复制到 Hytale 用户模组文件夹中：

~/Library/Application Support/Hytale/UserData/Mods

然后重启游戏/服务器。

版本支持

此版本面向 Hytale 服务器版本：

>=0.6.0 <0.7.0

已在安装的 Hytale 0.6.x 运行时上测试。