
饱腹
所有形式的移动现在都会消耗饥饿值,使食物成为充分利用的资源,并将每一个动作都变成生存中有意义的一部分。
FullBelly - 全面动作饥饿系统
介绍
FullBelly 是一个 Minecraft NeoForge 模组(1.21.1),添加了全面的基于动作的饥饿消耗系统。该模组追踪玩家的各种行为并自动扣除相应的饥饿值,使生存模式更具挑战性和真实感。
特性
- 全面动作覆盖:追踪 26 种不同的玩家行为
- 原版兼容:基于原版疲劳机制,与原生游戏机制完全兼容
- 调试 UI:实时 HUD 显示,展示食物水平、疲劳百分比和最近动作(仅调试模式)
- 动作记录:使用表情图标和相关动作连击检测提供视觉反馈
- 服务端处理:所有计算在服务端执行,确保不影响客户端性能
- 可配置:通过游戏内命令或配置文件切换调试模式
动作类型与消耗值
移动(9 种)
| 动作 | 基础消耗 | 描述 |
|---|---|---|
| 🚶 行走 | 0.005/刻 | 地面移动 |
| 🏃 疾跑 | 0.05/刻 | 疾跑(原版标准) |
| 🕵 潜行 | 0.005/刻 | 蹲伏移动 |
| 🏊 游泳 | 0.0075/刻 | 水中移动(原版标准) |
| 🤿 水下游泳 | 0.01/刻 | 水下憋气 |
| 🧗 攀爬 | 0.025/刻 | 梯子/藤蔓 |
| 🪽 鞘翅飞行 | 0.04/刻 | 滑翔 |
瞬时动作(3 种)
| 动作 | 基础消耗 | 描述 |
|---|---|---|
| ⬆ 跳跃 | 0.025/次 | 起跳(原版标准) |
| ⚔ 近战攻击 | 0.005/次 | 击中实体 |
| 💥 暴击 | 0.005/次 | 下落暴击 |
工具行为(4 种)
| 动作 | 基础消耗 | 描述 |
|---|---|---|
| ⛏ 挖掘 | 0.0025/方块 | 破坏方块 |
| 📦 放置 | 0.005/次 | 放置方块 |
| 🎣 钓鱼抛竿 | 0.005/次 | 抛出钓竿 |
| 🎣 钓鱼收竿 | 0.005/次 | 收线 |
战斗行为(9 种)
| 动作 | 基础消耗 | 描述 |
|---|---|---|
| 💔 受到伤害 | 0.005/次 | 任何伤害来源 |
| 🛡 格挡成功 | 0.005/次 | 盾牌成功格挡 |
| 🛡 持盾 | 0.005/刻 | 持续持盾 |
| 🏹 弓蓄力 | 0.005/刻 | 弓蓄力 |
| 🏹 弓射击 | 0.005/次 | 弓发射 |
| 🔫 弩装填 | 0.005/刻 | 弩装填 |
| 🔫 弩发射 | 0.005/次 | 弩发射 |
| 🔱 三叉戟蓄力 | 0.0075/刻 | 三叉戟蓄力 |
| 🔱 三叉戟投掷 | 0.015/次 | 三叉戟投掷 |
其他(1 种)
| 动作 | 基础消耗 | 描述 |
|---|---|---|
| 💥 坠落冲击 | 0.005/次 | 从高处落地(>3 方块) |
使用指南
安装
- 确保已安装 NeoForge 21.1.227+(Minecraft 1.21.1)
- 将
fullbelly-1.0.3.jar放入.minecraft/mods文件夹 - 启动游戏
调试模式
该模组包含内置调试模式,可显示实时 HUD 叠加层及详细信息。
游戏内命令:
/fullbelly debug - 检查当前调试模式状态
/fullbelly debug true - 启用调试模式
/fullbelly debug false - 禁用调试模式
调试 HUD 显示: 启用后,你将看到显示以下内容的叠加层:
- 🍗 食物水平:当前饥饿点数(0-20)
- ⚡ 疲劳:当前疲劳百分比(0-100%)
- 最近动作:最后 5 个动作,带表情图标和疲劳值
- 总疲劳:调试模式启用以来的累计疲劳
动作连击检测: 快速连续执行的相关动作会被分组显示:
- 绿色背景:最近的连击动作
- 红色背景:前一个连击动作
- 动作会随时间淡出
配置文件:
你还可以编辑 .minecraft/config/fullbelly-common.toml:
debug_mode = true
注意:调试模式默认禁用,以获得最佳性能。禁用时,饥饿消耗仍正常工作,但不显示 UI。
调整难度
修改 FatigueProcessor.java 中的基础值:
- 较低的值 = 简单模式
- 较高的值 = 困难模式
技术实现
核心组件
- ActionType:定义 24 种动作类型的枚举
- FatigueProcessor:核心处理器,将疲劳应用于 FoodData
- MovementHandler:使用位置追踪检测玩家移动
- ExhaustionHandler:捕获方块破坏/放置事件
- PlayerMixin:通过 Mixin 注入检测各种行为
工作原理
- 通过 Mixin 和事件系统检测玩家行为
- 调用
FatigueProcessor.dispatch()处理消耗 - 使用原版
FoodData.addExhaustion()方法应用消耗 - 当疲劳累积到 4.0 时,自动扣除 1 点食物值
兼容性
- ✅ NeoForge 21.1.229
- ✅ Minecraft 1.21.1
- ✅ 服务端/客户端均可运行
- ✅ 与其他模组无冲突
许可证
本项目基于 MIT 许可证开源。
版本:1.0.3
Minecraft:1.21.1
NeoForge:21.1.227+
最后更新:2026-05-13
更新日志
v1.0.3(2026-05-13)
- ✨ 将所有基础消耗值降低 50%,以获得更好的平衡性
- ✨ 将所有表情图标改为单字符变体,以获得更好的渲染效果
- ✨ 为调试模式添加实时 HUD 叠加层(替代聊天消息)
- ✨ 实现带视觉分组的动作连击检测
- ✨ 添加疲劳百分比显示(0-100%)
- ✨ 优化调试模式:禁用时不记录动作(防止内存泄漏)
- 🐛 修复挖掘检测以包含所有方块类型(不仅是工具可挖掘的)
- 🐛 修复连击背景透明度随文本淡出
v1.0.2(先前版本)
- 初始发布,包含全面的动作追踪
- 支持 24 种动作类型
- 服务端疲劳处理
- 带聊天输出的调试模式
详见 CHANGELOG.md 了解详细版本历史。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。