月月自动补充

月月自动补充

服务端权威的手部与图腾补货、潜影盒/末影箱补给、耐久保护、可选Carpet假玩家与快速设置。

月月补货 / Yueyue Auto Refill

版本 1.4.5,适用于 Minecraft 26.3。当主手/副手物品被消耗后,会依次从背包、随身潜影盒、末影箱、末影箱内潜影盒中补充。匹配物品组件,并单独处理图腾。可选的耐久保护会在装备耐久过低时将其与备用装备交换;若无备用装备,则暂停该装备的不安全使用。Carpet 假人为可选项;GCA 兼容可避免重复处理,同时由本模组负责其补货操作。

所有四个补货/保护开关在新世界中默认关闭;已有设置保持不变。服务器指令使用 /Yisibite,修改设置需要管理员权限。可选快速设置使用可配置的 N+C 快捷键,需要客户端安装 MaLiLib,并在双方安装 Fabric API 网络模块。基础指令/补货不需要 Fabric API。

多人游戏中需在服务端安装,以访问背包/末影箱。仅客户端安装无法控制远程服务器。指令使用不要求安装可选客户端 UI。自 1.4.4 起,创造模式进度可见性及其兼容的现有设置/指令由 Yueyue Advancement Helper 1.1.0 提供。本补货模组不再提供通用进度功能。

中文:背包→背包潜影盒→末影箱→末影箱潜影盒补货,支持图腾和低耐久保护,可选支持Carpet假人与GCA共存。新存档四项补货/保护默认关闭,旧设置保持。指令无需Fabric API;N+C页面需客户端MaLiLib和双方网络模块。多人需服务端安装。

在 1.4.5 中,补货会在提取物品前同步已打开的 QuickShulker 随身潜影盒,包括图腾和低耐久装备替换。光标物品会保留。已有设置不变。

英文操作指南

  • 普通补货会在主手或副手的最后一份物品因放置、进食、投掷或交互而被消耗时触发。它不会提前补满已部分使用的普通堆叠;丢弃整组物品、手动移动物品或选择空槽位均不会触发。补货仅提供所配置物品来源中可用的数量。
  • 普通堆叠会匹配完整物品组件。图腾补货是独立开关:图腾阻止致命伤害后,会在同一次伤害处理中向该手放置一个备用图腾,并保留备用图腾的数据。
  • 支持的原版钻石/下界合金装备会在剩余耐久 10 或更低 时警告,并在 5 或更低 时交换,同时保留旧装备。备用装备必须是相同物品类型且耐久高于 10;优先匹配相同附魔,其次才是不同附魔。若无符合条件的备用装备,保护会阻止该装备继续受损并警告你;护甲保护并不能阻止所有玩家伤害。
  • 按下可配置的 N+C 快捷键可打开四项快速设置,也可使用 MaLiLib 页面入口。这需要客户端安装 MaLiLib,并在客户端与逻辑服务端安装 Fabric API 网络模块。服务器会检查权限并按世界保存开关。缺少可选客户端 MaLiLib/网络组件时会隐藏快速设置入口;若仅服务端缺少网络模块,页面无法同步/修改世界模式,并会提示你使用服务器指令。基础指令和补货仍可使用。
  • 指令:/Yisibite buhuo all true|false、/Yisibite buhuo jiaren true|false、/Yisibite tutengbuhuo true|false、/Yisibite buhuobaogongju true|false。省略布尔值可查询;修改需要管理员权限。所有玩家的普通补货包含假人;假人开关可独立仅启用其普通补货。图腾补货独立于普通补货开关。耐久保护还要求玩家被 all=true 覆盖,或当该玩家为 Carpet 假人时被 jiaren=true 覆盖,并且 buhuobaogongju=true;它不会在创造/旁观模式下生效。
  • Carpet 启用假人支持;无 Carpet 则没有假人集成。GCA 兼容会避免对由本模组负责的操作重复处理。关闭本模组不会关闭 GCA 自身功能。

1.4.5 修复了已通过 QuickShulker 打开的随身潜影盒在补货时可能重复取料的问题;图腾补货、低耐久装备替换同样会先同步容器,并保留光标物品。已有设置保持。

中文使用说明

月月补货 1.4.5提供普通补货、假人补货、图腾即时补货和低耐久保护。新存档四项默认关闭,已有存档保留原设置。

  • 主手 / 副手最后一份物品因放置、进食、投掷或交互被消耗后,从 背包 → 背包内潜影盒 → 末影箱 → 末影箱内潜影盒 补充,库存不足则补实际数量。丢弃、手动挪走、换空槽不会触发;普通物品已有剩余时不提前填满。
  • 堆叠物匹配完整组件;备用耐久装备必须为同种物品且剩余耐久大于 10,先找相同附魔,再考虑不同附魔。图腾挡下致命伤后,在同一次伤害处理中向消耗的手补一个备用图腾,保留备用图腾本身数据。
  • 开启保护后,支持的原版钻石 / 下界合金耐久装备剩余耐久不高于 10 时提醒,到 5 时用合格备用交换并保留旧装备。无备用时阻止继续损坏该装备;护甲保护不等于玩家免伤。
  • 同时按可重绑定的 N+C 打开四项快速设置,也可通过 MaLiLib 页面入口。快速设置需要客户端 MaLiLib 及双方所需 Fabric API 网络模块,服务端校验权限并保存。客户端缺少 MaLiLib / 网络模块时隐藏快速设置入口;只有服务端缺网络模块时,页面不能同步或修改世界模式,会提示使用服务端指令。基础指令及补货本身无需 Fabric API。
  • 管理指令:/Yisibite buhuo all true|false、/Yisibite buhuo jiaren true|false、/Yisibite tutengbuhuo true|false、/Yisibite buhuobaogongju true|false;省略布尔值可查询。修改需要管理员权限,图腾开关独立于普通补货。耐久保护除开启 buhuobaogongju 外,还要求该玩家受 all=true 覆盖,或是假人且 jiaren=true;创造 / 旁观模式不执行耐久保护。
  • Carpet 是可选前置,安装后支持假人;与已适配 GCA 共存,接管对应假人时避免重复补货。关闭本模组功能不会连带关闭 GCA 自身功能。多人必须安装在服务端,客户端不能直接读取远程服务器末影箱。

创造查看进度已迁至月月进度辅助,本模组只保留补货和装备保护,不需要为了普通补货额外安装进度辅助。

运行环境与依赖

  • Minecraft 26.3 / Java 25 / Fabric。
  • 客户端:基础补货可选;快速设置 UI 需要
  • 服务端:逻辑服务端必需;支持专用服务器
  • carpet:可选 — 假人
  • gca:可选 — 兼容挂钩
  • malilib:可选 — 客户端快速设置
  • fabric-api:可选 — 客户端/服务端快速设置网络;基础补货无需 API

对应的完整源代码与构建说明另行附上。

致谢与参考

实现由 Yisibite 完成。可选 UI 使用 masa/维护者开发的 MaLiLib;假人功能使用 gnembon/贡献者开发的 Fabric Carpet;共存挂钩使用 Gu-ZT/贡献者开发的 GCA。源文档记录了一个 Auto Refill 26.1.2 参考 JAR 作为行为灵感;本版本未确认其精确上游身份。这不表示复用其源代码。未捆绑任何上游依赖 JAR/类。

Yueyue 原创代码由 Yisibite 编写,并有人工智能协助。源文件 REFERENCES.md、THIRD_PARTY_NOTICES.md 及任何文本源台账会单独标明上游材料。任何上游依赖均未被表示为 Yueyue 所有,也不受原创代码许可证重新授权。

原创代码许可证

本项目此前没有开源许可证声明。本次发布对 Yisibite 的原创代码保留所有权利;源代码可见不额外授予 MIT 许可证。独立的上游项目保留其各自许可证。

中文更新:1.4.4 起,创造查看全部进度和通用进度设置已迁入月月进度辅助 1.1.0,补货页面只保留四项补货/保护设置。