We recommend using the Thunderstore Mod Manager or an alternative for installing mods
|Date uploaded||2 weeks ago|
This mod requires the following mods to function
World Advancement and Progression
Created by [email protected].
This mod is in Beta: Use at your own risk! (make a backup of your data before you update). You will likely need to generate a fresh config file.
World Advancement and Progression lets you fine tune world settings. Ideal to use on multiplayer/RP (roleplay) servers to control world advancement.
NOTE: This mod is under heavy development and is not finished. All pre-releases are intended for those interested in helping test new features until the first official release.
The main feature of this mod is to have an easy way to fully customize the world difficulty and to control the rate at which the world and individual player advances. Set the difficulty of each biome and configure all creatures and items by using the automatic scaling system. You may also define your own custom configuration for individual creatures and items (including other modded content). This mod can dynamically create a game balance that is very different from the Vanilla gameplay experience!
WARNING: If you are using an in-game configuration manager you may be missing out of vital information about the settings! When in doubt please read the config descriptions included in the config file. The information included in the file will not always match the information provided in this readme.
Below are some explanations of features and how to configure them. See more details in the config file. Generate the config file by launching the game once with this mod installed.
Public & Private Key Management
What is a key and what is controlled by them? In vanilla Valheim there exists a "global key" list that is a bunch of strings shared by all players. Worldly spawns, raids, dreams, and Haldor's items are all controlled by the presence of specific keys. By default this mod will prevent/block public keys from being added to the global list which will prevent game behaviors that rely on the presence of these keys. This lets you control the game progression by choosing when these keys can be added to the game.
This mod also adds a private player key system in which data is saved to the character file. You can use this private key system to tailor game functionality to individuals rather than the vanilla default server-wide public keys. Gameplay will be altered when using private keys: The player that is hosting a loaded chunk will control the worldly spawns, and raids will only spawn on players when appropriate. For example, a player A with no keys that is in a base with a player B with all the boss keys can still get all those raids, but if player A is alone they should not get higher level raids. If player A loads and hosts an area and is later joined by player B, the area should not spawn the higher level monsters that become unlocked with keys. Private keys will be added to any player within a 100 meter range of the hosting player when the action occurs. For example, when a boss dies any player close enough to the chunk-hosting player should also get the private key, but a player online on the other side of the map will not get it.
When this mod is installed there will be a key "cleanup" performed for the server and any player who joins the game based off the mod configurations. When using the default settings you can expect all global keys to be cleared when you start up the server, resetting your server's key progress. When using private keys a similar principal applies, depending on your blocked or allowed key list, any keys that are not expected will be removed. If you see your keys resetting unexpectedly make sure to check your mod configuration is allowing the keys you want to exist. Any keys added manually will persist until the server is restarted (for private keys when the player logs back in), to ensure these keys remain after a restart you must check your mod configuration!
- BlockAllGlobalKeys: Prevent/block public all keys from being added to the global list, set to false to use vanilla behavior
- AllowedGlobalKeys: Allow only these keys being added to the global list when BlockAllGlobalKeys is true
- BlockedGlobalKeys: Stop only these keys being added to the global list when BlockAllGlobalKeys is false
- UsePrivateKeys: Use private player keys, rather than global keys for game key checking
- BlockedPrivateKeys: Stop only these keys being added to the player's key list when UsePrivateKeys is true (use this or AllowedPrivateKeys)
- AllowedPrivateKeys: Allow only these keys being added to the player's key list when UsePrivateKeys is true (use this or BlockedPrivateKeys, if the BlockedPrivateKeys has any values it will use that setting)
- UnlockAllHaldorItems: If true bypasses the key check for haldor's items and unlocks everything
- UseBossKeysForSkillLevel and BossKeysSkillPerKey explained under Skill Manager section below.
Vanilla Public Keys
Due to the changes this mod makes the vanilla "setkey" command will not function as expected in most cases. There is an added command "setglobalkey" that will work in it's place. For private keys there are 4 new commands added that work similar to the vanilla public key commands: setprivatekey, removeprivatekey, resetprivatekeys, listprivatekeys. For example, you can set your local player's key with "setprivatekey defeated_eikthyr", or any online player with "setprivatekey defeated_eikthyr PlayerName".
Possible Future Additions
- Ability to lock items or crafting to boss completion
- Locking boss summoning to enforce progression order
- More configuration options to toggle public or private key usage for different game features
- Requests welcome! See the bottom for my discord link
Have more control over Skill loss and gain. When using skill capping any skills that are already above the maximum skill cap will remain "frozen" and will not gain, but can still be lowered on death. Console cheats will still work as intended. Other mods that change how skill gain and loss functions may cause unexpected behaviors. Turn off this feature if using another mod for skill management if you see mod conflicts.
- EnableSkillManager must be set to True to enable these features.
- AllowSkillDrain: Set to False to turn off all skill loss on death.
- UseAbsoluteSkillDrain: Set to True to use an absolute number (AbsoluteSkillDrain) for skill loss. (Vanilla uses a percentage for skill loss, so you will lose more skill the higher the skill is)
- CompareAndSelectDrain: Set to true to use the minimum or maximum value between the vanilla skill loss and the absolute skill loss. Set CompareUseMinimumDrain to False to use the maximum of these two values as the skill loss.
- OverrideMaximumSkillLevel: True to set a server wide skill level ceiling for gaining skill to the value of MaximumSkillLevel. For example, if this value is 50 then you will not gain skill once you reach level 50+ in that skill.
- OverrideMinimumSkillLevel: True to set a server wide skill level floor for skill loss to the value of MinimumSkillLevel. For example, if this value is 10 then you will not lose skill on death until you reach level 10 in that skill, so your skills will not drop below 10.
Under the Keys category there are more configuration options for skills. This feature will only work if you DO NOT override the minimum and/or maximum skill levels as described above. Overridden values will take precedence.
- UseBossKeysForSkillLevel: Set this to true to use a more dynamic skill control dependant on boss completion. Skill minimum will start at 0 and increase by BossKeysSkillPerKey for each boss defeated. Skill maximum will be capped at [ 100 - (number of bosses: 6) * (BossKeysSkillPerKey: 10) = 40 ] with the current game state. For example, if you defeat one boss then your skill minimum for loss will be raised to 10, and your skill maximum will be raised to 50.
- BossKeysSkillPerKey: Amount used in calculation above.
The world is scaled according to the "natural" vanilla game progression by default. To see this mod's default classification of vanilla creatures and items you can view the code on Github. The scaling is applied after logging into a local world or server.
- EnableAutoScaling must be set to True to enable these features.
- AutoScaleType: Vanilla, Linear, or Exponential. If set to Vanilla these auto-scaling features will not be enabled!
- AutoScaleFactor: Change the biome scaling factor.
Linear scaling by default is a 75% growth (0.75). This means your 1st biome (Black Forest, Meadows is 0th) will have a scaling factor of 1.75, and 7th will be 6.25 for calculations. This setting will make a pretty even difficulty progression.
To use Exponential scaling PLEASE READ THIS PART: Given that there are by default only 8 biome difficulties to scale, the maximum scaling value you can input is roughly 21 without blatantly breaking the code generating the values (If using 12 custom biome difficulties this number is about 6). However, 21 is a much, much bigger number than you could ever want. Recommended values for exponential scaling are in a range of 0.25 - 1. For example, an exponential scaling of 0.75 will set the 1st biome to 1.75x harder, 7th biome to be about 50x harder than the base biome. This setting will make the first few biomes closer together in difficulty than the later biomes.
The total damage a creature can do will be scaled and then distributed to individual damage types for each attack; scaling will maintain the ratio for creatures with more than one attack (some attacks are stronger, some are weaker, scaling maintains this). All values for chop and pickaxe damage are ignored and will retain their original values without affecting scaling. To override this mod's default configurations there is a file called "WAP.CreatureOverrides.yaml" in which you can add customizations. Currently, all players must have the same file locally since this feature does not sync yet. Directions on how to use the override feature are included in that file.
The list for health and damage configs is in the format (for difficulty spread): Harmless, Novice, Average, Intermediate, Expert, Boss
- AutoScaleCreatures: Set to true to scale creature health and damage.
- AutoScaleCreaturesHealth: Leave blank to use default values: 5, 10, 30, 50, 200, 500; to override enter a comma-separated list of 6 integers.
- AutoScaleCreaturesDamage: Leave blank to use default values: 0, 5, 10, 12, 15, 20; to override enter a comma-separated list of 6 integers.
- AutoScaleCreaturesIgnoreDefaults: Set to true to exclude all defaults (can still use yaml override).
Vanilla items are grouped by custom types and are assigned the biome in which they naturally can be crafted. To override this mod's default configurations there is a file called "WAP.ItemOverrides.yaml" in which you can add customizations. Currently, all players must have the same file locally since this feature does not sync yet. Directions on how to use the override feature are included in that file.
- AutoScaleItems: Set to true to scale player items.
- AutoScaleItemsIgnoreDefaults: Set to true to exclude all defaults (can still use yaml override).
Custom Data Definitions
|Meadow = 0||Vanilla = 0||None = 0|
|BlackForest = 1||Harmless = 1||Shield = 1|
|Swamp = 2||Novice = 2||Helmet = 2|
|Mountain = 3||Average = 3||Chest = 3|
|Plain = 4||Intermediate = 4||Legs = 4|
|AshLand = 5||Expert = 5||Shoulder = 5|
|DeepNorth = 6||Boss = 6||Utility = 6|
|Ocean = 7||Tool = 7|
|Mistland = 8||PickAxe = 8|
|Axe = 9|
|Bow = 10|
|Ammo = 11|
|Sword = 20|
|Knife = 21|
|Mace = 22|
|Sledge = 23|
|Atgeir = 25|
|Battleaxe = 26|
|Primative = 27|
|Spear = 28|
|TowerShield = 29|
|BucklerShield = 30|
|PrimativeArmor = 31|
|Bolt = 32|
|Crossbow = 33|
|HelmetRobe = 34|
|ChestRobe = 35|
|LegsRobe = 36|
- ServerSync included
Developers (Always In Progress)
Want to define customizations of your own mod with these features so your users don't have to? If there is something you need let me know and I can add support for your mod!
Planned features include: Define your own biomes and add them to the scaling system by using any int value as a key that is not used. This mod's default values can be overridden to set custom scaling after initialization.
Examples (Will update this for first official release):
- To add a Biome '10' that is one biome harder than Plains (4th hardest by default, Meadows is 0th) use: AddBiome(10, 5)
- To add a Biome '10' that is 250% harder than the baseline use: AddCustomBiome(10, 2.5)
- To override Meadow's difficulty after it has been initialized: AddBiome(0, 8, true) or AddCustomBiome(0, 1.3, true)
- Fixed an issue with private key cleanup that would crash the game on player spawn.
- Depreciated use of the additional file for saving private player keys, saves to the main player file now. If using the previous version you can expect your keys to update to the new system and the file will be automatically deleted. Support for the upgrade will be removed in the future.
- Added ability to use private keys (rather than global keys) for game behaviors (i.e worldy spawns and raid checks)
- Added new config UsePrivateKeys under General, removed UsePrivateBossKeysForSkillLevel (now included under the new setting)
- Added new configs BlockedPrivateKeys and AllowedPrivateKeys, similar to the public key settings but for the private ones
- Added ability to manage other player's private keys with commands (if the player is online)
- Added ability to unlock all of haldor's items with new config UnlockAllHaldorItems
- Increased Key Manager cache timer to 10 seconds
- Small optimizations to Skill Manager, increased cache timer to 10 seconds
- Fix for some creature attacks not being scaled (whoops): will now track all random weapons and items from random sets (The scaling is not perfect, expect an overhaul for the scaling feature in the next major update)
- Decreased base Bow damage from 22 to 18
- Thank you all for your patience!!!
- Added (most) Mistlands additions to keys and scaling
- Added new scaling categories for "robes": reclassified troll, root, and fenris armors to the new types
- Added ability to override creature and item data using the specified yaml files
- New configuration options to ignore auto-scaling defaults, allows you to change only what you specify in the yaml files
- Renamed AutoScale config to EnableAutoScaling, you have to edit this value to use auto scaling
- Upgraded ServerSync to version 1.13 for game patch 0.212.7
- Bug fix for auto-scaling where a live configuration update would override stored vanilla data
- Removed chop and pickaxe damage from auto-scaling (I didn't like how it changed the game)
- Bug fix for auto-scaling item/creature damages calculating the values incorrectly.
- Bug fix from last update for creature attacks not configuring
- Added auto-scaling for item upgrades
- Upgraded ServerSync to V1.11: Crossplay compatibility upgrade for config sync.
- ServerSync patch for game patch 0.211.11.
- Major rework for testing purposes, added more unit tests, general code cleanup.
- Fixed a few bugs with autoscaling values calculated incorrectly.
- Added ability to restore vanilla game data without a game restart for autoscaling (in testing).
- Optimization for Key and Skills managers caching.
- Fixed biome ordering for Mistland, Ashland, DeepNorth.
- Fixed a server sync issue for auto scaling features.
- Added options to track boss completion for skill management.
- Moved the Key configurations to a new section.
- Update for game patch 0.211.7 Crossplay. Reverted ServerSync to 1.6.
See all patch notes on Github.
All issues can be reported on the project Github. To report issues please be as specific as possible and provide the following:
- Version of this mod you are using.
- List of the other mods being used.
All feedback, ideas, and requests are welcome! You can message me at my discord Venture Gaming.