Forge 1.12.2用Tessellator与BufferBuilder渲染立方体颜色异常
Forge 1.12.2 幽灵方块渲染异常定位与修复
问题根因拆解
- 坐标变换顺序完全颠倒:代码中先调用
GlStateManager.translate(-x, -y, -z),之后才给x/y/z赋值为100,此时参与矩阵平移计算的还是方法入口处的旧坐标值,根本没有把立方体放到目标(100,100,100)位置。再加上市面1.12.2版本的世界渲染管线中,模型视图矩阵已经是相机空间坐标,没有提前扣除相机本身的世界位置偏移,导致整体坐标空间错位,只有特定观察角度下的部分片元刚好进入可视范围,也就出现了只有沿+x、+z方向略微低头才能看到目标效果的现象。 - 渲染状态配置缺失或错误:
- 代码设置了
alphaFunc(GL11.GL_ALWAYS, 0)但从未启用alpha测试,收尾时直接调用disableAlpha(),整套alpha控制逻辑完全没有生效 - 没有启用半透明混合(幽灵方块的核心效果),仅关闭光照和面剔除无法实现正常的彩色渲染,顶点颜色会被默认绑定的游戏纹理图集采样覆盖
- 所有顶点传入的颜色值是(1.0,1.0,1.0,1.0)的纯白色,和预期的黑色渲染目标不符
- 代码设置了
- 顶点绕序不统一:六个面的顶点生成顺序没有统一规则,虽然写了
disableCull(),但片元剔除规则异常还是会导致不同观察角度下的面可见性错乱。
修复后参考实现
Minecraft mc = Minecraft.getMinecraft(); // 取相机对应的世界偏移量,保证坐标转换到相机空间 double camX = mc.getRenderManager().viewerPosX; double camY = mc.getRenderManager().viewerPosY; double camZ = mc.getRenderManager().viewerPosZ; Tessellator tessy = Tessellator.getInstance(); BufferBuilder buf = tessy.getBuffer(); GlStateManager.pushMatrix(); // 先配置完整的渲染状态,再做矩阵变换 GlStateManager.disableCull(); GlStateManager.disableLighting(); GlStateManager.enableBlend(); // 设置半透明混合规则 GlStateManager.blendFunc(GL11.GL_SRC_ALPHA, GL11.GL_ONE_MINUS_SRC_ALPHA); // 解绑默认绑定的方块纹理,避免顶点颜色被纹理采样覆盖 GlStateManager.bindTexture(0); // 关闭默认的alpha测试阈值,避免片元被错误剔除 GlStateManager.disableAlphaTest(); // 先赋值目标方块坐标,再做平移(修正之前的顺序错误) double targetX = 100, targetY = 100, targetZ = 100; // 平移到相机空间下的目标立方体位置,以立方体左下角为原点 GlStateManager.translate(targetX - camX - 0.5, targetY - camY - 0.5, targetZ - camZ - 0.5); buf.begin(GL11.GL_QUADS, DefaultVertexFormats.POSITION_COLOR); // 配置目标颜色:半透明黑色 float r = 0.0f, g = 0.0f, b = 0.0f, a = 0.5f; // 单位立方体(范围0~1)的六个面顶点,统一使用逆时针绕序 // 南面(z+方向) buf.pos(0, 0, 1).color(r, g, b, a).endVertex(); buf.pos(1, 0, 1).color(r, g, b, a).endVertex(); buf.pos(1, 1, 1).color(r, g, b, a).endVertex(); buf.pos(0, 1, 1).color(r, g, b, a).endVertex(); // 北面(z-方向) buf.pos(0, 1, 0).color(r, g, b, a).endVertex(); buf.pos(1, 1, 0).color(r, g, b, a).endVertex(); buf.pos(1, 0, 0).color(r, g, b, a).endVertex(); buf.pos(0, 0, 0).color(r, g, b, a).endVertex(); // 东面(x+方向) buf.pos(1, 0, 1).color(r, g, b, a).endVertex(); buf.pos(1, 0, 0).color(r, g, b, a).endVertex(); buf.pos(1, 1, 0).color(r, g, b, a).endVertex(); buf.pos(1, 1, 1).color(r, g, b, a).endVertex(); // 西面(x-方向) buf.pos(0, 1, 1).color(r, g, b, a).endVertex(); buf.pos(0, 1, 0).color(r, g, b, a).endVertex(); buf.pos(0, 0, 0).color(r, g, b, a).endVertex(); buf.pos(0, 0, 1).color(r, g, b, a).endVertex(); // 顶面(y+方向) buf.pos(0, 1, 1).color(r, g, b, a).endVertex(); buf.pos(1, 1, 1).color(r, g, b, a).endVertex(); buf.pos(1, 1, 0).color(r, g, b, a).endVertex(); buf.pos(0, 1, 0).color(r, g, b, a).endVertex(); // 底面(y-方向) buf.pos(0, 0, 0).color(r, g, b, a).endVertex(); buf.pos(1, 0, 0).color(r, g, b, a).endVertex(); buf.pos(1, 0, 1).color(r, g, b, a).endVertex(); buf.pos(0, 0, 1).color(r, g, b, a).endVertex(); tessy.draw(); // 渲染状态复位,避免影响游戏原有渲染流程 GlStateManager.enableLighting(); GlStateManager.enableCull(); GlStateManager.disableBlend(); GlStateManager.enableAlphaTest(); GlStateManager.popMatrix();
关键注意事项
- 这类世界空间渲染逻辑必须挂载在
RenderWorldLastEvent回调中执行,否则矩阵空间和游戏世界的空间映射完全不匹配 - 所有GL全局状态修改完成后必须复位,否则会导致游戏内原有方块、实体渲染出现花屏、颜色错乱的问题
- 参考Schematica的实现逻辑,可在半透明填充层之上再叠加一层同色的线框边框,进一步提升幽灵方块的辨识度,核心渲染流程和上述修复逻辑一致
内容的提问来源于stack exchange,提问作者Nikhil Nayak
相关产品推荐
相关产品推荐

