
Customizing text in Minecraft lets you overhaul the game interface or add custom icons to chat, menus, and signs. By setting up font definition files in a resource pack, players and server owners can modify default lettering or introduce brand-new typefaces and graphical symbols.
Text Width & Center Calculator
Minecraft manages fonts through JSON configuration files inside a resource pack. These files tell the game where to find character images or font files and how to display them on the screen.
To start, create your basic resource pack folder structure. Every pack requires a pack.mcmeta file in its root directory. Remember that pack format numbers change between versions, so ensure your pack_format matches the version of Minecraft you are running.
Font JSON files are placed inside the following directory path:
assets/<namespace>/font/<name>.jsonYou have two primary choices when naming and placing your font file:
assets/minecraft/font/default.json. Overwriting minecraft:default changes the primary text across the entire game interface, including menus, chat, and item tooltips.assets/myserver/font/custom.json. This leaves the main game text untouched and lets you call the custom font only when needed via text components.Inside your font JSON file, you must define a list of providers. A provider links character codes to actual visuals or spacing rules. Minecraft supports these provider types:
chars list, along with height and ascent values to align the image with normal text.size, oversample, and shift settings.Bitmap glyph sheets are frequently used by server owners and map makers to add custom icons, ranks, or emojis into chat and menus. To prevent your icons from replacing standard letters, map them to private-use Unicode characters (such as \uE000).
icons.png) and place it in assets/minecraft/textures/font/.assets/minecraft/font/default.json.bitmap provider entry pointing to your PNG sheet.Here is a copyable template for a bitmap provider (replace the placeholders in angle brackets with your desired numbers):
{
"providers": [
{
"type": "bitmap",
"file": "minecraft:font/icons.png",
"ascent": <ascent_number>,
"height": <height_number>,
"chars": [
"\uE000\uE001"
]
}
]
}In this setup:
textures folder.If you want to change the actual style of letters across the game without drawing a bitmap grid by hand, use the ttf provider.
myfont.ttf) straight into the assets/<namespace>/font/ directory alongside your JSON file.assets/custom/font/fancy.json) and configure the provider settings.{
"providers": [
{
"type": "ttf",
"file": "custom:myfont.ttf",
"shift": [<x_shift>, <y_shift>],
"size": <font_size>,
"oversample": <oversample_value>
}
]
}Replace the placeholders with numeric values to tweak how the TrueType font renders:
[x, y] array.The space provider lets you assign fixed advances to specific characters. This is useful for creating custom-width blank spaces or shifting text backward and forward on screen.
{
"providers": [
{
"type": "space",
"advances": {
" ": <space_width>,
"\uE002": <custom_advance>
}
}
]
}By replacing <space_width> and <custom_advance> with positive or negative numbers, you control how far the text cursor moves forward or backward whenever that character is typed. This allows you to adjust letter spacing or layer characters and bitmap images over one another.
When managing large resource packs, you may want to split your providers across multiple JSON files and merge them into one master font. The reference provider lets you include another font file seamlessly:
{
"providers": [
{
"type": "reference",
"id": "custom:extra_icons"
}
]
}Similarly, if you are working with Unifont hex files to cover extensive character sets, you can configure a unihex provider within your providers list to load those files directly.
Once your resource pack is enabled in Minecraft, any changes made to minecraft:default will show up immediately. If you mapped a custom icon to \uE000 in the default font, you can display it in chat using the /tellraw command:
/tellraw @a {"text":"\uE000 Welcome to the server!"}If you created a separate font file instead of replacing the default one (for instance, assets/custom/font/fancy.json), you must specify "font":"<namespace>:<name>" inside your text component. Here is how to call that specific font in chat or on an item label:
/tellraw @a {"text":"This text uses a custom font!","font":"custom:fancy"}You can also mix multiple fonts within a single message by chaining text components together, allowing you to show custom bitmap icons right next to styled TrueType text.
Create a font configuration file at assets/minecraft/font/default.json inside your resource pack. Modifying the minecraft:default font automatically changes all standard game text in menus, chat, and interfaces.
Use a bitmap provider in your font JSON and map the characters in the chars rows to private-use Unicode characters (like \uE000). This keeps the regular alphabet intact while giving you special codes for your icons.
Place the TrueType (.ttf) file inside the assets/
Check your pack.mcmeta file first. Pack format numbers change between Minecraft versions, and your JSON files must have valid syntax without missing commas or quotation marks.