Minecraft text formatting, parsing, and rendering library. Features all the exact glyphs used ingame, for the fonts of both pre and post-1.13.

• Builder API - Fluent interface for constructing formatted text
• Color Support - All 16 named Minecraft colors plus RGB hex colors
• Style Handling - Bold, italic, underlined, strikethrough, obfuscated
• Font Rendering - Measure and render text with authentic Minecraft fonts
• Legacy Support - Parse § formatting codes and JSON chat components

Looking for just the TTF files? Download them from the releases page:

• minecraft-fonts-modern.zip - Latest Minecraft fonts (updated, cleaner look)
• minecraft-fonts-legacy.zip - Classic fonts for those who prefer pre-1.13
• minecraft-fonts-special.zip - Enchanting and Illager fonts

[dependencies]
mctext = "1.0"

pip install mctext

npm install @hexze/mctext

use mctext::{MCText, NamedColor};

let text = MCText::new()
    .span("Red ").color(NamedColor::Red)
    .then("Bold").color(NamedColor::Red).bold()
    .build();

for span in text.spans() {
    println!("{}: {:?}", span.text, span.color);
}

import mctext

text = mctext.MCText().span("Red ").color("red").then("Bold").color("red").bold().build()

for span in text.spans():
    print(f"{span.text}: {span.color}")

const { MCText } = require('@hexze/mctext');

let text = new MCText().span("Red ").color("red").then("Bold").color("red").bold().build();

for (const span of text.spans()) {
    console.log(`${span.text}: ${span.color}`);
}

The main class for working with formatted Minecraft text.

Builder for constructing formatted text.

A segment of text with uniform formatting.

Either a named Minecraft color or RGB values.

Named colors have these properties:

• name - Color name (e.g., "red", "gold")
• code - Format code character (e.g., 'c', '6')
• rgb - RGB tuple/array

RGB colors have:

• r, g, b - Individual components

Render formatted Minecraft text to RGBA pixel data.

use mctext::{
    FontSystem, FontVersion, LayoutOptions, MCText, NamedColor,
    SoftwareRenderer, TextRenderContext,
};

let text = MCText::new()
    .span("Hello ").color(NamedColor::Red)
    .then("World").color(NamedColor::Red).bold()
    .build();

let fonts = FontSystem::new(FontVersion::Modern);
let (width, height) = (256, 64);
let mut buffer = vec![0u8; width * height * 4];

{
    let mut renderer = SoftwareRenderer::new(&fonts, &mut buffer, width, height);
    let ctx = TextRenderContext::new(&fonts);
    ctx.render(&mut renderer, &text, 0.0, 0.0, &LayoutOptions::new(16.0).with_shadow(true))
        .unwrap();
}
// buffer contains RGBA pixel data

import mctext

text = mctext.MCText().span("Hello ").color("red").then("World").color("red").bold().build()

fonts = mctext.FontSystem.modern()
options = mctext.LayoutOptions(16.0, None, True)
result = mctext.render(fonts, text, 256, 64, options)

# result.data() returns RGBA bytes, result.width/height for dimensions

const { MCText, FontSystem, LayoutOptions, render } = require('@hexze/mctext');

let text = new MCText().span("Hello ").color("red").then("World").color("red").bold().build();

let fonts = FontSystem.modern();
let options = new LayoutOptions(16.0).withShadow(true);
let result = render(fonts, text, 256, 64, options);

// result.data() returns Uint8Array of RGBA pixels

MIT