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 Thunderstore 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"
- Extract the ZIP contents to:
BepInEx/plugins/HUDGifAnimation/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!