Flux Networks Ultimate Addon

# Flux Networks Ultimate Addon 1.0.6

## Important

- **Back up the world before the first 1.0.6 load.**
- Remove **1.0.5** before installing this release; do not keep both versions in the `mods` folder.
- Update both client and server to **1.0.6**.
- The first time an old Ultimate storage is loaded and saved, its exact state is migrated automatically.
- Packet layout is unchanged; the Flux protocol remains **804**.
- Requires Minecraft **1.21.1**, NeoForge **21.1+**, and the official Flux Networks **8.0.0** JAR.

## Fixed: energy persistence

- Fixed Ultimate Flux Storage energy appearing to reset or disappear after leaving and reopening a world.
- Complete exact BigNumber states are now stored in world-level SavedData:
  `data/fluxnetworks_ultimate_storage_states.dat`.
- Chunk NBT keeps only a UUID and bounded summary instead of the multi-million-entry `container_state` tree. This prevents the roughly 4.7 MB oversized-chunk rewrite that caused periodic stutters.
- Legacy 1.0.5 and older `container_state` / Deflate-NBT data is read automatically and migrated without truncating the exact value.
- Item drops still contain the complete exact state, so moving or breaking a storage does not discard energy.
- If an exact external entry is absent but a bounded legacy long projection is present, it remains available as a compatibility fallback; it is not used in place of a healthy exact state.

## Fixed: GUI and save performance

- GUI snapshots use compact raw binary v2. Deflate v1 snapshots remain readable for backward compatibility, while v2 avoids the extra Deflate pass that was expensive for high-entropy late-game values.
- Unchanged GUI snapshots are cached and are not re-encoded every time the screen is reopened or synchronized.
- State changes mark SavedData dirty; final chunk detach also captures the latest snapshot so normal autosaves and world exits persist the final exact energy.
- Routine tile-update packets remove both legacy and new complete-state fields. The network packet layout and protocol number **804** are unchanged.

## Compatibility and verification

- Exact BigNumber values, exponent layers, overflow state, transfer behavior, GUI synchronization, old-save migration, and item drops are preserved.
- Added regression coverage for SavedData save/load, unload/reload, UUID cloning, externalized chunk saves, item drops, v1 decoding, malformed/truncated data, and GUI snapshot caching.
- Do not install this alongside 1.0.5. Back up `saves/<world>` before upgrading.

---

# Flux Networks Ultimate Addon 1.0.6 中文更新日志

## 重要提示

- **首次使用 1.0.6 加载世界前，请先备份存档。**
- 安装前删除 **1.0.5**，不要在 `mods` 文件夹中同时启用两个版本。
- 客户端和服务端都更新到 **1.0.6**。
- 第一次加载并保存旧版终极储能器时，会自动迁移其精确状态。
- 数据包结构未改变，Flux 网络协议号继续保持为 **804**。
- 需要 Minecraft **1.21.1**、NeoForge **21.1+** 和官方 Flux Networks **8.0.0** JAR。

## 修复：能量持久化

- 修复退出并重新进入世界后终极储能器能量显示重置或丢失的问题。
- 完整、精确的 BigNumber 状态现在保存到世界级 SavedData：
  `data/fluxnetworks_ultimate_storage_states.dat`。
- 区块 NBT 只保存 UUID 和有界摘要，不再保存数百万节点的 `container_state`，避免约 4.7 MB 的超大区块周期性重写导致卡顿。
- 自动读取并迁移 1.0.5 及更早版本的 `container_state` / Deflate-NBT 数据，不会截断精确数值。
- 方块掉落物仍携带完整精确状态，移动或破坏储能器不会导致能量丢失。
- 当精确外置条目缺失但区块中仍有有界 long 投影时，保留该投影作为兼容回退；正常情况下不会用它替代健康的精确状态。

## 修复：GUI 与保存性能

- GUI 快照使用紧凑原始二进制 v2；仍兼容读取旧 Deflate v1，后期高熵大数不再承担打开界面时昂贵的额外 Deflate 过程。
- 状态未变化时缓存 GUI 快照，重复打开界面或同步时不再重复编码。
- 能量变化会标记 SavedData，区块最终卸载时也会抓取最新快照，确保正常自动保存和退出存档时写入最终精确能量。
- 普通方块更新包会移除旧版与新版完整状态字段；网络数据包结构和协议号 **804** 保持不变。

## 兼容性与验证

- 精确 BigNumber、指数层、溢出状态、传输行为、GUI 同步、旧存档迁移和方块掉落功能保持不变。
- 新增 SavedData 保存/加载、卸载/重载、UUID 克隆、外置区块存档、方块掉落、v1 解码、损坏/截断数据和 GUI 快照缓存回归测试。
- 不要与 1.0.5 同时安装；升级前备份 `saves/<世界名>`。