ValheimLoading...ArthisticScheduleBossFight1.1.3

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

4 months ago

Downloads

199

Size

44KB

Dependency string

R2R-ArthisticScheduleBossFight-1.1.3

Download

Details Required (1)Versions

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, Thunderstore 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

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.

Installation

Install BepInEx and Jotunn (see links above) if you haven’t already.

Install Scheduled Boss Fight via your mod manager (e.g. r2modman, Thunderstore 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).

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