dysoncubeproject-addon

# 戴森立方计划附属
# Dyson Cube Project Addon

## 中文介绍

这是一个基于 **Dyson Cube Project（戴森立方计划）** 的大型扩展附属。

本模组不会替代原模组。加载原模组与本附属后，两者会共同组成完整的扩展版本，在保留原有戴森球玩法的基础上加入超大数能源、恒星级资源开采和后期宇宙 progression。

### 主要功能

- 使用 Flux Networks 8.0.0 BigNumber 系统处理超大能源数值
- 戴森球结构、能源缓存与超大数发电系统
- 16 个宇宙采矿等级，从单行星一直扩展到星海终点
- 宇宙采矿枢纽，可开采物品和流体资源
- 矿石处理枢纽、激光能源输入端口和超大数能源输出端口
- 戴森帆、光束、铁块、金块和下界合金块压缩物品
- 压缩等级使用大整数保存，不受普通 `int` 或 `long` 范围限制
- 寰宇之心、原初之气、反物质恒星及后期宇宙成长内容
- 超大数使用科学计数法显示，避免界面溢出和超长文本卡顿
- 针对超大库存、网络同步和存档进行了性能优化

### 可选 AE2 集成

安装 Applied Energistics 2 后会启用：

- 戴森 AE 终端
- 戴森存储元件
- 戴森 IO 端口
- 使用超大整数保存物品数量
- 戴森存储元件之间的超高速数量转移
- 普通 AE 存储元件的高速 IO 操作

AE2 不是本附属的必需前置，不安装 AE2 也可以使用其他全部内容。

### 管理员指令

给予玩家指定等级的压缩物品：

`/dysoncubeproject_addon give_compressed <玩家> <类型> <压缩等级> [数量]`

可用类型：

`sail`、`beam`、`iron_block`、`gold_block`、`netherite_block`

示例：

`/dysoncubeproject_addon give_compressed @s gold_block 10000 1`

### 必需前置

- Minecraft 1.21.1
- NeoForge 21.1.64 或更高版本
- Dyson Cube Project 1.0.5
- Titanium 4.0.45
- Flux Networks 8.0.0

### 可选前置

- Applied Energistics 2 19.2.17

客户端和服务端都需要安装本附属及其必需前置。更新版本前建议备份世界。

---

## English Description

This is a major overhaul addon for **Dyson Cube Project**.

It does not replace the original mod. Dyson Cube Project and this addon work together to provide the complete expanded experience, preserving the original Dyson sphere gameplay while adding huge-number energy systems, stellar-scale mining, and new late-game cosmic progression.

### Main Features

- Huge-number energy powered by the Flux Networks 8.0.0 BigNumber API
- Expanded Dyson sphere structures, energy storage, and power generation
- 16 cosmic mining tiers, ranging from a single planet to the Star End
- Cosmic Mining Hub for large-scale item and fluid extraction
- Ore Processing Hub, Laser Energy Input Port, and BigNumber Energy Output Port
- Compressed solar sails, beams, iron blocks, gold blocks, and netherite blocks
- Compression levels stored as large integers beyond normal `int` and `long` limits
- Cosmic Heart, Primordial Qi, antimatter stars, and late-game cosmic progression
- Compact scientific notation for extremely large values
- Performance optimizations for huge inventories, networking, and world saves

### Optional AE2 Integration

When Applied Energistics 2 is installed, the addon enables:

- Dyson AE Terminal
- Dyson Storage Cell
- Dyson IO Port
- Huge-integer item storage
- Extremely fast transfers between Dyson storage cells
- Accelerated IO operations for standard AE2 storage cells

AE2 is optional. All non-AE2 content remains available without it.

### Administrator Command

Give a player a compressed item with a specified compression level:

`/dysoncubeproject_addon give_compressed <player> <type> <level> [count]`

Available types:

`sail`, `beam`, `iron_block`, `gold_block`, `netherite_block`

Example:

`/dysoncubeproject_addon give_compressed @s gold_block 10000 1`

### Required Dependencies

- Minecraft 1.21.1
- NeoForge 21.1.64 or newer
- Dyson Cube Project 1.0.5
- Titanium 4.0.45
- Flux Networks 8.0.0

### Optional Dependency

- Applied Energistics 2 19.2.17

The addon and all required dependencies must be installed on both the client and server. Back up your world before updating.

---

## Credits

Original Dyson Cube Project author: **Buuz135**

Addon development and overhaul: **gugugaga233**

License: **MIT**

Dyson Cube Project Addon 1.0.1

## 中文更新日志

### 性能与稳定性

- 修复宇宙采矿枢纽处理十万位目标质量时，服务器线程长时间卡死的问题。
- 修复矿物处理枢纽将超大 `AbsoluteInteger` 转换为 Flux `BigNumber` 时持续占满服务器线程的问题。
- 为矿物处理能耗增加大数精度限制与结果缓存，避免每 tick 重复执行昂贵转换。
- 优化宇宙采矿目标的网络同步和存档格式，避免发送超长数字字符串。

### 戴森 AE 存储

- 修复戴森大数存储元件内容超过 2 MiB 后，触发 `container_set_slot` 解码失败并断开客户端的问题。
- 完整精确数量仍保存在世界存档中；客户端现在只接收紧凑的种类数和总量摘要。
- 戴森 IO 端口的大数传输改为整批只持久化一次，显著减少大量物品类型传输时的卡顿。
- 保持对 1.0.0 世界和已有戴森存储元件的兼容，无需清空或重新制作存储元件。

### 显示与工具

- 改进极大数字的科学计数法显示，支持嵌套指数的紧凑格式。
- 优化戴森终端、采矿界面和悬浮提示中的超大数量显示。
- 新增管理员指令，可给予玩家任意压缩等级的模组物品：

```mcfunction
/dysoncubeproject_addon give_compressed <玩家> <类型> <等级> [数量]
```

### 兼容性

- Minecraft 1.21.1
- NeoForge 21.1.64 或更高版本
- Dyson Cube Project 1.0.5 或更高版本
- Flux Networks 8.0.0
- AE2 19.2.17 或更高版本为可选前置，仅 AE 功能需要

## English Changelog

### Performance and Stability

- Fixed a server-thread freeze in the Cosmic Mining Hub when processing target masses with tens of thousands of digits.
- Fixed sustained server-thread stalls while the Ore Processing Hub converted huge `AbsoluteInteger` values to Flux `BigNumber` values.
- Added precision limiting and result caching for huge ore-processing energy costs, avoiding expensive conversions every tick.
- Optimized cosmic mining target synchronization and persistence to prevent oversized decimal strings from being sent over the network.

### Dyson AE Storage

- Fixed client disconnects caused by Dyson BigNumber Storage Cell contents exceeding Minecraft's 2 MiB `ItemStack` NBT packet limit.
- Full exact amounts remain stored in the world save; clients now receive only a compact type-count and total-amount summary.
- Batched Dyson IO Port exact transfers so a complete transfer is persisted once instead of once per item type.
- Existing 1.0.0 worlds and Dyson storage cells remain compatible and do not need to be emptied or recreated.

### Display and Tools

- Improved scientific notation for extremely large values, including compact nested-exponent formatting.
- Improved huge-number presentation in the Dyson terminal, mining screens, and tooltips.
- Added an administrator command for giving mod items at arbitrary compression levels:

```mcfunction
/dysoncubeproject_addon give_compressed <player> <type> <level> [count]
```

### Compatibility

- Minecraft 1.21.1
- NeoForge 21.1.64 or newer
- Dyson Cube Project 1.0.5 or newer
- Flux Networks 8.0.0
- AE2 19.2.17 or newer is optional and only required for AE features