Iconic

## Iconic **Upload your own icons to chat, fully client side!** *The following document is relevant for Iconic `2.0.0`.* <br /> ### Using the Mod To insert an icon into chat, begin by typing `:`. Autocomplete suggestions will pop up. Upon sending a message with icons, the icons will be sent to other clients, which will then show it on screen. <br />**The mod works by hiding an icon id in the chat. If the actual chat message sent exceeds the maximum length of 256 characters, a warning will be shown.** Don't icon spam too much. These commands also support including icons: `/me`, `/msg`, `/teammsg`, `/tell`, `/tellraw`, `/tm`, `/w`, `/reply`, `/r`, `/last`, `/l` (last 4 are common reply commands on servers). ### Adding Your Own Icons Add icons by clicking the star button at the bottom left of the chat bar. A directory will be opened where you can add icons. Alternatively, navigate to your dotminecraft and open the `icons` directory. <br />**Icons over 1 megabyte will be rejected. Only images in the `.png` format are accepted.** <br />**If an image is wider than taller (width > height), or the image is wider than `256`, it will automatically be corrected to a `256px` width square image.** Alternatively, you can use one of the provided icon generators: <details><summary>Icon Generators</summary> ### URL Downloads an icon from the internet by URL, and saves it to the icon directory as a PNG. <br />**Usage**: `/iconic url ` ### Player Skin Generates a 3D render of a player skin. <br />**Usage**: `/iconic player ` ### PetPet Animation Adds the petpet animation to any other icon. <br />**Usage**: `/iconic petpet ` </details> ### Built-in Icons The mod comes with some built-in icons. Here's a list: <details><summary>Built-in Icons List</summary> - `axolotl` - `bananaspin` (A spinning banana) - `birdspin` (A dancing bird) - `boatjeb` (Jeb in a boat) - `bruh` - `catbop` (Bopping cat) - `cathello` (Cat waving hello) - `concern` - `confusion` - `creeper` - `egg` - `emotionaldamage` (EMOTIONAL DAMAGE!!!) - `explosion` (Planet annihilation) - `eyes` - `fabric` (FabricMC logo) - `fire` - `heart` - `hellothere` (Obi-Wan Kenobi hello there) - `iapprove` - `minecraft` (Minecraft logo) - `missing` (Missing texture cube) - `modrinth` (Modrinth logo) - `neverdie` (Tribute) - `partypopper` - `pog` - `potato` - `prideflag` - `rage` (Angry seagull) - `rainbow` - `rickroll` (Rick Astley) - `shut` (Shut seagull) - `skull` - `snail` - `sob` - `sus` (Among Us character) - `tater` (FabricMC mascot?) - `thanossnap` (Fading away) - `thumbsdown` - `thumbsup` - `wheeze` </details> ### Animated Icons Icons can be animated too! Here's how: <details><summary>Adding Animated Icons</summary> To add an animated icon, create an image with a height greater than the width. For example, a `64x256` image would have 4 frames, each `64x64` pixels. <br /> Each frame is rendered for approximately 37.5 milliseconds (0.0375 seconds), and loops after reaching the last frame. <a href="https://ezgif.com/gif-to-sprite">Here's a tool</a> you can use to convert a gif into an icon that can be used. <br />**Make sure to set *Tile Alignment* to *Vertical* and *Tile Size* to *256x256* (or a smaller square).** </details> ### Mod Compatibility Here are the mods that have been tested alongside Iconic: <details><summary>Mod Compatibility</summary> <table> <tr> <th>Mod</th> <th>Compatibility</th> </tr> <tr><th><a href="https://modrinth.com/mod/fabric-api">Fabric API</a></th><th><strong>Required</strong></th></tr> <tr><th><a href="https://modrinth.com/mod/fabric-language-kotlin">Fabric Language Kotlin</a></th><th><strong>Required</strong></th></tr> <tr><th><a href="https://modrinth.com/mod/no-chat-reports">No Chat Reports</a></th><th>Compatible</th></tr> <tr><th><a href="https://modrinth.com/mod/figura">Figura</a></th><th>Compatible and Extended</th></tr> <tr><th><a href="https://modrinth.com/mod/symbol-chat">Symbol Chat</a></th><th><strong>Incompatible</strong></th></tr> </table> </details>