跳至主要內容

config.yml 配置详解

2026/1/16大约 45 分钟插件文档AkiAsync配置

config.yml 配置详解

主配置文件，包含 AkiAsync 所有核心功能的开关和参数设置。

基础配置

# 配置版本，请勿修改
version: 20
配置项类型默认值说明
version整数20配置文件版本号，用于插件内部版本管理，请勿手动修改

统一线程池配置

general-thread-pool:
  size: 0
配置项类型默认值说明
size整数0统一线程池大小。0 = 自动分配（CPU核心数÷4，最小为2）；>0 = 手动指定线程数量

调优建议

  • 推荐保持默认值 0，让插件根据服务器硬件自动分配
  • 如果服务器 CPU 核心数较少（如 2-4 核），可以手动设置为 2
  • 如果服务器 CPU 核心数较多（如 16+ 核），可以适当增加到 4-6
  • 更多线程 ≠ 更好性能，过多线程会增加上下文切换开销

实体系统优化

多线程实体追踪器 (entity-tracker)

entity-tracker:
  enabled: true
配置项类型默认值说明
enabled布尔true是否启用多线程实体追踪器

功能说明

多线程实体追踪器将实体追踪计算分散到多个线程并行处理，而不是在主线程串行执行。

性能提升：可降低 MSPT 10-30%，尤其在实体密集的区域效果显著。

工作原理：

  1. 收集需要追踪的实体列表
  2. 将实体分批分配给工作线程
  3. 各线程并行计算实体的可见性和追踪数据
  4. 汇总结果并同步到主线程

异步生物生成 (mob-spawning)

mob-spawning:
  enabled: true
  spawner-optimization: true
  spawn-interval: 1
配置项类型默认值说明
enabled布尔true是否启用异步生物生成
spawner-optimization布尔true是否优化刷怪笼性能，减少刷怪笼的计算开销
spawn-interval整数1生成频率。1 = 每 tick 检查生成；2 = 每 2 tick 检查一次，以此类推

功能说明

异步生物生成将自然生成的逻辑计算移至异步线程，避免阻塞主线程。

spawn-interval 参数详解：

  • 1（默认）：每 tick 都检查生物生成，生成速度最快，但 CPU 占用较高
  • 2：每 2 tick 检查一次，生成速度降低约 50%，但 CPU 占用明显降低
  • 3-5：适合对生成速度要求不高的服务器，可大幅降低 CPU 占用

spawner-optimization 参数详解：

  • 启用后，刷怪笼会使用优化的生成算法
  • 减少不必要的碰撞检测和位置验证
  • 对于大量刷怪笼的服务器效果显著

实体密度控制 (density)

density:
  enabled: true
  max-per-chunk: 80
配置项类型默认值说明
enabled布尔true是否启用实体密度控制
max-per-chunk整数80单个区块内允许的最大实体数量

功能说明

实体密度控制限制单个区块内的实体数量，防止实体过多导致的卡顿。

max-per-chunk 参数详解：

  • 80（默认）：适合大多数服务器，平衡性能和游戏体验
  • 50-60：适合性能较差的服务器，更严格的限制
  • 100-150：适合高性能服务器，允许更多实体

注意事项：

  • 此限制包括所有类型的实体（生物、掉落物、投射物等）
  • 超过限制后，新实体可能无法在该区块生成
  • 不会移除已存在的实体，只阻止新实体生成

AI 降频 (brain)

brain:
  enabled: true
  throttle-interval: 10
配置项类型默认值说明
enabled布尔true是否启用 AI 降频
throttle-interval整数10静止实体的 AI 更新间隔（tick）

功能说明

AI 降频对静止不动的实体降低 AI 更新频率，节省 CPU 资源。

throttle-interval 参数详解：

  • 10（默认）：静止实体每 10 tick（0.5 秒）更新一次 AI
  • 5：更频繁的更新，AI 反应更灵敏，但 CPU 占用更高
  • 20：更低的更新频率，更省 CPU，但 AI 反应可能略迟钝

工作原理：

  1. 检测实体是否处于静止状态（无移动、无目标）
  2. 静止实体的 AI 更新频率降低到每 N tick 一次
  3. 一旦实体开始移动或有新目标，立即恢复正常更新频率

适用场景：

  • 大量动物聚集的农场
  • 村民交易所
  • 任何有大量静止生物的区域

窒息优化 (suffocation-optimization)

suffocation-optimization:
  enabled: true
配置项类型默认值说明
enabled布尔true是否启用窒息检测优化

功能说明

窒息优化仅在实体能够受到伤害时才进行窒息检测，减少不必要的计算。

优化原理：

  • 原版每 tick 都会检测所有实体是否窒息
  • 优化后，只有当实体处于可受伤状态时才检测
  • 跳过无敌时间内的实体、创造模式玩家等

性能提升：减少约 5-10% 的实体 tick 计算量

抛射物优化 (projectile)

projectile:
  enabled: true
  max-loads-per-tick: 10
  max-loads-per-projectile: 10
配置项类型默认值推荐范围说明
enabled布尔true-是否启用抛射物优化
max-loads-per-tick整数108-15每 tick 所有抛射物最多加载的区块数
max-loads-per-projectile整数108-15单个抛射物在其生命周期内最多加载的区块数

功能说明

抛射物优化限制抛射物（箭、三叉戟、末影珍珠等）加载区块的能力，防止抛射物导致的卡顿。

问题背景：

  • 高速飞行的抛射物会触发大量区块加载
  • 末影珍珠、三叉戟等可以飞行很远
  • 大量抛射物同时飞行会导致严重卡顿

参数调优：

  • max-loads-per-tick：控制每 tick 的总区块加载量
    • 值越小，服务器越稳定，但抛射物可能"卡住"
    • 值越大，抛射物飞行更流畅，但可能造成卡顿
  • max-loads-per-projectile：控制单个抛射物的区块加载量
    • 限制单个抛射物的影响范围
    • 防止单个末影珍珠加载过多区块

虚拟实体兼容性 (virtual-entity-compatibility)

virtual-entity-compatibility:
  enabled: true
  bypass-packet-queue: true
  exclude-from-throttling: true
  
  plugins:
    fancynpcs:
      enabled: true
      use-api: true
      priority: 90
    znpcsplus:
      enabled: true
      use-api: false
      priority: 90
配置项类型默认值说明
enabled布尔true是否启用虚拟实体兼容
bypass-packet-queue布尔true虚拟实体的数据包是否绕过队列直接发送
exclude-from-throttling布尔true是否将虚拟实体从所有节流优化中排除

plugins 子配置：

配置项类型默认值说明
fancynpcs.enabled布尔true是否识别 FancyNpcs 插件的 NPC
fancynpcs.use-api布尔true是否使用 API 检测（更准确）
fancynpcs.priority整数90检测优先级（数值越高越优先）
znpcsplus.enabled布尔true是否识别 ZNPCsPlus 插件的 NPC
znpcsplus.use-api布尔false是否使用 API 检测（ZNPCsPlus 使用名称前缀检测）
znpcsplus.priority整数90检测优先级

重要提示

禁用此功能后，虚拟实体插件（如 FancyNpcs、ZNPCsPlus、Citizens 等）可能无法正常显示 NPC。

影响范围：

  • 实体包节流
  • 掉落物优化
  • 下落方块优化
  • 其他实体相关优化

如果你使用了 NPC 插件但 NPC 不显示，请确保此功能已启用。

实体碰撞优化 (collision-optimization)

collision-optimization:
  enabled: true
  exclusion-list-file: "entities.yml"
配置项类型默认值说明
enabled布尔true是否启用实体碰撞优化
exclusion-list-file字符串"entities.yml"排除列表配置文件路径

功能说明

实体碰撞优化针对密集实体环境提供高性能碰撞检测优化。

性能提升：40-60%，在实体密集区域效果尤为显著。

排除列表：某些需要精确物理的实体（如 TNT）可以添加到排除列表，详见 entities.yml 配置。

原生碰撞检测 (native)

  native:
    enabled: true
    fallback-enabled: true
配置项类型默认值说明
enabled布尔true是否启用原生碰撞检测
fallback-enabled布尔true不支持时是否降级到普通逻辑

功能说明

原生碰撞检测使用堆外内存和 AVX SIMD 向量化技术加速碰撞计算。

技术要求：

  • JDK 17 或更高版本
  • 需要添加 JVM 参数：--add-modules jdk.incubator.vector

fallback-enabled 说明：

  • true：如果服务器不支持原生检测，自动降级到普通逻辑
  • false：不支持时直接禁用此优化

性能提升：在支持的硬件上可提升 2-3 倍碰撞检测速度。

基础碰撞优化

  aggressive-mode: true
配置项类型默认值说明
aggressive-mode布尔true是否启用激进模式，跳过更多检查

功能说明

激进模式会跳过一些不太重要的碰撞检查，进一步提升性能。

跳过的检查包括：

  • 静止实体的碰撞检测
  • Paper 配置中已禁用的碰撞类型
  • 某些边缘情况的检测

注意：极少数情况下可能导致碰撞行为与原版略有差异。

方块缓存 (block-cache)

  block-cache:
    enabled: true
    cache-size: 512
    expire-ticks: 600
配置项类型默认值推荐范围说明
enabled布尔true-是否启用方块缓存
cache-size整数512256-1024缓存大小（条目数）
expire-ticks整数600400-1200缓存过期时间（tick，600 = 30 秒）

功能说明

方块缓存缓存碰撞检测中的方块状态查询结果，避免重复查询。

性能提升：10-15%

参数调优：

  • cache-size：
    • 较小的值（256）：内存占用低，但缓存命中率可能较低
    • 较大的值（1024）：缓存命中率高，但内存占用增加
  • expire-ticks：
    • 较短的时间（400）：缓存更新更及时，适合方块变化频繁的服务器
    • 较长的时间（1200）：缓存命中率更高，适合方块变化较少的服务器

Nitori/Lithium 实体优化 (nitori-entity-optimizations)

  nitori-entity-optimizations:
    mob-sunburn-optimization:
      enabled: true
    entity-speed-optimization:
      enabled: true
    entity-fall-damage-optimization:
      enabled: true
    entity-section-storage-optimization:
      enabled: true
配置项类型默认值说明
mob-sunburn-optimization.enabled布尔true生物日光燃烧优化：缓存 BlockPos，提前检查亮度
entity-speed-optimization.enabled布尔true实体速度优化：缓存方块速度因子
entity-fall-damage-optimization.enabled布尔true实体掉落伤害优化：跳过简单实体的掉落伤害计算
entity-section-storage-optimization.enabled布尔true实体区段快速检索优化：小区域使用直接哈希查找

功能说明

这些优化来源于 Nitori 和 Lithium Fabric 模组，经过移植和适配。

各优化详解：

  1. mob-sunburn-optimization（生物日光燃烧优化）

    • 缓存 BlockPos 对象，减少对象创建
    • 提前检查亮度等级，跳过不必要的计算
    • 对于大量亡灵生物的服务器效果显著

  2. entity-speed-optimization（实体速度优化）

    • 缓存方块的速度因子（如灵魂沙减速）
    • 避免每 tick 重复查询方块属性
    • 对于大量实体移动的场景效果显著

  3. entity-fall-damage-optimization（实体掉落伤害优化）

    • 跳过不需要计算掉落伤害的实体（如鸡、猫等）
    • 减少不必要的伤害计算

  4. entity-section-storage-optimization（实体区段快速检索优化）

    • 对于小区域的实体查询使用直接哈希查找
    • 避免遍历整个区段列表
    • 对于频繁的实体查询操作效果显著

射线碰撞检测 (ray-collision)

  ray-collision:
    enabled: true
    max-distance: 64.0
配置项类型默认值说明
enabled布尔true是否启用射线碰撞检测优化
max-distance浮点64.0最大检测距离（方块）

功能说明

射线碰撞检测使用 DDA（Digital Differential Analyzer）算法优化射线追踪。

性能提升：50-70%

应用场景：

  • 实体视线检测
  • 投射物碰撞检测
  • 玩家交互射线检测

max-distance 说明：

  • 超过此距离的射线检测将被截断
  • 较小的值可以提升性能，但可能影响远距离检测
  • 64 方块对于大多数场景已经足够

形状优化 (shape-optimization)

  shape-optimization:
    enabled: true
    precompute-arrays: true
    block-shape-cache: true
    cache-size: 512
配置项类型默认值推荐范围说明
enabled布尔true-是否启用形状优化
precompute-arrays布尔true-是否预计算形状数组
block-shape-cache布尔true-是否启用方块形状缓存
cache-size整数512512-2048缓存大小

功能说明

形状优化预计算和缓存碰撞形状，减少对象分配和重复计算。

性能提升：方块形状缓存可提升 2-3 倍碰撞形状查询速度。

各参数详解：

  1. precompute-arrays

    • 在服务器启动时预计算常用的形状数组
    • 减少运行时的计算开销
    • 会略微增加启动时间

  2. block-shape-cache

    • 缓存方块的碰撞形状
    • 避免每次碰撞检测都重新计算形状
    • 对于复杂形状的方块（如楼梯、栅栏）效果显著

  3. cache-size

    • 较小的值（512）：适合内存有限的服务器
    • 较大的值（2048）：适合方块种类繁多的模组服务器

实体移动优化 (living-entity-travel-optimization)

living-entity-travel-optimization:
  enabled: true
  skip-interval: 2
配置项类型默认值说明
enabled布尔true是否启用实体移动优化
skip-interval整数2每 N 个 tick 处理一次移动计算

功能说明

实体移动优化降低实体移动计算的频率，减少 CPU 占用。

skip-interval 参数详解：

  • 1：每 tick 都计算移动（原版行为）
  • 2（默认）：每 2 tick 计算一次，性能提升约 50%
  • 3-4：更低的计算频率，但可能导致移动不够平滑

注意事项：

  • 此优化主要影响生物的移动计算
  • 玩家移动不受影响
  • 过高的 skip-interval 可能导致生物移动看起来"卡顿"

生物消失检查优化 (mob-despawn-optimization)

mob-despawn-optimization:
  enabled: true
  check-interval: 20
配置项类型默认值说明
enabled布尔true是否启用生物消失检查优化
check-interval整数20消失检查间隔（tick，20 = 1 秒）

功能说明

生物消失检查优化降低生物消失检查的频率，减少不必要的计算。

check-interval 参数详解：

  • 20（默认）：每秒检查一次，平衡性能和响应速度
  • 10：每 0.5 秒检查一次，响应更快但 CPU 占用更高
  • 40：每 2 秒检查一次，更省 CPU 但消失响应较慢

原版行为：原版每 tick 都会检查生物是否应该消失，这是不必要的开销。

并行实体 Tick (entity-tick-parallel)

entity-tick-parallel:
  enabled: true
  min-entities: 50
  batch-size: 8
配置项类型默认值说明
enabled布尔true是否启用并行实体 Tick
min-entities整数50低于此实体数量时不启用并行处理
batch-size整数8每批处理的实体数量

功能说明

并行实体 Tick使用多线程并行处理实体的 tick 更新，充分利用多核 CPU。

参数详解：

  1. min-entities

    • 当区域内实体数量低于此值时，使用单线程处理
    • 避免小规模场景下多线程的额外开销
    • 推荐值：30-100

  2. batch-size

    • 每个工作线程一次处理的实体数量
    • 较小的值（4-8）：负载更均衡，但调度开销更大
    • 较大的值（16-32）：调度开销小，但可能负载不均

线程数：由 general-thread-pool.size 统一控制。

性能提升：在实体密集区域可提升 30-50% 的实体处理性能。

实体节流 (entity-throttling)

entity-throttling:
  enabled: false
  config-file: "throttling.yml"
  check-interval: 100
  throttle-interval: 3
  removal-batch-size: 10
配置项类型默认值说明
enabled布尔false是否启用实体节流（默认关闭）
config-file字符串"throttling.yml"节流配置文件路径
check-interval整数100检查间隔（每 N tick 检查一次）
throttle-interval整数3节流间隔（超限后每 N tick 更新一次）
removal-batch-size整数10每次检查最多移除的实体数量

谨慎启用

此功能默认关闭，因为可能影响游戏机制。启用前请仔细阅读 throttling.yml 配置。

影响范围：

  • 刷怪塔效率可能降低
  • 大型农场可能受限
  • 某些红石机器可能受影响

功能说明

实体节流根据配置文件对特定实体类型进行数量限制和节流。

参数详解：

  1. check-interval

    • 每 100 tick（5 秒）检查一次实体数量
    • 较小的值：响应更快，但 CPU 占用更高
    • 较大的值：响应较慢，但更省 CPU

  2. throttle-interval

    • 当实体数量超过限制时，这些实体每 3 tick 才更新一次
    • 降低超限实体的更新频率，减少性能影响

  3. removal-batch-size

    • 每次检查最多移除 10 个超限实体
    • 避免一次性移除大量实体导致的卡顿
    • 移除优先级：最早生成的实体优先被移除

异步 AI (async-ai)

异步寻路 (async-pathfinding)

async-ai:
  async-pathfinding:
    enabled: true
    keep-alive-seconds: 60
    max-queue-size: 500
    timeout-ms: 100
    sync-fallback-enabled: true
配置项类型默认值推荐范围说明
enabled布尔true-是否启用异步寻路
keep-alive-seconds整数6030-120线程存活时间（秒）
max-queue-size整数500500-1000最大队列大小
timeout-ms整数10050-200寻路超时时间（毫秒）
sync-fallback-enabled布尔true-异步失败时是否使用同步寻路

功能说明

异步寻路将寻路计算移至异步线程，避免阻塞主线程。

参数详解：

  1. keep-alive-seconds

    • 工作线程在空闲多久后被回收
    • 较短的时间：节省内存，但频繁创建线程有开销
    • 较长的时间：线程复用率高，但占用更多内存

  2. max-queue-size

    • 等待处理的寻路请求队列大小
    • 队列满时，新请求会被丢弃或降级到同步处理
    • 推荐值：500-1000

  3. timeout-ms

    • 单次寻路计算的超时时间
    • 超时后会返回部分路径或失败
    • 较短的时间：响应更快，但可能找不到最优路径
    • 较长的时间：路径质量更好，但可能造成延迟

  4. sync-fallback-enabled

    • 当异步寻路失败时，是否降级到同步寻路
    • 建议保持启用，确保生物总能找到路径

增强寻路系统 (enhanced)

    enhanced:
      enabled: true
      max-concurrent-requests: 30
      max-requests-per-tick: 15
      
      priority:
        high-distance: 16
        medium-distance: 48
      
      cache:
        hot-size: 150
        warm-size: 400
        cold-size: 800
        hot-expire-seconds: 10
        warm-expire-seconds: 30
        cold-expire-seconds: 60
        similarity-tolerance: 3
      
      prewarm:
        enabled: true
        radius: 32
        max-mobs-per-batch: 5
        max-pois-per-mob: 3
        batch-delay-ms: 100
        total-time-seconds: 5

基础配置：

配置项类型默认值说明
enabled布尔true是否启用增强寻路系统
max-concurrent-requests整数30最大并发寻路请求数
max-requests-per-tick整数15每 tick 最多处理的新请求数

优先级配置 (priority)：

配置项类型默认值说明
high-distance整数16高优先级距离阈值（方块）
medium-distance整数48中优先级距离阈值（方块）

多层缓存配置 (cache)：

配置项类型默认值说明
hot-size整数150热缓存容量（最常用的路径）
warm-size整数400温缓存容量（较常用的路径）
cold-size整数800冷缓存容量（不常用的路径）
hot-expire-seconds整数10热缓存过期时间（秒）
warm-expire-seconds整数30温缓存过期时间（秒）
cold-expire-seconds整数60冷缓存过期时间（秒）
similarity-tolerance整数3路径相似度容差（方块）

预热配置 (prewarm)：

配置项类型默认值说明
enabled布尔true是否启用路径预热
radius整数32预热半径（方块）
max-mobs-per-batch整数5每批最多预热的生物数
max-pois-per-mob整数3每个生物最多预热的 POI 数
batch-delay-ms整数100批次延迟（毫秒）
total-time-seconds整数5总预热时间（秒）

功能说明

增强寻路系统提供优先级队列、多层缓存和路径预热功能，全方位提升寻路性能。

优先级系统：

  • 距离玩家 16 方块内的寻路请求：高优先级
  • 距离玩家 16-48 方块的寻路请求：中优先级
  • 距离玩家 48 方块以上的寻路请求：低优先级

多层缓存：

  • 热缓存：存储最近使用的路径，过期时间短
  • 温缓存：存储较常用的路径，过期时间中等
  • 冷缓存：存储不常用的路径，过期时间长
  • similarity-tolerance：如果起点和终点在容差范围内，可以复用缓存的路径

路径预热：

  • 在服务器启动或区块加载时，预先计算常用路径
  • 减少运行时的寻路计算量

AI 传感器优化 (sensor-optimization)

  sensor-optimization:
    enabled: true
    sensing-refresh-interval: 5
配置项类型默认值说明
enabled布尔true是否启用 AI 传感器优化
sensing-refresh-interval整数5视线缓存清空间隔（tick）

功能说明

AI 传感器优化延长视线缓存的清空间隔，减少昂贵的射线追踪计算。

sensing-refresh-interval 参数详解：

  • 5（默认）：每 5 tick（0.25 秒）清空一次视线缓存
  • 3：更频繁的更新，AI 反应更灵敏
  • 10：更低的更新频率，更省 CPU

工作原理：

  • 生物的视线检测结果会被缓存
  • 在缓存有效期内，不会重复进行射线追踪
  • 缓存过期后才会重新计算

游戏事件系统优化 (game-event-optimization)

  game-event-optimization:
    enabled: true
    early-filter: true
    throttle-low-priority: true
    throttle-interval-ms: 50
    distance-filter: true
    max-detection-distance: 64.0
配置项类型默认值说明
enabled布尔true是否启用游戏事件系统优化
early-filter布尔true是否提前过滤不关心的事件
throttle-low-priority布尔true是否节流低优先级事件
throttle-interval-ms整数50节流间隔（毫秒）
distance-filter布尔true是否启用距离过滤
max-detection-distance浮点64.0最大检测距离（方块）

功能说明

游戏事件系统优化提前过滤不关心的事件，减少 Sculk Sensor 等方块的处理开销。

各参数详解：

  1. early-filter

    • 在事件传播前就过滤掉不需要处理的事件
    • 减少事件处理的总量

  2. throttle-low-priority

    • 对低优先级事件进行节流
    • 避免大量低优先级事件占用 CPU

  3. throttle-interval-ms

    • 低优先级事件的最小处理间隔
    • 50ms 意味着同一类型的低优先级事件每 50ms 最多处理一次

  4. distance-filter

    • 过滤超出检测距离的事件
    • 减少远距离事件的处理

  5. max-detection-distance

    • 超过此距离的事件不会被处理
    • 64 方块对于大多数场景已经足够

村民优化 (villager-optimization)

  villager-optimization:
    fast-raytrace:
      enabled: true
      cache-size: 256
    breed-optimization:
      async-villager-breed: true
      age-throttle: true
      check-interval: 5

快速射线追踪 (fast-raytrace)：

配置项类型默认值说明
enabled布尔true是否启用快速射线追踪
cache-size整数256缓存大小

繁殖优化 (breed-optimization)：

配置项类型默认值说明
async-villager-breed布尔true是否异步处理村民繁殖
age-throttle布尔true是否启用年龄节流
check-interval整数5检查间隔（tick）

功能说明

村民优化针对村民的特殊行为进行优化。

fast-raytrace：

  • 缓存村民的视线检测结果
  • 减少村民之间的射线追踪计算
  • 对于大型村民交易所效果显著

breed-optimization：

  • 异步处理村民繁殖逻辑
  • 年龄节流：降低幼年村民的更新频率
  • 减少村民繁殖时的 CPU 占用

VMP 优化套件 (vmp-optimizations)

vmp-optimizations:
  chunk-loading:
    enabled: true
    max-concurrent-per-player: 5
  
  entity-tracking:
    enabled: true
    range-multiplier: 0.8

区块加载优化 (chunk-loading)：

配置项类型默认值说明
enabled布尔true是否启用区块加载优化
max-concurrent-per-player整数5每玩家最大并发区块加载数

实体追踪优化 (entity-tracking)：

配置项类型默认值说明
enabled布尔true是否启用实体追踪优化
range-multiplier浮点0.8追踪范围倍数（0.8 = 原版的 80%）

功能说明

VMP 优化套件来源于 VMP（Very Many Players）模组。

chunk-loading：

  • 限制每个玩家同时加载的区块数量
  • 防止大量玩家同时传送导致的卡顿
  • 推荐值：3-8

entity-tracking：

  • 减少实体追踪范围以降低网络和 CPU 开销
  • 0.8 意味着追踪范围是原版的 80%
  • 推荐值：0.6-1.0

掉落物优化 (item-entity-optimizations)

智能合并 (smart-merge)

item-entity-optimizations:
  smart-merge:
    enabled: true
    cancel-vanilla-merge: true
    merge-interval: 5
    min-nearby-items: 3
    merge-range: 1.5
配置项类型默认值推荐范围说明
enabled布尔true-是否启用智能合并
cancel-vanilla-merge布尔true-是否取消原版合并逻辑
merge-interval整数55-10合并检查间隔（tick）
min-nearby-items整数33-5触发合并的最少附近物品数
merge-range浮点1.51.5-2.5合并范围（方块）

功能说明

智能合并智能合并附近的掉落物，减少实体数量。

性能提升：60-80%，降低 2-4ms MSPT。

参数详解：

  1. cancel-vanilla-merge

    • 取消原版的合并逻辑，避免重复处理
    • 建议保持启用

  2. merge-interval

    • 每 N tick 检查一次是否需要合并
    • 较小的值：合并更及时，但 CPU 占用更高
    • 较大的值：合并延迟增加，但更省 CPU

  3. min-nearby-items

    • 只有当附近物品数量达到此值时才触发合并
    • 避免对少量物品进行不必要的合并检查

  4. merge-range

    • 在此范围内的相同物品会被合并
    • 较大的范围：合并更积极，但可能影响物品分布

年龄优化 (age-optimization)

  age-optimization:
    enabled: true
    age-interval: 10
    player-detection-range: 8.0
配置项类型默认值推荐范围说明
enabled布尔true-是否启用年龄优化
age-interval整数1010-20年龄更新间隔（tick）
player-detection-range浮点8.08.0-16.0玩家检测范围（方块）

功能说明

年龄优化对静止的掉落物降低 tick 频率，大幅节省性能。

性能提升：80-90%，降低 3-5ms MSPT。

参数详解：

  1. age-interval

    • 静止物品每 N tick 更新一次年龄
    • 原版每 tick 都更新，这是不必要的

  2. player-detection-range

    • 在此范围内有玩家时，物品恢复正常更新频率
    • 确保玩家附近的物品行为正常

Inactive Tick 优化 (inactive-tick)

  inactive-tick:
    enabled: true
    inactive-range: 32.0
    merge-interval: 100
配置项类型默认值说明
enabled布尔true是否启用 Inactive Tick 优化
inactive-range浮点32.0不活跃范围（方块）
merge-interval整数100简化 tick 中的合并间隔

功能说明

Inactive Tick 优化对远离玩家的掉落物使用简化的 tick 逻辑。

性能提升：30-50%

参数详解：

  1. inactive-range

    • 超过此距离的掉落物使用简化 tick
    • 简化 tick 只处理必要的逻辑（如年龄增长）

  2. merge-interval

    • 简化 tick 中的合并检查间隔
    • 100 tick = 5 秒检查一次

经验球优化 (experience-orb-optimizations)

experience-orb-optimizations:
  inactive-tick:
    enabled: true
    inactive-range: 32.0
    merge-interval: 100
配置项类型默认值说明
enabled布尔true是否启用经验球优化
inactive-range浮点32.0不活跃范围（方块）
merge-interval整数100合并间隔（tick）

功能说明

与掉落物优化类似，对远离玩家的经验球使用简化 tick，节省性能。

方块实体优化 (block-entity-optimizations)

零延迟工厂优化 (zero-delay-factory-optimization)

block-entity-optimizations:
  zero-delay-factory-optimization:
    enabled: true
    entities-config-file: "entities.yml"
配置项类型默认值说明
enabled布尔true是否启用零延迟工厂优化
entities-config-file字符串"entities.yml"实体配置文件路径

功能说明

零延迟工厂优化将方块实体的 tick 延迟降至 0，提升工厂效率。

支持的方块实体（在 entities.yml 中配置）：

  • 漏斗、熔炉、高炉、烟熏炉
  • 酿造台、信标
  • 箱子、陷阱箱、木桶、潜影盒
  • 末影箱、投掷器、发射器

效果：

  • 漏斗传输速度提升
  • 熔炉冶炼更流畅
  • 整体工厂效率提升

并行 Tick (parallel-tick)

  parallel-tick:
    enabled: true
    min-block-entities: 50
    batch-size: 16
    protect-containers: true
    timeout-ms: 50
配置项类型默认值说明
enabled布尔true是否启用并行方块实体 Tick
min-block-entities整数50低于此数量时不启用并行
batch-size整数16每批处理的方块实体数量
protect-containers布尔true是否保护容器（主线程执行防物品丢失）
timeout-ms整数50超时时间（毫秒），超时后降级到同步

功能说明

并行 Tick使用多线程并行处理方块实体的 tick 更新。

参数详解：

  1. min-block-entities

    • 当方块实体数量低于此值时，使用单线程处理
    • 避免小规模场景下多线程的额外开销

  2. batch-size

    • 每个工作线程一次处理的方块实体数量
    • 推荐值：8-32

  3. protect-containers

    • 启用后，容器类方块实体在主线程执行
    • 防止多线程操作导致的物品丢失
    • 强烈建议保持启用

  4. timeout-ms

    • 并行处理超时后自动降级到同步处理
    • 防止死锁或长时间阻塞

注意：Folia 环境下自动禁用此功能。

漏斗优化 (hopper-optimization)

  hopper-optimization:
    enabled: true
    cache-expire-time: 100
    container-cache: true
    skip-failed-transfers: true
    fast-empty-full-check: true
配置项类型默认值说明
enabled布尔true是否启用漏斗优化
cache-expire-time整数100缓存过期时间（毫秒）
container-cache布尔true是否启用容器缓存
skip-failed-transfers布尔true是否跳过失败的传输尝试
fast-empty-full-check布尔true是否启用快速空满检测

功能说明

漏斗优化缓存容器查询结果，减少重复查询。

参数详解：

  1. cache-expire-time

    • 容器查询结果的缓存时间
    • 100ms 内对同一容器的查询会使用缓存

  2. container-cache

    • 缓存漏斗上方/下方的容器引用
    • 避免每次传输都重新查找容器

  3. skip-failed-transfers

    • 如果上次传输失败，短时间内跳过重试
    • 减少对满容器的无效传输尝试

  4. fast-empty-full-check

    • 使用优化的算法检测容器是否为空/满
    • 避免遍历所有槽位

矿车优化 (minecart-optimization)

  minecart-optimization:
    enabled: true
    tick-interval: 2
配置项类型默认值说明
enabled布尔true是否启用矿车优化
tick-interval整数2矿车 tick 间隔

功能说明

矿车优化降低矿车的 tick 频率，节省性能。

tick-interval 参数：

  • 1：每 tick 更新（原版行为）
  • 2（默认）：每 2 tick 更新一次
  • 3-4：更低的更新频率，但矿车移动可能不够平滑

配方优化 (recipe-optimization)

熔炉配方缓存 (furnace-recipe-cache)

recipe-optimization:
  furnace-recipe-cache:
    enabled: true
    cache-size: 100
    apply-to-blast-furnace: true
    apply-to-smoker: true
    fix-burn-time-bug: true
配置项类型默认值说明
enabled布尔true是否启用熔炉配方缓存
cache-size整数100每个熔炉的缓存配方数
apply-to-blast-furnace布尔true是否应用于高炉
apply-to-smoker布尔true是否应用于烟熏炉
fix-burn-time-bug布尔true是否修复 >32767 燃烧时间的 bug

功能说明

熔炉配方缓存（FastFurnace）缓存熔炉配方，避免重复查找。

效果：

  • 对于自定义配方较多的服务器效果显著
  • 减少配方查找的 CPU 开销

fix-burn-time-bug：

  • 修复原版中燃烧时间超过 32767 tick 时的溢出 bug
  • 某些模组可能添加超长燃烧时间的燃料

C2ME NBT 优化 (c2me-nbt-optimization)

  c2me-nbt-optimization:
    enabled: true
配置项类型默认值说明
enabled布尔true是否启用 C2ME NBT 优化

功能说明

C2ME NBT 优化来源于 C2ME Fabric 模组。

优化内容：

  • ListTag 使用 fastutil 高性能集合
  • 减少 NBT 操作的内存分配
  • Paper 已优化 CompoundTag，此优化主要针对 ListTag

工作台缓存 (crafting-recipe-cache)

  crafting-recipe-cache:
    enabled: false
    cache-size: 200
    optimize-batch-crafting: true
    reduce-network-traffic: true
配置项类型默认值说明
enabled布尔false是否启用工作台缓存（默认关闭）
cache-size整数200缓存大小
optimize-batch-crafting布尔true是否优化批量合成
reduce-network-traffic布尔true是否减少网络流量

实验性功能

此功能默认关闭，可能与某些插件冲突。

optimize-batch-crafting：

  • 优化 Shift+点击批量合成
  • 将 O(i×s) 复杂度降低到 O(1)

reduce-network-traffic：

  • 减少配方同步的网络流量

杂项优化 (misc-optimizations)

misc-optimizations:
  minecart-cauldron-destruction:
    enabled: true
配置项类型默认值说明
minecart-cauldron-destruction.enabled布尔true是否启用矿车炼药锅销毁

功能说明

支持漏斗矿车和箱子矿车被炼药锅销毁的机制。

智能滞后补偿 (smart-lag-compensation)

smart-lag-compensation:
  enabled: true
  tps-threshold: 18.0
  
  item-pickup-delay:
    enabled: true
  
  potion-effects:
    enabled: false
  
  time-acceleration:
    enabled: false
配置项类型默认值说明
enabled布尔true是否启用智能滞后补偿
tps-threshold浮点18.0TPS 阈值，低于此值时启用补偿

子功能配置：

配置项类型默认值说明
item-pickup-delay.enabled布尔true掉落物拾取延迟补偿
potion-effects.enabled布尔false药水效果补偿（默认关闭）
time-acceleration.enabled布尔false时间加速（默认关闭）

功能说明

智能滞后补偿在低 TPS 时自动补偿，保持游戏体验一致。

item-pickup-delay：

  • 在低 TPS 时减少掉落物拾取延迟
  • 保持玩家拾取物品的体验一致

potion-effects（默认关闭）：

  • 在低 TPS 时额外 tick 药水效果
  • ⚠️ 可能改变游戏平衡：药水效果消耗更快

time-acceleration（默认关闭）：

  • 在低 TPS 时加速游戏时间流逝
  • ⚠️ 可能影响依赖时间的机制

TNT 爆炸优化 (tnt-explosion-optimization)

tnt-explosion-optimization:
  enabled: true
  
  vanilla-compatibility:
    enabled: true
    use-vanilla-power: true
    use-vanilla-fire-logic: true
    use-vanilla-damage-calculation: true
    use-full-raycast: false
    use-vanilla-block-destruction: true
    use-vanilla-drops: true
配置项类型默认值说明
enabled布尔true是否启用 TNT 爆炸优化

原版兼容性配置 (vanilla-compatibility)：

配置项类型默认值说明
enabled布尔true是否启用原版兼容模式
use-vanilla-power布尔true使用原版爆炸威力
use-vanilla-fire-logic布尔true使用原版火焰逻辑
use-vanilla-damage-calculation布尔true使用原版伤害计算（⚠️ 重要）
use-full-raycast布尔false使用完整射线追踪（更精确但性能开销大）
use-vanilla-block-destruction布尔true使用原版方块破坏逻辑
use-vanilla-drops布尔true使用原版掉落物逻辑

功能说明

TNT 爆炸优化使用多线程并行处理 TNT 爆炸计算，大幅提升性能。

原版兼容性说明：

  • 启用所有原版兼容选项可确保 TNT 行为与原版一致
  • 如果你的服务器有 TNT 大炮等机制，建议保持所有选项启用

爆炸缓存 (cache)

  cache:
    enabled: true
    cache-expiry-ticks: 600
配置项类型默认值说明
enabled布尔true是否启用爆炸缓存
cache-expiry-ticks整数600缓存过期时间（tick，600 = 30 秒）

爆炸密度缓存 (density-cache)

  density-cache:
    enabled: true
配置项类型默认值说明
enabled布尔true是否启用爆炸密度缓存（使用空间索引加速实体查询）

向量化 AABB 检测 (vectorized-aabb)

  vectorized-aabb:
    enabled: true
配置项类型默认值说明
enabled布尔true是否启用 SIMD 向量化加速实体碰撞检测

统一爆炸引擎 (unified-engine)

  unified-engine:
    enabled: true
配置项类型默认值说明
enabled布尔true是否启用统一爆炸引擎（推荐，4x 吞吐量）

TNT 实体合并 (entity-merge)

  entity-merge:
    enabled: false
    radius: 1.5
    max-fuse-difference: 5
    power-multiplier: 0.5
    max-power: 12.0
配置项类型默认值说明
enabled布尔false是否启用 TNT 实体合并（默认关闭）
radius浮点1.5合并半径（方块）
max-fuse-difference整数5最大引信时间差（tick）
power-multiplier浮点0.5威力增益系数
max-power浮点12.0最大爆炸威力

注意

TNT 实体合并默认关闭，适用于大炮服务器。启用后会改变 TNT 的爆炸行为。

下落方块优化 (falling-block-optimization)

falling-block-optimization:
  enabled: true
  min-falling-blocks: 20
  batch-size: 10
配置项类型默认值推荐范围说明
enabled布尔true-是否启用下落方块优化
min-falling-blocks整数2020-50最少下落方块数（低于此值不并行）
batch-size整数1010-20批量大小

功能说明

下落方块优化使用多线程并行处理下落方块，适用于重力方块和大规模下落场景。

区块系统优化 (chunk-system)

chunk-system:
  enabled: true
配置项类型默认值说明
enabled布尔true是否启用区块系统优化（主开关）

区块生成优化 (generation)

  generation:
    noise-optimization:
      enabled: true
    jigsaw-optimization:
      enabled: true
    chunk-pos-optimization:
      enabled: true
    perlin-noise-optimization:
      enabled: true
配置项类型默认值说明
noise-optimization.enabled布尔true噪声采样优化，提升地形生成速度
jigsaw-optimization.enabled布尔trueJigsaw 结构生成优化，提升村庄等结构生成速度
chunk-pos-optimization.enabled布尔trueChunkPos equals 优化，避免不必要的对象创建（来源：C2ME）
perlin-noise-optimization.enabled布尔truePerlin 噪声优化，优化噪声采样算法（来源：C2ME）

区块加载优化 (loading)

  loading:
    async-loading:
      enabled: true
      cache-size: 256
    mid-tick-tasks:
      enabled: true
      interval-ns: 1000000
    async-blending:
      enabled: true
配置项类型默认值说明
async-loading.enabled布尔true异步区块加载，减少主线程阻塞
async-loading.cache-size整数256读取缓存大小
mid-tick-tasks.enabled布尔trueMid-Tick 区块任务，在 tick 中间执行区块任务减少延迟
mid-tick-tasks.interval-ns整数1000000执行间隔（纳秒，1000000 = 1ms）
async-blending.enabled布尔true异步 Blending 状态计算，减少世界升级卡顿

区块保存优化 (saving)

  saving:
    async-serialization:
      enabled: true
    unload-queue-optimization:
      enabled: true
配置项类型默认值说明
async-serialization.enabled布尔true异步区块序列化，将序列化移到后台线程
unload-queue-optimization.enabled布尔true区块卸载队列优化，避免 O(n) 的 size() 调用

磁盘 IO 优化 (io)

  io:
    async-disk-write:
      enabled: true
    storage-io-worker:
      enabled: true
    nbt-cache-limit:
      enabled: true
      max-size: 256
配置项类型默认值说明
async-disk-write.enabled布尔true异步磁盘写入，禁用 dsync 提升 IO 性能
storage-io-worker.enabled布尔true存储 IO 工作线程优化
nbt-cache-limit.enabled布尔trueNBT 缓存限制，防止内存泄漏
nbt-cache-limit.max-size整数256最大缓存条目数

提示

使用 -Dakiasync.chunk.forceDsync=true JVM 参数可强制启用同步写入。

方块 Tick 优化 (block-tick)

  block-tick:
    async:
      enabled: false
      timeout-us: 200
      batch-size: 16
配置项类型默认值说明
async.enabled布尔false是否启用方块 Tick 异步化（默认关闭）
async.timeout-us整数200超时时间（微秒）
async.batch-size整数16批量大小

注意

方块 Tick 异步化默认关闭，Folia 环境下自动禁用。

结构查找异步化 (structure-location-async)

structure-location-async:
  enabled: true
配置项类型默认值说明
enabled布尔true是否启用结构查找异步化

/locate 命令优化 (locate-command)

  locate-command:
    enabled: true
    search-radius: 100
    skip-known-structures: false
配置项类型默认值说明
enabled布尔true是否异步处理 /locate 命令
search-radius整数100搜索半径（区块）
skip-known-structures布尔false是否跳过已知结构（加速搜索）

村民交易地图优化 (villager-trade-maps)

  villager-trade-maps:
    enabled: true
    search-radius: 100
    skip-known-structures: false
    trade-types:
      - "minecraft:ocean_monument_map"
      - "minecraft:woodland_mansion_map"
      - "minecraft:buried_treasure_map"
    generation-timeout-seconds: 30
配置项类型默认值说明
enabled布尔true是否异步生成村民交易地图
search-radius整数100搜索半径（区块）
skip-known-structures布尔false是否跳过已知结构
trade-types列表见上支持的地图类型
generation-timeout-seconds整数30生成超时时间（秒）

海豚寻宝优化 (dolphin-treasure-hunt)

  dolphin-treasure-hunt:
    enabled: true
    search-radius: 50
配置项类型默认值说明
enabled布尔true是否异步处理海豚寻宝
search-radius整数50搜索半径（方块）

箱子探险地图生成 (chest-exploration-maps)

  chest-exploration-maps:
    enabled: true
    loot-tables:
      - "minecraft:chests/shipwreck_map"
      - "minecraft:chests/underwater_ruin_big"
      - "minecraft:chests/underwater_ruin_small"
配置项类型默认值说明
enabled布尔true是否异步生成箱子中的探险地图
loot-tables列表见上包含地图的战利品表

算法优化 (algorithm-optimization)

  algorithm-optimization:
    enabled: true
    search-pattern: "hybrid"
    caching:
      enabled: true
      max-size: 1000
      expiration-minutes: 30
    biome-aware-search:
      enabled: true
配置项类型默认值说明
enabled布尔true是否启用算法优化
search-pattern字符串"hybrid"搜索模式：spiral（螺旋）、layered（分层）、hybrid（混合）
caching.enabled布尔true是否启用结构缓存
caching.max-size整数1000最大缓存条目数
caching.expiration-minutes整数30缓存过期时间（分钟）
biome-aware-search.enabled布尔true是否启用基于生物群系的智能搜索

光照优化 (lighting-optimizations)

lighting-optimizations:
  enabled: true
  update-interval-ms: 10
  
  light-batching:
    enabled: true
配置项类型默认值推荐范围说明
enabled布尔true-是否启用光照优化
update-interval-ms整数105-20光照更新间隔（毫秒）
light-batching.enabled布尔true-是否启用光照更新批处理

功能说明

光照优化参考 ScalableLux，使用时间窗口控制更新频率。

update-interval-ms 参数：

  • 5：更新更快，但 CPU 占用更高
  • 10（默认）：平衡性能和响应速度
  • 20：更省 CPU，但光照更新可能有延迟

Bug 修复与特殊功能

出生区块移除 (spawn-chunk-removal)

spawn-chunk-removal:
  enabled: true
配置项类型默认值说明
enabled布尔true是否移除出生区块以加速世界加载

版本限制

仅对 1.21.8 有效。1.21.10+ 版本已默认移除出生区块。

蜜蜂修复 (bee-fix)

bee-fix:
  enabled: true
配置项类型默认值说明
enabled布尔true是否启用蜜蜂修复

修复的 Bug

修复 7 个 MC bug：MC-168329、MC-190042、MC-206401、MC-229321、MC-234364、MC-248332、MC-255743

潜影贝子弹自伤修复 (shulker-bullet-self-hit-fix)

shulker-bullet-self-hit-fix:
  enabled: true
配置项类型默认值说明
enabled布尔true防止潜影贝子弹击中发射它的潜影贝自己

End 维度地形修复 (end-island-density-fix)

end-island-density-fix:
  enabled: true
配置项类型默认值说明
enabled布尔true修复 End 维度地形环形缺失（MC-159283）

首领僵尸血量修复 (leader-zombie-health-fix)

leader-zombie-health-fix:
  enabled: true
配置项类型默认值说明
enabled布尔true修复首领僵尸生成时血量错误的问题（MC-219981）

传送门窒息检查 (portal-suffocation-check)

portal-suffocation-check:
  disabled: false
配置项类型默认值说明
disabled布尔falsefalse = 保持原版行为；true = 禁用检查提升性能

功能说明

Mojang 在 1.19.3 添加了实体传送后的窒息检查算法。禁用此检查可大幅提升传送门性能，但极少数情况下大型生物可能卡在方块内。

末影人方块搬运限制 (enderman-block-carry-limiter)

enderman-block-carry-limiter:
  enabled: true
  max-carrying-endermen: 50
  count-towards-mob-cap: true
  prevent-pickup-when-limit-reached: true
配置项类型默认值推荐范围说明
enabled布尔true-是否启用末影人方块搬运限制
max-carrying-endermen整数5030-100最大手持方块末影人数量
count-towards-mob-cap布尔true-是否强制计入刷怪上限（修复原版 bug）
prevent-pickup-when-limit-reached布尔true-达到限制时是否阻止拾取

功能说明

修复 Mojang 的 bug：手持方块的末影人不占刷怪上限导致无限堆积。

注意：如果启用了 entity-throttling，建议将此功能设为 false。

数据包优化 (datapack-optimization)

datapack-optimization:
  enabled: true
  batch-size: 100
  cache-expiration-minutes: 30
  max-file-cache-size: 1000
  max-filesystem-cache-size: 50
配置项类型默认值说明
enabled布尔true是否启用数据包优化
batch-size整数100批量大小
cache-expiration-minutes整数30缓存过期时间（分钟）
max-file-cache-size整数1000文件缓存上限（防止内存泄漏）
max-filesystem-cache-size整数50文件系统缓存上限

Execute 命令跳过不活跃实体 (execute-inactive-skip)

  execute-inactive-skip:
    enabled: false
    skip-level: 2
    simulation-distance-multiplier: 1.0
    cache-duration-ms: 1000
    whitelist-types:
      - "minecraft:player"
      - "minecraft:armor_stand"
配置项类型默认值说明
enabled布尔false是否启用（默认关闭）
skip-level整数2跳过级别：0=禁用，1=未加载区块，2=模拟距离外，3=所有不活跃
simulation-distance-multiplier浮点1.0模拟距离倍数
cache-duration-ms整数1000缓存持续时间（毫秒）
whitelist-types列表见上白名单实体类型（永不跳过）

函数命令去重 (command-deduplication)

  command-deduplication:
    enabled: true
配置项类型默认值说明
enabled布尔true是否去重数据包函数中的重复命令对象，减少内存使用

数学优化 (math-optimization)

math-optimization:
  enabled: true
  compact-sine-lut: true
  
  c2me-optimizations:
    bitset-pooling:
      enabled: true
    completable-future-optimization:
      enabled: true
    blockpos-cache: true
    optimized-collections: true
配置项类型默认值说明
enabled布尔true是否启用数学优化
compact-sine-lut布尔true紧凑型正弦查找表（节省 75% 内存）

C2ME 优化：

配置项类型默认值说明
bitset-pooling.enabled布尔trueBitSet 对象池（ThreadLocal 缓存）
completable-future-optimization.enabled布尔trueCompletableFuture 优化（优化异步任务组合）
blockpos-cache布尔trueBlockPos 缓存（预计算减少开销）
optimized-collections布尔true优化集合类（高性能集合）

种子加密 (seed-encryption)

seed-encryption:
  enabled: false
  scheme: "quantum"
  
  protect-structures: true
  protect-ores: true
  protect-slimes: true
  
  legacy:
    seed-bits: 1024
  
  quantum:
    encryption-level: 2
    private-key-file: "quantum-seed.key"
    enable-time-decay: false
    cache-size: 10000
  
  restrict-seed-command: true
  seed-command-deny-message: "&c你没有权限使用此命令。"
  
  anti-plugin-theft:
    enabled: true
    return-fake-seed: true
    fake-seed-value: 0
    log-suspicious-access: true
配置项类型默认值说明
enabled布尔false是否启用种子加密（默认关闭）
scheme字符串"quantum"加密方案：legacy（传统）、quantum（量子推荐）
protect-structures布尔true保护结构（村庄/要塞/遗迹）
protect-ores布尔true保护矿石（钻石/金矿等）
protect-slimes布尔true保护史莱姆区块

Legacy 方案配置：

配置项类型默认值说明
seed-bits整数1024种子位数（1024/2048/4096，推荐 1024 平衡性能）

Quantum 方案配置：

配置项类型默认值说明
encryption-level整数2加密强度：1=基础，2=标准推荐，3=最强
private-key-file字符串"quantum-seed.key"服务器私钥文件（⚠️ 自动生成，请备份！）
enable-time-decay布尔false时间衰减（防时间攻击，可能影响重生成）
cache-size整数10000缓存大小（推荐 5000-20000）

命令权限控制：

配置项类型默认值说明
restrict-seed-command布尔true限制 /seed 命令仅 OP 可用
seed-command-deny-message字符串见上拒绝消息

防插件窃取种子：

配置项类型默认值说明
anti-plugin-theft.enabled布尔true是否启用防插件窃取
return-fake-seed布尔true给可疑调用者返回假种子
fake-seed-value整数0假种子值（0 = 随机）
log-suspicious-access布尔true记录可疑访问

重要警告

启用后不可关闭！ 关闭会导致：

  • 区块错乱
  • 结构消失
  • 矿石改变
  • 史莱姆区块变化

如需关闭必须删除世界。

网络优化 (network-optimization)

区块可见性过滤 (chunk-visibility-filter)

network-optimization:
  chunk-visibility-filter:
    enabled: true
配置项类型默认值说明
enabled布尔true遮挡剔除：只发送玩家视野内的表层区块

高速移动区块预加载 (fast-movement-chunk-load)

  fast-movement-chunk-load:
    enabled: true
    speed-threshold: 0.5
    preload-distance: 8
    max-concurrent-loads: 4
    prediction-ticks: 40
    
    center-offset:
      enabled: true
      min-speed: 3.0
      max-speed: 9.0
      max-offset-ratio: 0.75
    
    async-loading:
      batch-size: 2
      batch-delay-ms: 20
    
    player-join-warmup:
      enabled: true
      warmup-duration-ms: 3000
      initial-rate: 0.5
    
    map-rendering:
      enabled: false

基础配置：

配置项类型默认值推荐范围说明
enabled布尔true-是否启用高速移动区块预加载
speed-threshold浮点0.50.3-0.8触发速度（b/t）
preload-distance整数86-10预加载距离
max-concurrent-loads整数42-6最大并发加载
prediction-ticks整数4030-50预测 tick 数

智能偏移加载中心 (center-offset)：

配置项类型默认值推荐范围说明
enabled布尔true-是否启用智能偏移
min-speed浮点3.02.0-4.0最小触发速度（b/t）
max-speed浮点9.07.0-12.0最大触发速度（⚠️ 过高可能卸载玩家）
max-offset-ratio浮点0.750.5-0.9最大偏移比例

异步加载批量控制 (async-loading)：

配置项类型默认值推荐范围说明
batch-size整数22-4每批区块数
batch-delay-ms整数2010-20批次延迟（毫秒）

玩家加入热身期 (player-join-warmup)：

配置项类型默认值推荐范围说明
enabled布尔true-是否启用热身期
warmup-duration-ms整数30002000-5000热身期时长（毫秒）
initial-rate浮点0.50.3-0.7初始加载速率（0.0-1.0）

地图渲染 (map-rendering)：

配置项类型默认值说明
enabled布尔false高速移动时优化地图渲染（⚠️ 实验性功能）

功能说明

高速移动区块预加载在鞘翅/疾跑/创造飞行时预加载区块，避免卡顿。

智能偏移加载中心根据速度方向偏移加载中心，实现类远视距效果。

高级网络优化 (advanced)

  advanced:
    enabled: true
    
    fast-varint:
      enabled: true
    
    eventloop-affinity:
      enabled: true
      strict-checking: false
    
    bytebuf-optimizer:
      enabled: true
      pooled-allocator: true
      prefer-direct: true
    
    skip-zero-movement-packets:
      enabled: true
      strict-mode: false
配置项类型默认值说明
enabled布尔true是否启用高级网络优化
fast-varint.enabled布尔true快速 VarInt 编码（1 字节路径提升 50%，2 字节路径提升 30%）
eventloop-affinity.enabled布尔trueEventLoop 亲和性检查（减少跨线程调度开销 10-20%）
eventloop-affinity.strict-checking布尔false严格检查模式（启用后会记录违规警告）
bytebuf-optimizer.enabled布尔trueByteBuf 优化器（减少 GC 压力 40-60%）
bytebuf-optimizer.pooled-allocator布尔true使用池化分配器
bytebuf-optimizer.prefer-direct布尔true优先使用直接内存
skip-zero-movement-packets.enabled布尔true零移动包过滤（减少 10-15% 实体包）
skip-zero-movement-packets.strict-mode布尔false严格模式（true=位置和旋转都为零才过滤）

AFK 玩家网络包节流 (afk-packet-throttle)

  afk-packet-throttle:
    enabled: true
    afk-duration-ms: 120000
    particle-max-distance: 0.0
    sound-max-distance: 64.0
配置项类型默认值说明
enabled布尔true是否启用 AFK 玩家包节流
afk-duration-ms整数120000AFK 判定时间（毫秒，120000 = 2 分钟）
particle-max-distance浮点0.0粒子最大距离（0 = 完全过滤）
sound-max-distance浮点64.0声音最大距离

功能说明

参考 ESU 的 AfkEfficiency 功能，对 AFK 玩家限制粒子、声音等非关键包的发送。

性能提升：减少 20-40% 网络流量（针对 AFK 玩家）。

动态区块发送速率 (dynamic-chunk-send-rate)

  dynamic-chunk-send-rate:
    enabled: true
    limit-upload-bandwidth: 10240
    guaranteed-bandwidth: 512
配置项类型默认值说明
enabled布尔true是否启用动态区块发送速率
limit-upload-bandwidth整数10240限制上传带宽（KB/s）
guaranteed-bandwidth整数512每玩家保证带宽（KB/s）

包压缩优化 (packet-compression)

  packet-compression:
    enabled: true
    adaptive-threshold: true
    skip-small-packets: true
    skip-threshold: 32
配置项类型默认值说明
enabled布尔true是否启用包压缩优化
adaptive-threshold布尔true自适应压缩阈值
skip-small-packets布尔true跳过小包压缩
skip-threshold整数32跳过阈值（字节）

区块批量优化 (chunk-batch)

  chunk-batch:
    enabled: true
    min-chunks: 2.0
    max-chunks: 32.0
    max-unacked-batches: 8
配置项类型默认值说明
enabled布尔true是否启用区块批量优化
min-chunks浮点2.0每 tick 最小区块数
max-chunks浮点32.0每 tick 最大区块数
max-unacked-batches整数8最大未确认批次

包优先级队列 (packet-priority)

  packet-priority:
    enabled: true
    prioritize-player-packets: true
    prioritize-chunk-packets: true
    deprioritize-particles: true
    deprioritize-sounds: true
配置项类型默认值说明
enabled布尔true是否启用包优先级队列
prioritize-player-packets布尔true优先玩家包
prioritize-chunk-packets布尔true优先区块包
deprioritize-particles布尔true降低粒子优先级
deprioritize-sounds布尔true降低声音优先级

高级优化 (advanced-optimizations)

advanced-optimizations:
  virtual-threads: true
  work-stealing: true
  multi-netty-event-loop: true
  paletted-container-lock-removal: true
  type-filterable-list: true
  entity-tracker-linked-hashmap: true
  spawn-density-array: true
  biome-access-optimization: true
  entity-move-zero-velocity: true
  entity-tracker-distance-cache: true
配置项类型默认值说明
virtual-threads布尔trueJava 21 虚拟线程（旧版自动降级）
work-stealing布尔true工作窃取调度
multi-netty-event-loop布尔true分离 Login/Play 网络 IO，减少竞争
paletted-container-lock-removal布尔true移除 PalettedContainer 锁（Paper/Folia 已在更高层级同步）
type-filterable-list布尔true实体类型过滤（+20-40%）
entity-tracker-linked-hashmap布尔true实体追踪器优化
spawn-density-array布尔true生成密度检查（+3-5x）
biome-access-optimization布尔true内联生物群系采样（-10-20% 开销）
entity-move-zero-velocity布尔true跳过零速度移动计算
entity-tracker-distance-cache布尔true缓存实体追踪距离

功能说明

这些优化来自多个高性能模组：VMP、Nitori、Lithium。

性能监控与调试 (performance)

performance:
  debug-logging:
    enabled: false
    modules:
      tnt: false
      collision: false
      lighting: false
      pathfinding: false
      entity: false
      chunk: false
      hopper: false
      math: false
      shapes: false
      datapack: false
      execute-command: false
      command-deduplication: false
      smart-lag-compensation: false
      log-missed-ticks: false
      log-compensation: false
  
  enable-metrics: true
配置项类型默认值说明
debug-logging.enabled布尔false是否启用调试日志（仅用于调试，生产环境建议关闭）
enable-metrics布尔true是否启用性能指标收集

调试模块：

模块说明
tntTNT 爆炸调试
collision碰撞检测调试
lighting光照计算调试
pathfinding寻路调试
entity实体系统调试
chunk区块系统调试
hopper漏斗系统调试
math数学优化调试
shapes形状优化调试
datapack数据包优化调试
execute-commandExecute 命令优化调试
command-deduplication命令去重调试
smart-lag-compensation智能滞后补偿调试
log-missed-ticks记录丢失的 tick
log-compensation记录补偿操作

指令配置 (commands)

commands:
  reload:
    require-confirmation: true
    confirmation-timeout: 30
配置项类型默认值说明
require-confirmation布尔true是否需要二次确认（首次警告需再次执行）
confirmation-timeout整数30确认超时时间（秒）
默认页脚
Copyright © 2026 Virgil698 & AnkiSama