Skip to main content

đŸ–ŧī¸ Your First Image

Turn a PNG into an in-game icon you can embed in item names, chat, and GUIs — using an <image:tutorial:star> tag.

How it works​

CraftEngine registers your PNG as a character in a custom font. You "type" the icon using an <image:namespace:id> tag. The player sees an image; the game sees text.

Step 1: place the PNG​

âŦ‡ Download the star icon and place it at:

resourcepack/assets/tutorial/textures/font/star.png
resourcepack/assets/tutorial
textures

⚠ī¸ Don't put font images in textures/item/ or textures/block/. Those directories belong to the texture atlas and can cause unintended mipmap degradation.

Step 2: define the image​

In configuration/, create images.yml:

images:
  tutorial:star:
    height: 10
    ascent: 9
    font: tutorial:ui
    file: tutorial:font/star
FieldRequiredDescription
fileyesPath to the PNG. .png extension auto-appended. Corresponds to textures/font/star.png
heightnoGlyph height in pixels. Omit to auto-detect from PNG
ascentnoBaseline offset. Higher = image sits higher. Defaults to height - 1
fontnoWhich font this image belongs to. Defaults to namespace:default
charnoThe codepoint. Leave blank — CraftEngine auto-assigns a free one, no conflicts

⚠ī¸ height must be â‰Ĩ ascent. If you need a larger ascent, add transparent pixels to the bottom of the PNG to increase height.

⚠ī¸ A single glyph must not exceed 256×256 pixels.

💡 Use a custom font (like tutorial:ui), not minecraft:default. With a custom font, players can't type the raw icon characters in chat — only your resource pack can render them.

Step 3: use it in an item name​

items:
  tutorial:star_sword:
    material: diamond_sword
    data:
      item_name: "<!i><white><image:tutorial:star> Star Sword"

/ce reload all, then /ce item get tutorial:star_sword. A star icon prefixes the sword's name.

Star sword with icon

The <image:namespace:id> tag works anywhere MiniMessage is parsed — item names, lore, chat, GUIs, signs.

Preview & debug​

/ce debug image tutorial:star

Prints clickable copy buttons in three formats: MiniMessage, MineDown, and RAW JSON.