HUDGifAnimation
Animated GIF overlay in top-left HUD corner
About this mod Author’s original text
HUD GIF Animation
Displays an animated GIF overlay in the top-left corner of your HUD during gameplay (100% adjustable now).
Features
- Supports any GIF with any frame count and timing
- Configurable position (X/Y coordinates)
- Adjustable scale
- Only shows during active runs
- Minimal performance impact
Installation
Install with r2modman or Mod Manager.
Configuration
After first launch, edit the config file at BepInEx/config/com.moetus.hudgifanimation.cfg:
[Position]
X Position = 10
Y Position = -80
[Appearance]
Scale = 1.0
Adjust these values to reposition or resize the GIF overlay.
How to Use Your Own GIF
- Find a GIF you want to use
- Go to ezgif.com/split
- Choose your GIF file and click "Upload"
- IMPORTANT: Change "Split options" to "Output as PNG"
- Click "Split into frames!"
- Click "Download frames as ZIP"
- Replace gif_frames located at:
-AppData/Roaming/r2modmanPluslocal/RiskOfRain2/profiles/DesiredProfile/BepInEx/plugins/HUDGifAnimation/plugins/HUDGifAnimation/
with a blank folder of the same name
- Extract the ZIP contents to:
- AppData/Roaming/r2modmanPlus-local/RiskOfRain2/profiles/DesiredProfile/BepInEx/plugins/HUDGifAnimation/plugins/HUDGifAnimaion/gif_frames/
- IMPORTANT: Make sure the folder is named exactly gif_frames
- The mod will automatically detect all frames and their delays
Notes
- A placeholder GIF is included as an example
- GIF size in corner is based on your GIF's resolution (placeholder is 512x512)
- Frame delays are read automatically from the filenames
- Use the Scale config option to make oversized GIFs smaller
- Transparent backgrounds work great!
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.
Install these first, or the mod will not work: