文档脚本 API

绘制 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 界面保持一致时,调用外挂自定义抗锯齿字体。脚本明确调用原版字体时,会保留原版文字的表现。

按屏幕宽度居中#

onRender2D 回调内
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]);