Configuration

Configuration

Blót has one settings file and two tables. The server's values are the ones that count; players don't need to change anything.

File	What
BepInEx/config/com.taeguk.valheim.blot.cfg	Settings (below). Changes need a server restart
BepInEx/config/Blot/offerings.yaml	Every item that scores and how much. Live: changes apply within seconds
BepInEx/config/Blot/blessings.yaml	The blessings and their order. Live: changes apply within seconds
BepInEx/config/Blot/<world id>/state.yaml	The world's pool, realm total, running blessings and log (written by the mod)
BepInEx/config/Blot/<world id>/contributions.yaml	Each account's total and daily-limit use (written by the mod)

Don't edit the files in <world id>/ while the server runs.

Only the server's files count. On a dedicated server, players' own files are never read: a player's game only reports what burned, and the server scores it with its own list and keeps its own record. A player's offerings.yaml and blessings.yaml are used only for worlds that player hosts (single-player or host & play), and are created the first time they start one.

Every world keeps its own record in its own <world id>/ folder: points offered in a player's single-player world never count on a server, and the other way round.

Settings — com.taeguk.valheim.blot.cfg

[Rites]

Setting	Default	What it does
restockCost	250	Pool points Restock costs
restockGate	defeated_gdking	World key that unlocks Restock (The Elder). Empty = always unlocked
regrowthCost	750	Pool points Regrowth costs
regrowthGate	defeated_goblinking	World key that unlocks Regrowth (Yagluth). Empty = always unlocked
riteMinContribution	10	Points an account must have offered in total to propose or vote
riteVote	true	A rite needs a vote. false = a proposal is performed at once
riteVoteSeconds	120	How long a vote stays open (minimum 10)
riteVoteCooldownMinutes	10	How long a proposer waits after a failed vote
restockSkipLocations	StartTemple,Vendor_BlackForest,Hildir_camp,BogWitch_Camp,Hildir_crypt,Hildir_cave,Hildir_plainsfortress	Locations Restock never touches (comma separated)
regrowthProtectPrefabs	Player_tombstone	Objects that protect their zone from Regrowth, besides player builds and tamed creatures
occupiedRadius	300	A place or zone within this many metres of a player waits until they leave
maxZdoOpsPerFrame	500	World objects Restock and Regrowth handle per frame. Lower it if the server stutters during a rite

[Offerings]

Setting	Default	What it does
dailyCapEnabled	true	Turns the daily limit on
dailyCapPoints	200	Points an account can score per day
dailyCapResetHour	0	Hour (server's local time) when the day starts
dailyCapIncludesBossOfferings	false	true = first-time boss/Lord offerings count against the limit too

[Blessings]

Setting	Default	What it does
milestoneEvery	150	A blessing starts each time the realm's total offered passes a multiple of this
onlineOnlyTimers	true	Blessing timers only run while someone is online

[Discord]

Setting	Default	What it does
discordWebhookUrl	(empty)	Public channel webhook, used when ServerGuard isn't posting
discordWebhookUrlAdmin	(empty)	Admin channel webhook (falls back to the public one)
preferServerGuard	true	Post through ServerGuard's webhooks when ServerGuard 2.2+ is on the server

A config file from 0.2.x still has [Finishers], [Ragnarok] and [Heritage] sections; they do nothing and can be deleted.

offerings.yaml

The full list of offerings: every item that scores, and its points. Changes apply live: save the file and the server uses it within a few seconds, with no restart and no command.

version: 2
repeatBossPoints: 1        # a boss/Lord offering after the account's first one
defaultTrophyPoints: 0     # an UNLISTED item whose prefab name starts with "Trophy"; 0 = only listed items score

items:
  # Bosses, by biome - full value the first time an account offers one
  TrophyEikthyr:               { points:  10, kind: boss }
  ...
  # Rare trophies and items - every copy
  DragonEgg:                   { points:  15, kind: item }
  ...
  # Creature trophies - every copy
  TrophyBoar:                  { points:   1, kind: item }
  ...

The file the server writes lists all 82 default offerings (Offering Points).

• Add an item: add a line with its prefab name (the item's internal name, such as SurtlingCore, not "Surtling Core"), e.g. SurtlingCore: { points: 3, kind: item }. Any item can be added, not only trophies.

• Remove an item: delete its line, or set points: 0. Items that are not listed score 0.

• kind:

  kind	Scores
  boss, lord	Full value the first time an account offers it, then repeatBossPoints. The first one skips the daily limit
  rare, item	Its points every time; always counts against the daily limit

• A mistake in the file (a missing }, wrong indentation): the server ignores the file, keeps the last good list, and says what is wrong in its log, in blot log and on the admin Discord channel. Fix it and save again.

• Delete the file to get the default list back (also live).

• Trophies from other mods score only when they are listed, or when defaultTrophyPoints is above 0.

• Coming from 0.3.0: that file listed only bosses, Lords and rare items. It is upgraded on the first start: the 59 creature trophies are added at 1 point and defaultTrophyPoints goes from 1 to 0, so the game's own trophies score as before.

blessings.yaml

milestoneOrder:            # milestone 1, 2, 3, … take these in turn, then start over
- odins_insight
- freyrs_bounty
- '@random'                # one of randomPool
randomPool:
- bifrost_hour
- valkyries_grace
- mercy_of_hel
- pack_mule
- feast_of_valhalla
- truce_of_the_gods
blessings:
- id: odins_insight
  name: Odin's Insight
  key: SkillGainRate       # a world modifier (the game's GlobalKeys)
  multiplier: 1.5          # 0 = an on/off modifier
  minutes: 120             # play time (online) it lasts
  effect: XP x1.5          # shown in game and on Discord

Default blessing	key	multiplier	minutes
odins_insight	SkillGainRate	1.5	120
freyrs_bounty	ResourceRate	1.5	120
bifrost_hour	TeleportAll	0	30
valkyries_grace	DeathKeepEquip	0	60
mercy_of_hel	SkillReductionRate	0.5	120
pack_mule	CarryWeightRate	1.5	60
feast_of_valhalla	FoodRate	0.67	120
truce_of_the_gods	PassiveMobs	0	20

FoodRate is how fast food runs out, so "food lasts ×1.5" is a multiplier of 0.67.

Changes to blessings.yaml also apply live. A file with a mistake, or with no blessings in it, is ignored and the last good one stays in use. Deleting it writes the defaults again.