This is an advanced tool for configuring all world spawners.
With this, it is possible to change almost all of the default settings for the way spawners work in Valheim. Want to have a world without trolls? Possible! (probably) Want to have a world with ONLY trolls? Possible! (almost) Want to have a world where greydwarves only spawn at night? Possible! Just want to have more/less of a mob type? Simple modifiers exist!
Why are the config files empty?
Where do I find the prefab names?
Valheim's main way of managing spawns work by having two types of spawners spread throughout the world. The world spawners, for which the world has them spread out in a grid fashion, each using the same list of templates to check if something should spawn. These are the general spawners and all currently use the same 44 templates. The local spawners, which are intended for fine-tuned spawning. Local spawners only spawn one specific mob type, and only has one alive at a time. These are bound to specific world locations, such as the surtling firehole.
For world spawners, you can either replace existing templates based on their index, or add to the list of possible templates to spawn from.
For local spawners, since these are more custom, you describe a location and the prefab name of the mob you what you want to override.
The mod modification happens at run-time, once for each spawner. Reloading the world resets all changes. As the player moves through the world, the game loads in the various spawners, and the mod applies its own settings.
Drop That needs to be installed on all clients (and server) to work.
From v0.3.0 clients will request the configurations currently loaded by the server, and use those without affecting the clients config files. This means you should be able to have server-specific configurations, and the client can have its own setup for singleplayer. For this to work, the mod needs to be installed on the server, and have configs set up properly there. When players join with Spawn That v0.3.0, their mod will use the servers configs.
All of this might be more complicated than what you need or want. Therefore, "spawn_that.simple.cfg" exists to provide simpler modifiers to world spawner mobs. These will simply scale the number of mobs up or down.
Be aware, these will be applied after any other configurations to world spawners have been set. Meaning if you have 10 times spawning in your "spawn_that.world_spawners_advanced.cfg", and the same in the simple config, you are going to end up with 100x spawning.
[YourUniqueNameHere]
## Prefab name of entity to modify.
# Setting type: String
PrefabName = Greydwarf
## Enable/Disable this set of modifiers.
# Setting type: Boolean
Enable = true
## Change maximum of total spawned entities. 2 means twice as many.
# Setting type: Single
SpawnMaxMultiplier = 1
## Change min number of entities that will spawn at once. 2 means twice as many.
# Setting type: Single
GroupSizeMinMultiplier = 1
## Change max number of entities that will spawn at once. 2 means twice as many.
# Setting type: Single
GroupSizeMaxMultiplier = 1
## Change how often the game will try to spawn in new creatures.
## Higher means more often. 2 is twice as often, 0.5 is double the time between spawn checks.
# Setting type: Single
SpawnFrequencyMultiplier = 1
World spawner templates are managed through the "spawn_that.world_spawners_advanced.cfg" file. There are currently 44 default templates, which can be overriden by setting a matching index (starting from 0).
The general config contains debugging options, which can be toggled to create a file containing all templates before the mod applies its changes, and after.
[WorldSpawner.0]
Name=deer
Enabled=True
Biomes=Meadows,BlackForest,
PrefabName=Deer
HuntPlayer=False
MaxSpawned=4
SpawnInterval=100
SpawnChance=50
LevelMin=1
LevelMax=3
LevelUpMinCenterDistance=0
SpawnDistance=64
SpawnRadiusMin=0
SpawnRadiusMax=0
RequiredGlobalKey=
RequiredEnvironments=
GroupSizeMin=1
GroupSizeMax=3
GroupRadius=5
GroundOffset=0.5
SpawnDuringDay=True
SpawnDuringNight=True
ConditionAltitudeMin=0
ConditionAltitudeMax=1000
ConditionTiltMin=0
ConditionTiltMax=35
SpawnInForest=True
SpawnOutsideForest=False
OceanDepthMin=0
OceanDepthMax=0
ConditionDistanceToCenterMin=0
ConditionDistanceToCenterMax=0
ConditionWorldAgeDaysMin=0
ConditionWorldAgeDaysMax=0
Local spawners are customly set up in the world, based on pre-defined location setups. This means they are each customized to the location at which they are placed, and are not as easily "targetted" as the world spawners templates are. To modify a local spawner, you must specify a location and mob prefab name you want to apply a configuration to. You can also use a room name, if more fine control is necessary for villages, dungeons and camps.
Every combination of Location and PrefabName must be unique.
The general config contains debugging options, which can be toggled to create a file containing all default local spawner configs before the mod applies its changes.
Replaces all boars usually spawning at boar runestones, with trolls.
[Runestone_Boars.Boar]
PrefabName=Troll
Enabled=True
SpawnAtDay=True
SpawnAtNight=True
LevelMin=1
LevelMax=3
LevelUpChance=10
RespawnTime=0
TriggerDistance=60
TriggerNoise=0
SpawnInPlayerBase=False
SetPatrolPoint=True
Replaces spawning of blobs in a specific dungeon room with a treasure chest that can respawn every 60 minutes (need to be destroyed for a new one to spawn).
[sunkencrypt_Corridor3.Blob]
PrefabName = TreasureChest_sunkencrypt
RespawnTime = 60
Spawn That will load additional configurations from configs with names prefixed with "spawn_that.world_spawners." and "spawn_that.local_spawners.".
This allows for adding your own custom templates to Spawn That, or simply separate your configs into more manageable pieces. Eg. "spawn_that.world_spawners.my_custom_configuration.cfg" and "spawn_that.local_spawners.my_custom_configuration.cfg"
The configurations loaded will be merged with the one loaded from the main files.
[WorldSpawner.0]
## Just a field for naming the configuration entry.
# Setting type: String
Name = deer
## Enable/disable this entry.
# Setting type: Boolean
Enabled = true
## Biomes in which entity can spawn. Leave empty for all.
# Setting type: String
Biomes = Meadows,BlackForest,
## Prefab name of the entity to spawn.
# Setting type: String
PrefabName = Deer
## Sets AI to hunt a player target.
# Setting type: Boolean
HuntPlayer = false
## Assign a specific faction to spawn. If empty uses default.
SetFaction =
## Maximum entities of type spawned in area.
# Setting type: Int32
MaxSpawned = 4
## Seconds between spawn checks.
# Setting type: Single
SpawnInterval = 100
## Chance to spawn per check. Range 0 to 100.
# Setting type: Single
SpawnChance = 50
## Minimum level to spawn.
# Setting type: Int32
LevelMin = 1
## Maximum level to spawn.
# Setting type: Int32
LevelMax = 3
## Minimum distance from world center, to allow higher than min level.
# Setting type: Single
LevelUpMinCenterDistance = 0
## Minimum distance to another entity.
# Setting type: Single
SpawnDistance = 64
## Minimum spawn radius.
# Setting type: Single
SpawnRadiusMin = 0
## Maximum spawn radius.
# Setting type: Single
SpawnRadiusMax = 0
## Required global key to spawn. Eg. defeated_bonemass
# Setting type: String
RequiredGlobalKey =
## Array of global keys which disable the spawning of this entity if any are detected.
# Setting type: String
RequiredNotGlobalKey =
## Array (separate by comma) of environments required to spawn in. Eg. Misty, Thunderstorm. Leave empty to allow all.
# Setting type: String
RequiredEnvironments =
## Minimum count to spawn at per check.
# Setting type: Int32
GroupSizeMin = 1
## Maximum count to spawn at per check.
# Setting type: Int32
GroupSizeMax = 3
## Size of circle to spawn group inside.
# Setting type: Single
GroupRadius = 5
## Offset to ground to spawn at.
# Setting type: Single
GroundOffset = 0.5
## Toggles spawning at day.
# Setting type: Boolean
SpawnDuringDay = true
## Toggles spawning at night.
# Setting type: Boolean
SpawnDuringNight = true
## Minimum altitude (distance to water surface) to spawn in.
# Setting type: Single
ConditionAltitudeMin = 0
## Maximum altitude (distance to water surface) to spawn in.
# Setting type: Single
ConditionAltitudeMax = 1000
## Minium tilt of terrain to spawn in.
# Setting type: Single
ConditionTiltMin = 0
## Maximum tilt of terrain to spawn in.
# Setting type: Single
ConditionTiltMax = 35
## Toggles spawning in forest.
# Setting type: Boolean
SpawnInForest = true
## Toggles spawning outside of forest.
# Setting type: Boolean
SpawnOutsideForest = false
## Minimum ocean depth to spawn in. Ignored if min == max.
# Setting type: Single
OceanDepthMin = 0
## Maximum ocean depth to spawn in. Ignored if min == max.
# Setting type: Single
OceanDepthMax = 0
## Minimum distance to center for configuration to apply.
# Setting type: Single
ConditionDistanceToCenterMin = 0
## Maximum distance to center for configuration to apply. 0 means limitless.
# Setting type: Single
ConditionDistanceToCenterMax = 0
## Minimum world age in in-game days for this configuration to apply.
# Setting type: Single
ConditionWorldAgeDaysMin = 0
## Maximum world age in in-game days for this configuration to apply. 0 means no max.
# Setting type: Single
ConditionWorldAgeDaysMax = 0
## Distance of player to spawner, for player to be included in player based checks such as ConditionNearbyPlayersCarryValue.
# Setting type: Single
DistanceToTriggerPlayerConditions = 100
## Checks if nearby players have a combined value in inventory above this condition.
## Eg. If set to 100, entry will only activate if nearby players have more than 100 worth of values combined.
# Setting type: Int32
ConditionNearbyPlayersCarryValue = 0
## Checks if nearby players have any of the listed item prefab names in inventory.
## Eg. IronScrap, DragonEgg
# Setting type: String
ConditionNearbyPlayerCarriesItem =
[Location.PrefabName]
## PrefabName of entity to spawn.
# Setting type: String
PrefabName = Troll
## Enable/disable this configuration.
# Setting type: Boolean
Enabled = true
## Enable spawning during day.
# Setting type: Boolean
SpawnAtDay = true
## Enable spawning during night.
# Setting type: Boolean
SpawnAtNight = true
## Minimum level of spawn.
# Setting type: Int32
LevelMin = 1
## Maximum level of spawn.
# Setting type: Int32
LevelMax = 1
## Chance to level up, starting at minimum level and rolling again for each level gained. Range is 0 to 100.
# Setting type: Single
LevelUpChance = 10
## Minutes between checks for respawn. Only one mob can be spawned at time per spawner.
# Setting type: Single
RespawnTime = 20
## Distance to trigger spawning.
# Setting type: Single
TriggerDistance = 60
## If not 0, adds a minimum noise required for spawning, on top of distance requirement.
# Setting type: Single
TriggerNoise = 0
## Allow spawning inside player base boundaries.
# Setting type: Boolean
SpawnInPlayerBase = true
## Sets position of spawn as patrol point.
# Setting type: Boolean
SetPatrolPoint = true
## Assign a specific faction to spawn. If empty uses default.
# Setting type: String
SetFaction =
These are implemented soft-dependant, meaning if the mod is not present, the configuration will simply do nothing.
Additional options for Creature Level and Loot Control. See the mod page for more in-depth documentation for the options.
Mod-specific configs can be added to each local spawner as [WorldSpawner.Index.CreatureLevelAndLootControl]
## Minimum CLLC world level for spawn to activate. Negative value disables this condition.
ConditionWorldLevelMin = -1
## Maximum CLLC world level for spawn to active. Negative value disables this condition.
ConditionWorldLevelMax = -1
## Assigns the specified infusion to creature spawned. Ignored if empty.
SetInfusion = Fire
## Assigns the specified effect to creature spawned. Ignored if empty.
SetExtraEffect =
## Assigns the specified boss affix to creature spawned. Only works for the default 5 bosses. Ignored if empty.
SetBossAffix =
Example of a world spawner template, for a boar that will spawn with a fire infusion, when the CLLC world level is high enough.
[WorldSpawner.1]
Name = FireBoar
PrefabName = Boar
[WorldSpawner.1.CreatureLevelAndLootControl]
ConditionWorldLevelMin = 3
SetInfusion = Fire
Mod-specific configs can be added to each local spawner as [Location.PrefabName.CreatureLevelAndLootControl]
## Minimum CLLC world level for spawn to activate. Negative value disables this condition.
ConditionWorldLevelMin = -1
## Maximum CLLC world level for spawn to active. Negative value disables this condition.
ConditionWorldLevelMax = -1
## Assigns the specified infusion to creature spawned. Ignored if empty.
SetInfusion = Fire
## Assigns the specified effect to creature spawned. Ignored if empty.
SetExtraEffect =
## Assigns the specified boss affix to creature spawned. Only works for the default 5 bosses. Ignored if empty.
SetBossAffix =
Example of local spawners around the boar runestone, which will always spawn with a fire infusion.
[Runestone_Boars.Boar]
PrefabName = Boar
Enabled = true
[Runestone_Boars.Boar.CreatureLevelAndLootControl]
ConditionNotInfusion = Fire
Additional keys can be created manually through console commands, or by a mod like Enhanced Progress Tracker.
For those who got this far: An additional "feature" hint. The game does not care what prefab you give it, it does NOT need to be a mob. Do with this knowledge what you will.
Changelog: