Common

KattonClientRenderApi

top.katton.apicommon/src/main/kotlin/top/katton/api/KattonClientRenderApi.kt

Screen-space render callback context.

Members

Jump directly to declarations on this page.

• HudRenderContextData Class
• WorldRenderContextData Class
• HudRenderLayerEnum Class
• WorldRenderLayerEnum Class
• registerHudRendererFunction
• registerHudRendererFunction
• unregisterHudRendererFunction
• registerWorldRendererFunction
• registerWorldRendererFunction
• unregisterWorldRendererFunction
• clearClientRenderersFunction
• dispatchHudRenderFunction
• dispatchWorldRenderFunction
• drawHudTextFunction
• fillHudRectFunction
• drawHudTextureFunction
• drawLine3DFunction
• drawBillboard3DFunction

HudRenderContext

CommonData Class

data class HudRenderContext( val graphics: GuiGraphics, val tickDelta: Float )

Screen-space render callback context.

Contains the graphics context and timing information for HUD rendering.

Properties

Property	Description
graphics	The runtime GUI graphics object from Minecraft (GuiGraphics)
tickDelta	The partial tick time for smooth animations

WorldRenderContext

CommonData Class

data class WorldRenderContext( val viewMatrix: Any, val projectionMatrix: Any, val camera: Camera?, val tickDelta: Float )

World-space render callback context.

Contains matrix and camera information for 3D world rendering.

Properties

Property	Description
viewMatrix	The current view transformation matrix
projectionMatrix	The current projection matrix
camera	The current camera instance (may be null)
tickDelta	The partial tick time for smooth animations

HudRenderLayer

CommonEnum Class

enum class HudRenderLayer

Ordering bucket for HUD render callbacks.

Renderers are processed in order: BACKGROUND -> NORMAL -> FOREGROUND

WorldRenderLayer

CommonEnum Class

enum class WorldRenderLayer

Ordering bucket for world render callbacks.

Renderers are processed in order: EARLY -> NORMAL -> LATE

registerHudRenderer

CommonFunction

fun registerHudRenderer(id: String, render: (HudRenderContext) -> Unit)

Register (or replace) a HUD renderer by [id].

The renderer will be called each frame during HUD rendering. Uses NORMAL layer with priority 0.

Parameters

Parameter	Description
id	Unique identifier for this renderer
render	The render callback receiving HudRenderContext

registerHudRenderer

CommonFunction

fun registerHudRenderer(id: String, layer: HudRenderLayer, priority: Int = 0, render: (HudRenderContext) -> Unit)

Register (or replace) a HUD renderer by [id], with [layer] and [priority].

Lower priority values are rendered earlier within the same layer. Layers are rendered in order: BACKGROUND -> NORMAL -> FOREGROUND

Parameters

Parameter	Description
id	Unique identifier for this renderer
layer	The render layer determining draw order
priority	Priority within the layer (lower = earlier)
render	The render callback receiving HudRenderContext

unregisterHudRenderer

CommonFunction

fun unregisterHudRenderer(id: String): Boolean

Remove a HUD renderer by [id].

Parameters

Parameter	Description
id	The identifier of the renderer to remove

Returns

true if the renderer was found and removed, false otherwise

registerWorldRenderer

CommonFunction

fun registerWorldRenderer(id: String, render: (WorldRenderContext) -> Unit)

Register (or replace) a world-space renderer by [id].

The renderer will be called each frame during world rendering. Uses NORMAL layer with priority 0.

Parameters

Parameter	Description
id	Unique identifier for this renderer
render	The render callback receiving WorldRenderContext

registerWorldRenderer

CommonFunction

fun registerWorldRenderer(id: String, layer: WorldRenderLayer, priority: Int = 0, render: (WorldRenderContext) -> Unit)

Register (or replace) a world renderer by [id], with [layer] and [priority].

Lower priority values are rendered earlier within the same layer. Layers are rendered in order: EARLY -> NORMAL -> LATE

Parameters

Parameter	Description
id	Unique identifier for this renderer
layer	The render layer determining draw order
priority	Priority within the layer (lower = earlier)
render	The render callback receiving WorldRenderContext

unregisterWorldRenderer

CommonFunction

fun unregisterWorldRenderer(id: String): Boolean

Remove a world-space renderer by [id].

Parameters

Parameter	Description
id	The identifier of the renderer to remove

Returns

true if the renderer was found and removed, false otherwise

clearClientRenderers

CommonFunction

fun clearClientRenderers()

Clears all client render callbacks (both HUD and world renderers).

Useful for cleanup during script reload or when resetting state.

dispatchHudRender

CommonFunction

@JvmName("dispatchHudRender")
@JvmName("dispatchHudRender") fun dispatchHudRender(graphics: GuiGraphics, tickDelta: Float)

Internal dispatcher: called by platform render hooks to invoke all HUD renderers.

Parameters

Parameter	Description
graphics	The GUI graphics context
tickDelta	The partial tick time

dispatchWorldRender

CommonFunction

@JvmName("dispatchWorldRender")
@JvmName("dispatchWorldRender") fun dispatchWorldRender(viewMatrix: Any, projectionMatrix: Any, camera: Camera?, tickDelta: Float)

Internal dispatcher: called by platform render hooks to invoke all world renderers.

Parameters

Parameter	Description
viewMatrix	The view transformation matrix
projectionMatrix	The projection matrix
camera	The camera instance
tickDelta	The partial tick time

drawHudText

CommonFunction

fun drawHudText(ctx: HudRenderContext, message: Any?, x: Int, y: Int, color: Int = 0xFFFFFF, shadow: Boolean = true)

Draws text on HUD using current [HudRenderContext].

Parameters

Parameter	Description
ctx	The HUD render context
message	The text to draw (will be converted to Component if not already)
x	The X position in screen coordinates
y	The Y position in screen coordinates
color	The text color in ARGB format (default: white)
shadow	Whether to draw a drop shadow (default: true)

Returns

true if drawing succeeded, false otherwise

fillHudRect

CommonFunction

fun fillHudRect(ctx: HudRenderContext, x1: Int, y1: Int, x2: Int, y2: Int, color: Int)

Draws a solid rectangle on HUD using current [HudRenderContext].

Parameters

Parameter	Description
ctx	The HUD render context
x1	The left edge X coordinate
y1	The top edge Y coordinate
x2	The right edge X coordinate
y2	The bottom edge Y coordinate
color	The fill color in ARGB format

Returns

true if drawing succeeded, false otherwise

drawHudTexture

CommonFunction

fun drawHudTexture(ctx: HudRenderContext, texture: String, x: Int, y: Int, width: Int, height: Int, u: Float = 0f, v: Float = 0f, textureWidth: Int = width, textureHeight: Int = height): Boolean

Draws a texture region on HUD using current [HudRenderContext].

Parameters

Parameter	Description
ctx	The HUD render context
texture	The texture identifier string
x	The X position on screen
y	The Y position on screen
width	The width to draw
height	The height to draw
u	The U coordinate in the texture (default: 0)
v	The V coordinate in the texture (default: 0)
textureWidth	The total texture width (default: same as width)
textureHeight	The total texture height (default: same as height)

Returns

true if drawing succeeded, false if texture ID was invalid

drawLine3D

CommonFunction

fun drawLine3D(ctx: WorldRenderContext, x1: Double, y1: Double, z1: Double, x2: Double, y2: Double, z2: Double, argbColor: Int, lineWidth: Float = 1.0f): Boolean

Draw a 3D line using world coordinates and ARGB color.

Uses real GPU mesh rendering via VertexConsumer+RenderType.

Parameters

Parameter	Description
ctx	The world render context
x1	Start X coordinate in world space
y1	Start Y coordinate in world space
z1	Start Z coordinate in world space
x2	End X coordinate in world space
y2	End Y coordinate in world space
z2	End Z coordinate in world space
argbColor	The line color in ARGB format
lineWidth	The width of the line (default: 1.0)

Returns

true if drawing succeeded, false otherwise

drawBillboard3D

CommonFunction

fun drawBillboard3D(ctx: WorldRenderContext, x: Double, y: Double, z: Double, argbColor: Int, size: Float = 1.0f): Boolean

Draw a colored quad billboard at world position.

Uses real GPU mesh rendering via VertexConsumer+RenderType. Billboards always face the camera.

Parameters

Parameter	Description
ctx	The world render context
x	The X coordinate in world space
y	The Y coordinate in world space
z	The Z coordinate in world space
argbColor	The color in ARGB format
size	The size of the billboard (default: 1.0)

Returns

true if drawing succeeded, false otherwise