add-text

name	add-text
description	Draw text with the built-in system font or a loaded .btfont bitmap font. Use for scores, labels, titles, dialog, a HUD, or any on-screen words, including centering or right-aligning text.

Add text

Show text with the built-in font (no setup), or load a custom bitmap font.

When to use

Use for scores, labels, titles, dialog, or any on-screen words.

Built-in font (no file needed)

The order is position, color slot, text:

render() {
    BT.systemPrint(new Vector2i(8, 8), 4, `Score: ${this.score}`);
}

Center or right-align by measuring first:

const size = BT.systemPrintMeasure('Game Over'); // a Vector2i (width, height)
const x = Math.floor((BT.displaySize.x - size.x) / 2);
BT.systemPrint(new Vector2i(x, 100), 4, 'Game Over');

Custom bitmap font

Load a .btfont file in init() (async), then draw with printFont:

async init() {
    this.font = await BitmapFont.load('/fonts/pixel.btfont');
    return true;
}
render() {
    BT.printFont(this.font, new Vector2i(8, 8), 'HELLO');
}

Key calls

• BT.systemPrint(pos, slot, text) (method) – built-in 6x14 font.
• BT.systemPrintMeasure(text) (method) – returns a Vector2i size for centering.
• BitmapFont.load(url) (static, async) – load a .btfont file.
• BT.printFont(font, pos, text, paletteOffset?) (method) – draw with a loaded font; paletteOffset shifts the glyph colors.

Notes

• Positions are whole numbers (Vector2i).
• The color is a palette slot number (set up colors with the use-palette skill).
• await the font load – forgetting await is the most common beginner bug.

See docs/drawing.md.