当前开发版本为 0.0.9：个人仙窍维度、仙窍/RS 存储磁盘、仙灵驱动器、替死傀儡与所有者绑定机器统一改用随玩家数据持久化的稳定身份，不再直接依赖启动器本次会话 UUID。旧存档首次加载时从已保存仙窍引用或一致的旧绑定物品执行一次性迁移，合法旧绑定原地升级且不改变磁盘 ID、物品内容、耐久或锚点；同时包含 AE2
external_resource缺失客户端渲染处理器的崩溃修复。0.0.9 RS 额外资源显示与附属兼容（2026-08-08）： 仅安装 Refined Storage 2.0.9 时，仙窍交换磁盘会用仙藏自有
xianqiao_external资源类型在 RS 网格中显示 FE、Mana、Source、Souls 与 Mekanism 化学品。安装 Refined Types 时 FE/Source/Souls 自动改用其原生键，安装官方 RS Mekanism Integration 时化学品自动改用其原生键；仙藏回退键继续可读写，避免升级、移除附属或网络缓存中的旧条目失效，并保证同一账本资源只枚举一次。ExtraStorage 等使用 RS 标准存储容器协议的扩容附属可与仙窍交换磁盘共存。详见archive/2026-08-08-rs-external-resource-display-and-addon-compat.md。0.0.9 RS 合成网格闪退修复（2026-08-08）： 修复打开含仙藏额外资源的 RS 合成网格时
No factory for class ... RsExternalResource导致连接中断。资源类型序列化与图标渲染此前均已注册，但遗漏了 RS 网格仓库的ResourceRepositoryMapper；现补齐addGridResourceRepositoryMapper及安全网格条目。绑定旧磁盘的Test世界已通过 Numen 实机复测，CraftingGridScreen正常显示资源且无高级屏幕处理失败。详见archive/2026-08-08-rs-grid-mapper-crash-fix.md。0.0.8 崩溃修复（2026-08-08）： 修复摧毁源方块管理器时
Missing id for entity in: {CachedUnits:...}闪退。根源是原版block_entity_data组件编码要求携带字符串id键，而管理器为新建/免费源成员写入CachedUnits时未补id，导致成员序列化报错。现统一在写入侧补齐id，且对已有id的成员（挖掘入仓）只更新缓存不覆盖；模拟轮回炼化炉的拆下/保存路径同步改用含id的saveWithFullMetadata。详见archive/2026-08-08-source-vein-manager-missing-entity-id-crash-fix.md。0.0.8 源方块管理器控制器动效（2026-08-08）： 源方块管理器改用
design/SourceVeinController.bbmodel设计稿——12 根黑色 Edge 梁组成顶底开敞的镂空笼子（静态烘焙模型），内部 8 个 3x3x3 源核小立方按 72 格→8 段阶梯从空（蓝）→用（紫）→满（红）点亮，并作为刚体整体绕块中心 y 轴缓慢旋转（自定义 BlockEntityRenderer 动画）。手持/物品栏按原版默认渲染（空笼）。详见archive/2026-08-08-source-vein-manager-controller-bbmodel-animation.md。0.0.8 源方块管理器实机修复（2026-08-08）： 实机验证发现两个显示缺陷并已修复：① 顶面圆环消失——顶/底各四根圆环梁补齐
up/down封口面（复用既有 edge 贴图的备用不透明 2x2 采样区，贴图零改动），顶部框架不再消失；② 手持/物品栏只显示空笼——改为方块物品 BEWLR，在标准方块模型之上叠加与世界中完全一致的 8 段旋转源核（状态读取拆下时保留的DisplayState，缺失时按成员数推导），与世界中渲染像素一致。详见archive/2026-08-08-source-vein-manager-bugfix-frame-and-item-core.md。0.0.8 仙窍身份统一（Bug 2，2026-08-08）： 不同启动方式进入同一测试世界会产生两条互相隔离的离线身份与个人仙窍。已按“规范身份获胜”完成区块级迁移：规范
00000fff-ffff-ffff-ffff-fffffff16c5c作为唯一身份，旧身份00000000-0000-3003-998f-501bcc516c5c的仙窍区块/成就并入（entities +9 独有区块、成就 +14 条），玩家数据保留规范身份，旧身份文件与旧仙窍目录整体隔离到saves\Test\_quarantine_old_identity\，迁移前全量备份见saves\_backups\Test_pre-realm-merge_20260808_141636。所有启动批处理均已硬编码规范--uuid，无需改启动脚本。详见archive/2026-08-08-realm-identity-unification-bug2.md。0.0.8 仙窍雪不计入强制加载（设计约束，2026-08-08）： 仙窍下雪仅为客户端粒子视觉，服务端 SNOW 天气不置
raining=true（否则 vanilla 会在整个仙窍铺雪层）；驱动强制加载的“玩家改动区块”集合只由玩家/实体驱动的破坏/放置事件喂养，vanilla 下雪用 null 实体的setBlock永远不会进入该记录路径。该不变式已通过RealmEnvironmentPolicy.requiresRain/requiresThunder纯函数与RealmEnvironmentPolicyTest回归测试锁定。0.0.8 AE2 客户端闪退修复（2026-08-08）： 修复在合并后的仙窍内打开 AE2 终端时
Missing render handler for channel immortalstorage:external_resource闪退。根源是服务端已注册immortalstorage:external_resourceAEKey 通道，但客户端从未向AEKeyRendering注册渲染处理器，AE2 终端渲染/悬停该外部资源条目时getOrThrow抛异常。现新增客户端注册入口Ae2ClientCompat（在CompatManager.initializeClientIntegrations中于AE2_LOADED守护下反射调用）与ImmortalStorageExternalResourceKeyRenderHandler（绘制与命名复用ExternalResourceCatalog，与仙窍接口视觉一致），并由回归测试直接复现原崩溃条件。全门禁 191 suites / 706 tests / 0 failures。详见archive/2026-08-08-ae2-missing-render-handler-crash-fix.md。
简体中文 | English
仙藏（ImmortalStorage）是一个面向 Minecraft 生存流程的修仙、个人存储、自动化与专属维度模组。玩家会从凡人启灵开始，通过古玉了解修行道路，积累灵气与材料，逐步突破十个阶段，扩展与角色绑定的空窍/仙窍存储，建设属于自己的仙窍维度，并在后期通过渡劫完成境界提升。
模组界面采用 Minecraft 原版像素语言，并借鉴大型存储网络的信息架构：存储、检索、合成、仙炉、装备、流体、磁铁和仙窍管理集中在连续终端中，不需要频繁打开互不关联的独立窗口。
0.0.9 仅支持 Minecraft 1.21.1、NeoForge 21.1.235、Java 21。其他 NeoForge 版本区间尚未声明支持。
破坏性品牌迁移： 本次重发将模组 ID、资源命名空间、Java 包、网络 Payload、配置文件、命令和制品名全部改为
immortalstorage。不兼容旧cultivation世界或配置；测试旧世界必须删除后新建世界。不要同时安装任何旧cultivation-*.jar。
发行 JAR SHA256： 79EECB2B262C0FCC27C0AA0CC7A67BE89A79458D03A8F8C426F98ED94B74B870（5,137,573 字节）
- 从凡人到十阶的完整修行阶段，包含灵气、丹药、真元、仙元、飞升和渡劫。
- 与玩家身份绑定的空窍/仙窍存储，不依赖某一个固定放置的箱子或机器。
- 原版风格连续滚动终端，支持搜索、排序、合成、仙炉、装备、流体与磁铁管理。
- 每位玩家独有的仙窍维度，空间边界和时间流速会随阶段成长。
- 源方块、源方块管理器、仙窍管理器和仙窍接口组成的大宗资源自动化系统。
- 探索、扳手、镐子、建筑、传送五模式灵器，以及可淬火成长的灵剑。
- 模组武器通过统一攻击投影将资源支付与成长增伤写入标准主手攻击属性，便于神化等属性系统读取并参与乘算。
- 内置帕秋莉运行时的古玉手册，内含阶段流程、功能说明和真实配方图，无需另装手册模组。
- 可选兼容 JEI、EMI、AE2、RS、通用机械、植物魔法、通量网络与工业先锋灵魂等模组；Iron's Spells 玩家魔力不接入仙窍存储。
- 完整的简体中文与英文游戏文本、Tooltip 和模组配置说明。
| 项目 | 版本 |
|---|---|
| Minecraft | 1.21.1 |
| NeoForge | 21.1.235 |
| Java | 21 |
| 仙藏 ImmortalStorage | 0.0.9 |
JEI、EMI 和其他存储/科技模组均不是必需依赖。可选联动只会在目标模组实际安装时启用，未安装的联动不会造成类加载冲突。
- 回响碎片源方块与四个容器交互面变体的调度器、掩码解码、区内独占枚举、排序/收集/反向/投出等 9 项契约测试全部通过。
- 全部 700 项自动化测试通过，失败、错误与跳过均为 0；生产 JAR 边界、版本组成、精确版本产物、Ars Source API 与无 AE2 运行时校验通过。
- 0.0.7 在 30-JAR 全模组 PCL2 配置（含 Create 6.0.10 及其 ponder/flywheel）中使用 JDK 21、
zh_cn完成启动与单人实机验证，进入个人仙窍维度无 ImmortalStorage 致命错误。 - 鼓风机源方块触媒：
create:fan_processing_catalysts/splashing（水仙墟）、blasting（岩浆仙墟），并补充create:fan_transparent白名单使风机风穿过源方块。 - 发行包 SHA256 为
0547EFD1B1E75C9FE4305F3F6A48A79A9F5147FD42CA468AF716B87E91739B75。
- 模拟灵田的永久种源、50 tick 处理、真实作物战利品、特殊基底、紫颂/地狱疣规则、六面输出、自动输出与经验配置均有自动化契约测试。
- 仙炉、模拟轮回炼化炉和模拟灵田可在所有者仙窍内直接从个人存储支付仙元；联网协议已同步升级为 8。
- 仙窍日夜和天气由服务器持久锁定；Numen 实机完成“黑夜 → 白天 → 黑夜”往返并确认午夜天空盒、雨与四态天气切换。
- 2026-08-01 全量 691 项测试、生产 JAR 边界、版本组成、精确版本产物、Ars Source API、无 AE2 运行时及专用服务端启动校验通过。
- 发行包 SHA256 为
21B27726DA0647A121A1E58CBF655AC2CA1B89DE4ADDE954FDE76C2F24C3DD89。 CHANGELOG.md与 GitHub Release 正文用中英文完整列出相对 0.0.5 的新增、行为变化、修复、兼容性和验证记录。
- 安装 Minecraft 1.21.1 与 NeoForge 21.1.235。
- 确认客户端与服务端均使用 Java 21。
- 从 GitHub Release 下载
immortalstorage-neoforge-mc1.21.1-nf21.1.235-0.0.7.jar。 - 将 JAR 放入游戏实例或服务端的
mods文件夹。 - 启动游戏。默认情况下，新玩家首次进入世界会获得一本古玉指导书。
模组列表显示名为 ImmortalStorage，中文名为 仙藏；管理员命令根节点为 /immortalstorage，配置文件为 immortalstorage-common.toml 和 immortalstorage-client.toml。
安装或更新任何内容模组前，请先备份重要世界。
古玉是玩家的主要修行指导书。默认情况下，新角色首次进入世界时会获得一本；也可以使用书、绿宝石、灵晶和仙元进行无序合成。
古玉会根据玩家当前阶段显示：
- 当前最适合完成的修行目标；
- 从启灵到十阶的阶段路线；
- 空窍、仙窍、源方块、机器、灵器、灵剑和个人维度的详细说明；
- 从当前世界配方管理器读取并渲染的真实合成台与烧炼配方；
- 与服务器实际配置一致的十阶仙元、渡劫和边界说明；
- 可搜索的中英文物品、方块与功能章节。
指导书以正常玩家的游玩顺序编写，不是开发计划或功能清单。即使没有安装 JEI/EMI，也应当能够依靠古玉完成基础到后期的正常流程。
古玉只维护一份双语帕秋莉手册。ImmortalStorage 发行 JAR 通过 NeoForge Jar-in-Jar 内置 Patchouli 1.21.1-93，玩家无需单独安装；古玉右键直接打开该手册，不再包含或维护旧独立指导界面。手册提供六类目录、真实配方页面，并完整覆盖 0.0.3–0.0.9 的主要玩法：替死傀儡、灵剑三条内容线、拘灵器、仙灵驱动器、模拟生产设备、四类稳定化仙墟、源方块/管理器、个人仙窍天气与持久身份迁移，以及 AE2/RS 额外资源兼容。中英条目树与后续版本系统覆盖均由自动契约检查。
修行从零阶凡人开始，最高正常达到十阶。
- 一至五阶围绕启灵、灵气积累、丹药、真元与逐步扩展的空窍展开。
- 五阶是有限存储的最后阶段，需要满足飞升条件才能进入六阶。
- 五升六时会一次性处理既有真元；六阶以后新获得的真元不会继续被主动转换。
- 六阶开始开放仙窍存储、仙元、个人仙窍维度和后期自动化。
- 六至十阶通过在个人仙窍内完成渡劫进阶。
- 阶段常驻效果会在登录、复活、切换维度和改变游戏模式后重新校准；渡劫期间则会暂时失效。
整合包作者可以配置正常流程最高阶数以及各阶段渡劫敌人的注册 ID。
真元与仙元均为真实物品，而不是只能在界面中查看的隐藏数值，因此其他模组可以通过普通物品能力读取、抽取并用于合成或机器处理。
- 有阶段上限时，限制按玩家身上与个人存储中的总量共同计算。
- 六阶以后真元不再具有上限。
- 十阶默认每 20 tick 生成 256 仙元，存储无上限。
- 配置中可开启十阶无消耗仙元通道；该选项默认关闭。
- 一个仙元可以无序合成 64 个真元。
- 真元和仙元都可以作为普通熔炉燃料。
- 两者都可放置可染色、可隐藏模型的悬浮核心光源；仙元光源还会抑制其当前区块的敌对生物自然生成。
个人存储通过可自定义快捷键打开。存储快捷键可以覆盖大多数非文本输入界面全局打开，按 Esc 会返回之前的界面。
- 在一至五阶使用。
- 采用随阶段提升的有限物理槽位容量。
- 只存储物品，不支持流体。
- 不支持仙窍管理器等飞升后设备。
- 低阶段会限制空白显示行数，避免小容量存储出现过多空行。
- 六阶开始使用。
- 按物品身份和完整 Data Components 聚合同类物品。
- 以长整型显示大宗数量，同时保持外部自动化的标准能力语义。
- 物品与流体共用同一存储页面，流体按桶数显示。
- 可以被存储总线、管道与其他标准能力自动化读取。
- 九列连续存储页面和平滑像素滚动。
- 按本地化名称、Tooltip、标签、命名空间或普通文本搜索。
- 支持按数量、名称和模组 ID 排序。
- 物品数量显示在材质上层，不会被图标遮挡。
- 可直接管理玩家背包、快捷栏与四件真实装备槽。
- 支持鼠标拖动均分等原版容器交互。
- 内置真实 3x3 合成台，材料不足时自动从个人存储补充。
- 可切换是否要求自动补料完全匹配 NBT/Data Components。
- 内置三工作格仙炉，支持自动补入上一组原料并将输出送回存储。
- 磁铁支持开关、黑名单/白名单与掉落物直接入库。
- 手持物品耗尽后可按完整数据组件自动补充一组。
每位飞升玩家拥有一个按稳定 UUID 绑定的独立仙窍维度。
| 阶段 | 可用空间 | 可用时间流速 |
|---|---|---|
| 六阶 | 3x3 区块 | 1x |
| 七阶 | 7x7 区块 | 0.5x、1x、2x、4x |
| 八阶 | 19x19 区块 | 0.2x 至 8x 固定档位 |
| 九阶 | 无限 | 0.1x 至 16x 固定档位 |
| 十阶 | 无限 | 0x 冻结至 32x 固定档位 |
六至八阶会显示原版世界边界。玩家越过允许空间时会收到边界提醒，并被送回最近的合法位置。边界检测只在玩家位于自己的仙窍时运行，离开维度后会停止相关检查。
时间倍率只作用于对应仙窍维度。减速或完全冻结仙窍不会影响主世界，也不会阻止玩家正常离开。
仙窍存储的“仙窍管理”页提供并排的时间与天气控制：时间按钮在白天/黑夜间切换，天气按钮按无天气、下雨、雷雨、下雪循环。个人仙窍会持续锁定所选正午/午夜时刻与天气，天空盒会同步切换而不受原版昼夜、天气倒计时或仙窍时间倍率影响；雨雪状态不会修改主世界天气。
个人仙窍支持原版床。右键床会正常睡眠并将该床设置为玩家在其个人仙窍中的重生点，不会触发维度床爆炸；服务器会在需要解析该重生点时恢复对应的动态个人维度。
物品名称颜色采用统一稀有度：基础材料保持普通，中期灵晶、灵器和机器为罕见，高成本仙窍、保命与高级资源设施为稀有，龙蛋/下界之星级无限源和终局仙墟装备为史诗。
六阶以后的渡劫只能在玩家自己的仙窍中开始。渡劫期间，ImmortalStorage 提供的常驻增益与飞行能力会暂时失效。
默认敌人如下：
| 突破 | 默认敌人 |
|---|---|
| 六升七 | 全套附魔下界合金装备的僵尸 |
| 七升八 | 全套附魔下界合金装备的凋零骷髅 |
| 八升九 | 全套附魔下界合金装备、抗性提升 I 的卫道士 |
| 九升十 | 坚守者 |
渡劫目标会永久发光，获得力量 III，并拥有原生基础生命值的十倍。后期渡劫还会对玩家施加失明、凋零等压力效果。
无论游戏模式如何，渡劫期间死亡都会被拦截：召唤物会被清除，玩家保留物品并在原地复活，当前仙元清零，但阶段不会下降。
仙炉拥有三个并行工作格，既可以作为世界方块放置，也可以作为仙窍终端内置模块使用。
- 支持符合设计范围的原版熔炉与高炉配方。
- 灵铁矿和深层灵铁矿只支持高炉或仙炉烧炼。
- 灵晶矿和深层灵晶矿只支持仙炉烧炼。
- 使用真元时，每个工作格一次烧炼一个物品，耗时 50 tick。
- 使用仙元时，每次烧炼一组物品，耗时 25 tick。
- 自动化从方块上方输入。
- 内置仙炉自动填充会补入完整一组上一轮原料，并将输出直接存入个人存储。
- 仙灵驱动器可绑定玩家并从绑定人的空窍/仙窍支付仙元或真元燃料，仅在真实需要付款且余额不足时进入五 tick 重试。
- JEI 和 EMI 中拥有独立仙炉配方分类和配方转移。
模拟灵田使用平滑石原材质的 12 棱镂空框架；几何只参考稳定化迷你仙墟，未从哭泣黑曜石采色。内部基底按实际方块渲染，普通土壤显示为湿润耕地，作物模型依 50 tick 处理进度显示实际生长阶段。
- UI 的尺寸、种源/燃料/额外工具位置、12 格产物区和玩家背包布局与模拟轮回炼化炉一致。
- 顶面只输入种子，四个水平侧面只输入真元、仙元或已绑定仙灵驱动器；六个面可分别启用产物抽取，工具槽只允许手动交互。
- 种子作为永久种源，处理永不消耗；每 50 tick 使用成熟作物方块的真实战利品表和工具槽物品生成一次收获，并以 12 格原子输出逻辑避免溢出丢失。
- 紫颂果可作为永久种源，只能配合末地石类基底；内部以居中紫颂花从 0.15 倍持续放大至 0.70 倍显示生长，每轮固定产出 1 个紫颂花和 2 个紫颂果。
- 真元与仙元分别提供与仙炉一致的 150/500 tick 燃烧时间；仙窍内燃料槽为空时直接向该仙窍所有者支付 1 仙元。
- 右上角齿轮展开与模拟轮回炼化炉相同的六面邻接预览、逐面输出、自动输出和经验提取设置；自动输出对象严格按“当前仙窍主人、仙灵驱动器绑定人、本地 12 格产物槽”依次解析。
- 泥土、耕地、通用土壤/耕地标签、末地石和灵魂沙类基底可右键替换；旧基底返还玩家背包。紫颂类作物只接受末地石类基底，地狱疣只接受灵魂沙。
- 数据包可通过
immortalstorage:simulated_spirit_field_seeds、immortalstorage:simulated_spirit_field_substrates标签，以及data/*/simulated_spirit_field_crops/*.json的种子—作物—基底清单扩展模组作物。 - 工作台配方为“灵晶/混元一气/灵晶，灵铁粒/草方块/灵铁粒，灵晶/蕴灵晶/灵晶”，每次合成 4 个；物品稀有度为罕见（UNCOMMON）。
- 2026-08-01 已将 0.0.6 正式制品部署到 30-JAR 全模组 PCL2 配置并用 JDK 21、
zh_cn完成 Numen 单人实机验证。
- 新增回响碎片源方块：不可堆叠的源方块，接入源方块管理器聚合与六面推出，附带成就、战利品表与合成配方，可被镐子采集。
- 水仙墟与岩浆仙墟可作为机械动力（Create）鼓风机触媒：洗炼（splashing）与鼓风烧炼（blasting）通过
create:fan_processing_catalysts/*标签启用；两源方块同时注册create:fan_transparent，使鼓风机风能直接穿过源方块到达触媒。
- 基础稳定化、基础纠缠、高级稳定化与高级纠缠四个容器交互面变体统一采用 2×3 交互面掩码网格：上行 UP/NORTH/DOWN、下行 WEST/SOUTH/EAST，逐面启用并显示半透明白色预览高亮；六格全关 = 该侧完全不交互。
- 每个操作区域内的方块位置 × 每个已启用面 = 一个独立目标，通过 NeoForge 官方
Capabilities.ItemHandler.BLOCK, pos, face面参数访问容器能力。 - 调度器严格只与预览盒内的容器交互，不会越出区域外一格与相邻容器交互；旧存档“任意面”(-1) 配置加载时迁移为全关掩码。
- 纠缠变体支持正常/反向双向：正常侧把区域内的掉落物收集进 54 格缓冲，反向侧把缓冲按频率、范围与过滤器投出到目标容器。
每个源方块都有独立的长整型真实缓存和独立的六面设置。
- 六个面分别设置关闭、推出或绕过上限推出。
- 每个面拥有独立的每 tick 推出预算和数值输入。
- 关闭只停止主动抽取/推出，不会拒绝存储总线或管道的被动访问。
- 外部抽取优先消耗真实缓存，缓存不足时才进行仙元兑换。
- 流体源方块始终接受六面输入的任意流体并直接销毁。
- 面对只支持整形数量的管道时，对外提供安全饱和的整形视图，内部账本仍保持长整型。
源定义支持通过配置文件扩展。相同资源在同一有效配置中只能存在一个源定义，避免重复定义导致预算与统计冲突。
- 只能放置在所有者自己的仙窍维度内。
- 拥有 72 个单件槽，每格只能放入一个不可堆叠源方块。
- 同名源方块在同一个管理器中只能存在一个。
- 每个成员源仍独立工作和保存缓存，管理器仅聚合其对外取出能力。
- 聚合视图会绑定到仙窍存储统计，使终端和存储总线能读取最大预算与真实缓存。
- 成员源方块物品的持久缓存写在
block_entity_data组件上；管理器会在写入CachedUnits时确保该组件带合法的方块实体id（immortalstorage:source_vein），避免摧毁管理器或保存时触发原版Missing id for entity序列化错误。 - 0.0.8 改用
design/SourceVeinController.bbmodel设计稿外观：黑色镂空笼子（12 根 Edge 梁，顶/底圆环梁已补齐up/down封口面）静态渲染，内部 8 个 3x3x3 源核小立方按 72 格→8 段阶梯从空（蓝）→用（紫）→满（红）点亮，并作为刚体绕块中心缓慢旋转；手持/物品栏通过方块物品 BEWLR 叠加同一旋转源核（状态读取拆下保留的DisplayState），与世界中渲染一致。
仙窍管理器把相邻自动化与所有者的个人仙窍存储绑定，对外提供标准物品/流体能力。正式模组不包含任何 Numen、HTTP 或外部调试接口。
仙窍接口可以放置在其他维度，且不能被其他玩家重新认领。
0.0.8： 仙窍接口方块已改用
design/xianqiao-interface/的六面内凹设计稿——12 根深色金属棱边框架住内陷核心（上表面金色、其余五面面板），以 13 元素独立方块模型渲染；渲染采用默认 scale display（忽略设计稿的缩放参数）。设计源文件与接入说明见design/xianqiao-interface/README.md与archive/2026-08-07-immortalstorage-0.0.8-development.md。
- 配置物品与流体缓存目标。
- 默认每个物品槽上限 128，每个流体槽上限 16 桶，可在配置中调整。
- 支持从 JEI/EMI 拖动设置幽灵目标，并通过小窗口输入缓存数量。
- 空手左键已配置缓存槽会安全返还缓存并清除设置；空手右键打开数量与逐槽六面掩码窗口。
- 每个缓存目标都拥有独立的六面交互掩码。
- 具有主动抽入、主动推出总开关，以及每面的抽入、推出、关闭设置。
- 主动抽入会从开启面的相邻容器提取所有能够存入个人存储的内容，而不是只提取当前配置目标。
- 主动推出会从真实缓存向对应面输出配置资源。
- 安装对应模组后可配置电力、化学品、魔源、魔力和灵魂涌动等额外资源缓存。
- FE、植物魔法 Mana 与新生魔艺魔源均先消耗真实缓存，缓存不足时才按配置原子消耗仙元兑换缺口。
高级仙窍接口（advanced_xianqiao_interface）采用 design/advanced-xianqiao-interface/ 的空心框架+浮空核心+顶部圆垫设计稿（默认 scale display）。它保留普通仙窍接口的九个混合缓存槽与物品/流体/电力/化学品输入输出能力，但拒绝接口自身原有的六面主动推拉功能——六面区域改为配置与高级稳定化迷你仙墟系列一致的容器交互面掩码网格，主动调度改为对配置范围内的容器进行：
- xyz / +xzy 配置栏：范围尺寸
sizeX/Y/Z（1–13）与偏移offsetX/Y/Z（-13–13）。 - 预览框与面预览渲染与开关：
preview开关在世界上绘制白色选区线框与每个启用面的半透明高亮。 - 轮询相关选项：周期
frequency、启用总开关、访问（轮询跳过/强制轮询）、均分（逐个/按组）、顺序（远处/近处优先），以及通过潜行右键或设置面板按钮切换的汇入/推出模式。 - 汇入模式把范围内容器中可抽取的物品、流体、电力与化学品输入所有者的仙窍；推出模式把配置的缓存槽资源按面掩码推入范围内的容器。
- 设置面板（齿轮）不含六面行为设置，六面行为只在主界面六面区域配置。
- 合成：
{灵晶，迷你仙墟，灵晶，回响碎片，仙窍接口，回响碎片，灵晶，村民刷怪蛋，灵晶}有序 3×3。
灵器拥有探索、扳手、镐子、建筑四种模式。
对空气右键开关自动收纳，启用时显示附魔光效。只有玩家仍手持启用状态的灵器并打开箱子、陷阱箱、木桶、Lootr 页面或已注册战利品容器时，当前打开页面的内容才会事务性转入个人存储；无法容纳的物品保留在原容器中。
使用公开扳手语义兼容 ImmortalStorage、通用机械、AE2、RS、机械动力等机器。对属于玩家的 ImmortalStorage 功能方块 Shift 右键可完整拆下并获得掉落物。
拥有下界合金挖掘等级。普通左键挖掘会正常使用铁砧附魔并消耗耐久；六阶以后右键方块可消耗一个仙元执行灵器自带的精准采集，该右键能力不受灵器附魔影响。
客户端会显示与服务端实际放置计划一致的轮廓预览，材料可从背包和个人存储共同取用。默认单次上限为 64，可通过配置调整。按住“灵器特殊操作 / 灵剑召来”绑定键并右键，可以无掉落删除计划中的一层；该键默认是反引号键，可在控制设置中修改。每次放置或删除一层消耗一点耐久。
灵器不能在附魔台随机附魔，但可以通过铁砧接受当前下界合金镐允许的附魔，包括其他模组动态加入的附魔。
灵剑的 Tooltip 与实际攻击共享同一套伤害模型。
-
空手按住“灵器特殊操作 / 灵剑召来”键右键，可从内置仙炉召来正在淬火的灵剑；手持灵剑执行同一操作可将其送回空闲通道。
-
召走灵剑后，其内置仙炉通道会保留并暂停当前淬火进度，自动填充不会占用该空位；送回同一把灵剑后继续原进度。
-
根据阶段获得额外伤害，命中时从背包与个人存储支付对应真元或仙元。
-
余额不足时仍能攻击，但只造成基础武器伤害。
-
不能在附魔台随机附魔，但可通过铁砧接受当前下界合金剑允许的附魔。
-
自带灵气修复，可消耗元气恢复耐久。
-
可在熔炉、高炉、放置仙炉和内置仙炉中反复淬火，每次增加一点淬火点且不给予经验。
-
每一点淬火使伤害提高 1%；每次命中后淬火点减半并向下取整。
-
当前淬火点与伤害加成会直接显示在 Tooltip 中。
仙墟锻灵剑右键传送目标后会立即清除目标速度，并施加 40 tick（2 秒）的绝对禁锢；期间忽略实体碰撞、挤压和外力，目标被固定在原位。immortalstorage-common.toml 与原生模组配置页提供“传送影响其他玩家”开关：默认开启以保持原行为；关闭后范围传送与禁锢只影响非玩家生物。
世界碎片开采器使用与信标相同的完整同种方块底座结构。完整钻石块、下界残骸或紫颂砖底座分别激活主世界、下界和末地模式，底座等级一至四控制工作速度。
默认情况下，开采器会读取当前世界实际生效的矿物生成规则，使数据包和其他模组修改的矿物分布参与权重计算。整合包也可以选择启用固定表覆盖世界读取。在仙窍内工作时，产物直接进入对应玩家存储；在其他维度则进入机器内部一个木桶容量的缓存，缓存满后停机。
聚宝盆与开采器逻辑解耦，双方不存在主动通信。聚宝盆只检查正下方是否存在已激活的世界碎片开采器，并根据观察到的工作模式抽取对应战利品表；它拥有独立缓存，同时可以遮挡信标光束。
- 灵铁、粗灵铁、灵晶、对应矿石、深层矿石和储存块构成基础材料链。
- 灵核堆叠上限为 16，只作为中间合成材料，不再具有饰品功能。
- 所有丹药缩短食用时间、可以无视饱食度食用，并在 Tooltip 中写明效果。
- 破限丹在五阶使用时会将灵气进度补满，但不会自动完成飞升。
- 进阶虚弱与灵气饱和均为正式注册、可见且有独立图标的状态效果。
- 灵气修复为正式附魔，并拥有附魔书形态。
- 仙师孑遗村民职业以仙炉为工作方块并提供修行交易。
- 普通村民交易可以从当前个人存储补充精确要求的付款物品；不会自动用仙元替代真元。
JEI 和 EMI 均为可选依赖。安装后支持：
- 在终端条目上使用 R/U 查询配方和用途；
- 材料识别、高亮与缺料提示；
- 终端搜索框与配方查看器搜索同步，并避免循环更新；
- 正确报告终端和侧边面板的界面避让区域；
- 从个人存储、玩家背包和真实合成格进行配方转移；
- 物品与流体条目的点击识别；
- 独立仙炉配方分类与转移处理。
不安装任何查看器可以正常游戏，同时安装两者也不会因可选类加载而崩溃。
普通自动化优先通过 NeoForge 官方物品/流体能力交互。所有可选兼容均放在独立边界中，未安装目标模组时不会静态引用其类型。
0.0.2 使用 ImmortalStorage 自己的共享资源 Key 与长整型权威账本表示 FE、通用机械化学品、Ars Nouveau Source、植物魔法 mana 和工业先锋灵魂。Iron's Spells 玩家魔力明确不接入。该核心接口不依赖 AE2；未安装 AE2 时，仙窍接口、终端和其他已安装模组仍可直接通过各自官方能力读取与写入这些资源。仙窍存储主目录把额外资源与物品、流体放在同一搜索、排序和连续滚动网格中显示。
安装 AE2 后，ImmortalStorage 的可选 AE2 适配层才会把同一共享 Key 包装成 AEKey，供仙窍交流磁盘和 AE2 网络访问。玩家不需要额外安装 Applied Flux、Applied Mekanistics、Ars Énergistique、Applied Botanics、Soulplied Energistics 或其他 AEKey 中介模组。AE2 适配层与无 AE2 路径共用同一份账本，不复制资源数量。
若玩家同时安装上述受支持的 AE2 中间层附属，ImmortalStorage 不注册竞争性的重复目录身份，而是优先映射其现有资源键到同一仙窍账本；缺少附属时才回退到 ImmortalStorage 自有键。两条路径共享去重、revision 和模拟/执行事务，禁止目录双计或互相转换复制。
当前工程包含 AE2、RS 交流存储介质与存储总线读取，以及通用机械能量/化学品、植物魔法魔力、Ars Nouveau Source、通量网络能量、工业先锋灵魂等兼容区域。具体可用功能取决于实际安装版本与服务器配置。
仙窍存储界面的玩家背包槽保持为直接绑定原版 Inventory 的标准槽，供 R 键整理类辅助模组识别；ImmortalStorage 不监听或占用 R 键。界面在背包右上方另提供三个 16x16 小图标按钮：扳手整理、绿色上箭头全部存入、红色下箭头按当前筛选取出，并保留完整悬停说明。Building Gadgets 2 1.3.9 的复制粘贴小帮手在玩家主手或副手持有时，可把当前空窍/仙窍物品作为材料来源，模拟检查不扣物，正式施工才执行抽取。Create 蓝图大炮可把仙窍管理器当作标准 NeoForge 方块物品仓库读取，不需要 Create 私有 API。
Beyond Dimensions 安装与否都不会停用、替换或迁移 ImmortalStorage 自有空窍/仙窍存储；两套存储保持彼此独立，当前版本不安装外部权威后端路由。
植物魔法联动通过在仙窍接口上放置真实火花实现：接口向 Botania 注册官方 SparkAttachable 与 ManaReceiver，火花实体和强化负责网络流向，魔力直接进入或离开仙窍接口的共享魔力缓存。Ars Nouveau Source 同样通过官方的按位置 Source Provider 直接读写接口魔源缓存。这两类由方块本身直接完成、没有物理面参数的交互不受接口六面模式、主动推拉总开关或逐槽面掩码影响；即使六面全部关闭也保持可用。六面配置只约束物品、流体、FE、化学品等明确携带方向的能力。
本次 Release 只声明已经针对 Minecraft 1.21.1 / NeoForge 21.1.235 构建和验证的适配，不将尚未独立发布的其他 NeoForge 版本区间描述为已支持。
在主菜单或暂停菜单中打开 模组 -> ImmortalStorage -> 配置，即可使用 NeoForge 原生配置界面。所有现有分组、次级菜单、配置名称和 Tooltip 均已注册自然中文与英文翻译。
主要配置包括：
- 新玩家是否自带古玉；
- 古玉、丹药等战利品注入概率与数量；
- 正常流程最高可达阶数；
- 十阶是否启用无消耗无限仙元通道；
- 各阶段渡劫敌人注册 ID；
- 源方块认领、破坏与爆炸权限；
- 仙窍接口物品/流体缓存上限；
- 灵器建筑模式单次方块上限。
- 仙墟锻灵剑的传送与两秒绝对禁锢是否影响其他玩家。
- 安装通用机械/通量网络、植物魔法或新生魔艺后，配置页会分别显示仙元转化 FE、Mana、魔源的允许开关、比例和每刻上限；同一设置也写入
immortalstorage-common.toml，默认开启。
调整阶段、资源或兼容配置前，建议关闭服务器并备份世界。
所有 ImmortalStorage 快捷键都可以在 Minecraft 控制设置中重新绑定。存储按键可以在大多数非文本界面上全局使用，其他模式按键保持在游戏场景内生效，避免抢占菜单输入。
需要权限等级 2 的管理员指令：
/immortalstorage stage <0..10> [玩家]
/immortalstorage unload [玩家]
/immortalstorage reload [玩家]
/immortalstorage speed <固定档位>x [玩家]
不填写可选玩家参数时，默认作用于指令执行者。
- 存储目录使用稳定条目 ID、revision 校验、紧凑同步和仅视口渲染。
- 连续滚动不降低动画帧数，只卸载视野外行与不可见渲染内容。
- 高仙窍时间倍率下，单纯数量变化不会使终端物品无法点击。
- 长整型资源对只支持整形的 API 提供安全饱和值。
- 存储操作、合成补料、源兑换、接口传输和仙炉处理均由服务端权威事务执行。
- 可选模组兼容按安装状态隔离，专用服务端不会加载客户端查看器类。
- 源方块恢复 0.0.1 的原生方块物品模型；NeoForge
standalone只旁加载同一基础模型，自定义渲染器不再重复应用 GUI 变换或居中。产物角标与本体仍在同一次标准物品渲染中完成，并先于数量文字绘制。 - 正式 ImmortalStorage JAR 不包含 Numen、MCP、HTTP、Bearer Token 或外部调试端点；Numen 仅用于外部实机测试。
克隆仓库后，在 Windows PowerShell 中执行：
cd project/neoforge-1.21.1-mdk
$env:JAVA_HOME = "C:\path\to\jdk-21"
.\gradlew.bat clean build --no-daemon --max-workers 1 --console=plain发行文件生成在：
project/neoforge-1.21.1-mdk/build/libs/immortalstorage-neoforge-mc1.21.1-nf21.1.235-0.0.9.jar
完整验证命令：
.\gradlew.bat test build verifyProductionJarBoundary verifyVersionComposition verifyVersionArtifact --no-daemon --max-workers 1 --console=plain0.0.9 正式制品已通过 717 项测试（196 suites / 0 failures/errors/skips）、生产边界、版本组成与精确制品检查；统一持久身份、旧 UUID 一次性迁移、AE2/RS 磁盘、RS 无附属额外资源显示、RS 网格 Mapper、Refined Types/官方 RS Mekanism Integration 原生键退让、仙灵驱动器、替死傀儡、绑定机器、AE2 Missing render handler 崩溃条件及古玉手册双语完整性均有回归覆盖。此前 SHA-256 为 BE3F8C2A5283166513CA178DE5A9186651C3780C9DCD358B416BA849FE4C1228 的实机验证制品已部署到 30-JAR 全模组 PCL2 实例；Numen 在绑定旧交换磁盘上实机打开 RS CraftingGridScreen，确认化学品与仙藏一致仅显示注册表取样纯色，非纯色资源继续使用目录纹理，且 No factory、高级屏幕处理失败与外部资源纹理加载失败均为 0。包含完整手册的最终发布 JAR SHA-256 为 79EECB2B262C0FCC27C0AA0CC7A67BE89A79458D03A8F8C426F98ED94B74B870。详细记录见 archive/2026-08-08-rs-native-fallback-rendering.md。
.
├── README.md 中文默认介绍
├── README_en.md English documentation
├── CHANGELOG.md 版本变更记录
├── LICENSE 发行许可证
├── design/
│ ├── xianqiao-interface/ 六面内凹仙窍接口美化设计稿（已接入 0.0.8 生产模型）
│ ├── advanced-xianqiao-interface/ 高级仙窍接口设计稿（空心框架 + 边框材质，已接入 0.0.8）
│ ├── SourceVeinController.bbmodel 源方块管理器控制器设计稿（黑框笼 + 8 核旋转动效，已接入 0.0.8）
│ └── swords/ 灵剑/仙墟锻灵剑/一气归元剑 剑系美化设计稿（已接入 0.0.8 材质）
└── project/
└── neoforge-1.21.1-mdk/
├── build.gradle
├── gradle.properties
├── gradle/
└── src/
├── main/java/ 模组实现
├── main/resources/ 材质、模型、语言、配方、标签与数据
└── test/java/ 自动化行为与发行边界测试
参考模组、第三方提取源码、PCL2 测试实例、Numen 调试桥、日志、截图、归档和构建 JAR 均不会进入 Git 历史。编译后的正式版本只通过 GitHub Releases 分发。
提交问题时，请附上：
- Minecraft、NeoForge、Java 与 ImmortalStorage 的准确版本；
- 问题发生于客户端、单人整合服务端还是专用服务端；
- 已安装联动模组及其准确版本；
- 最小复现步骤；
- 与问题相关的
latest.log片段，请移除账号 Token 和其他隐私信息。
ImmortalStorage 使用仓库中的 All Rights Reserved 许可证。允许个人游玩与私人整合包使用；重新分发、商业使用、修改或发布衍生版本需要事先获得书面许可。
Minecraft 是 Mojang Studios 的商标。本项目为独立模组，与 Mojang Studios 或 Microsoft 无隶属或授权关系。