Feat: 1.19+的新方块更新管理机制

[hotpad100c]

我们在方块更新分析里给出的分析方法从行为上看是正确的，但因该在本章节末尾加一篇Advance文章，描述1.19+引入的新更新栈，说明高版本真正的更新传递方式（原来的树状更新链被摊平在一个栈里了）以及它带来的潜在影响（更新间的因果关系变得难以追溯，以及我记得fallen说了某个刷线机的两个水源的计划刻顺序会因此反转？）

我想我可以负责写这些，但我把issue放在这里，这样如果有什么可参考的东西就能放出来

[hotpad100c]

该代码段在活板门里:

level.setBlock(pos, state.setValue(POWERED, signal), 2);
 if (state.getValue(WATERLOGGED)) {
      level.scheduleTick(pos, Fluids.WATER, Fluids.WATER.getTickDelay(level));
  } 

含水活板门与另一水源相邻放置，激活活板门时：

1.19-

• 改变，向邻居发出PP更新

  • 相邻水添加计划刻

• 活板门内水添加计划刻

1.19+

• 改变，向邻居发出PP更新
  • PP更新项被添加进Updater
• 活板门内水添加计划刻
  .
  .
  .
• Updater执行PP更新
  • 相邻水添加计划刻

---

如果我理解没错，这会导致计划刻反转

[Arcadi4]

1.19+ 的主要变化是shape update 从同步调用变为调用 NeighborUpdater。

1.18.2：同步执行

Level#setBlock 在 flags 为 2 时仍调用 updateNeighbourShapes：

if ((flags & 16) == 0 && recursionLeft > 0) {
    int i = flags & -34;
    blockState.updateIndirectNeighbourShapes(this, pos, i, recursionLeft - 1);
    state.updateNeighbourShapes(this, pos, i, recursionLeft - 1);
    state.updateIndirectNeighbourShapes(this, pos, i, recursionLeft - 1);
}

BlockBehaviour.BlockStateBase#updateNeighbourShapes 直接遍历邻居并调用 updateShape：

for (Direction direction : BlockBehaviour.UPDATE_SHAPE_ORDER) {
    mutableBlockPos.setWithOffset(pos, direction);
    BlockState neighbor = level.getBlockState(mutableBlockPos);
    BlockState updated = neighbor.updateShape(
        direction.getOpposite(), this.asState(), level, mutableBlockPos, pos
    );
    Block.updateOrDestroy(neighbor, updated, level, mutableBlockPos, flag, recursionLeft);
}

因此相邻水源的 LiquidBlock#updateShape 会在 setBlock 返回前执行：

if (state.getFluidState().isSource() || facingState.getFluidState().isSource()) {
    level.scheduleTick(currentPos, state.getFluidState().getType(), this.fluid.getTickDelay(level));
}

1.20.1：嵌套更新进入队列

World#setBlockState 的整体流程基本没变，但 updateNeighbors 不再直接调用邻居：

for (Direction direction : AbstractBlock.DIRECTIONS) {
    mutable.set(pos, direction);
    world.replaceWithStateForNeighborUpdate(
        direction.getOpposite(), this.asBlockState(), mutable, pos, flags, maxUpdateDepth
    );
}

当这段代码发生在当前 neighbor update 内时，新条目被放进 pending：

boolean running = this.depth > 0;
this.depth++;
if (running) {
    this.pending.add(entry);
} else {
    this.queue.push(entry);
}

所以区别可以直接概括为：

1.18.2: setBlock -> 相邻水 updateShape -> 相邻水 scheduleTick
        -> setBlock 返回 -> 活板门内水 scheduleTick

1.20.1: setBlock -> 相邻水 shape update 加入 pending
        -> setBlock 返回 -> 活板门内水 scheduleTick
        -> 当前 neighbor update 返回 -> pending 执行
        -> 相邻水 scheduleTick

同一游戏刻、同一优先级的计划刻最终按递增的 subTickOrder 排序，因此这里的调度先后确实反转。