饱腹

饱腹

所有形式的移动现在都会消耗饥饿值,使食物成为充分利用的资源,并将每一个动作都变成生存中有意义的一部分。

游戏机制

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 方块)

使用指南

安装

  1. 确保已安装 NeoForge 21.1.227+(Minecraft 1.21.1)
  2. 将 fullbelly-1.0.3.jar 放入 .minecraft/mods 文件夹
  3. 启动游戏

调试模式

该模组包含内置调试模式,可显示实时 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 注入检测各种行为

工作原理

  1. 通过 Mixin 和事件系统检测玩家行为
  2. 调用 FatigueProcessor.dispatch() 处理消耗
  3. 使用原版 FoodData.addExhaustion() 方法应用消耗
  4. 当疲劳累积到 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 了解详细版本历史。