本文详解如何在minecraft forge/architectury客户端环境中，通过投影变换将3d世界坐标（如路标位置）准确映射到gui缩放后的屏幕像素坐标，并判断其是否在视锥内可见。
本文详解如何在minecraft forge/architectury客户端环境中，通过投影变换将3d世界坐标（如路标位置）准确映射到gui缩放后的屏幕像素坐标，并判断其是否在视锥内可见。
在游戏开发（尤其是Minecraft模组开发）中，常需将3D世界中的目标点（如传送点、敌人、标记物）实时渲染为屏幕上的2D UI元素（如箭头、图标或文本）。这要求精确执行世界空间 → 视图空间 → 裁剪空间 → 屏幕空间的完整坐标变换流程。手动推导三角函数（如仅用pitch/yaw/FOV近似）易因忽略相机矩阵、透视畸变、GUI缩放及OpenGL视口设置而产生偏移或失效——正确做法是复用渲染管线已有的变换矩阵。
以下为工业级可靠实现，基于Minecraft 1.19.4+ Architectury客户端环境（兼容Forge），使用LWJGL3与OpenGL API：
✅ 核心步骤解析
获取当前相机位姿与视口参数
Camera 提供相机位置与朝向；GL11.glGetIntegerv(GL_VIEWPORT, viewport) 获取OpenGL原生视口（非GUI缩放尺寸），确保与渲染管线一致。构建相对向量并应用世界空间变换
先计算目标点相对于相机的偏移向量 (dx, dy, dz)，再乘以 lastWorldSpaceMatrix（实际为 view × model 的组合矩阵，由渲染器每帧更新）。注意：该矩阵已包含旋转、平移及可能的缩放，不可省略。执行标准透视投影与视口变换
使用 Matrix4f.project() 方法完成裁剪空间归一化（[-1,1]³）→ 屏幕像素坐标（[0,w]×[0,h]）的转换，内部自动处理齐次除法与Y轴翻转。-
适配GUI缩放与Y轴校正
Minecraft GUI经getGuiScale()缩放，且窗口Y轴原点在顶部（OpenGL在底部），故需：- X：target.x / guiScale
- Y：(displayHeight - target.y) / guiScale（翻转+缩放）
- Z：保留归一化深度值（-1~1），用于可见性判断
? 完整代码实现
private static final Minecraft client = Minecraft.getInstance();
public static final Matrix4f lastProjMat = new Matrix4f(); // 每帧由Renderer注入
public static final Matrix4f lastModMat = new Matrix4f(); // 同上
public static final Matrix4f lastWorldSpaceMatrix = new Matrix4f();
public static Vector3d worldSpaceToScreenSpace(Vector3d pos) {
Camera camera = client.getEntityRenderDispatcher().camera;
int displayHeight = client.getWindow().getHeight();
int[] viewport = new int[4];
GL11.glGetIntegerv(GL11.GL_VIEWPORT, viewport); // 获取真实OpenGL视口
// 计算世界坐标到相机的相对向量
double dx = pos.x - camera.getPosition().x;
double dy = pos.y - camera.getPosition().y;
double dz = pos.z - camera.getPosition().z;
// 应用世界空间变换（view × model）
Vector4f transformed = new Vector4f((float) dx, (float) dy, (float) dz, 1.0f)
.mul(lastWorldSpaceMatrix);
// 投影到屏幕空间（返回[0,w]×[0,h]像素坐标）
Matrix4f projModel = new Matrix4f(lastProjMat).mul(lastModMat);
Vector3f screenPos = new Vector3f();
projModel.project(transformed.x(), transformed.y(), transformed.z(), viewport, screenPos);
// 转换为GUI缩放坐标（适配高DPI/缩放设置）
float guiScale = client.getWindow().getGuiScale();
return new Vector3d(
screenPos.x / guiScale,
(displayHeight - screenPos.y) / guiScale,
screenPos.z // 归一化深度，用于裁剪判断
);
}
// 判断是否在视锥内（Z∈[-1,1] 且在屏幕范围内）
public static boolean screenSpaceCoordinateIsVisible(Vector3d screenPos) {
if (screenPos == null) return false;
if (screenPos.z 1.0) return false; // 被裁剪
Window window = client.getWindow();
double x = screenPos.x;
double y = screenPos.y;
return x >= 0 && x = 0 && y <h3>⚠️ 关键注意事项</h3>
- 矩阵时效性：lastProjMat 和 lastModMat 必须在渲染线程中、主渲染循环内及时更新（通常在 RenderLevelStageEvent 或自定义渲染器中捕获）。若在非渲染线程调用，矩阵可能过期导致坐标错乱。
- 坐标系一致性：Vector3d 使用右手坐标系（Y向上），与Minecraft世界坐标系一致；OpenGL NDC空间Z轴指向屏幕内（-1为近平面，1为远平面）。
- 性能优化：避免在每帧高频调用中重复创建Matrix4f或int[] viewport，应复用静态缓冲区。
- 边界处理：screenSpaceCoordinateIsVisible() 仅检测Z深度和屏幕矩形范围，对屏幕外但Z有效的点（如侧方远处）返回false，符合UI显示需求。
通过此方案，你可稳定地将任意3D世界坐标（如_warp.x(), _warp.y(), _warp.z()）转换为精准的GUI像素位置，完美支撑路标追踪、战斗HUD、AR式指引等高级功能。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
