2D render

Render2DEvent hands you a drawing surface — e.render(). Coordinates are framebuffer pixels, not GUI-scaled units, and every call queues a command flushed after all handlers ran, so call order is draw order.

on<Render2DEvent> { e ->
    val r = e.render()
    val label = "fps " + client.fps()
    val w = r.textWidth(label, 10f) + 12f
    r.blur(8f, 8f, w, 22f, 12f, Colors.rgba(0, 0, 0, 160), 6f)
    r.roundedRect(8f, 8f, w, 22f, 6f, Colors.rgba(10, 12, 15, 120))
    r.text(label, 14f, 14f, 10f, Colors.WHITE)
}

#The surface

At GUI Scale 2 a 1920×1080 window still reports width() = 1920. Divide by gameSettings.scaleFactor() to get vanilla GUI units.

#Shapes

#StrokeAlign

The size you pass is always the shape itself; the stroke grows outwards from it.

#Gradients and blur

Blur reads the framebuffer at its own place in the queue, so it only blurs commands issued before it. The rect is snapped to whole pixels and the blur radius to max(1, round(radius)) px; a width or height that rounds to 0 is skipped.

#Text

y is the line top; the baseline sits at y + textAscent(...). An unknown family falls back to inter, and null or empty text is skipped.

#Measuring text

textHeight equals textAscent + textDescent at the same size, family and weight.

#Fonts and weights

A name that already exists — including the client's own inter, jetbrains-mono and minecraft — is ignored, and script families are dropped when the script unloads. The byte form pairs with base64(...): see assets inside the script.

#Weight

#Items, heads, icons

#Textures

A file path is resolved against scripts/assets, with a one-time-warned fallback to the scripts root — see assets. skinTexture() on a player or a tab entry returns the same kind of handle.

#Colours

Every colour is an int shaped 0xAARRGGBB.

#A world point on the screen

#Clipping

The rect is in framebuffer px, rounded and clamped to the frame; a negative width or height becomes 0. Every scissor a render handler leaves open is dropped when that handler returns.

#Blending

Text, items, heads, blur and shader quads keep their own blending; the modes are listed on Your own geometry. INVERT flips every pixel under the shape, weighted by its alpha — the blend of the vanilla crosshair.

#Shaders

Foreign Shader implementations are ignored, and the quad is skipped while compilation failed. Compiling one and setting uniforms: shaders.