Discord GIFs
Capture 4-second Valheim GIFs with a hotkey or on death and share them to Discord. Includes a 2-second death delay and an in-game configuration menu. Windows client only.Discord GIFs
Capture moments from Valheim as looping, silent 4-second GIFs and share them to a Discord channel through your own webhook.
Features
- F8 saves the previous 4 seconds.
- Death capture waits 2 seconds after death, producing approximately 2 seconds before and 2 seconds after the event.
- F1 opens shudnal's ConfigurationManager; select Discord GIFs.
- Portuguese setting labels, editable hotkey, capture quality, local folder, upload size and cooldown.
- GIFs are saved locally even when uploading fails. An empty webhook means local-only capture.
- Default GIF output: 10 FPS, up to 480 pixels wide, looping continuously.
- File size is checked before uploading. Resolution is reduced when required.
- Default upload cap: 20 decimal MB; change it to match your channel. This is not an automatically detected Discord entitlement.
- No microphone, system audio capture or MP4 output.
Installation
Install with your mod manager. BepInExPack Valheim and shudnal's ConfigurationManager are listed as dependencies; the manager also installs their dependencies.
Windows client only. Install on each player's PC that should capture GIFs, not just on the server.
On first launch, the mod automatically downloads FFmpeg from Gyan's HTTPS distribution, verifies its published SHA-256 and extracts the encoder alongside the plugin. Internet access is required once. FFmpeg is a separate executable; OBS is not required. The mod does not bundle FFmpeg or game binaries.
Enter a world, keep the game focused for at least 5 seconds and press F8.
Configuration
Press F1, select Discord GIFs, then adjust:
| Group | Options |
|---|---|
| Geral | Enable capture, capture on death, hotkey |
| GIF | Capture FPS/height, vertical orientation, focus-only capture; advanced buffer settings |
| Discord | Webhook, sender name, death/manual messages, maximum file size, cooldown |
| Arquivos | Output folder, automatic FFmpeg download; advanced executable path |
To send GIFs, copy a webhook URL from your Discord channel's integration settings, then use Colar beside the masked webhook field. Clear it to save only on your PC.
Use {player} in either message to insert the player name. The two capture types use the same webhook. Mentions are disabled.
Changes apply to subsequent captures. Capture pauses and clears its buffer while the configuration window is open; after closing it, wait 5 seconds.
The webhook is masked in our normal menu field but remains plain text in the configuration file and its local migration backup. Do not share those files.
The default output folder is clips next to DiscordClips.dll. The existing DLL filename and plugin ID hugo.valheim.discordclips are retained so that prototype upgrades keep their configuration.
Updating from a manually installed prototype
Close the game and replace the DLL in your existing Hugo-DiscordClips folder. Keep ffmpeg.exe and your GIFs.
If switching to installation through the mod manager, remove the old manually installed DLL only to avoid two copies of the same plugin. Keep the old captures. You can set an absolute GIF folder and FFmpeg path in the new configuration.
On first startup, the mod backs up and cleans the prototype configuration. Active preferences and webhook are retained; obsolete audio, microphone, movie encoder and duration settings are removed. Old saved captures are not deleted.
Requirements and limitations
- Windows Valheim client with BepInEx 5 and asynchronous GPU readback support.
- A focused game window and a full capture buffer.
- One export at a time; default cooldown is 15 seconds.
- Capture and GIF encoding use CPU and memory. Lower settings if gameplay is affected.
- Focus loss or opening configuration clears the buffer, including during the death delay.
- The GIF capture and death delay were tested by the author in game. This release's new configuration menu still needs in-game verification.
- Automated validation covers GIF export/decoding, migration and simulated upload responses; it does not post to Discord.
Credits
Created by Hugo. MIT license for this mod's original code. ConfigurationManager, BepInEx, Harmony, Valheim, Unity and FFmpeg remain separate projects with their own licenses.