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.
• Separate sender names and avatar URLs for manual and death captures; optional GIF footers and automatically bold player names.
• 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:

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 in bold automatically. Existing **{player}** templates are also accepted without doubling the formatting. The two capture types use the same webhook. Mentions are disabled.

In Discord manual and Discord morte, set independent sender names and avatar URLs. An empty sender name keeps the existing shared sender setting; an empty avatar uses the webhook's default avatar. Supply a direct public HTTP/HTTPS image URL, not a local path. An invalid URL is omitted; Discord still needs to be able to retrieve a valid image from the address.

Footers are optional. A nonempty footer puts the GIF in an image embed with the footer below it. {player} in a footer inserts the plain player name because Discord footer text does not support Markdown. Clear the footer to use the simple GIF attachment layout.

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. The new sender/avatar/footer options still need in-game and live Discord 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.

• ConfigurationManager
• FFmpeg distribution

Changelog

0.2.1

• Independent manual/death sender names and avatar image URLs in ConfigurationManager.
• Optional per-event footer displayed below the attached GIF in an embed.
• Automatically bold player placeholders, escape player Markdown, and accept existing bold templates.
• Preserve existing shared sender, webhook, messages and capture settings.
• 35 automated checks passed, including simulated uploads and real four-second GIF export/decoding; no live Discord messages sent.

0.2.0

• GIF-only release preparation for Thunderstore.
• Removed obsolete audio and MP4 code; renamed internal frame/export types to GIF.
• Added Portuguese ConfigurationManager labels and a masked webhook field with paste button.
• Pauses capture while configuration is open.
• Migrates and cleans prototype config, preserving active settings and making a local backup.
• Keeps 4-second GIFs and the 2-second post-death delay.