Changelog

[0.0.10] - 2026-08-09

本节完整列出 0.0.9 → 0.0.10 的用户可见变化。

简体中文

新增与兼容

• 新增可选 Mekanism 化学品容器与仙窍终端的双向交互。阶段 8 及以上可右键手持已装容器将化学品存入仙窍，左键点击已选中的化学品条目并手持空容器取出化学品；操作遵循流体/流体容器的容器驱动语义。
• 化学品容器事务由服务端负责：校验实时菜单、阶段 8 外部资源权限、菜单 revision、化学品频道/注册表身份，并使用模拟、执行、返回容器与存储回滚处理，支持堆叠容器而不产生半完成转移。
• Mekanism 类仅位于可选兼容边界；未安装 Mekanism 时公共终端、网络和存储代码仍可加载，安装后才注册化学品容器能力桥。
• 补充双语帕秋莉古玉手册的缺失内容：新增仙窍管理器章节，扩展世界碎片开采器/聚宝盆的 27 格缓存、2400 刻战利品周期与数据包规则，并同步补充终端、源方块、仙窍接口、AE2/RS、可选联动和三类灵剑系数说明。
• 手册条目树契约现在检查中英文资源的结构一致性、JSON 合法性，以及新增系统与关键规则均已进入随 JAR 内置的 Patchouli 手册。

优化与界面

• 统一三类灵剑的淬火系数来源：一气归元剑为 0%/淬火点，普通灵剑为 1%/淬火点，仙墟锻灵剑为 1.5%/淬火点；Tooltip 预览、标准主手攻击属性和战斗计算使用同一剑型规则。
• 仙窍存储的整理、全部存入、按筛选取出三个 8×8 操作按钮移动到存储网格与玩家背包之间的空隙，并保持原版背包槽和外部整理器识别契约。
• 仙窍管理时间流速改为居中的 - 数值 + 对称布局：标题独立居中，数值位于两个调速按钮之间，白天/天气控制保持在下一行。
• 时间流速标题和数值改用显式关闭阴影的原版文字绘制路径，消除截图中的文字重影并保持像素字体清晰。

修复

• 修复一气归元剑 Tooltip 将每点淬火误显示为 1% 的问题；现在显示并使用 0%/淬火点。
• 修复仙墟锻灵剑 Tooltip 将每点淬火误显示为 1% 的问题；现在显示并使用 1.5%/淬火点，普通灵剑仍为 1%。
• 修复仙墟锻灵剑的 1.5% 淬火系数因浮点转换显示为 1.49999……% 的问题；Tooltip 百分比现在最多保留两位小数，并自动去除无意义的尾零。
• 固定外部资源阶段边界常量，避免能量、化学品、魔力和工业先锋灵魂等频道在阶段不足时通过不同入口出现不一致权限。

支持范围、验证与发布

• 版本更新为 0.0.10；构建基线为 Minecraft 1.21.1、NeoForge 21.1.235、Java 21，正式 NeoForge 支持范围扩展为 [21.1.235,21.2)，网络协议保持 8。
• 已采纳并合并 PR #2 与 PR #3：JEI 基线为 19.27.0.343，Refined Types 接受 0.3.x/1.21.1-0.3.x，并以 [21.1.235,21.2) 关闭 Issue #1；对应版本清单、适配器描述和 JAR 元数据保持一致。
• 兼容范围在 NeoForge 21.1.236 与 21.1.248 上分别执行 clean test，每次均为 724 tests / 0 failures / 0 errors / 0 skipped；正式 21.1.235 基线完整门禁同样通过。
• 以合并后 0.0.10 JAR 在 35 模组临时客户端中分别启动 Sodium 0.8.12-alpha.4 与 Embeddium 1.0.15 栈，并加入 ModernFix 5.27.20、FerriteCore 7.0.3、ImmediatelyFast 1.6.11、Entity Culling 1.10.5；两次均完成 NeoForge 客户端启动、资源重载、声音引擎初始化和 ImmortalStorage 可选联动注册，无优化模组或仙藏崩溃。
• Sodium 与 Embeddium 分别作为二选一渲染后端验证，不能同时安装；生产 JAR 静态检查未发现 Sodium、Embeddium、Rubidium、Lithium、FerriteCore、ModernFix、ImmediatelyFast、Entity Culling、Iris、Oculus、Starlight 或相关优化 Mixin 的类名、引用或目标，仙藏继续只依赖标准 Minecraft/NeoForge 渲染入口。上述为启动、资源重载、声音引擎和联动注册烟测，不替代逐项玩法/UI 实机回归。
• 合并来源为 PR #2（合并提交 310a857ee624ed29b3f9f5fa75a08ca0d9431e72）与 PR #3（合并提交 670b0968e00c951272418f1f0904c45e262bc8ec）；Issue #1 已关闭并标记为完成。
• 最终重发状态为提交 13f896c85a45ca55fc9ac846fda6ac2a9aefd5da、标签 0.0.10 和 GitHub Release 0.0.10。制品 immortalstorage-neoforge-mc1.21.1-nf21.1.235-0.0.10.jar 大小为 5,163,055 字节，SHA-256 为 EA09A8493367E4E05A4C04D520FCB6E74EBF6409DC103E5BE0A4AE2ACD6564B4；远端重新下载哈希与本地干净构建完全一致。
• 完整门禁包含 test、build、Ars Source API、无 AE2 运行时、生产 JAR 边界、版本组成和精确版本产物检查，结果为 199 suites / 724 tests / 0 failures / 0 errors / 0 skipped。

English

This section is the complete user-visible delta from 0.0.9 to 0.0.10.

Added and compatibility

• Added optional Mekanism chemical-container interaction with the Xianqiao terminal. From stage 8 onward, right-clicking with a filled container deposits its chemical into Xianqiao, while left-clicking a selected chemical entry with an empty container withdraws it; the interaction follows the existing fluid/container model.
• Made the chemical-container transaction server-authoritative: it validates the live menu, stage-8 external-resource access, menu revision, chemical channel/registry identity, and uses simulate, execute, returned-container handling, and storage rollback to support stacked containers without partial transfers.
• Kept Mekanism classes behind the optional compatibility boundary. Common terminal, network, and storage code remains loadable without Mekanism; the chemical-container hook is installed only when Mekanism is present.
• Expanded the bilingual Patchouli Ancient Jade handbook with a dedicated Xianqiao Manager chapter, World Shard Miner/Treasure Basin 27-slot cache, 2400-tick loot cycle and datapack rules, plus deeper terminal, Source Vein, Xianqiao Interface, AE2/RS, optional-integration, and sword-coefficient guidance.
• Handbook contracts now enforce bilingual entry-tree parity, valid JSON, and inclusion of the new systems and key rules in the bundled Patchouli handbook.

Improvements and interface

• Unified all three sword tempering coefficient sources: One-Qi Returning Origin Sword 0%/tempering point, ordinary Spirit Sword 1%/tempering point, and Immortal-Ruin-Forged Spirit Sword 1.5%/tempering point. Tooltip previews, standard main-hand attributes, and combat calculations now use the same item-specific rule.
• Moved the three Xianqiao storage 8×8 sort, deposit-all, and filtered-withdraw buttons into the gap between the storage grid and player inventory while preserving vanilla player slots and external sorter recognition.
• Reworked realm time flow into a centered symmetric - value + row: the title is centered separately, the value sits between the two controls, and day/weather controls remain on the following row.
• Switched the time-flow title and value to the explicit no-shadow vanilla text-rendering overload, removing the visible ghosting while retaining the pixel-font layout.

Fixed

• Fixed the One-Qi Returning Origin Sword tooltip showing 1% per tempering point; it now shows and uses 0%/tempering point.
• Fixed the Immortal-Ruin-Forged Spirit Sword tooltip showing 1% per tempering point; it now shows and uses 1.5%/tempering point; the ordinary Spirit Sword remains at 1%.
• Fixed the Immortal-Ruin-Forged Spirit Sword 1.5% tempering coefficient being rendered as 1.49999…% after floating-point conversion; tooltip percentages now use at most two decimal places and trim insignificant trailing zeroes.
• Centralized the external-resource stage boundary so energy, chemicals, mana, Industrial Foregoing souls, and similar channels cannot expose inconsistent access through separate entry points below their unlock stage.

Support, verification, and release

• Bumped the version to 0.0.10; the build baseline is Minecraft 1.21.1, NeoForge 21.1.235, and Java 21, while the official NeoForge support range is now [21.1.235,21.2), with network protocol 8 unchanged.
• Accepted and merged PR #2 and PR #3: JEI is based on 19.27.0.343, Refined Types accepts 0.3.x/1.21.1-0.3.x, and [21.1.235,21.2) closes Issue #1; the supported-version manifest, adapter descriptor, and JAR metadata stay aligned.
• The compatibility range passed clean test separately on NeoForge 21.1.236 and 21.1.248, with 724 tests / 0 failures / 0 errors / 0 skipped each time; the formal 21.1.235 baseline also passed the complete gate.
• The merged 0.0.10 JAR started in two 35-mod temporary clients: a Sodium 0.8.12-alpha.4 stack and an Embeddium 1.0.15 stack, each also using ModernFix 5.27.20, FerriteCore 7.0.3, ImmediatelyFast 1.6.11, and Entity Culling 1.10.5. Both reached NeoForge client startup, resource reload, sound-engine initialization, and ImmortalStorage optional-integration registration without an optimization-mod or ImmortalStorage crash.
• Sodium and Embeddium were tested as mutually exclusive renderer backends; they must not be installed together. Static inspection of the production JAR found no Sodium, Embeddium, Rubidium, Lithium, FerriteCore, ModernFix, ImmediatelyFast, Entity Culling, Iris, Oculus, Starlight, or related optimization-mixin class names, references, or targets. ImmortalStorage continues to use standard Minecraft/NeoForge rendering entry points. This covers startup, resource reload, sound-engine, and integration-registration smoke checks rather than every gameplay/UI path.
• The merged sources are PR #2, merge commit 310a857ee624ed29b3f9f5fa75a08ca0d9431e72, and PR #3, merge commit 670b0968e00c951272418f1f0904c45e262bc8ec; Issue #1 is closed as completed.
• The final republish is commit 13f896c85a45ca55fc9ac846fda6ac2a9aefd5da, tag 0.0.10, and GitHub Release 0.0.10. The artifact immortalstorage-neoforge-mc1.21.1-nf21.1.235-0.0.10.jar is 5,163,055 bytes with SHA-256 EA09A8493367E4E05A4C04D520FCB6E74EBF6409DC103E5BE0A4AE2ACD6564B4; a fresh remote download matches the local clean build exactly.
• The complete gate includes test, build, the Ars Source API check, no-AE2 runtime verification, production-JAR boundary, version composition, and exact-version-artifact checks. It passes 199 suites / 724 tests / 0 failures / 0 errors / 0 skipped.

[0.0.9] - 2026-08-08

本节完整列出相对正式版 0.0.8 的全部用户可见变化。

简体中文

新增与迁移

• 新增统一持久玩家身份：个人仙窍维度不再直接依赖启动器本次会话 UUID。首次加载 0.0.8 及更早存档时，依次从已保存的仙窍重生维度、仙窍退出维度或一致的旧绑定物品所有者执行一次性迁移；没有可靠旧证据时保留原 UUID 目录，不覆盖、复制或猜测维度数据。
• 仙窍存储磁盘、AE2 交换磁盘、RS 交换磁盘、仙灵驱动器、替死傀儡、仙窍/源方块管理器、普通/高级仙窍接口、源方块、世界碎片矿机与聚宝盆、轮回炼化炉、模拟轮回炼化炉、模拟灵田、渡劫与个人存储/燃料解析统一使用同一持久身份。
• 合法的旧会话 UUID 绑定会在首次交互时原地升级；磁盘独立 ID、物品内容与组件、耐久、替死傀儡锚点和机器数据全部保留。不同启动器启动同一用户时不再出现“物品栏/仙窍存储一致，但个人维度或绑定物品失联”。
• 完整补齐古玉指导书在后续版本中遗漏的双语章节：一气归元剑、拘灵器、仙灵驱动器、模拟轮回炼化炉、模拟灵田、回响碎片源方块、纠缠/高级/高级纠缠稳定化迷你仙墟，以及新版个人仙窍天气和持久身份迁移说明；灵剑、替死傀儡、源方块、兼容与个人仙窍旧章节同步校正。

材质、模型与渲染

• 源方块管理器采用 design/SourceVeinController.bbmodel 新外观：12 根黑色 Edge 梁构成顶底开敞的镂空笼，内部 8 个 3×3×3 源核按 72 格容量映射为八段状态，使用空=蓝、使用中=紫、满=红的纯色不透明材质，并以 4°/tick 绕中心 Y 轴整体旋转。
• 源方块管理器移除旧六格指示器和 source_vein_manager_side/top/front.png 三张旧贴图，改用 source_vein_manager_edge.png 与三张独立核心材质；方块模型按世界方向映射 UV，内部开口保持无面遮挡。
• 源方块管理器手持/物品栏改为方块物品 BEWLR：标准笼模型上叠加与世界完全相同的八段旋转核心，优先读取拆下物品保留的 DisplayState，其次按序列化成员数推导。
• AE2 与 RS 的仙藏额外资源渲染统一复用 ExternalResourceCatalog 的名称、颜色和纹理定义。化学品严格采用仙藏一致的注册表取样纯色；FE、Mana、Source、Souls 等非纯色资源使用仙藏自带纹理，未安装资源渲染附属时不再借用交换磁盘模型。

修复

• 修复摧毁源方块管理器时 Missing id for entity in: {CachedUnits:...} 导致的崩溃：管理器为新建/免费源成员写入 CachedUnits 时补齐方块实体字符串 id，已有 id 的成员只更新缓存；模拟轮回炼化炉拆下/保存同步改用含完整元数据的序列化路径。
• 修复源方块管理器顶面圆环不可见：顶部四根圆环梁补齐 up 面，底部四根补齐 down 面，复用 edge 贴图既有不透明采样区而不增加额外贴图。
• 修复源方块管理器手持/物品栏只显示空笼，动态核心、阶段颜色和拆下状态现在与世界内渲染一致。
• 修复 AE2 终端渲染或悬停 immortalstorage:external_resource 时因缺失客户端 AEKeyRendering 处理器而崩溃；新增受 AE2 可选加载边界保护的客户端注册，服务端与无 AE2 运行时不加载 AE2 客户端类。
• 修复 RS 合成终端触及 RsExternalResource 时因缺少网格仓库 Mapper 而断开连接；通过官方 addGridResourceRepositoryMapper 注册安全网格条目，名称、检索、数量、提示和提取分发均正常。
• 修复 RS 无额外资源附属时不显示仙藏额外存储，以及安装/移除附属后旧回退键可能失效的问题；同一账本资源只枚举一次，回退键继续可读写。
• 修复 RS 化学品渲染错误：solidColor 取样与纹理 blit 改为互斥分支，不再在绿色、灰色、粉色等化学品色块上叠加蓝色图标。
• 修复仙窍雪天气可能被误解为服务端降水并纳入强制加载的问题：SNOW 只保留客户端粒子，服务端不启用 rain/thunder；强制加载的玩家改动区块只接受玩家/实体驱动的破坏与放置事件。

兼容与验证

• 仅安装 Refined Storage 2.0.9 时，仙窍 RS 交换磁盘以内置资源类型显示 FE、Mana、Source、Souls 与 Mekanism 化学品。
• 安装 Refined Types 0.3.x 时优先使用其 FE/Source/Souls 原生键；安装官方 RS Mekanism Integration 1.x 时优先使用其化学品原生键。仙藏回退键保留最低优先级，避免升级或移除附属后数据不可读。
• ExtraStorage 等标准 RS 容量附属继续通过官方 StorageContainerItem 契约共存，不需要硬依赖或专用分支；Refined Types 与 RS Mekanism Integration 仍是可选依赖。
• 正式支持范围保持 Minecraft 1.21.1、NeoForge 21.1.235、Java 21；网络协议保持 8。
• 完整门禁通过 196 suites / 717 tests / 0 failures / 0 errors / 0 skipped，并通过生产 JAR 边界、版本组成、精确版本制品、Ars Source API 与无 AE2 运行时验证；新增手册契约会检查中英条目树一致及后续版本主要系统覆盖。
• 30-JAR PCL2 全模组实例完成 JDK 21、zh_cn 实机验证：绑定旧 AE2/RS 磁盘可打开终端，RS 化学品取样颜色正确，Missing render handler、No factory for class、高级屏幕处理失败和仙藏外部资源纹理加载失败均为 0。
• 0.0.9 最终制品为 immortalstorage-neoforge-mc1.21.1-nf21.1.235-0.0.9.jar，大小 5,137,573 字节，SHA-256 为 79EECB2B262C0FCC27C0AA0CC7A67BE89A79458D03A8F8C426F98ED94B74B870。
• 版本更新为 0.0.9。

English

This section is the complete user-visible delta from release 0.0.8.

Added and migrated

• Added one persistent player identity for personal realms. The realm key no longer depends directly on the launcher's current session UUID. On the first load of a 0.0.8-or-earlier save, a one-shot migration uses the saved realm respawn dimension, saved realm exit dimension, or one consistent legacy-bound item owner in that order; without reliable evidence, the existing UUID directory is preserved rather than copied or guessed.
• Xianqiao storage disks, AE2/RS exchange media, Spirit Drives, Substitute Puppets, Xianqiao/Source Vein Managers, plain/Advanced Xianqiao Interfaces, Source Veins, World Shard machines, reincarnation machines, Simulated Spirit Fields, tribulation ownership, and personal-storage/fuel resolution now share that same stable identity.
• Valid legacy session-UUID bindings upgrade in place on first interaction. Independent disk IDs, item contents/components, durability, puppet anchors, and machine data are preserved. Starting the same user through another launcher no longer separates the personal realm while inventory and Xianqiao storage remain shared.
• Completed the bilingual Ancient Jade handbook for systems missed by later updates: One-Qi Returning Origin Sword, Soul Catcher, Spirit Drive, Simulated Reincarnation Furnace, Simulated Spirit Field, Echo Shard Source Vein, Entangled/Advanced/Advanced Entangled Stabilized Ruins, plus current personal-realm weather and persistent-identity migration. The older sword, puppet, source, compatibility, and realm chapters were corrected at the same time.

Materials, models, and rendering

• Replaced the Source Vein Manager appearance with design/SourceVeinController.bbmodel: 12 black Edge beams form an open-top/open-bottom cage, while eight inner 3×3×3 cores map the 72-slot capacity to eight stages, use opaque empty-blue / used-purple / full-red materials, and rotate as one rigid body around Y at 4°/tick.
• Removed the old six-slot indicator and source_vein_manager_side/top/front.png textures. The new model uses source_vein_manager_edge.png plus three dedicated core textures, world-direction UV mapping, and an unobstructed inner opening.
• Hand/inventory rendering now uses a block-item BEWLR that overlays the same eight-stage rotating core on the standard cage model, reading persisted DisplayState first and serialized member count as fallback.
• AE2 and RS external-resource entries now share ExternalResourceCatalog names, colors, and textures. Chemicals use the same registry-sampled solid colors as Xianqiao; non-solid FE/Mana/Source/Souls entries use bundled ImmortalStorage textures when no resource-rendering addon is present.

Fixed

• Fixed Missing id for entity in: {CachedUnits:...} when destroying a Source Vein Manager. Fresh/free member data now receives the source-vein block-entity string id; existing IDs are preserved while cache data changes, and Simulated Reincarnation Furnace pickup/save uses full metadata.
• Fixed the Source Vein Manager top ring being invisible by adding up faces to the four top beams and down faces to the four bottom beams, reusing opaque regions of the existing edge texture.
• Fixed the Source Vein Manager hand/inventory item showing only an empty cage; its dynamic core, stage colors, and persisted pickup state now match world rendering.
• Fixed the AE2 terminal crash caused by a missing client AEKeyRendering handler for immortalstorage:external_resource; client registration remains behind the optional AE2 class-loading boundary and does not affect dedicated servers or no-AE2 runtimes.
• Fixed the RS crafting-terminal disconnect caused by the missing repository mapper for RsExternalResource. The official addGridResourceRepositoryMapper extension point now supplies safe grid entries with correct naming, search, amount, tooltip, and extraction dispatch.
• Fixed missing ImmortalStorage external resources with base RS and preserved readability when resource addons are installed or removed. Each ledger resource is emitted once and legacy fallback keys remain readable/writable.
• Fixed RS chemical rendering: sampled solidColor fills and textured blit rendering are now mutually exclusive, so no blue icon is overlaid on green, gray, pink, or other chemical swatches.
• Fixed personal-realm snow being eligible for server precipitation/forced-load interpretation. SNOW remains client particles only, rain/thunder stay disabled, and the forced-chunk set accepts only player/entity-driven break/place changes.

Compatibility and validation

• With Refined Storage 2.0.9 alone, Xianqiao RS exchange disks expose FE, Mana, Source, Souls, and Mekanism chemicals through the built-in resource type.
• Refined Types 0.3.x native FE/Source/Souls keys and official RS Mekanism Integration 1.x chemical keys take priority when installed. The ImmortalStorage fallback remains at lowest priority for upgrade/removal safety.
• Standard RS capacity addons such as ExtraStorage continue to coexist through the official StorageContainerItem contract; Refined Types and RS Mekanism Integration remain optional.
• Official support remains Minecraft 1.21.1, NeoForge 21.1.235, and Java 21; network protocol remains 8.
• The full gate passes 196 suites / 717 tests / 0 failures / 0 errors / 0 skipped, plus production-JAR boundary, version composition, exact-version artifact, Ars Source API, and no-AE2 runtime verification. New handbook contracts enforce bilingual entry-tree parity and later-version major-system coverage.
• A 30-JAR full-mod PCL2 client passed JDK 21 / zh_cn live validation: bound legacy AE2/RS disks open their terminals, RS chemicals use the correct sampled colors, and there are zero Missing render handler, No factory for class, advanced-screen handling, or ImmortalStorage external-texture load failures.
• The final 0.0.9 artifact is immortalstorage-neoforge-mc1.21.1-nf21.1.235-0.0.9.jar, 5,137,573 bytes, with SHA-256 79EECB2B262C0FCC27C0AA0CC7A67BE89A79458D03A8F8C426F98ED94B74B870.
• Bumped the version to 0.0.9.