-
Notifications
You must be signed in to change notification settings - Fork 0
Discord (Herald)
One post in a Discord channel that edits itself as the server changes. Not a stream of messages. One post, kept fresh.

Setup wizard walks the whole thing in four steps and is the easiest way in.

Welcome explains what the post carries and what you need: a Discord server where you can manage webhooks, or a friendly admin who can.
Webhook has the steps for making one: Server Settings, Integrations, Webhooks, New Webhook, name it, pick a channel, Copy Webhook URL. Paste it in the field and BakaLoader knocks on it to check it answers. The status line goes from "paste the URL · the Herald will knock on it to make sure it answers" to "checking…" to either the webhook's name or the error. There is a Thread ID field here too, optional.

Tidings is where you choose the extras: join address, password, event posts.

Publish summarises what you picked and places the first post.

Share this server on Discord is the master switch. Off means nothing is ever sent, whatever else is set.
Webhook URL is the one you copied from Discord. It has to look like https://discord.com/api/webhooks/<numbers>/<token>.
Thread ID is optional. Set it and every post goes inside that thread or forum post instead of the channel itself. To get one, turn on Developer Mode under App Settings, Advanced, then right click the thread and Copy Thread ID. Blank posts in the channel.
Always: the server name as the title, Status, Players online, World, Mods, Last mod update and Next restart. The colour follows the state, green for running, orange for starting or stopping, grey for offline.
The two optional fields have their own switches.
Join address (IP:port) puts your public address in the post so friends can copy it straight from Discord. If you set a custom domain, the name is used instead of the raw address.
Server password puts the password in the post. Everyone who can read that channel can read it. The warning under the switch says so, and it means it. Private channels only.
Event posts are separate one off messages, not edits of the status post. They fire on server start, stop and crash, on players joining and leaving, when a start was held back, when a server update finishes or fails, and when a pre-1.0 world is loaded.
The post also disables mentions entirely, so nothing in a server name, a world name or a player name can ping your channel.
Publish now creates the post, or refreshes it immediately if it already exists.
Remove post deletes it from Discord. Your settings stay, so you can publish again whenever.
BakaLoader creates the post once and remembers its message id. Every change after that is an edit of that same message.
Edits are throttled. At most one edit every 10 seconds, and near simultaneous changes are gathered for 2 seconds before an edit goes out, so a wave of joins is one edit rather than six.
If an edit comes back as not found, because someone deleted the post or the webhook moved channels, BakaLoader forgets the id and creates a fresh post on the next update.
"Paste the webhook URL first."
"That does not look like a Discord webhook URL. It should start with https://discord.com/api/webhooks/"
"Discord says that webhook does not exist. It may have been deleted, so create a new one and paste the fresh URL."
"Discord answered 429. Try again in a moment."
"No server snapshot is available yet." means BakaLoader has not seen the server yet, so there is nothing to post.
Only to the webhook URL you pasted. Nothing about your server goes anywhere else because of this feature.
Turning the master switch off stops every post and every edit. It does not delete the post that is already there. Use Remove post for that.
You want a channel that always shows whether the server is up.
Make a channel, #valheim-status. Server Settings, Integrations, Webhooks, New Webhook, pick that channel, Copy Webhook URL.
In BakaLoader, open Discord, press Setup wizard, paste the URL. The status line names the webhook. Press Next.
Turn on Join address. Leave Server password off, because that channel is not private. Turn on Event posts so joins and leaves show. Next, then Publish the post.
The post appears. Somebody joins, and within a couple of seconds the Players online field says 1. They leave and it says 0. The post never moves.
Will it spam my channel? Not the status post. That is one message, edited in place. Event posts are separate messages and are off unless you turn them on.
Can I have several servers post to one channel? Yes. Each profile has its own webhook setting, so point them all at the same channel and each keeps its own post.
The post stopped updating. The webhook was deleted, or the master switch is off. Press Publish now and read the status line.
Can I change what the post looks like? No. The layout is fixed, and the only choices are the join address, the password and event posts.
Does the password field show my password to Discord? Only if you turn that switch on, and only to whoever can read that channel. Discord itself receives it either way as part of the message body.
Screens
Dashboard (Hearth) Players (Vikings) Mods Hexium Configs (Runes) Settings (World) World modifiers Map (Atlas) Log (Saga) Discord (Herald) Statistics (Skald)
Guides
Running the server Automatic restarts Server updates and the launch guard Updating the server Updating BakaLoader Worlds, backups and restore Deleting a world Multiple servers Custom domain The condition bar Command palette and shortcuts Privacy and network
Reference
Settings reference How mods are matched and updated The bundled plugins World file formats How the map is drawn For mod authors
Help