fonts registers custom typefaces for canvas text.
| Function | Does |
|---|---|
fonts.register(name, path[, antialias]) |
Loads a TTF or OTF file. The path is relative to the scripts folder, absolute paths work too. antialias defaults to true |
fonts.exists(name) |
true when a font with that name is registered |
fonts.register("pixel", "fonts/pixel.ttf")
render.text("Hi", 8, 8, 12, nil, "pixel")Registering the same name again replaces the font, which keeps hot-reload working. Built-in fonts cannot be replaced.
The vanilla font
"minecraft" renders the real in-game font. Glyphs come from the game’s font providers, so
resource packs and Force Unicode apply on their own.
Size is line height in pixels: 9 matches vanilla at GUI scale 1, 18 at scale 2. Shaping is
vanilla-faithful, one glyph per code point, no kerning or ligatures.
render.text("Diamonds: 12", 8, 8, 18, nil, "minecraft")The paint color tints glyphs the way vanilla text color does. Colored glyphs from emoji-style packs keep their own colors.