FarmLedger

FarmLedger

DONUT SMP

衡量你农场的产出，并估算升级是否值回票价。

FarmLedger 是一个客户端 Fabric 模组，用于追踪物品收集、估算游戏内利润，并比较不同农场的生产会话。选择一个物品，输入你的价格，然后开始收集。

功能特性

• 实时追踪 HUD： 查看已收集物品、每小时物品数、每小时预估利润以及目标预计完成时间。
• 命名农场配置文件： 为你的各个农场保存不同的物品、价格、成本和目标。
• 两种测量模式： 追踪地面拾取物或背包物品的正向变化。
• 精确物品匹配： 通过物品组件区分物品，包括不同种类的药水。
• 生产目标： 以单个物品或潜影盒等价物为单位设定目标。
• 会话历史： 回顾之前的运行记录，并保留其原始价格和设置。
• 升级对比： 比较收集速率，并估算一项升级需要多长时间才能回本。
• HTML 和 CSV 导出： 保存可读的报告，或在电子表格中分析你的结果。
• 本地存储： 配置文件和会话数据保存在你的游戏文件夹中。无需账户或 API 密钥。

快速上手

1. 手持你想要追踪的输出物品。
2. 按 J 键并选择 新建（New）。
3. 输入农场名称、每件物品的售价，以及每件输出物品的投入成本。
4. 选择你的测量模式和可选的生产目标。
5. 保存配置文件，然后点击 开始会话（Start session）。
6. 收集产出，然后选择 停止并保存（Stop + save） 来记录你的结果。

例如，如果三瓶药水的原料总成本为 9,000，则每瓶药水的投入成本应输入 3,000。

按键控制

按键	功能
J	打开仪表盘
F7	暂停或恢复追踪
F8	切换 HUD 显示

按键可以在 Minecraft 的控制设置中更改。你也可以使用 /farmledger 命令打开仪表盘。

理解你的结果

地面拾取（Ground pickups） 统计你从地面拾取到的匹配物品。

背包增长（Inventory gains） 统计匹配物品在背包中的数量增加，包括从箱子取出、交易和他人给予。

FarmLedger 测量的是观察到的收集量。它无法检查未打开的箱子或存放在潜影盒内的物品。丢弃、存入物品后再拾取可能会导致重复计数。在比较不同会话时，请使用一致的收集方法。

所有货币数值均为基于手动输入价格的服务器虚构货币估算值——并非确认的销售记录或真实货币收益。

升级对比功能需要两个匹配的会话，且每个会话有效活动时间至少为 60 秒。它会对两次运行都采用较晚会话的单位价格，并排除固定每小时间接费用的变化。

环境要求

• Minecraft Java 26.2
• Fabric Loader 0.19.3 或更新版本
• Fabric API 0.158.0+26.2，或专门针对 26.2 的更新版本
• Java 25 或更新版本

将 FarmLedger 和 Fabric API 安装到客户端的 mods 文件夹中。无需在服务器端安装。

发布状态与致谢

这个初始版本针对 Minecraft 26.2 编译，并已通过 46 项自动化检查。完整的游戏内验证仍在进行中。

代码和文档主要是在创作者指导下使用 OpenAI Codex 生成的。项目标志为 AI 生成的艺术作品。

非 Minecraft 官方产品。未经 Mojang 或 Microsoft 批准，亦与其无关联。