You need to enable JavaScript to run this app. Forge 1.12.2用Tessellator与BufferBuilder渲染立方体颜色异常
优惠活动
大模型
产品
解决方案
定价
更多

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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 12:15:05