优化Minecraft Forge 1.19.2中方块检测与光源判断的性能_技术教程

本文旨在提供minecraft forge 1.19.2模组开发中，优化玩家周围方块检测及光源判断逻辑的策略。针对常见代码中重复获取方块状态和亮度信息导致的性能问题，我们将探讨如何通过引入局部变量、清晰分离逻辑判断，以及利用数据结构简化代码，从而提升代码的可读性、维护性与cpu效率。

在Minecraft Forge模组开发中，尤其是在处理玩家周围方块的逻辑时，开发者常会遇到性能瓶颈。一个典型的场景是在一定半径内遍历方块，并根据其类型或亮度进行判断。如果处理不当，这类操作可能导致CPU负担过重，影响游戏流畅性。

1. 低效方块检测的常见模式

在检测玩家周围方块时，一种常见的低效模式是重复调用 world.getBlockState() 和 world.getMaxLocalRawBrightness() 方法。考虑以下简化后的代码片段，它展示了这种重复性问题：

// 假设在一个循环中，currentPos 代表 (x + sx, y + sy, z + sz)
if (world.getBlockState(currentPos).getBlock() == Blocks.TORCH
    || world.getBlockState(currentPos).getBlock() == Blocks.WALL_TORCH
    || world.getBlockState(currentPos).getBlock() == Blocks.FIRE
    || (world.getBlockState(currentPos).getBlock() == Blocks.CAMPFIRE && world.getMaxLocalRawBrightness(currentPos) == 15)
    // ... 更多类似重复的判断
) {
    // 执行相关逻辑
}

这种实现方式存在以下主要问题：

重复的方法调用： 对于同一个 BlockPos，world.getBlockState() 和 world.getMaxLocalRawBrightness() 被多次调用，造成不必要的计算开销。
可读性差： 冗长的 if 条件语句难以理解和维护。
潜在的逻辑错误： && 和 || 运算符的优先级可能导致意料之外的逻辑结果，尤其是在缺乏括号明确优先级的情况下。

2. 优化策略一：引入局部变量提升效率与可读性

最直接且效果显著的优化方法是引入局部变量，将重复调用的结果存储起来。这不仅减少了方法调用次数，也极大地提升了代码的可读性。

// 假设在一个循环中，需要检测 (x + sx, y + sy, z + sz) 位置的方块
BlockPos currentPos = new BlockPos(x + sx, y + sy, z + sz); // 仅创建一次BlockPos对象
BlockState blockState = world.getBlockState(currentPos);    // 仅获取一次BlockState
Block block = blockState.getBlock();                        // 仅获取一次Block
int lightLevel = world.getMaxLocalRawBrightness(currentPos); // 仅获取一次亮度等级

if (block == Blocks.TORCH
    || block == Blocks.WALL_TORCH
    || block == Blocks.FIRE
    || (block == Blocks.CAMPFIRE && lightLevel == 15) // 使用局部变量 lightLevel
    || block == Blocks.LANTERN
    || block == Blocks.LAVA
    || block == Blocks.LAVA_CAULDRON
    || (block == Blocks.FURNACE && lightLevel == 13) // 使用局部变量 lightLevel
) {
    // 执行相关逻辑
}

优点：

显著的性能提升： 避免了对 world.getBlockState() 和 world.getMaxLocalRawBrightness() 的重复调用，从而减少了CPU的负担。
增强可读性： 代码变得更加简洁明了，易于理解和调试。
降低维护成本： 当需要修改判断条件时，只需关注局部变量，而不是重新解析复杂的表达式。

3. 优化策略二：分离方块类型与亮度等级判断逻辑

原始代码将方块类型检查和亮度等级检查混杂在一起，这可能导致逻辑混乱或不准确。清晰地分离这两种判断逻辑，能使代码更健壮、更易于管理。

3.1 明确判断目标

在编写代码之前，首先要明确你的目标：

你是否在寻找 特定类型的光源方块（例如火把、熔炉）？
你是否在寻找 任何亮度达到特定阈值的方块位置？
你是否需要 特定方块类型并且满足特定亮度条件？

3.2 独立判断示例

仅判断方块类型： 如果你的目标是识别一组特定的方块类型，无论它们的亮度如何，可以使用 Set 来存储目标方块，从而使判断逻辑更简洁高效。

import net.minecraft.world.level.block.Block;
import net.minecraft.world.level.block.Blocks;
import java.util.Set;
import java.util.HashSet;

// 在类加载时初始化一次，避免在循环中重复创建
private static final Set TARGET_LIGHT_BLOCK_TYPES = new HashSet<>(Set.of(
    Blocks.TORCH, Blocks.WALL_TORCH, Blocks.FIRE, Blocks.LANTERN,
    Blocks.LAVA, Blocks.LAVA_CAULDRON
    // 注意：CAMPFIRE和FURNACE因有亮度条件，可能不适合直接放入此Set
));

// 在循环中，假设 block 已经通过局部变量获取
if (TARGET_LIGHT_BLOCK_TYPES.contains(block)) {
    // 处理这些特定类型的光源方块
}

使用 Set 的好处在于，它提供了平均 O(1) 的查找时间复杂度，比冗长的 || 链更具扩展性和性能优势。

仅判断亮度等级： 如果只关心某个位置的环境光照强度是否达到特定阈值，则可以完全忽略方块类型。

// 在循环中，假设 lightLevel 已经通过局部变量获取
if (lightLevel >= 13) { // 根据需求设置合适的亮度阈值
    // 处理亮度达标的区域
}

组合判断（精确匹配）： 当需要同时满足特定方块类型和特定亮度条件时，务必使用括号来明确逻辑优先级，确保判断的准确性。

// 在循环中，假设 block 和 lightLevel 已经通过局部变量获取
if (block == Blocks.TORCH
    || block == Blocks.WALL_TORCH
    || block == Blocks.FIRE
    || (block == Blocks.CAMPFIRE && lightLevel == 15) // 使用括号明确CAMPFIRE的亮度条件
    || block == Blocks.LANTERN
    || block == Blocks.LAVA
    || block == Blocks.LAVA_CAULDRON
    || (block == Blocks.FURNACE && lightLevel == 13) // 使用括号明确FURNACE的亮度条件
) {
    // 执行相关逻辑
}

这种结构清晰地表达了每个条件的意图，避免了因运算符优先级导致的潜在错误。

4. 性能考量与进阶建议

避免过度迭代： 遍历一个大范围内的所有方块本身就是一个CPU密集型操作。在设计模组逻辑时，应尽可能缩小搜索半径，或者仅在必要时执行此类遍历。对于非常大的范围，可以考虑更高级的空间数据结构或异步处理。
BlockState.getLightEmission() 与 Level.getMaxLocalRawBrightness() 的区别：
- BlockState.getLightEmission()：返回该方块自身能发出的光照强度（例如，火把通常为14，熔岩为15）。这个值是方块的固有属性。
- Level.getMaxLocalRawBrightness()：返回该 BlockPos 位置处环境的最大原始亮度等级，它考虑了天空光、方块自身发光、以及附近其他光源的综合影响。根据你的具体需求选择合适的方法。如
  果你的目标是识别 任何能够发出光的方块，那么结合 BlockState.getLightEmission() > 0 和 Set 可能会更通用。如果你的目标是检测 某个位置的环境光照强度，那么 getMaxLocalRawBrightness() 是正确的选择。在原问题中，两种意图有所混杂，因此理解它们的区别至关重要。
使用 Predicate 或辅助方法： 对于更复杂的判断逻辑，可以考虑创建 Predicate 或独立的辅助方法，将判断逻辑封装起来，进一步提高代码的模块化和可读性。