
About this Mod
Amoji
Adds emojis to Minecraft.
This mod is based largely on Emojiful, but with a focus on simplicity and making it easier to add custom emojis.
The functionality is intended to be kept to a bare minimum, to make maintenance easier.
Adding your own emojis
There is a simple way of adding your own sets of emojis. Using the command /amoji add <name> <url> you can add a set of your own custom emojis.
The URL provided should return data of the following format:
{
"emoji1Name": "image1Url",
"emoji2Name": "image2Url",
"emoji3Name": "image3Url"
}
Example:
{
"like": "https://raw.githubusercontent.com/albarv340/amoji/main/like.png"
}
This example can be added with the command:
/amoji add example https://raw.githubusercontent.com/albarv340/amoji/main/example.json
The image URLs can be pretty much any static image URLs, and none of the files used have to be hosted on GitHub, it is just an example.
Using Google Sheets
A relatively user-friendly emoji API can be created using google sheets.
Make a copy of this Google Sheet (By clicking
File > Make a copy)Open the Apps Script editor by clicking
Extensions > Apps Script.Click
Deploy > New Deployment. Fill in the relevant information and chooseAnyonefor who has access. And clickDeploy.Authorize Apps Script with your Google Account. (If it tells you the website is unsafe, you should still proceed, it is an official Google product, nothing to worry about).
Copy the link, visiting it should yield a JSON of the correct format with the emojis added to the sheet.
The emoji API can then be added to the mod with the command:
/amoji add <name> <url>
Available Versions
How to Install Amoji on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.4).
Install Mod
Open the mod browser in the dashboard and search for "Amoji". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.4, 1.21.3, 1.21.2 (+6 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Amoji server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.4). You can switch loaders with one click in the panel.
Is Amoji compatible with fabric and forge?
Amoji officially supports fabric, forge for Minecraft 1.21.4, 1.21.3, 1.21.2. Note: Forge and Fabric mods are NOT cross-compatible – pick one loader and stick with it. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Amoji – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Amoji consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Amoji with just one click on your server.