Yueyue Advancement Helper

Yueyue Advancement Helper / 月月进度辅助

An independent advancement companion by Yisibite, 1.1.0 for Minecraft 26.3. It provides creative advancement visibility, Chinese criterion names and selected bilingual variant names, plus an effects history and a timed analysis session. It works without Yueyue Modern Technology or Yueyue Auto Refill; those mods’ content, rewards and refill functions remain their own.

Usage

• Press L to open the advancement screen. 进度设置 (Advancement Settings) controls whether creative players can see all advancements. It defaults to enabled in new worlds and preserves the existing world setting. Returning to survival restores normal visibility; this display option never grants advancements or experience.
• 效果纪录 (Effects Record) and 进度设置 are available in the vanilla screen, supported Advancements Reloaded and Better Advancements screens. The inline detailed criterion checklist integrates with Advancements Reloaded 0.15.0; that optional checklist integration is absent when its provider is not installed. Basic settings and effect records remain available without it.
• In supported Advancements Reloaded, click an advancement to inspect its individual criteria. Food, breeding and other lists follow the current advancement/data-pack requirements. Selected cat, wolf and frog variants display Chinese (English) names.
• Open 效果纪录 to select How Did We Get Here? or A Furious Cocktail. The initial view shows the historical best simultaneous record collected since installation. Choose 开始记录当前 (Start Current Recording), then 停止记录 (Stop Recording) to inspect a new attempt. Each session stops automatically after five minutes; closing the page keeps recording, and the screen does not pause a singleplayer world.
• Results use the best single moment in that session. 同时获得 means present together in that moment; 错过重叠 means the effect satisfied its conditions during the session but missed that best moment; 条件不足 means it appeared without satisfying the advancement predicate; 从未获得 means it never appeared during the session. Separate moments are never combined into advancement success. You can switch between required effects and all effects at the recorded moment. History from before installation cannot be recovered; record again after changing predicates/data packs.
• Legacy commands remain available: /Yisibite creativeAdvancements true|false and /Yisibite 创造进度 true|false; omit the boolean to query. Changing the world setting requires the singleplayer owner in the UI or administrator permission; command changes require administrator permission. Multiplayer recording and creative visibility require this mod on the logical server, and the companion UI requires it on the client.

The mod also provides general Better Advancements category position, clicking and background compatibility fixes. These general advancement functions moved from Yueyue Auto Refill and Modern Technology into this companion; existing world settings are retained.

中文介绍与操作

月月进度辅助 1.1.0独立提供通用进度功能，不依赖月月现代科技或补货。内容模组自身的进度树和奖励、补货模组的物品补充仍各自负责。

• 创造查看全部进度：按 L 打开进度页，点击顶部 进度设置。新存档默认开启，旧世界沿用原开关；仅扩展创造模式可见范围，不授予进度或经验。切回生存恢复正常显示。
• 入口与可选界面：原版、受支持的 Advancements Reloaded 和 Better Advancements 页面都提供 进度设置、效果纪录。内联侧栏的逐项累计条件详情需要 Advancements Reloaded 0.15.0；未安装时不提供这项集成，基础设置和效果记录仍可使用。
• 累计条件：配合受支持的 Advancements Reloaded，点击进度查看每项条件的完成情况，例如还差哪些食物或动物种类。提供中文条件，猫、狼、青蛙等部分变体采用中文（English）；具体条件来自当前进度与数据包。
• 效果纪录：按 L 点击 效果纪录，选择“为什么会变成这样呢”或“狂乱的鸡尾酒”，默认查看安装后留下的历史最多同时纪录。点击 开始记录当前 后变成 停止记录，每次最多 5 分钟，到时自动停止；关闭页面仍继续记录，界面不暂停单人世界。可切换查看所需效果或最佳时刻的全部效果。
• 状态含义：显示本次最佳同一时刻。“同时获得”指该时刻满足；“错过重叠”指本次曾符合条件，但最佳时刻缺少；“条件不足”指曾出现却未满足成就谓词；“从未获得”指本次未出现。先后效果不会拼成一次成就成功。安装前历史无法追溯，修改谓词或数据包后应重新记录。
• 指令与权限：兼容 /Yisibite creativeAdvancements true|false 和 /Yisibite 创造进度 true|false，省略布尔值查询。界面修改需要存档主人或管理员权限，指令修改需要管理员权限。多人效果记录和创造可见性需服务端安装，辅助界面需客户端安装。

本模组还承担 Better Advancements 栏目位置、点击及背景兼容修复。通用进度显示功能已从补货及现代科技迁入此模组，旧世界设置保持。

Runtime and dependencies

• Minecraft 26.3 / Java 25 / Fabric Loader 0.19.5+.
• Fabric API required.
• Client needed for companion UI; logical server needed for recording and creative visibility.
• Advancements Reloaded and Better Advancements are optional integrations.

Complete corresponding source and build instructions are attached separately.

Credits and references

Original companion by Yisibite. Uses Advancements Reloaded screen/config APIs by 42atomys and contributors (MIT), and Fabric API networking/screen events. The original Advancements Reloaded JAR is not bundled or replaced. Minecraft criteria, variants and effect rules belong to Mojang and respective mod authors.

• Advancements Reloaded: Optional UI API (MIT, installed metadata)
• Fabric API: Networking/screen/lifecycle API

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.

Additional compatibility reference: Better Advancements. No upstream dependency classes or JARs are bundled.