Upgrade world

This single player tool includes console commands which can add new content to already explored areas.

For dedicated servers, open the world in single player.

Always back up your world before making any changes!

Things you can do

• Place tar pits on already explored areas.
• Reroll chest loots to have onion seeds on already explored areas.
• Completely regenerate Mistlands (with new or legacy content).
• Remove any object from the game world.
• Generate the whole world without having to physically go anywhere.
• Explore/hide parts of the map (unfortunately only for the current character).

Manual Installation:

1. Install the BepInExPack Valheim.
2. Download the latest zip.
3. Extract it in the <GameDirectory>\BepInEx\plugins\ folder.
4. Optionally also install the Configuration manager.

Quick instructions:

1. Back up your world!
2. Install the mod.
3. Load the world.
4. Open console with F5, write upgrade and use tab to cycle through available options.
5. Write start to execute and wait until tue operation completes.
6. Verify that your bases are ok (should be because of the automatic base detection).
7. If not, restore back up. read more detailed instructions and go back to the first step.
8. Uninstall the mod.
9. Enjoy the new stuff!

This mod also adds current coordinates (and zone index) to the minimaps which should help using the commands and setting up the config.

Note: The default base detection is very conservative. Single workbenches, campfires, etc. will exclude a significant area around them, unless configured otherwise.

Parameters

Effective usage of this tool requires understanding the general parameters that are used to filter out affected zones and entities. Following parameters are available to most commands:

• Biome names to only include those biomes. If not given, all biomes are included. Available options are: "AshLands", "BlackForest", "DeepNorth", "Meadows", "Mistlands", "Mountain", "Ocean", "Plains" and "Swamp".
• Minimum and maximum distance as a range "min-max". Either of the values can be omitted for either "min" or "-max".
• Center position as two parameters "x" and "z" (y coordinate is used the altitude).
• Flag "noedges" to only include zones that have included biomes in all of its corners. Without the flag, it's enough if just one of the corners is in the included biomes.
• Parameter "safezones=value" to set safe zone size of major structures (0 to disable). Default value 2 is defined in the config. List of major structures is also defined in the config.
• Flag "zones" to change distance and position parameters to be zone based. "x" and "z" are zone indices. "min" and "max" determine how many adjacent zones are included.
• Flag "force" to automatically execute the command. Can be permanently turned on from the config.

Examples:

• command mistlands: Affects zones which have Mistlands biome at any of their corners.
• command 5000 0 0: Affects zones which are 5000 meters away from the world center.
• command 3000-5000 0 0: Affects zones which are from 3000 to 5000 meters away from the world center.
• command 3 -3 zones safezones=0: Affects the zone at indices 3,-3 even if it has major structures.
• command zones: Affects the current zone at the player's position.
• command blackforest ocean -1000 noedges: Affects zones that only have Black Forest or Ocean at their corners and that are up to 1000 meters away from the player.

Commands

Overview of available commands (remember that tab key can be used for autocomplete / cycle through options):

upgrade [operation] [...args]

Performs a predefined upgrade operation. Available operations are tarpits, onions and mistlands.

Examples:

• upgrade mountain_caves: Places mountain caves to already explored areas.
• upgrade tarpits: Places tar pits to already explored areas.
• upgrade onions: Rerolls already generated and unlooted mountain chests.
• upgrade new_mistlands: Fully regenerates mistlands biomes.
• upgrade old_mistlands: Fully regenerates mistlands biomes with the legacy content (webs, etc.).

destroy [...args]

Destroys zones which allows the world generator to regenerate them when visited.

Examples:

• destroy mistlands: Destryoing a biome.
• destroy 5000 0 0 : Destroying areas after 5000 meters from the world center.
• destroy 3 -3 zones ignorebase: Destroy a single zone at indices 3,-3 to fix any local issues.

generate [...args]

Generates zones which allows pregenerating the world without having to move there physically.

Examples:

• generate: To generate the entire world (takes hours) and then use count_entities command to check how many of each entity exists.
• generate: To generate the entire world (takes hours) and then use remove_entities for modifications.

place_locations [noclearing] [...location_ids] [...args]

Distributes unplaced locations to already explored areas and then places them to the world. With "noclearing" flag, the area under placed location is not cleared of existing entities.

Normally this command (or the similar genloc command) won't do anything because the locations will be generated the same way. However if a new update adds new locations or the world generating otherwise changes this causes changed to the world.

reroll_chests [chest name] [looted] [...item_ids] [...args]

Rerolls contents of a given treasure chest (use tab key to cycle through available treasure chests). Chest name * rerolls all treasure chests.

Empty (looted) chests are only rerolled with "looted" flag.

Item ids can be used to detect and prevent rerolling chests which players are using to store items.

Example:

• reroll_chests TreasureChest_mountains Amber Coins AmberPearl Ruby Obsidian ArrowFrost OnionSeeds: Rerolls mountain treasure chests which only have naturally occurring items.
• reroll_chests * looted 1500 0 0: Rerolls all chests which are 1500 meters away from the world center.

count_biomes [frequency] [...args]

Counts amounts of biomes. Frequency determines in meters how often the biome is checked. Result it also printed to the player.log file.

Example:

• count_biomes 100 5000 0 0: Counts only biomes after 5000 meters from the world center by checking the biom every 100 meters.

count_entities [all] [...ids] [...args]

Counts amounts of given entities. If no ids given then counts all entities. All entities are listed with the flag "all". Result is also printed to the player.log file.

Wildcards are also supported.

Examples:

• count_entities Spawner_*: Counts all creature spawnpoints.
• count_entities *_wall*_: Counts all walls structures.

list_entities [...ids] [...args]

Lists given entities showing their position and biome. Result is also printed to the player.log file.

Example:

• list_entities VikingShip Karve Raft: Lists coordinates of all ships.

remove_entities [...ids] [...args]

Removes entities.

If you already know the entity id, use "count_entities" to ensure you are only removing what needed. If too many entities are returned, use a shorter distance until you get the right amount. Then use the remove command to remove them.

If you don't know the id, use "count_entities" without specifying the id to find the entity. If too many entities are returned, use a shorter distance until you find it. Then use remove command to remove it.

Examples:

• remove_entities StatueCorgi: Removes all corgi statues.
• remove_entities Spawner_* -200: Removes all creature spawnpoints within 200 meters.

reveal_position [x] [y] [distance=0]

Explores the map at a given position to a given distance.

hide_position [x] [y] [distance=0]

Hides the map at a given position to a given distance.

remove_pins [x] [y] [distance=0]

Removes map from the map at a given position to a given distance.

change_time [seconds]

Changes the world time by real life seconds while also updating entities so that they keep their progression. This ensures that enemy spawning and structures won't break when going back in the time.

Verbose mode prints how many data entries were affected.

change_day [day]

Changes the world time by in-game days while also updating entities so that they keep their progression. This ensures that enemy spawning and structures won't break when going back in the time.

Verbose mode prints how many data entries were affected.

set_time [seconds]

Sets the world time to real life seconds while also updating entities so that they keep their progression. This ensures that enemy spawning and structures won't break when going back in the time.

Verbose mode prints how many data entries were affected.

set_day [day]

Sets the world time to in-game days while also updating entities so that they keep their progression. This ensures that enemy spawning and structures won't break when going back in the time.

Verbose mode prints how many data entries were affected.

set_vegetation [disable] [...ids]

Enables vegetation for the world generator, affecting any forced (with "generate" command) or natural generation. Disables vegetation with the "disable" flag.

Tab key can be used to autocomplete available prefab ids.

Examples:

• set_vegetation disable BlueberryBush: Disables generation of blueberry bushes.
• set_vegetation vertical_web horizontal_web tunnel_web: Enables webs to generate in Mistlands.

reset_vegetation

Revert vegetation generation back to the original.

distribute

Runs the "genloc" command without needing devcommands enabled. This can be used to redistribute locations after destroying zones.

start

Zone based commands don't exeute instantly but instead print the zones being affected. This command can be then used to start executing.

stop

Stops execution of commands and removes any pending commands.

verbose

Toggles the verbose mode which prints more information when enabled. Can also be toggled from the config.

Configuration

The config can be found in the <GameDirectory>\BepInEx\config\ folder after the first start up.

Filtering options in the config:

• Safe zone items: List of items used for the automatic player base detection. By default includes structures that have the player base effect.
• How many adjacent zones are included in the safe zone: Size of the player base protection. Default value 1 means 3x3 zones per player base structure to ensure proper coverage. Value -1 can be used to disable the player base detection.
• Safe distance around the player: Excludes zones that are too close to the players (in meters). All commands allow specifying the minimum distance so using this setting is not really needed.
• Custom points: Coordinates and distances to exclude zones. Format: x1,z1,min1,max1|x2,z2,min2,max2|...

Other settings are:

• Verbose output: Prints more output which gives a better understanding how the mod operators. However this can spoil things of your world.
• Automatic start: Starts commands automatically without having to use the start command. This allows using the commands more easily but can lead to more mistakes.
• Operations per update: How many zones are destroyed per Unity update. Can be useful if destroying large parts of a world, but recommended to keep it as it is.

Examples:

• Setting "300,500,500,0|1000,2000,500,0" to custom points would protect areas at coordinates 300,500 and 1000,2000 within 500 meters.
• Setting "300,500,0,100" to custom points would only operate near coordinates 300,500 witin 100 meters.

How it works

Glossary

• Generated area: The world generator generates up to 500 meters from places any player has visited (usually abour 350 meters). This is much bigger area than what gets revelead on the minimap.
• Location: Special places like rune stones, dungeon entrances or abandoned houses that are placed to the world by the world generator.
• Zone: The world is split to tiles of 64 m x 64 m size. This is the granularity of the world generation. See https://valheim.fandom.com/wiki/Zones for more info.

Destroy

1. Removes all objects from a zone (including player placed structures).
2. If the zone has a location, marks the location as unplaced (to allow redistributing it).
3. Marks the zone as ungenerated. Visiting the zone will regenerate like it were at start of the game.
4. Locations are not automatically redistributed. Use "redistribute" command (otherwise you get the same locations as before).
5. Visiting zones will regenerate them.

Portals in the loaded area won't be automatically disconnected but relogging fixes that.

Generate

1. Calls the generating function for each zone.

Place locations

1. Runs a modified genloc command which allows redistributing unplaced locations to already generated areas.
2. Skip zones that didn't get a new location.
3. For each redistributed location, destroy everything within the location exterior radius and place the location to the world.

Reroll chests

1. Gets all chests from the save file. Filters chests that are empty (looted or loot not rolled yet) or include a wrong item (to not replace manually put items).
2. If the chest is in a loaded area, remove all items and roll loot.
3. Otherwise remove all items and set the chest as "not rolled yet" so that the loot is rolled when the chest is loaded. This is done directly by modifying the save file without actually loading the chest.

Count biomes

1. Checks from the map which biome is at each position.

The map returns the exact biome information. This is slightly different than what the minimap shows as it will show the average biome.

Count/list/remove entities

1. Uses the available id list (same what spawn command uses) to resolve wildcards.
2. Directly counts entities from the save file data without loading them to the world.
3. Biome is the exact biome like with count biomes.

This can result in entities near biome edges showing "wrong" biome because the generation code uses the average biome.

Change time/day

1. Changes the world time like the skiptime command.
2. Changes the time data values of entities to match the new time.
3. When moving the time forward, this prevents the time skip (plants don't grow instantly, smelters don't work faster, etc.).
4. When moving the time backward, this prevents things getting stuck (plants, smelters, enemy spawning, etc. won't progress until back to the original time).

Following data values are updated if their value is not 0:

• For general enemy spawning, all data values of the zone control entity are updated. Each of these data values affect spawning of a one enemy type.
• "spawntime" for offspring growth timer and also for ship build timer (but unlikely to use the command when constructing a ship).
• "SpawnTime" for item drop despawn timer.
• "lastTime" for beehive and fireplace progressing.
• "StartTime" for cooking, smelting and fermenting.
• "timeOfDeath" is not included as this is for coropses and gravestones. The value doesn't seem to be currently used at all.
• "alive_time" for spawn point timers.
• "spawn_time" for loot spawners (not used in the game at the moment).
• "picked_time" for pickable respawn timers.
• "plantTime" for growth timers.
• "pregrant" for breeding timers.
• "TameLastFeeding" for animal hunger timer.

Affected data values can be configured but recommended to keep them as it is.

Changelog

• v1.10:

  • Adds a new upgrade command for mountain caves.

• v1.9:

  • Fixed change_time and change_day being able to put negative timestamp to entities.
  • Fixed change_time, change_day, set_time and set_day being able to set the time negative.
  • Fixed set_time and set_day setting entity timestamps to the given value instead of using the time difference like change_time and change_day to.
  • Added better icon. Thanks Azumatt!

• v1.8:

  • Fixed reroll_chests not working without giving any valid items.
  • Added reroll_chests to support all chests.
  • Added "looted" flag to reroll_chests to also reroll empty chests.

• v1.7:

  • Fixed graceful entity removing being bit too graceful (not working in all situations).

• v1.6:

  • Fixed upgrade tarpits command needing to be used twice.

• v1.5:

  • Fixed non-player placed items also counting as player bases (for example in Fuling villages).
  • Added autocomplete to place_locations command.
  • Added new commands to set specific world time (instead of a relative value).
  • More graceful entity removing.
  • Changed parameter "includebases" to "safezones" which allows setting the player base safe zone size (instead of only enable/disable).
  • Chests added to the default list of major structures (won't affect existing configs).
  • Changed player base safe zone value handling (0 is disable, 1 is current zone, etc.)
  • Renamed player base safe zone size config setting to ensure the new default value is used.
  • Fixed generate command targeting only generated zones instead of ungenerated zones.
  • Fixed generate command forcing player base detection (now disables it).
  • Fixed start command causing the next command to execute instantly if used without any pending operations.

• v1.4:

  • Operation split to instant and delayed operations. Delayed operations print some initial output but require start command to execute.
  • Added setting to force start operations without having to use the start command. Added parameter to force start commands.
  • Removed query command as obsolete.
  • Removed setting to prevent loaded areas being destroyed (after all testing seems to work fine).
  • Removed setting about location placement clearing the area (can be given as a flag parameter).
  • Added general argument system (same set of basic arguments for most commands).
  • Merged all destroy commands to a single command.
  • Merged all generate commands to a single command.
  • Merged entity counting commands to a single command.
  • Added a new command to count biomes.
  • Added new command to change world time (while also updating entities).
  • Added new command to list each entity and their position.
  • Added automatic player base detection.
  • Count, remove and list entities support wildcards.
  • Added setting to enable/disable verbose mode.
  • Added command to toggle the verbose mode.
  • Improved output.

• v1.3:

  • Regeneration commands renamed to destroy to make the effect more clear.
  • Destroy all command now requires biomes as a parameter (replacing the config setting and making harder to accidentally nuke the whole world).
  • New commands for generating areas without having to physically go there.
  • New command for counting amount of entities.
  • New command for counting all entities.
  • New command to remove entities.
  • New command to place any unplaced locations (replacing one of the config settings).
  • New command to reroll any chest.
  • New command to explore a part of the map.
  • New command to hide a part of the map.
  • New command to remove pins from a part of the map.
  • Upgrade command now has a second parameter to determine the operation.
  • New upgrade command for generating onion seeds.
  • New upgrade command for regenerating Mistlands.
  • New setting to disable area clearing when placing locations..
  • Improved area clearing when placing locations.
  • Added setting for verbose mode, default output is now very minimal to not include any spoilers.
  • Improved output for all commands.
  • New setting to filter zones too close to the player (effectively creating a safe zone around the player).
  • Many settings removed as obsolete.

• v1.2:

  • Added coordinates to minimaps.
  • Added option to also regenerate loaded zones,
  • Renamed nuke command.
  • Added new commands for a targeted regeneration.

• v1.1:

  • Commands now work from the chat.
  • Console is now enabled by default.

• v1.0:

  • Initial release

• v1.53

  • Fixes the upgrade operation "ashlands" not resetting the ocean gap.

• v1.52.1

  • Fixes wrong version number.

• v1.52

  • Adds a new command temple_gen to update the Start Temple boss stone positions.
  • Adds Start Temple boss stone position fix to the "ashlands" upgrade operation.

• v1.51

  • Adds a new upgrade operation "ashlands" to reset existing ashlands.

• v1.50

  • Fixes some resets not always working.

• v1.49

  • Fixes object removing not working properly with Dungeon Splitter mod.

• v1.48

  • Fixes location adding affecting the entire location database instead of only selected areas.
  • Fixed for the new game version.

• v1.47

  • Adds a new parameter type to limit objects by their components.
  • Changes the default minimum count of count_objects from 0 to 1.
  • Fixes terrain reset sometimes not working properly.
  • Fixes Root user check not working properly with crossplay.

• v1.46

  • Adds a new parameter limit to limit the amount of affected objects.
  • Fixes chests_reset not working properly on servers if clients were on the area.
  • Fixes objects_swap not working properly on servers if clients were on the area.
  • Improves performance of object related commands.