Discord GIFs

Record your Valheim adventures and share GIFs on Discord automatically when you die or by pressing F8.

• Capture without the HUD while keeping it visible on your screen.
• Default death replay: 2 seconds before + 2 seconds after death, with adjustable duration.
• 720p by default, with optional 1080p.
• Separate sender names, avatars, messages and footers for manual captures and deaths.
• Full-quality originals saved locally; only the upload copy is reduced when needed.
• Optional server-controlled Discord settings through Jötunn.

GIFs have no audio and support up to 256 colors. Windows clients record and upload the GIFs.

Installation

Install BepInEx, ConfigurationManager and Jötunn 2.30.2 or newer, then install Discord GIFs. Close Valheim before updating and keep only one copy of DiscordClips.dll. Keep your existing ffmpeg.exe, clips folder and configuration.

Simple Discord setup

1. In Discord, open the settings of the text channel where you want to receive GIFs.
2. Go to Integrations → Webhooks, create a webhook and click Copy Webhook URL. You need permission to manage webhooks.
3. In Valheim, press F1, select Discord GIFs and paste the URL into WebhookUrl under 03 - Discord. Click Colar (Paste) if using the masked field.
4. If prompted, wait for the automatic encoder download to finish. Enter a world, play for at least 6 seconds, close the settings menu and press F8 to test.

Deaths also generate GIFs automatically when capture is enabled and the mod is outside its cooldown. Manual captures save the previous 4 seconds by default. Leave the webhook empty to save GIFs only on your computer.

Optional separate channel: set ManualWebhookUrl under 05 - Discord manual to send F8 captures to another channel. Leave it empty to use the main webhook.

Customize your messages

Set names, avatar image URLs and footers separately under 05 - Discord manual and 06 - Discord morte. Set ManualMessage and DeathMessage under 03 - Discord.

Use {player} in messages to show the player's name in bold. Separate complete death messages with semicolons to choose one randomly:

{player} went to Valhalla!;{player} fell in battle!

Empty sender names use WebhookName. Empty avatar URLs use the webhook's avatar. Avatar URLs must point to a public HTTP/HTTPS image. Footers support {player} as plain text.

Optional server setup — new in 0.3.1

Install Discord GIFs 0.3.1 and Jötunn on the server and participating clients. Start the server once, then edit BepInEx/config/hugo.valheim.discordclips.cfg to set webhooks, messages and death replay duration.

Saving the configuration file on a running dedicated server reloads it after about one second. Administrators listed in adminlist.txt can also change shared options in game. Shared options are locked for other players.

The server controls webhooks, sender identities, messages, death replay duration, automatic death capture, upload size limit, cooldown and timeout. Each player keeps control of capture on/off, hotkey, quality, resolution, FPS, memory, HUD mode, orientation, focus behavior, encoder and clip folder.

The dedicated server distributes settings; recording, encoding and uploads happen on each player's computer. Shared webhook URLs are sent to participating clients; masking only hides them on screen. Local values are restored on disconnect by Jötunn.

The server installation is optional. Without the mod on the server, clients use their own settings. Server and clients running this mod must use matching versions. Players without the mod are not required to install it.

Quick troubleshooting

• GIF too large: set MaxUploadMB to your Discord upload limit. Only the upload copy is reduced; the original stays on your computer.
• Black frames or capture problems: disable HideHUD to use screen capture.
• Upside-down image: toggle FlipVertically.
• Encoder missing: enable AutoDownloadEncoder and use the default FfmpegPath = ffmpeg.exe, or provide your own encoder path.
• Settings locked: ask the server administrator to update the shared configuration.

Higher resolution and FPS use more resources. World-space labels may remain visible with HideHUD enabled. Capture can be skipped during cooldown or another export. Failed uploads keep the local original.

Test status

Version 0.3.1 compiled successfully and passed 67 automated checks. In-game capture, live Discord output and multiplayer configuration synchronization still require live testing.