Structure DFU Cache

结构 DFU 缓存

将重复的结构 DataFixerUpper（DFU）迁移工作移至启动阶段，并缓存处理结果，从而在大量加载区块时提升 TPS。

工作原理

• 在游戏启动或重载时，统一解析服务端结构资源。
• 通过兼容原版的资源包层提供并缓存处理后的结构。

配置

从 1.2.0 开始，可在 config/structure_dfu_cache.toml 中配置处理限制；这些设置会在游戏启动时加载（编辑后需要重启游戏）：

# Maximum decoded NBT memory quota in MiB (tracks NBT decoder accounting of NBT objects and allocation overhead)
maxDecodedNbtMiB = 1024

# Maximum compressed structure resource size in MiB
maxCompressedResourceMiB = 64

• 两个选项都必须是正整数，单位为 MiB。
• maxDecodedNbtMiB用于记录 NBT 解码器在处理过程中对内存中 NBT 对象及分配开销的统计（不代表 DFU 的总内存占用）。
• 工作线程并发数会根据可用堆内存估算：先扣除常驻内存和 2 GiB 预留，再按每个工作线程约 4 倍 maxDecodedNbtMiB 的预算计算（最多 4 个线程；CPU 核心数超过 1 时会空出 1 个核心）。提高配额值会减少并行工作线程，为转换留出更多内存余量。
• 当压缩后的资源大小超过 maxCompressedResourceMiB 时，将跳过启动预处理，交由原版读取结构。当解码后的 NBT 超过 maxDecodedNbtMiB 或转换失败时，会将原始压缩字节缓存为未优化资源，并在之后加载或重载时重试。

依赖

请安装以下模组作为前置：

• RinLib