Font Images
Create images which can be used in texts, also known as glyphs and symbols
Font images are custom characters that have a custom texture. You can use font images to create emojis, ranks, GUI and more.
Creating a generic font image
In this example my namespace is my_content
(you can decide your own).
Create a
.png
filecontents/my_content/textures/image_1.png
.Create a
.yml
filecontents/my_content/my_config.yml
.

Access it ingame using :image_1:
placeholder. If you have PlaceholderAPI you can access it using %img_image_1%
in various places and other plugins.
Properties
scale_ratio
scale_ratio
Resize the image to a specific height and width. Default value is the PNG file height.
y_position
y_position
Move the image on the Y axist. Accepts positive and negative.
y_position
must be lower or equal to scale_ratio
.
This is a limitation of the game and I cannot fix it.
To bypass this limitation you have to create an image with higher height, you can do it by adding some blank pixels on the bottom or on the top of the image.
Built-in Placeholders
You can use these special placeholders in chat, signs, books and in GUIs names.
Image
To show the image in-game you have to write down its name surrounded by :
character.
Offset
This is a special placeholder that allows you to move a font image back and forward specifying pixels number.
As you can see you have to write :offset_
AMOUNT
:
(without spaces).
If you would like to change the image's height, you will need to change it's 'y' value.
This is located in the image's configuration.
For example:
you can shift a font image back by 16 pixels by writing
:offset_-16::smile:
you can shift a text back by 16 pixels by writing
:offset_-16:hello
you can shift a font image forward by 16 pixels by writing
:offset_16::smile:
you can shift a text forward by 16 pixels by writing
:offset_16:hello
PlaceholderAPI Placeholders
Font image
This is the code: %img_NAME%
instead of NAME
write the font image name.
For example: %img_smile%
Offsets
You can shift text or font images back and forward. For example
you can shift it back of 16 pixels by writing
%img_offset_-16%
you can shift it forward of 16 pixels by writing
%img_offset_16%
More tutorials
Ranks / prefixesEmojisCommon mistakes
I see only a white square
If you see a white square make sure the height of your image is not greater than the y_position
value you set.
To bypass this limitation you have to create an image with higher height.
Images must also not have Uppercase or Bad Characters (eg. *
, à
, ù
, =
, $
, space etc.) in the filename or in the folders.
Keep in mind that the max size of a font image is 256x256. This is a Minecraft limitation. To bypass this (if you're creating a GUI or HUD) you can split your image in multiple font images and merge them shifting them.
Imprecise HUD shifting
Be sure to have each image size set to a multiple of 2 (2x2, 4x4, 6x6, 8x8, 10x10, etc.)
If you still have problems try to increase/decrease the size by 2 until the wrong shift disappears. This is an approximation problem I cannot fix.
GUI image is colored
You need to specify the GUI image name in the name of the GUI
title: :myimage: My Custom GUI
which can be colored by the custom menu plugin automatically. Be sure to add &f
before doing :myimage: in the GUI.
Last updated
Was this helpful?