Yueyue Auto Refill

Version 1.4.4 for Minecraft 26.3. Refills a consumed main/off-hand stack from inventory, carried shulker boxes, ender chest, then shulker boxes in the ender chest. Matches item components and handles totems separately. Optional low-durability protection swaps supported equipment with a spare and pauses unsafe use when no spare exists. Carpet fake players are optional; audited GCA coexistence avoids duplicate handling while this mod owns their refill action.

All four refill/protection switches start off in new worlds; existing settings are retained. Server commands use /Yisibite, with administrator permission for changes. Optional quick settings use configurable N+C and require MaLiLib on the client plus Fabric API networking on both sides. Base commands/refill do not need Fabric API.

Install server-side for multiplayer inventory/ender-chest access. Client-only installation cannot control a remote server. The optional client UI is not required for command use. Since 1.4.4, creative advancement visibility and its compatible existing settings/commands are provided by Yueyue Advancement Helper 1.1.0. This refill mod no longer supplies general advancement features.

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

English operation guide

• Ordinary refill triggers when the last item in the main or off hand is consumed by placement, eating, throwing or interaction. It does not refill a partially used ordinary stack early; dropping a stack, moving it manually or selecting an empty slot is not a trigger. Refill supplies only the amount available in the configured inventory sources.
• Ordinary stacks match complete item components. Totem refill is a separate switch: after a totem prevents lethal damage, it places a spare in that hand during the same damage handling, retaining the spare's data.
• Supported vanilla diamond/netherite equipment warns at 10 or less remaining durability and swaps at 5 or less, preserving the old equipment. A spare must be the same item type with more than 10 durability; matching enchantments are preferred before different enchantments. Without an eligible spare, protection blocks further damage to that equipment and warns you; armor protection does not prevent all player damage.
• Press the configurable N+C shortcut for the four quick settings, or use the MaLiLib page entry. It requires client MaLiLib and the Fabric API networking modules on client and logical server. The server checks permission and saves per-world switches. Missing the optional client MaLiLib/networking components hides the quick-settings entry; if only the server lacks networking, the page cannot synchronize/change world modes and directs you to server commands. Base commands and refill remain usable.
• Commands: /Yisibite buhuo all true|false, /Yisibite buhuo jiaren true|false, /Yisibite tutengbuhuo true|false, /Yisibite buhuobaogongju true|false. Omit the boolean to query; administrator permission is required to change them. All-player ordinary refill includes fake players; the fake-player switch can enable only their ordinary refill independently. Totem refill is independent of the ordinary-refill switches. Durability protection additionally requires the player to be covered by all=true, or by jiaren=true when that player is a Carpet fake player, as well as buhuobaogongju=true; it does not operate in creative/spectator mode.
• Carpet enables fake-player support; without Carpet there is no fake-player integration. Audited GCA coexistence avoids duplicate handling for actions owned by this mod. Switching this mod off does not switch off GCA's own features.

中文使用说明

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

• 主手 / 副手最后一份物品因放置、进食、投掷或交互被消耗后，从 背包 → 背包内潜影盒 → 末影箱 → 末影箱内潜影盒 补充，库存不足则补实际数量。丢弃、手动挪走、换空槽不会触发；普通物品已有剩余时不提前填满。
• 堆叠物匹配完整组件；备用耐久装备必须为同种物品且剩余耐久大于 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 自身功能。多人必须安装在服务端，客户端不能直接读取远程服务器末影箱。

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

Runtime and dependencies

• Minecraft 26.3 / Java 25 / Fabric.
• Client: Optional for base refill; needed for quick-settings UI
• Server: Required on logical server; dedicated supported
• carpet: optional — Fake players
• gca: optional — Audited coexistence hooks
• malilib: optional — Client quick settings
• fabric-api: optional — Client/server quick-settings networking; base refill works without API

Complete corresponding source and build instructions are attached separately.

Credits and references

Implementation by Yisibite. Uses MaLiLib by masa/maintainers for optional UI, Fabric Carpet by gnembon/contributors for fake players and GCA by Gu-ZT/contributors for coexistence hooks. The source documentation records an Auto Refill 26.1.2 reference JAR as behavioral inspiration; its precise upstream identity is not established in this release. This is not a claim of source reuse. No upstream dependency JAR/classes are bundled.

• MaLiLib: Optional UI API (LGPLv3)
• Fabric Carpet: Optional fake-player API (MIT)
• Gugle Carpet Addition: Optional coexistence targets (MIT)

Original Yueyue code by Yisibite, with AI assistance. Source REFERENCES.md, THIRD_PARTY_NOTICES.md and any text-source ledger identify upstream material separately. No upstream dependency is represented as Yueyue-owned or relicensed by the original-code license.

Original-code license

This project had no existing open-source license declaration. This publication retains All Rights Reserved for Yisibite's original code; source availability does not grant an additional MIT license. Separate upstream projects retain their own licenses.

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