Item Sprites & World Flags

YEmojis provides a built-in dictionary of over 1,500 visual shortcuts, covering all vanilla Minecraft items, sovereign flags, mob heads, and player skins.

1,200+ Vanilla Item & Block Sprites

Every item and placeable block in Minecraft 1.21+ has a dedicated 2D sprite shortcut.

Syntax Rules

• Surround any standard vanilla material name with colons: :item_name:.
• Shortcuts are case-insensitive (:diamond_sword:, :Diamond_Sword:, and :DIAMOND_SWORD: produce the same icon).
• Common aliases are supported (e.g. :gapple: for Golden Apple, :totem: for Totem of Undying).

Examples

• :diamond_sword: → 2D Diamond Sword Sprite
• :netherite_pickaxe: → 2D Netherite Pickaxe Sprite
• :elytra: → 2D Elytra Sprite
• :golden_apple: or :gapple: → 2D Golden Apple Sprite
• :trident: → 2D Trident Sprite
• :mace: → 2D Mace Sprite
• :wind_charge: → 2D Wind Charge Sprite

212 World & Territory Country Flags

YEmojis contains permanent Base64 skull textures for all 212 sovereign countries and recognized international territories.

Benefits of Permanent Textures

• Zero External HTTP Calls: Flag textures are pre-resolved and stored in flags.yml.
• Zero Mojang Rate Limits: Textures render instantly without hitting authentication servers.
• Consistent Rendering: No missing textures or broken Unicode glyphs across Windows, macOS, or Linux clients.

Flag Syntax

Type :flag_<country_code>: using the standard ISO 3166-1 alpha-2 code:

Country	Code Shortcut
United States	:flag_us:
United Kingdom	:flag_gb:
Egypt	:flag_eg:
Saudi Arabia	:flag_sa:
Germany	:flag_de:
France	:flag_fr:
Japan	:flag_jp:
Canada	:flag_ca:
Brazil	:flag_br:
Palestine	:flag_ps:
United Arab Emirates	:flag_ae:
Turkey	:flag_tr:

Dynamic Player Heads

Display any player's skin head in chat messages by wrapping their Minecraft username with colons:

:<player_name>:

Examples

• :Notch: → Renders Notch's skin head
• :Yowsef: → Renders Yowsef's skin head

YEmojis caches skin profiles in memory with an asynchronous non-blocking loader to prevent server thread lag on Folia and Paper.

Mob Heads & Smileys

• Mob Heads: :cow:, :pig:, :creeper:, :zombie:, :skeleton:, :enderman:, :warden:, :allay:, :breeze:.
• Smileys & Symbols: :smile:, :heart:, :fire:, :star:, :coin:, :check:, :cross:, :warning:.

Interactive Hover Tooltips

Hovering your mouse over any item sprite or flag head in chat reveals an interactive MiniMessage hover card:

chat:
  hover-tooltips:
    enabled: true
    item-format: "<yellow><display_name></yellow><newline><gray>Minecraft Item</gray>"
    mob-format: "<aqua><display_name></aqua><newline><gray>Mob Head</gray>"
    flag-format: "<green><display_name></green><newline><gray>Country Flag</gray>"
    emoji-format: "<light_purple><display_name></light_purple><newline><gray>Chat Emoji</gray>"
    player-format: "<gold><player_name>'s Head</gold><newline><gray>Player Skin</gray>"