Iconic

Personalize chat with your own icons!

This documentation is relevant for Iconic version 2.0.0.

How to use the mod

To add an icon to chat, simply start typing the : symbol — the system will automatically suggest available options. After sending a message with icons, they will be transmitted to other players and displayed on their screens.

Important: the mod works by hiding an icon code in the chat text. If the total message length exceeds the 256-character limit, you will receive a warning. We recommend not overusing the number of icons in a single message.

Icons are also supported in the following commands: /me, /msg, /teammsg, /tell, /tellraw, /tm, /w, /reply, /r, /last, /l (the last four are commonly used for replies on servers).

Adding your own icons

To add icons, click the star button in the bottom left corner of the chat bar. A folder will open where you can upload images. You can also navigate to the icons folder in your game directory.

Limitations: only PNG files up to 1 MB in size are accepted. If an image is wider than tall or exceeds 256 pixels in width, it will automatically be converted to a 256x256 pixel square.

Icon generators

The mod includes built-in tools for creating icons:

• URL — downloads an image from the internet via URL and saves it as PNG. Command: /iconic url [icon name] [image URL]
• Player Skin — creates a 3D render of a player skin. Command: /iconic player [player name or UUID]
• PetPet Animation — adds petpet animation to any other icon. Command: /iconic petpet [other icon name]

Built-in icons

The mod comes with a set of ready-made icons, including:

• axolotl — axolotl
• bananaspin — spinning banana
• birdspin — dancing bird
• boatjeb — Jeb in a boat
• bruh, concern, confusion — emotional reactions
• creeper — creeper
• egg — egg
• emotionaldamage — EMOTIONAL DAMAGE!!!
• explosion — planet annihilation
• eyes — eyes
• fabric — FabricMC logo
• fire — fire
• heart — heart
• hellothere — Obi-Wan Kenobi
• iapprove — approval
• minecraft — Minecraft logo
• missing — missing texture cube
• modrinth — Modrinth logo
• neverdie — tribute
• partypopper — party popper
• pog, potato, prideflag — various styles
• rage — angry seagull
• rainbow — rainbow
• rickroll — Rick Astley
• shut — "shut" seagull
• skull — skull
• snail — snail
• sob — crying
• sus — Among Us character
• tater — FabricMC mascot
• thanossnap — fading away
• thumbsdown, thumbsup — thumbs down/up
• wheeze — laughter

Animated icons

Create moving icons! For this, use an image where the height is greater than the width. For example, a 64x256 pixel image will contain 4 frames of 64x64 each.

Each frame is displayed for approximately 37.5 milliseconds (0.0375 seconds), and the animation loops after the last frame.

To convert GIF to the appropriate format, you can use a special tool. Make sure to select vertical orientation and tile size of 256x256 pixels (or smaller).

Compatibility with other mods

Tested compatibility:

• Fabric API — required for operation
• Fabric Language Kotlin — required for operation
• No Chat Reports — fully compatible
• Figura — compatible with extended features
• Symbol Chat — incompatible