ArthisticScheduleBossFight
Schedule Valheim boss unlocks to real-life dates (configurable timezone). Optional Discord webhooks and config sync.
About this mod Author’s original text
Scheduled Boss Fight
A Valheim BepInEx mod that unlocks bosses on real-life dates. Set a date and time (Philippines, GMT+8) for each boss; the mod blocks altar use until then and can notify players via in-game chat and optional Discord webhooks.
Features
- Date-based unlock — Configure unlock utc offset/date/time per boss (Eikthyr, Elder, Bonemass, Moder, Yagluth, Queen, Fader).
- Blocks early summon — Prevents using boss altars or offering items before the scheduled unlock.
- In-game messages — Countdown and “unlocks tomorrow” / “unlocked” messages to all connected players.
- Optional Discord — Send the same announcements to a Discord channel via webhook.
- Config sync — ServerSync support so server config is synced to clients (optional lock for admin-only changes).
- Config watcher — Edit the config file on disk and the mod reloads it without restarting the server.
Requirements
- Valheim (dedicated server and/or client)
- BepInEx 5 (e.g. BepInExPack Valheim)
ServerSync is included with the mod for config synchronization.
Installation
- Install BepInEx and Jotunn (see links above) if you haven’t already.
- Install Scheduled Boss Fight via your mod manager (e.g. r2modman, Mod Manager) or manually:
- Extract the package into your Valheim folder so that BepInEx/plugins/Arthistic-ScheduleBossFight/ contains the mod DLL (and any bundled files).
- Run the game or dedicated server once to generate the config file.
Configuration
Config file: BepInEx/config/arthistic_scheduledbossfight.cfg
General
| Setting | Default | Description |
|--------|---------|-------------|
| Lock Configuration | true | If enabled, only server admins can change config (synced via ServerSync). |
| CheckIntervalSeconds | 1800 | How often the mod checks unlock dates (seconds). |
| UtcOffsetHours | 8 | Timezone offset from UTC in hours (e.g. 8 for Philippines GMT+8, -5 for EST). UnlockAt times are interpreted in this timezone. |
| DiscordNotifyMinutesBefore | 30 | Send a Discord message this many minutes before a boss unlocks (0 = disabled). |
| DiscordWebhookURL | (empty) | Optional Discord webhook URL for unlock/countdown messages. |
Per-boss (e.g. Eikthyr, Elder, Bonemass, …)
| Setting | Description |
|--------|-------------|
| DisplayName | Name used in chat/Discord messages. |
| Enabled | Turn scheduled unlock on/off for this boss. |
| UnlockAt | Date and time in Philippines (GMT+8). Format: yyyy-MM-dd or yyyy-MM-dd HH:mm or yyyy-MM-dd HH:mm:ss. |
Example: UnlockAt = 2027-01-01 18:00:00 → boss unlocks on 1 Jan 2027 at 18:00 Philippines time.
How it works
- Only the server runs the unlock checks. When the current time (UTC) reaches the configured unlock time, the mod sets the game’s global key for that boss (e.g. defeated_eikthyr), so the boss is considered defeated for progression.
- Until then, Harmony patches block:
- Interacting with the boss altar to summon the boss.
- Using the required offering item on the altar.
- If a player tries to use an altar too early, they see a message with the unlock date/time in Philippines (GMT+8).
Support
- Bugs / feature ideas: GitHub Issues
- Source: GitHub – Arthistic04/Arthistic-ScheduleBossFight
Changelog
| Setting | Description |
|---------|-------------|
| 1.1.2 | UTC Offset set to configurable |
| 1.1.1 | Removed global key (defeated_eikthyr etc.) after the configured date, Error on me |
| 1.1.0 | Release for production |
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file. In multiplayer, the host and every client need the same mods installed.
Install these first, or the mod will not work: