活塞系统全剖析#

private boolean shouldExtend(RedstoneView world, BlockPos pos, Direction pistonFace) {
    // 检测方向1：除了活塞朝向那一面，其余5个面的红石信号
    for (Direction d : Direction.values()) {
        if (d != pistonFace && world.isEmittingRedstonePower(pos.offset(d), d)) {
            return true;
        }
    }
    // 检测方向2：活塞下方发来的信号（BUD位准）
    if (world.isEmittingRedstonePower(pos, DOWN)) return true;
    // 检测方向3：活塞上方方块周围的信号（模拟"BUD更新"检测）
    BlockPos above = pos.up();
    for (Direction d : Direction.values()) {
        if (d != DOWN && world.isEmittingRedstonePower(above.offset(d), d)) {
            return true;
        }
    }
    return false;
}

public static boolean isMovable(BlockState state, World world, BlockPos pos,
                                 Direction dir, boolean canBreak, Direction pistonDir) {
    // 绝对不可动：黑曜石、哭泣黑曜石、重生锚、强化深板岩
    if (state.isOf(OBSIDIAN) || state.isOf(CRYING_OBSIDIAN)
        || state.isOf(RESPAWN_ANCHOR) || state.isOf(REINFORCED_DEEPSLATE))
        return false;
    // 越界
    if (pos.getY() < bottomY || pos.getY() > topYInclusive) return false;
    // 基岩（硬度 -1）
    if (state.getHardness(world, pos) == -1.0F) return false;

    // 按 PistonBehavior 分支
    switch (state.getPistonBehavior()) {
        case BLOCK:     return false;     // 阻挡
        case DESTROY:   return canBreak;  // 破坏型（仙人掌），允许破坏才通过
        case PUSH_ONLY: return dir == pistonDir;  // 只能推，不能拉
        default: break;
    }
    // 活塞本身伸出时不可动
    if (state.isOf(PISTON) || state.isOf(STICKY_PISTON)) {
        if (state.get(EXTENDED)) return false;
    }
    // 带 BlockEntity 的方块（除了 MOVING_PISTON）不可动 → 防止数据丢失
    return !state.hasBlockEntity();
}

private static boolean isAdjacentBlockStuck(BlockState a, BlockState b) {
    // 特殊规则：蜂蜜块 + 粘液块 不粘
    if (a.isOf(HONEY_BLOCK) && b.isOf(SLIME_BLOCK)) return false;
    if (b.isOf(HONEY_BLOCK) && a.isOf(SLIME_BLOCK)) return false;
    // 其余：只要任一方是粘液块/蜂蜜块就粘
    return isBlockSticky(a) || isBlockSticky(b);
}

List<BlockPos> moved = pistonHandler.getMovedBlocks();   // 被推动的方块
List<BlockPos> broken = pistonHandler.getBrokenBlocks(); // 被破坏的方块
Map<BlockPos, BlockState> map = 位置 → 原状态;  // 用于失败时回滚

if (extend) {
    BlockState headState = PISTON_HEAD
        .defaultState.with(FACING, dir).with(TYPE, sticky ? STICKY : DEFAULT);
    BlockState movingHead = MOVING_PISTON
        .defaultState.with(FACING, dir).with(TYPE, ...)
    map.remove(blockPos);  // 活塞位置也要换成 MOVING_PISTON
    world.setBlockState(pos, movingHead, SKIP_REDRAW... | MOVED);
    world.addBlockEntity(createBlockEntityPiston(
        pos, movingHead, headState,
        dir,
        true,   // 正在伸出
        true)); // source=true（这是活塞头本体）
}

// amountExtended：沿朝向方向的偏移距离
// extend=true 时 progress 从 0→1，偏移从 -1 → 0（从活塞里伸出来）
// extend=false 时 progress 从 0→1，偏移从 0 → -1（收回到活塞里）
private float getAmountExtended(float progress) {
    return extending ? progress - 1.0F : 1.0F - progress;
}

// 渲染偏移 = 方向轴 * 伸出量 * 进度（带 1gt 插值用于流畅动画）
offsetX = facing.getOffsetX() * getAmountExtended(lerp(tickDelta, lastProgress, progress))

// 把碰撞箱沿运动方向拉伸 d（本 tick 进度差），找出所有相交的实体
List<Entity> list = world.getOtherEntities(
    null, Boxes.stretch(box, direction, d).union(box));

for each entity:
  跳过 PistonBehavior.IGNORE（物品展示框、画等）
  if 粘液块 && !玩家:
    给实体一个沿活塞方向的速度（于是粘液块"甩"起玩家）
  for each 碰撞箱子块:
    计算 box3 与 entity.boundingBox 的相交深度
    得到推动距离 i
  moveEntity(direction, entity, min(i, d) + 0.01, direction)
  // 0.01 是魔法余量，防止浮点误差把实体卡墙里

if (!extending && source) {
    push(pos, entity, direction, d);
}

if (sticky) {
    BlockPos twoBlocksAway = pos.add(dir * 2);
    BlockState s = world.getBlockState(twoBlocksAway);
    // 特殊：前方 2 格有另一个正在伸出的活塞 → 让它先 finish
    if (s.isOf(MOVING_PISTON) && ...isExtending()) {
        ((PistonBlockEntity)be).finish(); // 立即完成，时序对齐
    } else {
        // 决定拉不拉
        if (type==1 && (s.air || !isMovable(s, pos, opposite) ||
            s.behavior != NORMAL && 不是活塞)) {
            // 只删除活塞头，不拉回方块
            world.removeBlock(pos.offset(dir), false);
        } else {
            // 调用 move(extend=false) → 执行完整拉回流程
            move(world, pos, dir, false);
        }
    }
} else {
    // 普通活塞：直接移除活塞头，什么也不拉
    world.removeBlock(pos.offset(dir), false);
}