gfx and gfx3d

Drawing overlays on the screen and in the world.

gfx draws on the screen, in pixels. gfx3d draws in the world, in game coordinates, so a circle around a monster follows it as the camera moves. Both only work in on_render, and both draw over the game, not inside a window.

function on_render()
    local me = agents.local_player()
    if not me then return end

    gfx3d.circle(me, 600, Color.CYAN, 2, 64)

    local t = agents.selected()
    if t then
        gfx3d.line(me, t, Color(255, 80, 80, 200), 2)
        gfx3d.text_centered(t:name() or "?", t, Color.WHITE)
    end

    gfx.text("Hello", Vec2(20, 200), Color.YELLOW, 18)
end

Colors are Color values; positions are Vec2 (screen) or Vec3 (world) values, and a world position can also be an Agent. Thickness and size are in pixels.

#gfx

#Images

Images come from the game (item:icon(), skill.icon, game.profession_icon(...)) or from PNG files in your plugin's folder.

local logo = gfx.image_from_png(files.read("logo.png"))

function on_render()
    gfx.image(logo, Vec2(20, 20), 64, 64)
end

#gfx3d