How to Create Custom Fonts with a Minecraft Resource Pack

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

Understanding Resource Pack Font Structure

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>.json

You have two primary choices when naming and placing your font file:

Font Provider Types Explained

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:

Creating a Bitmap Font for Custom Icons

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).

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:

Using a TrueType (TTF) Font

If you want to change the actual style of letters across the game without drawing a bitmap grid by hand, use the ttf provider.

{
  "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:

Adjusting Character Widths with the Space Provider

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.

Combining Fonts with Reference and Unihex

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.

Applying Custom Fonts In-Game

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.

Questions

How do I replace the entire default font in Minecraft?

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.

How do I add custom icons without replacing normal letters?

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.

Where do I put a TTF file in a Minecraft resource pack?

Place the TrueType (.ttf) file inside the assets//font/ folder, which is the exact same directory where your font JSON configuration files are stored.

Why is my custom resource pack not showing up or working?

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.