
Arauto
Discord webhook announcements for Valheim servers: start (when the world is really ready), stop, joins, leaves, deaths with the cause, shouts, pings, events, new day, and a single self-editing save message.Arauto
⚠️ Disclaimer
I created this mod for personal use on my dedicated server.
Will it work on yours? Hell if I know, but I hope it does!
Server announcements in a Discord channel through a webhook. Made to replace DiscordConnector on our server, with the same messages plus a few things it did not do:
- "Server started" only when the world is really ready. With Voxheim installed, that is when Voxheim logs
terrain authority … is ready(can be minutes afterOpened Steam server). Without Voxheim, atOpened Steam server. - Deaths with the cause, Terraria style: fall, drowning, smoke, fire, lava, freezing, poison, trees, collapsing buildings, ballistas, carts, boats, creatures, other players… Several random phrases per cause.
- One save message that edits itself. Instead of a new message at every world save, the last one is edited to
💾 Último salvamento às <time>(shown in each reader's own time zone), as long as nothing else was posted since.
Default texts are in Portuguese (Brazil); every text can be changed in the config.
Messages
| Message (config key) | When |
|---|---|
Iniciando |
Server process started |
Iniciado |
World ready to play (see above) |
Parando / Parado |
Shutdown started / finished (world already saved) |
Salvamento |
World saved (edits the previous save message if nothing else was posted) |
NovoDia |
A new in-game day begins |
Entrada / Saida |
Player joined / left |
PrimeiraEntrada |
Right after a player's very first join |
Morte / PrimeiraMorte |
Player died (with the cause) / first death of that player |
Grito |
Player shouted in chat |
Ping |
Player pinged the map (position optional) |
EventoInicio, EventoFim, EventoPausa, EventoRetomada |
Raid started, ended, paused (nobody in the area) or resumed (position optional) |
Each message has an on/off switch in section [Ligar]. Placeholders: %PLAYER_NAME%, %DEATH_TEXT%, %SHOUT%, %SAVE_TIME%, %DAY_NUMBER%, %EVENT_MSG%, %EVENT_START_MSG%, %EVENT_END_MSG%.
Death phrases are in section [Mortes], one key per cause, phrases separated by | (one is picked at random). %PLAYER_NAME% and %ENEMY% work there.
Installation
- Server: required. Set the webhook in
BepInEx/config/SAFADOS.Arauto.cfg, section[Webhook], keyURL(Discord: channel settings → Integrations → Webhooks). Empty URL = nothing is sent. - Clients: recommended. Only the player's own game knows what killed them; with Arauto on the client, it tells the server the cause. Without it, the death is still announced, with a generic phrase. Clients send nothing to Discord and need no configuration.
- Manual install:
BepInEx/plugins/SAFADOS-Arauto/Arauto.dll.
Good to know
- Mentions are blocked. Every message is sent with
allowed_mentionsempty: a player shouting@everyonepings nobody. - Messages go out in order, from a separate thread (the game never waits for Discord), and are retried when Discord rate-limits (HTTP 429).
- "Parando" and "Parado" are sent immediately at shutdown (up to ~5 s), so they are not lost when the process exits. The save done during shutdown produces no message.
- Coming from DiscordConnector? "First time" messages use
BepInEx/config/SAFADOS.Arauto.jogadores.txt, one line per player:entrou: Name(has joined before) ormorreu: Name(has died before). Fill it with your veterans before the first start, or everyone gets a welcome. - The save message can only edit Arauto's own messages: if someone writes in the channel between two saves, the save still edits the previous message (now further up).
EsperaMaximaVoxheimMinutos(default 20): with Voxheim, if it never reports ready, "Iniciado" is sent anyway this long afterOpened Steam server.- Test mode: environment variable
ARAUTO_TESTE=1sends a sample of every message right after "Iniciado". Test servers only.
Compatibility
Tested with BepInEx 5.4.23 (BepInExPack Valheim 5.4.2333) and Voxheim 0.1.10, on a Linux dedicated server.