绘制 HUD
在 onRender2D 中使用逻辑坐标绘制形状和文字。
本页目录
坐标与时机#
左上角是 (0, 0),x 向右增大,y 向下增大。使用 event.getScaledWidth() 和 event.getScaledHeight() 计算布局;mc.getDisplayWidth() / getDisplayHeight() 是窗口像素尺寸,不能直接当作相同的坐标系。
二维形状与文字在 onRender2D 回调中绘制。获取字体后可以复用它完成当前帧的文字测量与布局。
形状 API#
| 调用 | 参数含义 |
|---|---|
| render.rectangle(x, y, width, height, color) | 以左上角和尺寸绘制矩形 |
| render.roundedRectangle(x, y, width, height, radius, color) | 绘制带圆角的矩形 |
| render.roundedOutlineRectangle(x, y, width, height, radius, lineWidth, color) | 绘制圆角轮廓 |
| render.centeredRectangle(x, y, width, height, color) | 以给定中心点绘制矩形 |
颜色与透明度#
color 使用 [红, 绿, 蓝, 透明度],每项范围 0–255。透明度 0 完全透明,255 完全不透明。传三个分量时透明度默认为 255;文档示例统一传四项。半透明底色与背景模糊是不同的效果。
字体与文字#
| 调用 | 作用 |
|---|---|
| render.getMainFontRenderer(size) | 获取外挂自定义渲染字体 |
| render.getMainFontRendererBold(size) | 获取粗体 |
| render.getMainFontRendererMedium(size) | 获取中等字重 |
| render.getMainFontRendererLight(size) | 获取细字重 |
| render.getMinecraftFontRenderer() | 获取原版字体渲染器 |
| font.width(text) | 测量文字宽度 |
| font.height() | 获取字体高度 |
| font.draw(text, x, y, color) | 绘制文字 |
| font.drawCentered(text, x, y, color) | 水平居中绘制 |
| font.drawWithShadow(text, x, y, color) | 带阴影绘制 |
| font.drawCenteredWithShadow(text, x, y, color) | 水平居中并带阴影绘制 |
需要与 Modern 界面保持一致时,调用外挂自定义抗锯齿字体。脚本明确调用原版字体时,会保留原版文字的表现。
按屏幕宽度居中#
var text = "Polaris";
var font = render.getMainFontRenderer(18);
var x = (event.getScaledWidth() - font.width(text)) / 2;
font.draw(text, x, 24, [240, 244, 255, 255]);