Valheim
Install with App

Details

Latest version
1.0.0
Last Updated
First Uploaded
Downloads
10
Likes
0
Size
38KB
Dependants
ADDatHost Valheim hosting
30% off

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 after Opened Steam server). Without Voxheim, at Opened 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], key URL (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_mentions empty: a player shouting @everyone pings 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) or morreu: 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 after Opened Steam server.
  • Test mode: environment variable ARAUTO_TESTE=1 sends 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.

Thunderstore development is made possible with ads. Please consider making an exception to your adblock.