## 2.2.1 — 2026-07-18 ### 简体中文 #### 调整 - HUD 选择页的默认快捷键由 `F9` 改为 macOS `Left Option + B` / Windows `Left Alt + B`；`B` 仍可在 Minecraft 按键设置中重绑，左侧修饰键固定。 - 射钉枪锚定后按当前跳跃键（默认 `Space`），现在会丢弃原有动量并沿钢索方向直线拉向锚点；遮挡、碰撞、到达和停滞释放保护保持不变。 - 探矿强化的方向箭头、距离和高度提示由屏幕正上方移至右上角，并按当前文本宽度与 GUI Scale 保持右边距。 #### 修复 - 修复水魂充能耗尽后，玩家站在水下实体方块上会被误判为离水并开始恢复的问题。 - 修复少量恢复的水魂充能会在水下重新启用水面行走、导致玩家无法正常游泳上浮的问题。 - 穿水魂鞋在水面行走时，按住当前潜行键（默认 `Shift`）现在可以主动下潜。 #### 质量与兼容性 - 新增水魂海底充能、潜行下潜、浸没游泳和射钉枪直线牵引回归，Dedicated Server GameTest 增至 37 项。 - 不涉及强化数值、配方、Registry ID、存档结构或网络协议变化，可直接从 `2.2.0` 升级。为避免旧 `F9` 配置覆盖新默认值，HUD 使用新的按键设置项；曾自定义旧 HUD 主键的玩家需要重新设置一次。 需要 Minecraft `1.21.3`、Java `21+`、Fabric Loader `0.18.4+` 和 Fabric API `0.114.1+1.21.3`。 ### English #### Changed - Changed the default HUD selection shortcut from `F9` to `Left Option + B` on macOS / `Left Alt + B` on Windows. `B` remains rebindable in Minecraft Controls; the left modifier is fixed. - After attaching the Nail Gun, pressing the current jump key (`Space` by default) now discards existing momentum and pulls straight toward the anchor along the cable. Obstruction, collision, arrival, and stall-release protections remain intact. - Moved the Ore Seeker direction arrow, distance, and vertical hint from the top center to the upper-right corner, with a stable right margin across text widths and GUI scales. #### Fixed - Fixed depleted Water Soul charge starting to recover while the player was still underwater but standing on a solid block. - Fixed a small amount of recovered Water Soul charge re-enabling surface walking underwater and preventing normal swimming or ascent. - Holding the current sneak key (`Shift` by default) while surface-walking with Water Soul boots now allows the player to dive. #### Quality and compatibility - Added Water Soul seabed-charge, sneak-dive, submerged-swimming, and Nail Gun straight-pull regression coverage, bringing the Dedicated Server suite to 37 GameTests. - No enhancement values, recipes, registry IDs, save schema, or network protocol changed. Worlds can upgrade directly from `2.2.0`. The HUD uses a new Controls entry so a saved legacy `F9` value cannot override the new default; players who customized the old HUD binding must configure it once again. Requires Minecraft `1.21.3`, Java `21+`, Fabric Loader `0.18.4+`, and Fabric API `0.114.1+1.21.3`.

## 简体中文 ### 新功能 - 强化物品现在会按最高适用强化显示独立轮廓光：I 阶蓝色、II 阶紫色、III 阶粉色、IV 阶橙色。 - 同一阶内从 1 到 10 级逐步增加轮廓宽度与强度，让长期强化成长更直观。 - 轮廓只覆盖物品剪影外侧，不修改原贴图、本体颜色、明暗或原版附魔 glint，也不会照亮周围环境。 - 背包、热栏和第一人称手持已完成实机验证；第三人称、掉落物和展示框使用同一物品渲染路径，仍在兼容验收。 ### 质量与兼容性 - 新增 Alpha-only 轮廓 Shader、Shader 发布资源门禁，以及四阶颜色和阶内强度规则测试。 - Dedicated Server GameTest 扩充至 35 项，正式构建继续校验中英文 translation key 和发布 JAR 边界。 - 不修改强化数值、配方、Registry ID、存档结构或网络协议，可直接从 2.1.1 升级。 - 穿在身上的盔甲暂不显示这层轮廓；多人游戏仍需要客户端与服务端安装相同版本的 Magic。 ## English ### New - Enhanced items now receive a separate silhouette halo based on the strongest applicable enhancement: Tier I blue, Tier II purple, Tier III pink, and Tier IV orange. - Halo width and intensity rise from level 1 to 10 within each tier, making long-term gear progression easier to read. - The halo covers only the outside of the item silhouette. It does not alter the original texture, item color, lighting, or vanilla enchantment glint, and it does not illuminate the environment. - Inventories, hotbars, and first-person hands have been verified in a real client. Third-person hands, dropped items, and item frames use the same item-rendering path and remain under compatibility validation. ### Quality and compatibility - Added an alpha-only outline shader, release-JAR shader resource gates, and regression coverage for all four colors and every within-tier intensity step. - The Dedicated Server suite now contains 35 GameTests, while release builds continue to verify English/Chinese translation parity and JAR isolation. - No balance, recipe, registry ID, save schema, or network protocol changes. Worlds can upgrade directly from 2.1.1. - Worn armor does not yet receive this outline. Multiplayer still requires matching Magic versions on client and server. ## 安装要求 / Requirements Minecraft 1.21.3 · Java 21+ · Fabric Loader 0.18.4+ · Fabric API 0.114.1+1.21.3 下载主运行 JAR（不要安装 sources JAR），并在多人游戏的客户端与服务端使用相同版本。 Download the primary runtime JAR (not the sources JAR) and use matching versions on multiplayer clients and servers.

## 简体中文 ### 修复 - 修复强化台进入客户端渲染范围时立即闪退的问题。星环与成功能量特效现在按正确的 RenderLayer 缓冲区生命周期顺序绘制。 ### 兼容性 - 不涉及数值、配方、Registry ID、存档结构或网络协议变化，可直接从 2.1.0 升级。 - 多人游戏仍需要客户端与服务端安装相同版本的 magic。 ## English ### Fixed - Fixed an immediate client crash when a Strengthening Table entered render range. Astral rings and success-energy effects now render in the correct RenderLayer buffer lifecycle order. ### Compatibility - No balance, recipe, registry ID, save schema, or network protocol changes. Worlds can upgrade directly from 2.1.0. - Multiplayer still requires matching magic versions on client and server. Minecraft 1.21.3 · Java 21+ · Fabric Loader 0.18.4+ · Fabric API 0.114.1+1.21.3

## Magic 2.1.0 — Minecraft 1.21.3 / Fabric - Added the original Astral Strengthening Table: custom model and textures, three animated rings, displayed slots, and synchronized success feedback. - Completed the four-tier, 40-level progression for 12 stackable weapon, tool, and armor enhancements. - Hardened server-authoritative multiplayer combat, ranged snapshots, Water/Fire Soul persistence, and the Nail Gun state machine. - Added player-selected HUD and ore targets with English and Simplified Chinese language switching. - Added 34 Dedicated Server GameTests, translation-key parity checks, and original-visual-resource validation. ### Requirements Minecraft 1.21.3, Java 21+, Fabric Loader 0.18.4+, and Fabric API 0.114.1+1.21.3+. Install the same Magic version on client and server for multiplayer.