Dyson Cube Project Addon 1.3.0

Minecraft 1.21.1 · NeoForge

中文：1.2.3 → 1.3.0 累积更新

本日志根据本地1.2.3发布记录及当前1.3.0实现整理，汇总两个版本之间的更新，不把旧版已有的中枢、采矿、压缩、戴森盘或基础AE联动重复列为新增。由于没有完整的1.2.3历史包，本日志不代表逐文件完整差分。

戴森工作台合成与AE联动

• 新增戴森合成元件、戴森并行元件及独立批量下单入口。满足条件时，按整条工作台配方链计算基础原料，直接扣料并把最终产物交付当前请求连接的ME网络，不再逐个制造、搬运中间产物。例如只有铁粒时，162铁粒可直接结算为2铁块。
• 支持多层工作台依赖、压缩配方、大数量及已支持的替代原料组合；独立合成检查当前网络中实际在线的两种戴森元件，不要求普通AE合成CPU空闲或提供其内存。
• 新增戴森样板、戴森样板编码终端和戴森样板供应器。编码、发布和执行均核对服务器真实配方，自填输入与产物、JEI材料清单或给方块改名不能作为任意产出的授权。
• 改进材料分页、缺料说明、订单选择、恢复及取消；修正同一戴森盘通过多个筛选入口接入时，原料被漏读或重复统计的问题。普通AE订单的多订单管理与戴森独立请求分别处理。
• 取消独立工作台合成额外的规划节点能量扣费；ME网络仍需正常供电，普通存储本身的原生规则不因此取消。
• 本次1.3.0进一步修正75级压缩场景的超大数量输入，支持 1e(1e1000) 示例；材料“本次需要／可用／缺少”等字段改用紧凑大数显示，不再显示Flux内部精确展开式。实际库存与计算精度不因显示缩短而改变。

戴森存储与搬运

• 改进戴森盘之间以及中枢到戴森盘的BigNumber整笔物品、流体搬运和戴森I/O端口处理，不把戴森专用大数通道拆成逐次 long 搬运；普通AE盘和第三方存储仍保留各自接口限制。
• 戴森盘物品／流体种类上限提高到 Integer.MAX_VALUE，不代表实际内存占用无限。
• 补充部分接收、阻塞重试、按实收结算、宿主保存通知、盘升级组件继承，以及异常数据隔离等保护；这不等于旧丢盘事故已定因或已根治。
• 改进戴森终端的大数与CPU字段显示；戴森能力使用 ℵ₀ 标记并调整彩色动态效果。原生AE接口的有限容量／线程值不被描述成数学无限，也不向普通终端物品格叠加戴森专用大数绘制。

行星资源、矿产处理与输出

• 收紧自动资源发现：结合自然生成来源筛选矿物及基础资源，减少把纯合成材料误当自然矿物的情况；补充已支持的AE陨石、Mekanism矿脉、源流体及化合物资源检查，并尊重已接入的生成配置开关。
• 修正资源预览、候选缓存和重载后的同步；增加资源导出诊断，方便整合包作者检查实际候选。未知模组与未知生成器仍可能需要显式配置，不承诺自动收录所有资源。
• 矿产处理基础产出改为1倍；完善鸿蒙升级、并行／产量／减能分配、能源不足时的部分批次处理、费用与界面刷新。
• 增加处理中枢戴森元件槽位，可按烧炼规则读取盘内对应原料；补充统一烧炼及矿石标签分组配置。
• 矿产中枢集中管理原矿、成品和流体的AE输出规则，支持搜索、物品／流体分别统一配置、当前网络自动选存储及指定戴森元件。目标不可用时保留来源缓存；有线连接与附近已加载范围内的无线发现分别处理。
• 可选植物魔法联动增加行星魔力和魔力输出端口；可选闪电科技联动由气态巨行星直接生成高压／极高压原生闪电资源，经资源输出规则存入ME网络，不再使用能源端口切换闪电模式，也不是普通物品或FE换算。

生物体系

• 新增戴森生物捕捉中枢、戴森生物处理中枢及可选联合控制器；捕捉与处理各司其职，由控制器关联管理，不要求建成固定形状的单台巨构。
• 生物处理改为明确的固定产物候选：由玩家选择一项，按本批刷怪蛋数量和机器倍率结算，不进行随机抽样，也不同时产出所有候选。
• 内置80份原版生物固定矩阵。未配置的模组生物保留刷怪蛋，不随机猜测战利品；整合包可通过数据包或本次新增JSON补充。
• 完善缓存取出、关联供蛋、ME输出、并行、产量、耗能、升级保存与设备拆装生命周期。至高特殊命中“万物之魂”效果为生物并行×2、产量×2、作业耗能÷2，与矿产鸿蒙升级的倍率体系区分。

界面与兼容修正

• 调整长文本、滚动、悬浮提示、低缩放布局、重复界面与返回路径；重整面向玩家的手册，配置与开发说明单独保留给整合包作者。
• 补充可选FTB Teams同队访问支持，仍保留中枢所有权与活动实例检查。
• 修正AE元件节点生命周期、CPU容量投影、中文名称，以及AE2LT beta4 版本标识的依赖判断。
• 相关参考项目仅用于架构借鉴，不新增对GTNH、GTL、GTO、ECO等项目的强制依赖，不修改官方AE2或Flux文件。

开发者与整合包作者：配置文件变更

以下区分1.3.0新文件、1.2.3以来扩展的配置能力和保留字段，不代表所有字段都在本次1.3.0首次新增。多人游戏请修改服务器使用的配置。

1. 1.3.0新增生物战利品配置

文件：config/dysoncubeproject-biological-loot.json。首次加载服务端世界资源时生成；默认 entities 为 {}，不改变数据包默认产物。生成文件的 _说明 和 _example 仅供阅读，修改示例不会自动生效。

{
  "format_version": 1,
  "entities": {
    "minecraft:zombie": {
      "drops": [
        { "id": "minecraft:rotten_flesh", "count": 4 },
        { "id": "minecraft:iron_ingot", "count": 7 }
      ]
    },
    "minecraft:bat": { "drops": [] }
  }
}

• entities 的键是实体注册ID，不是刷怪蛋ID。每个覆盖项整份替换该生物的数据包候选，未填写的生物不变。
• drops 支持物品 id、可选 count 和可选 components。count 默认为1，填写时必须是1至2147483647的整数；这是单蛋基础配方数量，不限制整批BigNumber数量。上例表示每个僵尸蛋选择4腐肉或7铁锭，再乘机器产量倍率。
• drops: [] 关闭该实体的战利品处理，不禁用捕捉，不删除现有蛋或成品。
• 文件使用UTF-8 JSON，最多4 MiB。服务端加载世界资源或执行 /reload 后生效，生产周期只读缓存，不反复读盘；只重开界面不会重载文件。
• 单个实体条目无效时隔离该实体并保留蛋；整文件损坏、版本不支持或读取失败时，保留上一次成功加载的完整候选快照并记录警告。首次尚无成功快照时暂不可处理，不猜测回退产物。
• 删除某实体覆盖后重载，可恢复其数据包候选。保留相同物品及组件时原选择继续有效；移除该候选需重新选择，既有成品不追溯重算。
• 数据包方式继续支持：data/<实体命名空间>/dyson_biology/loot_matrices/<实体路径>.json，内容为 {"drops":[...]}；本配置覆盖优先于数据包。

2. 全局TOML配置与默认值

文件：config/dysoncubeproject-addon-common.toml。编辑已有段落和字段，不要重复声明。下列为当前默认值，不是要求覆盖现有整合包设置。

[planetaryResources]
oreOverrides = []
disabledOres = []
fluidOverrides = []
fluidTags = []
disabledFluids = []
customPlanets = []
customStars = []

[botaniaMana]
enabled = true
planetIds = ["symbiotic"]
manaPerResourceUnit = 1
maxManaOutputPerCycle = 1000000

[lightningGeneration]
gasGiantLightningPerResourceUnit = 1

字段	格式或作用
oreOverrides	planet_id\|namespace:item_id\|weight，显式增加或替换行星物品资源。
disabledOres	planet_id\|namespace:item_id，禁用指定物品，优先于添加规则。
fluidOverrides	planet_id\|namespace:fluid_id\|weight，显式增加或替换流体。
fluidTags	planet_id\|namespace:tag\|weight，只展开实际标签中的源流体，不加入流动变体。
disabledFluids	planet_id\|namespace:fluid_id，禁用指定流体，优先于添加规则。
customPlanets / customStars	自定义名称、属性及贴图路径，格式见下。贴图须由资源包提供，配置不会自动生成图片。
botaniaMana.planetIds	可产魔力的行星ID；空列表不生成。
manaPerResourceUnit	每实际采矿资源单位附带的魔力；0不生成。
maxManaOutputPerCycle	每5服务器tick的有限魔力输出预算，不是缓存容量。
gasGiantLightningPerResourceUnit	每实际气态巨行星采矿资源单位分别生成两档闪电的基础量；0关闭新生成，不把闪电换算成FE。

自定义星体每项仍使用以下竖线分隔格式：

customPlanets:
id|display_name|category|base_template|min_mass_milli_earth|max_mass_milli_earth|abundance_basis_points|namespace:texture_path

customStars:
id|display_name|radius_rsun|mass_msun|temperature_k|base_power_fe|special|weight|minimum_wrapped|namespace:texture_path

weight 是相对选取权重，不是固定产量；显式资源覆盖可绕过自动筛选，禁用规则优先。minimum_wrapped 支持超出普通long范围的Flux整数／科学计数文本。

原有字段继续保留，不能视为本次新增：[oreProcessing] enabled=true, Cost=12000；[integration] aeNetworkEnabled=true, vmpPerformanceLogging=false。注意费用键为大写开头的 Cost。既有太阳帆配置和压缩配方JSON方式继续支持，没有要求强制删键或重置全部配置。

3. 升级、重载与迁移注意

• 升级前备份存档和配置，停服后替换附属，避免同一实例保留两份本附属JAR；无需修改官方AE2或Flux文件。
• TOML建议停服备份、修改后重启。生物JSON和数据包可用服务端 /reload；不要把它当成重读所有TOML的通用命令。
• 更严格的自然资源筛选可能移除旧版误收录的合成材料；需要保留这类自定义产出的整合包，应显式填写覆盖规则。
• 旧处理机AE导出规则迁入矿产中枢，升级后核对冲突、累计上限和指定目标；这些是机器保存设置，不是新TOML键。
• 旧共享闪电缓存保留一份，不复制成两份、不换算FE；不再沿用旧版“能源端口切高压／极高压”的操作。

本版范围与验证状态

• 本版独立瞬发合成只支持经核验的工作台配方；耐久工具、需要常规执行的返还物及处理样板不走这条直出路径。AE处理配方瞬发推迟到下一版本，矿产机器正常烧炼与生物处理不受此范围调整影响。
• 不包含未知第三方多方块的通用假合成，也不包含未来黑洞巨构。
• 1.3.0完整本地测试共2984项：2983通过、0失败／错误、1项外部Aelis兼容测试未运行。已完成构建；这不代表全部实机玩法、第三方界面或游戏性能均已验收，升级后请在测试副本验证。

English: Cumulative Update from 1.2.3 to 1.3.0

This summary compares local 1.2.3 release records with the current 1.3.0 implementation. Existing hubs, mining, compression, Dyson cells and basic AE integration are not presented as new features. A complete historical 1.2.3 artifact was unavailable, so this is not an exhaustive file-by-file diff.

Dyson Workbench Crafting and AE Integration

• Added Dyson Crafting Units, Parallel Units and an independent bulk request entry. Eligible workbench recipe chains consume their leaf ingredients and deliver final products to the requesting ME network without manufacturing and moving every intermediate item. For example, 162 iron nuggets can directly settle an order for two iron blocks.
• Supports multi-stage workbench dependencies, compression recipes, large quantities and supported ingredient alternatives. Eligibility comes from both active Dyson unit types on the current network, not an idle native AE CPU or its available memory.
• Added Dyson patterns, a pattern encoding terminal and a dedicated provider. Encoding, publication and execution validate real server recipes; declared outputs, JEI material lists or renamed blocks do not authorize arbitrary production.
• Improved material pages, shortage details, order selection, recovery and cancellation. Fixed missing or duplicated ingredient accounting when one Dyson cell is exposed through multiple filtered mounts. Native AE orders and independent Dyson requests remain separate paths.
• Removed the extra planning-node energy charge for independent workbench crafting. The ME network still needs normal power; native storage rules remain applicable.
• In 1.3.0, expanded bounded quantity parsing for the level-75 compression case, including 1e(1e1000). Material requirements, availability and shortages now use compact numbers instead of verbose Flux internal expressions, without reducing actual inventory or calculation precision.

Storage and Transfers

• Improved whole-quantity BigNumber item/fluid transfers for Dyson cells, hub exports and the Dyson I/O Port, rather than repeatedly moving long-sized chunks. Ordinary AE and third-party storage retain their own interface limits.
• Increased Dyson cell item/fluid type limits to Integer.MAX_VALUE; this does not imply unlimited physical memory.
• Added protections around partial acceptance, blocked retries, actual-received accounting, host save notifications, upgrade component retention and invalid stored data. The historical item-loss incident is not claimed to be diagnosed or permanently resolved.
• Improved Dyson terminal amounts and CPU fields, including the ℵ₀ capability marker and colored animation. Native finite AE values are not mathematical infinity, and Dyson-specific large-number slot rendering is not overlaid onto ordinary terminals.

Planetary Resources, Processing and Export

• Tightened automatic resource discovery using natural-generation evidence, reducing crafted materials incorrectly classified as natural ores. Extended reviewed AE meteorite, Mekanism vein, source-fluid and compound-resource paths, including supported generation-config gates.
• Improved resource previews, cache invalidation and reload synchronization, with a resource export diagnostic for pack authors. Unknown generators may still require explicit overrides.
• Changed base ore-processing output to 1× and improved upgrades, parallel/output/energy allocation, partial batches when power is limited, costs and UI refreshes.
• Added a Dyson cell input slot for rule-based smelting of stored ingredients, plus unified smelting and ore-tag group settings.
• Centralized raw-item, processed-item and fluid AE export rules in the mining hub, including search, separate bulk item/fluid settings, automatic network storage selection and specific-cell targets. Unavailable targets retain source buffers. Wired connections and nearby loaded-area wireless discovery remain distinct.
• Optional Botania integration adds planetary mana and a Mana Output Port. Optional Lightning Tech integration produces native high/extreme-voltage lightning resources on gas giants and exports them through resource rules; lightning is neither an ordinary item nor an FE conversion or energy-port mode.

Biological System

• Added capture and processing hubs and an optional joint controller. Each device keeps its role and can be associated with the controller without constructing a fixed-shape megastructure.
• Processing now uses explicit fixed output candidates. Players select one candidate per batch, multiplied by egg count and machine output upgrades; no random sampling or simultaneous production of every candidate.
• Includes 80 vanilla fixed matrices. Unconfigured modded entities retain their eggs rather than guessing loot; packs can supply a datapack or the new JSON configuration.
• Improved buffer collection, egg handoff, ME export, upgrades, persistence and block lifecycle handling. The supreme biological effect “万物之魂” provides 2× parallelism, 2× output and half operating energy, separate from mining upgrade multipliers.

UI and Compatibility

• Adjusted long text, scrolling, tooltips, small-scale layouts, duplicate screens and return navigation. Reorganized player-facing documentation separately from author configuration.
• Added optional FTB Teams access for team members while retaining ownership and active-instance checks.
• Fixed AE unit node lifecycle, native CPU capacity projection, localized names and AE2LT beta4 dependency-version recognition.
• Reference projects remain architectural references, not new mandatory dependencies. Official AE2 and Flux files are not modified.

For Developers and Modpack Authors: Configuration Changes

The following distinguishes the new 1.3.0 file, configuration extensions accumulated since 1.2.3 and retained settings. It does not claim that every listed key was first added in 1.3.0. Multiplayer changes belong on the server.

1. New Biological Loot JSON in 1.3.0

config/dysoncubeproject-biological-loot.json is generated when server world resources first load. The default entities object is empty, preserving datapack defaults. Generated _说明 and _example fields are inactive documentation, not overrides.

{
  "format_version": 1,
  "entities": {
    "minecraft:zombie": {
      "drops": [
        { "id": "minecraft:rotten_flesh", "count": 4 },
        { "id": "minecraft:iron_ingot", "count": 7 }
      ]
    },
    "minecraft:bat": { "drops": [] }
  }
}

• Keys are entity registry IDs, not spawn-egg IDs. Each override replaces that entity's entire datapack candidate list; unlisted entities remain unchanged.
• Candidates accept an item id, optional count and optional ItemStack components. count defaults to 1 and must be an integer from 1 to 2147483647. This is the base yield per egg, not a limit on BigNumber batch size. The example offers four rotten flesh OR seven iron ingots before machine multipliers.
• An empty drops array disables loot processing for that entity, not capture, stored eggs or existing products.
• Use UTF-8 JSON, up to 4 MiB. World-resource loading or server /reload applies it; production ticks only read cached data. Reopening a screen does not reload the file.
• Invalid entity entries are isolated while retaining eggs. A malformed, unsupported or unreadable whole file retains the last successfully loaded complete candidate snapshot and logs a warning. With no prior successful snapshot, processing remains unavailable rather than inventing fallback loot.
• Removing an override and reloading restores datapack candidates. Matching item/component selections survive reload; removed candidates require reselection. Existing products are not recalculated.
• Datapacks remain supported at data/<entity_namespace>/dyson_biology/loot_matrices/<entity_path>.json, containing {"drops":[...]}. The configuration file takes precedence.

2. Common TOML Settings

File: config/dysoncubeproject-addon-common.toml. Edit existing sections rather than duplicating them. These are current defaults, not instructions to replace existing pack settings:

[planetaryResources]
oreOverrides = []
disabledOres = []
fluidOverrides = []
fluidTags = []
disabledFluids = []
customPlanets = []
customStars = []

[botaniaMana]
enabled = true
planetIds = ["symbiotic"]
manaPerResourceUnit = 1
maxManaOutputPerCycle = 1000000

[lightningGeneration]
gasGiantLightningPerResourceUnit = 1

Key	Format or purpose
oreOverrides	planet_id\|namespace:item_id\|weight: explicitly add or replace an item resource.
disabledOres	planet_id\|namespace:item_id: disable an item, taking priority over additions.
fluidOverrides	planet_id\|namespace:fluid_id\|weight: explicitly add or replace a fluid.
fluidTags	planet_id\|namespace:tag\|weight: expand registered source fluids only, excluding flowing variants.
disabledFluids	planet_id\|namespace:fluid_id: disable a fluid, taking priority over additions.
customPlanets / customStars	Customize names, attributes and texture paths using the formats below. Supply textures separately in a resource pack.
botaniaMana.planetIds	Planet IDs that generate mana; an empty list generates none.
manaPerResourceUnit	Mana per actually mined resource unit; 0 generates none.
maxManaOutputPerCycle	Finite mana output budget per five server ticks, not buffer capacity.
gasGiantLightningPerResourceUnit	Base amount generated separately for both lightning tiers per actually mined gas-giant resource unit; 0 disables new generation, without converting lightning into FE.

Pipe-separated celestial definitions:

customPlanets:
id|display_name|category|base_template|min_mass_milli_earth|max_mass_milli_earth|abundance_basis_points|namespace:texture_path

customStars:
id|display_name|radius_rsun|mass_msun|temperature_k|base_power_fe|special|weight|minimum_wrapped|namespace:texture_path

Weights are relative selection weights, not fixed yields. Explicit resource overrides bypass automatic filters; disabled entries take precedence. minimum_wrapped accepts Flux integer/scientific notation beyond the ordinary long range.

Retained, not newly introduced settings: [oreProcessing] enabled=true, Cost=12000; [integration] aeNetworkEnabled=true, vmpPerformanceLogging=false. The cost key is capitalized Cost. Existing solar-sail settings and compression-recipe JSON remain supported; no blanket key deletion or configuration reset is required.

3. Upgrade and Reload Notes

• Back up worlds and configuration, stop the server, and replace the addon without keeping duplicate addon JARs. Do not patch official AE2 or Flux files.
• For TOML, back up, edit and restart. Biological JSON and datapacks support server /reload; it is not a universal TOML reread command.
• Stricter natural-resource discovery can remove crafted materials incorrectly included by older rules. Add explicit overrides if the pack intentionally wants them.
• Older processor AE export rules migrate into the mining hub. Check conflicts, cumulative limits and selected targets after upgrading; these are saved machine settings, not new TOML keys.
• Legacy shared lightning retains one balance, not a duplicated balance for both tiers or an FE conversion. Old energy-port lightning-mode instructions no longer apply.

Scope and Validation

• Independent instant crafting in this version is limited to validated workbench recipes. Durability-based tools, return-item recipes requiring normal execution and processing patterns do not use this direct-output path. Instant AE processing recipes are deferred to the next version; ordinary machine smelting and biological processing remain available.
• Generic arbitrary third-party multiblock fabrication and the planned black-hole megastructure are not included.
• The final local 1.3.0 run contains 2984 tests: 2983 passed, no failures/errors and one external Aelis compatibility test not run. The build is complete; this does not establish that all gameplay, third-party UI or in-game performance has been validated. Test upgrades in a separate world copy.