Adding emotes to RPEmotes requires uploading image files through the mod's configuration folder

RPEmotes is a roleplay mod that lets you perform custom animations and expressions in games like Garry's Mod and Source Engine games. The mod comes with built-in emotes, but you can add your own by placing image files in the correct folder and configuring them with a straightforward text file. The process takes about five minutes once you know where the files go and what format they need to be in.

You will need three things: the RPEmotes mod already installed in your game, image files for your emotes (PNG or JPG format works), and a text editor like Notepad. The mod looks for emotes in a specific folder structure, and if the files are in the wrong place or named incorrectly, the game will not recognize them.

Key Takeaways

  • Emote image files go in the garrysmod/data/rpemotes folder on your computer, not in the game's main mod folder.
  • Each emote needs an image file (PNG or JPG) and an entry in the config.txt file that tells the mod what to call it and how to display it.
  • Image files should be square and at least 64 pixels wide, though 128x128 pixels gives the clearest result in-game.
  • After adding files, restart your game completely for RPEmotes to load the new emotes into the menu.

Locating the RPEmotes configuration folder

RPEmotes stores all custom emotes in a folder buried inside your game directory. On Windows, navigate to your Steam installation folder, then find SteamApps/common/GarrysMod/garrysmod/data/rpemotes. On Mac or Linux, the path is similar but your Steam folder location may differ — it is usually in your home directory under .steam/steamapps/common/GarrysMod/garrysmod/data/rpemotes.

If the rpemotes folder does not exist yet, create it yourself. Right-click in the data folder, select New Folder, and name it rpemotes. The mod will look for this folder when it starts, and if it finds it, it will scan for any image files inside. If the folder does not exist, the mod will still work with its default emotes, but it will not load any custom ones you add.

Preparing your image files

Emote images work best when they are square — the same width and height. A 128x128 pixel image is the standard size and displays clearly in the emote menu. You can use smaller images like 64x64 pixels, but they will appear blurry. Larger images like 256x256 pixels will work but take up more space and may slow down the menu slightly.

Save your images as PNG or JPG files. PNG is preferred because it supports transparent backgrounds, which looks cleaner in the emote menu. If your image has a solid background color, JPG works fine too. Name each file something straightforward and descriptive — for example, happy.png or thumbsup.jpg — and avoid spaces or special characters in the filename. The mod reads the filename to create the emote name, so a file called my-emote.png will appear as "my-emote" in your emote menu.

Adding emotes through the config file

Inside the rpemotes folder, you need a file called config.txt. If it does not exist, create one by opening Notepad, leaving it blank, and saving it as config.txt in the rpemotes folder. Open config.txt with Notepad and add one line for each emote you want to add. The format is straightforward: the emote name, a comma, and the filename.

For example, if you have an image file called happy.png, add this line to config.txt:

Happy,happy.png

The first part (Happy) is what appears in the emote menu. The second part (happy.png) is the actual filename. You can make the menu name different from the filename if you want — for instance, you could have a file called smile.png but call it "Big Smile" in the menu by writing:

Big Smile,smile.png

Add as many lines as you have emotes. Save the file when you are done. Do not add extra spaces or punctuation — just the name, a comma, and the filename.

Testing your new emotes in-game

Close your game completely if it is running. Restarting the game is the only way RPEmotes will read the new config.txt file and load your custom images. straightforward minimizing the game or loading a new map will not work — you must fully exit and restart.

Launch the game and join a server or start a single-player game. Open the emote menu using the default key (usually E, but check your keybinds). Scroll through the list and look for your custom emotes. If they appear, click one to use it. If they do not appear, check that the image files are in the rpemotes folder and that the filenames in config.txt match exactly — including capitalization and file extensions.

Troubleshooting missing or broken emotes

If your custom emotes do not show up, the most common cause is a filename mismatch. Open config.txt and compare each filename to the actual files in the rpemotes folder. Windows hides file extensions by default, so you might think a file is called happy when it is actually happy.png. Enable "Show file extensions" in Windows File Explorer to see the real names.

Another common issue is the config.txt file itself being in the wrong format. Make sure you are editing it with a plain text editor like Notepad, not Word or Google Docs — those programs add invisible formatting that breaks the file. If you are still stuck, delete config.txt, create a new one, and add just one emote to test. Once that works, add the rest one at a time.

If an image appears as a broken or missing-file icon in the menu, the file is in the right place but the image format is corrupted. Try re-saving the image in PNG format using an image editor like Paint or GIMP, then update config.txt with the new filename.

Sharing emotes with other players

Custom emotes only appear on your own computer — other players will not see them unless they add the same images to their own rpemotes folder. If you want to share emotes with friends, send them the image files and the line you added to config.txt. They can then place the files in their rpemotes folder and add the same line to their config.txt.

Some communities share emote packs as ZIP files that contain a ready-made rpemotes folder. If you read one, extract it and copy the contents into your own rpemotes folder, replacing the config.txt if prompted. This is faster than adding emotes one at a time.

Frequently Asked Questions

Can I use animated GIFs as emotes?

RPEmotes does not support animated GIFs — it only displays static images. If you have an animated GIF, you can extract a single frame from it using an image editor and save it as a PNG or JPG. Websites like ezgif.com can do this quickly if you do not have editing software.

What happens if I delete an emote from the folder?

If you remove an image file but leave its line in config.txt, the emote will appear in the menu as a broken icon. Delete the corresponding line from config.txt to remove it from the menu. Restart the game for the change to take effect.

Can I organize emotes into categories or folders?

Standard RPEmotes does not support subfolders or categories — all emotes appear in a single scrollable list. Some modified versions of the mod may support organization, but you would need to check the specific mod's documentation.

How many emotes can I add?

There is no hard limit, but adding hundreds of emotes will make the menu slower to load. Most players keep between 20 and 100 custom emotes. If the menu becomes sluggish, try removing emotes you do not use.

Do I need to restart the game every time I add a new emote?

Yes, you must fully close and restart the game for it to read the updated config.txt file and load new images. straightforward reloading a map or changing servers will not work.