ImmortalStorage

ImmortalStorage (仙藏) is a cultivation progression, personal storage, automation, and UUID-bound personal-dimension mod for Minecraft.

Begin as a mortal, awaken through the Ancient Jade handbook, advance across ten cultivation stages, expand character-bound Kongqiao and Xianqiao storage, construct a personal realm, automate resources, master Spirit equipment, and face late-game tribulations.

The mod uses a vanilla-inspired interface and combines storage, search, crafting, furnace processing, equipment, fluids, magnet controls, and realm management in one continuous terminal.

Requirements

Component	Version
Minecraft	1.21.1
Mod Loader	NeoForge 21.1.235
Java	Java 21
ImmortalStorage	0.0.3
Client	Supported
Dedicated Server	Supported

Only the Minecraft and NeoForge combination listed above is officially supported by this release.

JEI, EMI, AE2, Refined Storage, Mekanism, and all other integrations are optional.

Patchouli 1.21.1-93 is bundled through Jar-in-Jar. Players do not need to install Patchouli separately.

Core Progression

Ten Cultivation Stages

Cultivation begins at stage 0 and normally progresses to stage 10.

• Stages 1-5 focus on awakening, Lingqi, pills, TruePower, and Kongqiao development.
• Stage 5 is the final finite-storage stage.
• Ascending from stage 5 to 6 unlocks Xianqiao storage, ImmortalPower systems, and the personal realm.
• Stages 6-10 advance through tribulations fought inside the player's own Xianqiao realm.
• Higher stages grant increasingly powerful strength, speed, regeneration, resistance, and flight effects.
• ImmortalStorage-provided permanent effects and flight are temporarily suppressed during tribulations.
• Modpack authors can configure the maximum normally reachable stage and the enemy used by each tribulation.

Ancient Jade Handbook

New players receive an Ancient Jade by default. It can also be crafted again if lost.

Ancient Jade opens a bundled bilingual Patchouli handbook containing:

• Complete progression from awakening to stage 10
• TruePower, ImmortalPower, and pill mechanics
• Kongqiao and Xianqiao storage tutorials
• Immortal Furnace usage
• Source Veins and automation
• Personal realm and time-flow mechanics
• Spirit Instrument and Spirit Sword instructions
• Nurturing Crystal progression
• Substitute Puppet mechanics
• Miniature and Stabilized Miniature Immortal Ruins
• JEI, EMI, AE2, Refined Storage, and technology-mod compatibility
• Real crafting and processing recipes read from the active recipe manager

The primary progression can be completed without installing JEI or EMI.

Personal Storage

Kongqiao

Kongqiao is used during stages 1-5.

• Bound to the player rather than a placed container
• Capacity increases with cultivation stage
• Uses real item slots
• Supports search, sorting, and inventory management
• Does not support fluids or late-game external resources

Xianqiao

Xianqiao is unlocked at stage 6.

• Aggregates items by complete Data Components identity
• Uses long-valued counts for bulk storage
• Supports fluid storage
• Displays items, fluids, and external resources in one catalog
• Exposes standard NeoForge item and fluid capabilities
• Can be accessed through Xianqiao Managers, Xianqiao Interfaces, and optional storage mods
• Remains bound to the player's UUID

Storage Terminal

The terminal provides a continuous nine-column storage interface with:

• Search by localized name, tooltip, tag, namespace, or text
• Sorting by name, quantity, or mod ID
• Unified item, fluid, and external-resource entries
• Long-valued bulk quantity display
• Player inventory, hotbar, and armor management
• Vanilla-style dragging and stack distribution
• Compact sort, deposit-all, and filtered-withdraw controls
• A real 3x3 crafting grid
• Automatic ingredient refill from inventory and personal storage
• Optional exact NBT/Data Components matching
• An embedded three-lane Immortal Furnace
• Magnet controls with blacklist and whitelist modes
• Exact-component held-item refill
• JEI and EMI recipe lookup and recipe transfer

Personal Xianqiao Realm

Every ascended player owns a separate personal dimension bound to their UUID.

Stage	Usable Area	Time Flow
6	3x3 chunks	1x
7	7x7 chunks	0.5x, 1x, 2x, 4x
8	19x19 chunks	0.2x to 8x
9	Unlimited	0.1x to 16x
10	Unlimited	0x to 32x

Time flow affects only the corresponding personal realm. Slowing or freezing one Xianqiao does not alter the overworld or another player's realm.

Stages 6-8 use a visible vanilla world border. Crossing the permitted area returns the player to the nearest valid position.

Beds and Respawning

Version 0.0.3 supports normal vanilla bed behavior inside personal realms.

• Beds do not explode
• Players can sleep normally
• Beds can set a realm-local respawn point
• The saved target retains the exact UUID-bound dimension
• The server restores the dynamic personal dimension before resolving the respawn point

TruePower and ImmortalPower

TruePower and ImmortalPower are physical items rather than hidden interface-only values.

They can be:

• Carried in the player inventory
• Stored in Kongqiao or Xianqiao
• Used in crafting
• Used as furnace and Immortal Furnace fuel
• Accessed through standard item capabilities
• Placed as dyeable floating-core light sources

ImmortalPower lights also suppress natural hostile-mob spawning in their current chunk.

Stage 10 generates 256 ImmortalPower every 20 ticks by default. An optional non-consuming stage-10 channel is available for modpacks but disabled by default.

Immortal Furnace

The Immortal Furnace contains three independent processing lanes and can be used as either a placed block or an embedded Xianqiao module.

• Supports the intended range of vanilla furnace and blast-furnace recipes
• Spirit Iron ores require a blast furnace or Immortal Furnace
• Spirit Crystal ores require the Immortal Furnace
• TruePower processes one item at a time
• ImmortalPower processes a complete stack
• Embedded lanes can refill the previous input automatically
• Completed outputs can return directly to personal storage
• Spirit Swords can be tempered repeatedly
• JEI and EMI provide dedicated Immortal Furnace recipe categories and transfer support

Spirit Instrument

The Spirit Instrument has four modes.

Explore Mode

When automatic collection is enabled, supported loot-container contents can be transferred transactionally into personal storage.

Supported containers include:

• Chests
• Trapped chests
• Barrels
• Lootr containers
• Registered loot containers

Items that cannot be stored remain in the original container.

Wrench Mode

Uses public wrench semantics for ImmortalStorage and supported machinery from other mods.

Shift-use on an owned ImmortalStorage functional block dismantles it while preserving required data.

Pick Mode

• Uses Netherite mining level
• Normal mining follows standard tool behavior
• From stage 6 onward, block use can spend ImmortalPower to perform built-in Silk Touch
• Supports compatible anvil enchantments

Build Mode

• Displays a preview matching the authoritative server placement plan
• Draws materials from inventory and personal storage
• Has a configurable per-action block limit
• Supports layer removal through the special-operation key
• Placement and removal consume durability

Spirit Sword

Spirit Swords support:

• Stage-based bonus damage
• TruePower or ImmortalPower payment from inventory and personal storage
• Spirit Repair
• Compatible anvil enchantments
• Repeated tempering in furnaces, blast furnaces, placed Immortal Furnaces, and embedded Immortal Furnaces
• Tooltip display of tempering points and damage bonuses
• Summoning from and returning to an embedded Immortal Furnace
• Persistent lane reservations while a tempering sword is summoned

Each normal Spirit Sword tempering point increases damage by 1%. After a successful hit, the tempering value is halved and rounded down.

Immortal-Ruin-Forged Spirit Sword

The forged sword is created through smithing:

• Miniature Immortal Ruin as the template
• Spirit Sword as the base
• Spirit Core as the addition
• Preserves enchantments and tempering points
• Restores full durability when upgraded
• Grants 1.5% damage per tempering point
• Increases sweep range by 50%

Using the sword spends five ImmortalPower and pulls targets within a 13x13x13 region to the wielder.

Successfully teleported targets:

• Have their velocity cleared
• Receive maximum-strength movement slowdown for 20 ticks
• Are effectively restrained for one second

A common configuration option controls whether this effect applies to other players. Non-player entities remain valid targets when player targeting is disabled.

Nurturing Crystal Progression

Version 0.0.3 introduces a complete Nurturing Crystal production chain.

• Spirit Iron can be divided into Spirit Iron Nuggets and recombined
• Spirit Crystal Blocks can be processed into Inactive Nurturing Crystal Bedrock in the Immortal Furnace
• Eight ImmortalPower surrounding the inactive block create active Nurturing Crystal Bedrock
• The active bedrock grows four crystal stages
• Only mature clusters drop Nurturing Crystals
• Mature clusters require Netherite-level mining
• Fortune affects the mature-cluster drop count
• Personal-realm time scaling accelerates crystal growth
• Nurturing Crystal, a Netherite Block, and a Spirit Core create Premixed Heavy Compound
• Premixed Heavy Compound is processed into a Heavy Core in the Immortal Furnace

Substitute Puppet

The Substitute Puppet is a UUID-bound survival item.

• Maximum stack size of one
• Binds to its owner on first use
• Tooltip displays owner, durability, and Respawn Anchor
• Maximum durability of 16
• Eight Nurturing Crystals restore one durability
• Activates from inventory, Kongqiao, or Xianqiao storage
• Displays a dedicated totem-style activation animation
• Prevents death and consumes one durability
• Can bind to a vanilla Respawn Anchor
• Can teleport the owner across dimensions when activated

If the bound Respawn Anchor is mined or destroyed by an explosion, the binding is cleared automatically.

Stale anchors are also validated during:

• Player login
• Inventory ticks
• Puppet activation
• Kongqiao and Xianqiao synchronization

Miniature Immortal Ruin

The Miniature Immortal Ruin creates a server-authoritative entity-control field.

• Maximum stack size of one
• Placed as an unbreakable, non-colliding partial block
• Uses a default 13x13x1 horizontal area
• Attracts or repels entities
• Can apply magic damage
• Can optionally affect players
• Supports separate entity and player damage settings
• Supports disabled, light, medium, strong, and teleport force levels
• Reversed mode converts teleport force into strong repulsion
• Empty-hand use toggles attraction and repulsion
• Spirit Instrument wrench use opens configuration

The field uses a dynamic black-and-white core whose colors reverse with its state.

Stabilized Miniature Immortal Ruin

The stabilized ruin is an automation-oriented version of the Miniature Immortal Ruin.

• Constructed with Crying Obsidian and Nurturing Crystals
• Contains 54 internal inventory slots
• Configurable X, Y, and Z region dimensions
• Configurable relative offsets
• Adjustable execution interval
• Optional white wireframe preview
• Collects item entities in normal mode
• Ejects stored items in reversed mode
• Can insert directly into an adjacent NeoForge item storage
• Does not eject through a blocked target
• Supports external automation
• Shift-wrench dismantling preserves complete configuration
• Silk Touch drops an unconfigured stabilized ruin
• Crafting a configured ruin by itself clears its stored configuration

Source Veins

Source Veins continuously provide configured resources.

Each Source Vein has:

• An independent long-valued cache
• Six independently configured faces
• Disabled, push, and bypass-limit push modes
• Per-face transfer budgets
• Configurable output quantities
• Standard item or fluid capabilities
• ImmortalPower conversion when its real cache is insufficient
• Safe saturated views for integer-only APIs

Fluid Source Veins accept and void input fluids to provide stable automation semantics.

Source Vein items display their actual item or bucket output in the lower-right corner. The preview is consistent across inventory, creative inventory, hotbar, JEI, EMI, and the ImmortalStorage terminal.

Source Vein Manager

• Contains 72 single-item slots
• Accepts one non-stackable Source Vein per slot
• Rejects duplicate source identities
• Preserves each member's independent cache and operation
• Aggregates extraction capability
• Binds source statistics into Xianqiao storage
• Exposes real cache and maximum-budget information to terminals and storage buses

Xianqiao Manager

The Xianqiao Manager connects nearby automation to its owner's personal Xianqiao storage.

It exposes standard item and fluid capabilities for pipes, storage buses, and compatible machines.

Its item form has a dynamic core rendered consistently in inventory, creative inventory, hotbar, JEI, EMI, and the ImmortalStorage terminal.

Xianqiao Interface

The Xianqiao Interface can be placed outside the owner's personal realm.

• Bound to the first valid owner
• Cannot be claimed by another player
• Supports item and fluid cache targets
• Supports FE, Mekanism chemicals, Botania Mana, Ars Nouveau Source, and Industrial Foregoing Souls
• Supports JEI and EMI ghost targets
• Provides numeric cache configuration
• Provides per-target face masks
• Supports active pulling and pushing
• Active pulling accepts any resource that can enter personal storage
• Active pushing exports explicitly configured caches
• Passive pipe access is separate from scheduled block automation
• Incoming resources do not require a preconfigured output cache
• Transfers use server-authoritative transactions
• Partial and multi-stack transfers preserve resources

For fluid and chemical containers:

• Left click configures the exact container item
• Right click configures the contained fluid or chemical

World Shard Miner

The World Shard Miner uses a complete beacon-like base made from one material.

• Diamond Block base activates overworld mode
• Ancient Debris base activates Nether mode
• Purpur Block base activates End mode
• Base levels 1-4 control operation speed
• Reads the active world's effective ore-generation rules by default
• Datapack and modded ore-generation changes can participate in output weights
• Modpacks can replace dynamic scanning with explicit tables
• Outputs directly into personal storage when operating inside the exact owner's realm
• Uses a 27-slot local cache in other dimensions
• Pauses when its output cache is full

Treasure Basin

The Treasure Basin operates independently from the World Shard Miner.

• Checks for an active miner directly below
• Selects loot according to the observed miner mode
• Uses its own cache
• Does not directly control the miner
• Can obstruct a beacon beam
• Uses server-authoritative random results

JEI and EMI

JEI and EMI are optional.

When installed, they provide:

• Recipe and usage lookup from terminal entries
• Ingredient identification
• Missing-material hints
• Search synchronization
• GUI exclusion zones
• Recipe transfer from inventory, personal storage, and the real crafting grid
• Item and fluid entry interaction
• Dedicated Immortal Furnace recipe categories
• Xianqiao Interface ghost-target configuration

The mod works without either viewer. Installing both does not create mandatory class-loading conflicts.

Optional Integrations

Version 0.0.3 includes optional support for:

• JEI
• EMI
• Applied Energistics 2
• Refined Storage
• Mekanism
• Botania
• Ars Nouveau
• Flux Networks
• Industrial Foregoing Souls
• Create
• Building Gadgets 2
• Beyond Dimensions
• Public wrench conventions

Applied Energistics 2

ImmortalStorage includes its own external-resource keys and does not require intermediary addons.

When supported addons such as Applied Flux, Applied Mekanistics, Ars Energistique, or Applied Botanics are installed:

• Their standard keys are preferred
• Keys map to the same authoritative Xianqiao ledger
• Duplicate terminal rows are prevented
• Double accounting and resource duplication are prevented
• Built-in keys remain compatibility fallbacks

Mekanism

Supports:

• FE energy
• Individual chemical identities
• Registered chemical colors
• Localized chemical names
• Pipe insertion and extraction
• Active output into normally connected pipe networks
• ImmortalPower conversion after real stored resources are exhausted

Botania

The Xianqiao Interface exposes official:

• ManaReceiver
• SparkAttachable
• Real spark attachment
• Direct Mana access to the authoritative Xianqiao ledger

Ars Nouveau

The Xianqiao Interface supports:

• Official Source provider behavior
• Dominion Wand binding
• Relay source and destination endpoints
• Automatic repair of old same-position relay loops

Refined Storage

Xianqiao exchange disks and resource adapters allow RS networks to access personal Xianqiao resources.

Create and Building Gadgets 2

• Create Schematicannons can read a Xianqiao Manager as standard block-item storage
• Building Gadgets can use the current player's Kongqiao or Xianqiao as a material source
• Simulation does not consume materials
• Actual construction performs the authoritative extraction

Iron's Spells player mana is intentionally not connected to Xianqiao storage.

Configuration

Open:

Mods → ImmortalStorage → Config

The native NeoForge configuration interface includes:

• Starting Ancient Jade
• Loot injection chances and quantities
• Maximum cultivation stage
• Optional stage-10 infinite ImmortalPower
• Tribulation enemies
• Source Vein claiming, breaking, and explosion permissions
• Xianqiao Interface item and fluid cache limits
• Spirit Instrument build limit
• Whether forged-sword teleportation affects other players
• ImmortalPower conversion settings for FE, Mana, and Source

Configuration files:

• immortalstorage-common.toml
• immortalstorage-client.toml

Item Rarity

Version 0.0.3 assigns consistent vanilla rarity colors based on material cost, recipe complexity, progression stage, and functional power.

• Common: basic ores, parts, and low-cost materials
• Uncommon: Spirit Crystals, mid-game equipment, machines, and processed materials
• Rare: Xianqiao devices, Substitute Puppets, Miniature Immortal Ruins, and advanced resource systems
• Epic: dragon-egg or nether-star-class infinite sources, World Shard Miners, and endgame ruin equipment

Block items and their corresponding functional products follow the same policy.

Installation

1. Install Minecraft 1.21.1.
2. Install NeoForge 21.1.235.
3. Run the game with Java 21.
4. Download immortalstorage-neoforge-mc1.21.1-nf21.1.235-0.0.3.jar.
5. Place the JAR in the client or server mods folder.
6. Start the game.

Clients and servers must use the same mod version.

Back up important worlds before updating mods or modpacks.

Version 0.0.3 Verification

• Minecraft: 1.21.1
• NeoForge: 21.1.235
• Java: 21
• Automated tests: 653
• Failures: 0
• Errors: 0
• Skipped: 0
• JDK 21 clean build: Passed
• Production JAR boundary audit: Passed
• Version composition audit: Passed
• Exact artifact audit: Passed
• Ars Source adapter verification: Passed
• No-AE2-runtime verification: Passed

Release artifact:

immortalstorage-neoforge-mc1.21.1-nf21.1.235-0.0.3.jar

SHA256:

789565B8BCE085F2889FAAF02DDD33DD5F5186A2804EC0C59E6A8C8820E4B811

Support

When reporting an issue, include:

• Minecraft version
• NeoForge version
• Java version
• ImmortalStorage version
• Single-player, client, or dedicated-server environment
• Installed integration mods and their versions
• Minimal reproduction steps
• Relevant latest.log excerpts
• Screenshots or recordings when useful

Remove account tokens, server secrets, and other private data before publishing logs.

License

ImmortalStorage is distributed under an All Rights Reserved license.

Personal play and private modpack use are permitted. Redistribution, commercial use, modified public releases, or derivative publication require prior written permission.

Minecraft is a trademark of Mojang Studios. This project is independent and is not affiliated with or endorsed by Mojang Studios or Microsoft.

---

仙藏 ImmortalStorage

仙藏（ImmortalStorage）是一个面向 Minecraft 生存流程的修仙成长、个人存储、资源自动化与 UUID 专属维度模组。

玩家将从凡人启灵开始，通过古玉了解修行道路，逐步突破十个修行阶段；扩展与角色绑定的空窍和仙窍存储，建设个人仙窍维度，自动化处理各种资源，掌握灵器与灵剑，并在后期面对渡劫挑战。

模组采用接近 Minecraft 原版的像素界面，将存储、搜索、合成、仙炉、装备、流体、磁铁和仙窍管理整合在连续终端中。

版本要求

项目	支持版本
Minecraft	1.21.1
模组加载器	NeoForge 21.1.235
Java	Java 21
ImmortalStorage	0.0.3
客户端	支持
专用服务器	支持

本版本仅正式声明支持以上 Minecraft 与 NeoForge 组合。

JEI、EMI、AE2、Refined Storage、Mekanism 以及其他联动模组均为可选依赖。

Patchouli 1.21.1-93 已通过 Jar-in-Jar 内置，玩家无需单独安装。

核心玩法

十阶段修行流程

修行从零阶凡人开始，最高正常达到十阶。

• 一至五阶围绕启灵、灵气、丹药、真元与空窍成长展开；
• 五阶是有限空窍存储的最后阶段；
• 五升六完成飞升，解锁仙窍存储、仙元系统和个人仙窍维度；
• 六至十阶需要在玩家自己的仙窍中完成渡劫；
• 高阶玩家会逐步获得力量、速度、恢复、抗性和飞行能力；
• 渡劫期间，仙藏提供的常驻效果与飞行会暂时失效；
• 整合包作者可以配置最高正常阶数以及各阶段渡劫敌人。

古玉指导书

新玩家默认会获得一本古玉。古玉丢失后也可以重新合成。

古玉会打开内置的双语 Patchouli 手册，其中包含：

• 从启灵到十阶的完整修行路线；
• 真元、仙元和丹药机制；
• 空窍与仙窍存储教程；
• 仙炉使用方法；
• 源方块与自动化；
• 个人仙窍维度和时间倍率；
• 灵器与灵剑；
• 蕴灵晶材料链；
• 替死傀儡；
• 迷你仙墟和稳定化迷你仙墟；
• JEI、EMI、AE2、RS 和科技模组联动；
• 从当前世界配方管理器读取的真实合成与加工配方。

不安装 JEI 或 EMI 也可以完成主要修行流程。

个人存储

空窍

空窍在一至五阶使用。

• 与玩家身份绑定，而不是依赖固定容器；
• 容量随修行阶段增加；
• 使用真实物品槽；
• 支持搜索、排序和背包管理；
• 不支持流体与后期额外资源。

仙窍

仙窍在六阶解锁。

• 按完整 Data Components 身份聚合物品；
• 使用长整型数量保存大宗物品；
• 支持流体存储；
• 物品、流体和额外资源显示在同一目录；
• 提供标准 NeoForge 物品与流体能力；
• 可以通过仙窍管理器、仙窍接口及可选存储模组访问；
• 权威存储始终绑定玩家 UUID。

仙藏终端

终端提供九列连续滚动界面，支持：

• 按本地化名称、Tooltip、标签、命名空间或文本搜索；
• 按名称、数量或模组 ID 排序；
• 统一显示物品、流体与额外资源；
• 显示长整型大宗数量；
• 管理玩家背包、快捷栏和装备；
• 原版风格拖动、堆叠和均分操作；
• 整理、全部存入和按筛选批量取出；
• 真实 3×3 合成格；
• 从背包和个人存储自动补料；
• 可选精确 NBT/Data Components 匹配；
• 内置三通道仙炉；
• 磁铁黑名单与白名单；
• 手持物品耗尽后的精确组件补充；
• JEI 和 EMI 配方查询与转移。

个人仙窍维度

每位飞升玩家拥有一个与 UUID 绑定的独立维度。

阶段	可用空间	时间倍率
六阶	3×3 区块	1×
七阶	7×7 区块	0.5×、1×、2×、4×
八阶	19×19 区块	0.2× 至 8×
九阶	无限	0.1× 至 16×
十阶	无限	0× 至 32×

时间倍率只作用于对应个人仙窍，不会影响主世界或其他玩家的维度。

六至八阶使用可见的原版世界边界。玩家越过允许范围后会返回最近的合法位置。

床与重生

0.0.3 支持在个人仙窍中正常使用原版床。

• 床不会爆炸；
• 玩家可以正常睡眠；
• 床可以设置仙窍内重生点；
• 重生点保留完整的 UUID 专属维度身份；
• 服务器会在解析重生位置前恢复对应动态维度。

真元与仙元

真元和仙元都是真实物品，而不是只能在界面中查看的隐藏数值。

它们可以：

• 保存在玩家背包中；
• 存入空窍或仙窍；
• 参与合成；
• 作为熔炉和仙炉燃料；
• 通过标准物品能力被其他模组读取；
• 放置为可染色的悬浮核心光源。

仙元光源还会抑制当前区块的敌对生物自然生成。

十阶默认每 20 tick 生成 256 仙元。整合包可以开启十阶无消耗仙元通道，但该选项默认关闭。

仙炉

仙炉拥有三个独立加工通道，可以作为世界方块或仙窍终端内置模块使用。

• 支持设计范围内的原版熔炉和高炉配方；
• 灵铁矿需要高炉或仙炉；
• 灵晶矿只能由仙炉加工；
• 真元每次加工一个物品；
• 仙元可以一次加工整组物品；
• 内置仙炉能够自动补入上一轮原料；
• 加工结果可以直接返回个人存储；
• 灵剑可以反复淬火；
• JEI 和 EMI 提供独立仙炉配方分类和转移支持。

灵器

灵器具有四种模式。

探索模式

启用自动收纳后，打开受支持的战利品容器会将其中物品事务性转入个人存储。

支持：

• 箱子；
• 陷阱箱；
• 木桶；
• Lootr 容器；
• 已注册战利品容器。

无法存入的物品会保留在原容器中。

扳手模式

使用公开扳手语义兼容仙藏及部分其他模组机器。

对玩家拥有的仙藏功能方块 Shift 右键，可以拆卸并保留所需数据。

镐子模式

• 具有下界合金挖掘等级；
• 普通挖掘遵守标准工具逻辑；
• 六阶后右键方块可以消耗仙元执行内置精准采集；
• 支持兼容的铁砧附魔。

建筑模式

• 显示与服务端实际放置计划一致的预览；
• 材料可以来自背包和个人存储；
• 单次方块数量上限可以配置；
• 特殊操作键可以删除一层结构；
• 放置与删除都会消耗耐久。

灵剑

灵剑支持：

• 修行阶段增伤；
• 从背包和个人存储支付真元或仙元；
• 灵气修复；
• 兼容的铁砧附魔；
• 在熔炉、高炉、放置仙炉和内置仙炉中反复淬火；
• Tooltip 显示淬火点和伤害加成；
• 从内置仙炉召来和送回；
• 灵剑被召走后保留并暂停对应仙炉通道。

普通灵剑每一点淬火提高 1% 伤害。成功命中后，淬火点减半并向下取整。

仙墟锻灵剑

仙墟锻灵剑通过锻造台制作：

• 迷你仙墟作为模板；
• 灵剑作为基底；
• 灵核作为追加材料；
• 保留附魔和淬火点；
• 升级后恢复完整耐久；
• 每点淬火增加 1.5% 伤害；
• 横扫范围提高 50%。

右键消耗五枚仙元，将 13×13×13 范围内的目标拉到使用者面前。

被成功传送的目标：

• 移动速度会立即清零；
• 获得 20 tick 的最高等级缓慢；
• 被近似禁锢一秒。

配置中可以控制该效果是否作用于其他玩家。关闭玩家目标后，非玩家实体仍会受到影响。

蕴灵晶材料链

0.0.3 新增完整的蕴灵晶生产流程。

• 灵铁可以分解为灵铁粒并重新合成；
• 灵晶块可以在仙炉中加工为失活蕴灵晶母岩；
• 使用八枚仙元包围失活母岩可以将其激活；
• 激活母岩会生长四个阶段的晶簇；
• 只有成熟晶簇掉落蕴灵晶；
• 成熟晶簇需要下界合金等级工具；
• 时运会影响掉落数量；
• 仙窍时间倍率会加速晶簇成长；
• 蕴灵晶、下界合金块和灵核可以合成预拌沉重混合物；
• 预拌沉重混合物只能在仙炉中加工为沉重核心。

替死傀儡

替死傀儡是一件与玩家 UUID 绑定的保命物品。

• 最大堆叠数量为一；
• 首次使用时认主；
• Tooltip 显示所有者、耐久和重生锚；
• 最大耐久为 16；
• 每八枚蕴灵晶恢复一点耐久；
• 可以从背包、空窍或仙窍存储中触发；
• 显示独立的图腾式激活动画；
• 阻止死亡并消耗一点耐久；
• 可以绑定原版重生锚；
• 触发时能够跨维度传送所有者。

绑定的重生锚被挖掘或爆炸破坏时，绑定会自动清除。

失效锚点还会在以下时间复核：

• 玩家登录；
• 物品栏 tick；
• 傀儡触发前；
• 空窍与仙窍同步期间。

迷你仙墟

迷你仙墟会创建一个服务端权威的实体控制场。

• 最大堆叠数量为一；
• 放置后是不可破坏、无碰撞的不完整方块；
• 默认范围为同一水平面的 13×13×1；
• 可以吸引或排斥实体；
• 可以造成魔法伤害；
• 可以选择是否影响玩家；
• 可以分别设置实体与玩家伤害；
• 支持关闭、轻、中、强和传送力度；
• 反转模式会将传送力度降为强力排斥；
• 空手右键切换吸引和排斥；
• 使用灵器扳手右键打开配置。

迷你仙墟拥有动态黑白核心，反转状态会同步反转核心颜色。

稳定化迷你仙墟

稳定化迷你仙墟是偏向自动化的升级版本。

• 使用哭泣的黑曜石和蕴灵晶制作；
• 拥有 54 格内部存储；
• 可以配置 X、Y、Z 区域大小；
• 可以配置相对偏移；
• 可以调整执行间隔；
• 可以显示白色线框范围；
• 正常模式收集掉落物；
• 反转模式输出存储物品；
• 可以直接插入相邻 NeoForge 物品存储；
• 目标被阻挡时不会错误输出；
• 支持外部自动化；
• 灵器扳手 Shift 右键拆卸会保留完整配置；
• 精准采集会掉落无配置版本；
• 将已配置方块单独合成可以清除配置。

源方块

源方块用于持续提供指定资源。

每个源方块拥有：

• 独立长整型缓存；
• 六面独立设置；
• 关闭、推出和绕过上限推出模式；
• 每面独立传输预算；
• 可配置输出数量；
• 标准物品或流体能力；
• 缓存不足时使用仙元兑换；
• 面向整形 API 的安全饱和值。

流体源方块接受并销毁输入流体，以保持稳定的自动化语义。

源方块物品会在右下角显示真实产物或桶装资源。该预览在背包、创造栏、快捷栏、JEI、EMI 和仙藏终端中保持一致。

源方块管理器

• 拥有 72 个单件槽；
• 每槽只能放置一个不可堆叠源方块；
• 不允许重复源身份；
• 保留每个源的独立缓存与工作状态；
• 聚合对外抽取能力；
• 将源统计绑定到仙窍存储；
• 向终端和存储总线提供真实缓存与最大预算。

仙窍管理器

仙窍管理器将附近自动化设备与所有者的个人仙窍存储连接。

它提供标准物品与流体能力，可供管道、存储总线及兼容机器访问。

仙窍管理器物品具有动态核心，在背包、创造栏、快捷栏、JEI、EMI 和仙藏终端中采用统一渲染。

仙窍接口

仙窍接口可以放置在所有者个人仙窍以外的维度。

• 与首次有效放置者绑定；
• 不能被其他玩家重新认领；
• 支持物品和流体缓存；
• 支持 FE、Mekanism 化学品、Botania Mana、Ars Nouveau Source 和 Industrial Foregoing Souls；
• 支持 JEI 和 EMI 幽灵目标；
• 提供缓存数量输入；
• 每个目标具有独立面掩码；
• 支持主动抽入和主动推出；
• 主动抽入接受所有可写入个人存储的资源；
• 主动推出只输出明确配置的缓存；
• 被动管道访问与定时方块自动化相互独立；
• 输入资源不要求提前配置输出缓存；
• 所有传输由服务端权威执行；
• 部分传输和多堆叠传输遵守资源守恒。

配置流体或化学品容器时：

• 左键配置完整容器物品；
• 右键配置容器内的流体或化学品。

世界碎片开采器

世界碎片开采器使用类似信标的完整同种材料底座。

• 钻石块底座激活主世界模式；
• 下界残骸底座激活下界模式；
• 紫颂砖底座激活末地模式；
• 一至四级底座控制工作速度；
• 默认读取当前世界实际生效的矿物生成规则；
• 数据包和其他模组修改的矿物生成可以参与产物权重；
• 整合包可以用明确配置表覆盖动态扫描；
• 在所有者的个人仙窍中工作时，产物直接进入个人存储；
• 在其他维度工作时使用 27 格本地缓存；
• 缓存满后自动暂停。

聚宝盆

聚宝盆与世界碎片开采器彼此独立。

• 检查正下方是否存在已激活的开采器；
• 根据观察到的开采器模式选择战利品；
• 使用独立缓存；
• 不直接控制开采器；
• 可以遮挡信标光束；
• 使用服务端权威随机结果。

JEI 与 EMI

JEI 和 EMI 均为可选模组。

安装后支持：

• 从终端条目查询配方和用途；
• 材料识别；
• 缺料提示；
• 搜索同步；
• GUI 避让区域；
• 从背包、个人存储和真实合成格转移配方；
• 物品与流体条目交互；
• 独立仙炉配方分类；
• 仙窍接口幽灵目标配置。

不安装任何配方查看器也可以正常游戏。同时安装两者不会产生必选类加载冲突。

可选模组联动

0.0.3 提供以下可选兼容：

• JEI；
• EMI；
• Applied Energistics 2；
• Refined Storage；
• Mekanism；
• Botania；
• Ars Nouveau；
• Flux Networks；
• Industrial Foregoing Souls；
• Create；
• Building Gadgets 2；
• Beyond Dimensions；
• 公开扳手语义。

Applied Energistics 2

ImmortalStorage 内置外部资源键，不要求安装中介附属。

安装 Applied Flux、Applied Mekanistics、Ars Energistique 或 Applied Botanics 等受支持附属时：

• 优先使用附属的标准资源键；
• 映射到同一仙窍权威账本；
• 避免重复目录；
• 避免双重记账和资源复制；
• 内置键保留为兼容后备。

Mekanism

支持：

• FE 能量；
• 独立化学品身份；
• 注册颜色；
• 本地化名称；
• 管道输入与抽取；
• 向普通连接管网主动输出；
• 真实缓存不足后的仙元转换。

Botania

仙窍接口提供官方：

• ManaReceiver；
• SparkAttachable；
• 真实火花连接；
• 直接访问仙窍权威魔力账本。

Ars Nouveau

仙窍接口支持：

• 官方 Source Provider；
• Dominion Wand 绑定；
• 中继起点和终点；
• 旧存档同位置中继循环自动修复。

Refined Storage

仙窍交流磁盘与资源适配器允许 RS 网络访问个人仙窍资源。

Create 与 Building Gadgets 2

• Create 蓝图大炮可以将仙窍管理器作为标准方块物品仓库；
• Building Gadgets 可以使用当前玩家的空窍或仙窍材料；
• 模拟阶段不会扣除材料；
• 正式施工时才执行权威抽取。

Iron's Spells 玩家魔力不会接入仙窍存储。

模组配置

打开：

模组 → ImmortalStorage → 配置

NeoForge 原生配置页面包括：

• 新玩家是否获得古玉；
• 战利品注入概率和数量；
• 最高修行阶段；
• 可选十阶无限仙元；
• 渡劫敌人；
• 源方块认领、破坏和爆炸权限；
• 仙窍接口物品和流体缓存上限；
• 灵器建筑上限；
• 仙墟锻灵剑是否影响其他玩家；
• 仙元转换 FE、Mana 和 Source 的配置。

配置文件：

• immortalstorage-common.toml
• immortalstorage-client.toml

物品稀有度

0.0.3 根据材料成本、配方复杂度、修行阶段和功能强度设置统一的原版稀有度颜色。

• 普通：基础矿物、零件和低成本材料；
• 罕见：灵晶、中期装备、机器和加工材料；
• 稀有：仙窍设备、替死傀儡、迷你仙墟和高级资源系统；
• 史诗：龙蛋或下界之星级无限源、世界碎片开采器和终局仙墟装备。

方块物品与对应功能成品使用相同规则。

安装方法

1. 安装 Minecraft 1.21.1。
2. 安装 NeoForge 21.1.235。
3. 使用 Java 21 启动游戏。
4. 下载 immortalstorage-neoforge-mc1.21.1-nf21.1.235-0.0.3.jar。
5. 将 JAR 放入客户端或服务器的 mods 文件夹。
6. 启动游戏。

客户端与服务器必须使用相同的模组版本。

更新模组或整合包前，请备份重要世界。

0.0.3 验证信息

• Minecraft：1.21.1
• NeoForge：21.1.235
• Java：21
• 自动化测试：653
• 失败：0
• 错误：0
• 跳过：0
• JDK 21 clean build：通过
• 生产 JAR 边界检查：通过
• 版本组成检查：通过
• 精确制品检查：通过
• Ars Source 适配器检查：通过
• 无 AE2 运行时检查：通过

正式文件：

immortalstorage-neoforge-mc1.21.1-nf21.1.235-0.0.3.jar

SHA256：

789565B8BCE085F2889FAAF02DDD33DD5F5186A2804EC0C59E6A8C8820E4B811

问题反馈

反馈问题时请提供：

• Minecraft 版本；
• NeoForge 版本；
• Java 版本；
• ImmortalStorage 版本；
• 单人、客户端或专用服务器环境；
• 已安装的联动模组及其版本；
• 最小复现步骤；
• 相关 latest.log 内容；
• 必要时提供截图或录像。

公开日志前请移除账号 Token、服务器密钥和其他隐私信息。

许可证

ImmortalStorage 使用 All Rights Reserved 许可证。

允许个人游玩和私人整合包使用。重新分发、商业使用、公开发布修改版或衍生版本需要事先获得书面许可。

Minecraft 是 Mojang Studios 的商标。本项目为独立项目，与 Mojang Studios 或 Microsoft 无隶属或授权关系。