Custom emojis for OSRS.
The plugin does not come with built-in emojis. You have a few options:
- Use the built-in GitHub downloader to fetch emoji packs directly (see GitHub Integration below)
- Manually download from a known repository on github and install to your emojis folder
Known repositories:
TheLouisHong/custom-emoji-repository- Has a good baseline of commonly used static emoji. [link]mooncord-emojis/emojis- Has a ton of (1000+) emoji both animated and static. Great option if you aren't picky about what emoji you want to see. [link]
The filename becomes the trigger for the emoji. For example, woow.png means typing woow in-game will display that image.
- Supported formats:
.png,.jpg,.jpeg,.gif - Location:
.runelite/emojis/
You can organize emoji in subfolders for easier management.
GIF files are fully supported with frame-by-frame animation:
- Animations play in chat messages and above player heads
- Original GIF frame timing is preserved (probably)
Zero-Width emoji are fully supported!
- Zero-Width emoji filenames must end with 00. e.g.
alert00.gif
Holiday versions of your emoji swap in automatically when the season arrives, and swap back when it ends.
Give the seasonal version the same filename as the emoji it replaces, and put it in Seasonal/<Holiday>/:
| Holiday | Folder | Active |
|---|---|---|
| Halloween | Seasonal/Halloween/ |
October 1 - November 1 |
| Christmas | Seasonal/Christmas/ |
December 1 - January 1 |
The filename becomes the trigger for the soundoji. For example, pipe.wav means pipe in-game will play that audio file.
- Supported formats:
.wav - Location:
.runelite/soundojis/ - Volume: Adjustable in plugin settings (0-100)
An explorer-style emoji browser in the RuneLite sidebar that allows the user to configure settings for individual emoji:
Settings - Open plugin configuration
Github - Opens a browser page to this repository
Folder - Shows the ~/.runelite/emojisfolder in a file explorer window
Back - Navigates to to the previous directory
Reload - Reload all emoji
Download - Fetch GitHub emoji pack
Resize mode - Toggle resize configuration mode
Download emoji packs directly from GitHub repositories:
- Open plugin settings
- Enter a repository in the Repository field using format:
owner/repoorowner/repo/tree/branch.- For example, a github repository with the url of
https://github.com/realbillgates/osrs-emojiswould instead be entered asrealbillgates/osrs-emojisfor the default branch orrealbillgates/osrs-emojis/tree/largeif you wanted to instead use thelargebranch.
- For example, a github repository with the url of
- Emoji are automatically downloaded and saved to
.runelite/emojis/github-pack/
Click the 
download button in the sidebar panel to manually check for updates. The plugin tracks file changes and will sync additions, modifications, and deletions.
Note: Local emoji take priority over GitHub pack emoji. If you have a local emoji with the same trigger name, it will be used instead of the downloaded one.
| Command | Description |
|---|---|
::emojifolder |
Open the emoji folder |
::soundojifolder |
Open the soundoji folder |
::emojierror |
Show emoji loading errors |
Will you implement autofill/autocomplete? No.
If you need help, feel free to open an issue.
- Panel icons from Bootstrap Icons (MIT)
- Plugin Hub icon adapted from OpenMoji (CC BY-SA 4.0)