Star Level Systems expands upon the Valheim star system and allows extensive customization.
Features:
Got a bug to report or just want to chat about the mod? Drop by the discord or github.
Below are a few examples of what you might see, and what the mod can do.
So you want creatures to have more levels, but you don't want to die instantly to a level 100 boar when you start the game? Well have I got the config file for you.
Level settings allows configuration of creature levelup chance, creature stats, max level, increased level up chance based on distance from the center- and respectively biome based configs for all of that.
Want some help calculating and building a level definition? Check out this tool
Lets take a look at some of the things you can do with this, and what better spot to start out than the default All biome
configuration (which applies to every creature by default).
Here is a section of the default example config, lets walk through what everything does.
All:
distanceScaleModifier: 1.5 # The influence of distance ring based scale increases (1.5 means 150% of the bonus value will be applied)
spawnRateModifier: 1.5 # Spawn rate of every creature is 50% higher (1.5), which means every spawn has a 50% chance of being 2 creatures.
creatureBaseValueModifiers: # These values modify the base stats of every creature in this biome (eg, all creatures)
BaseHealth: 1 # The default health of all creatures is 100% (1), numbers below 1 reduce health, above increase is (2) is 200% health for everything
BaseDamage: 1 # Default damage of all creatures is 100% (1)
Speed: 1 # Default movement speed of all creatures is 100% (1)
Size: 1 # Default size of all creatures is 100% (1)
creaturePerLevelValueModifiers: # Per level modifiers are applied per level, eg each star will give this value to the creature
HealthPerLevel: 0.4 # Each star provides 40% more health (0.4)
DamagePerLevel: 0.1 # Each star provides 10% more damage (0.1)
SpeedPerLevel: 0 # Each star does not increase speed (0)
SizePerLevel: 0.1 # Each star makes the creature 10% bigger (0.1)
damageRecievedModifiers: # Damage reduction or increases
Poison: 1.5 # Everything recieves 50% (1.5) more damage from poison (that includes players)
Note: creaturePerLevelValueModifiers do not apply to characters. But, damageRecievedModifiers DOES.
Biome specific configurations can be used to override the default All configuration, in this case max level for Ashlands is being set
to 26 and the distance modifier is being reduced by 50%
AshLands:
biomeMaxLevelOverride: 26
distanceScaleModifier: 0.5
Creature specific configuration allows you to override what is set in the biome definition for a creature, which allows more fine-grained control of how a specific creature should be modified.
Lets take a look at this creature definition
Troll: # Creature prefab name, must match exactly, you can find this using VNEI, the wiki, or Jotunn prefab documentation
customCreatureLevelUpChance: # Sets the levelup chance for this specific creature, overrides the default values, can still be modified by distance bonuses
1: 100 # Gauranteed level 1
2: 50 # 50% chance to reach level 2
3: 5 # 5% chance to reach level 3
creatureMaxLevelOverride: 11 # Overrides the max level for this creature (11 instead of biome default)
creatureBaseValueModifiers: # Overrides the base stat modifiers for this creature, values below 1 reduce stats, above 1 increase stats
BaseHealth: 1.05 # Base health is increased by 5%
BaseDamage: 0.95 # Base damage is reduced by 5%
Speed: 1.05 # Speed is increased by 5%
Size: 1.05 # Size is increased by 5%
AttackSpeed: 1.05 # Attack speed is increased by 5%
creaturePerLevelValueModifiers: # Per level stat modifiers for this creature, these are multiplied by the creatures level and applied to the total stat value
HealthPerLevel: 0.3 # Each star provides 30% more health
DamagePerLevel: 0.05 # Each star provides 5% more damage
SizePerLevel: 0.005 # Each star provides 0.5% more size
requiredModifiers: # Modifiers that this creature will always spawn with, regardless of level, chance or modifier limit, but still count towards max modifier count
Poison: Major # Trolls will always spawn with the Poison major modifier, Modifier names can be found in Modifiers.yaml, along with their categories
This is a definition of the chance that a creature has to level up at each point.
This works hand in hand with the distance scale modifier and distanceLevelBonus, distance level bonuses are applied if
the creature falls into a distance category with bonuses.
eg:
distanceLevelBonus:
1250:
1: 25
Will give all creatures a +25% chance to reach the first star level, if they are at least 1250m from the center. This value is then modified based on biome settings.
In our example biome file we have a 1.5 value for the distance modifier so 1.5 x 25 = 37.5 would be the increase provided to reach level 1.
If the total bonus and base value exceeds 100 that level will be gaurenteed, every creature with that condition will be at a minimum that level.
You can see this in some of the later distance bonuses which slowly drive of the guaranteed spawn level of creatures up
5000:
1: 100
2: 100 # All creatures at least 5000m from center will be level 2+
3: 75
4: 50
5: 25
6: 15
You can also use the distanceLevelBonus to add additional levels, make it so that certain distances are required to spawn higher level enemies.
defaultCreatureLevelUpChance:
1: 20
2: 15
distanceLevelBonus:
1250:
1: 25
2: 15
3: 5
5000:
1: 100
2: 100
3: 75
4: 50
With the above configuation the region closest to start up to 1250m will only be able to spawn level 1 and 2 creatures. Between 1250m and 5000m creatures can spawn up to level 3, and beyond 5000m creatures can spawn up to level 4.
Now, we've walked through a lot of the bonuses to level up chance but lets take a look at the base values too. Star level systems default config has a relatively large spawn range- which is limited by biome configuration.
defaultCreatureLevelUpChance Defines the levelup chance of all creatures, this however can be limited by biome configuration and
it can be increased by other factors, such as the distance from center bonus.
defaultCreatureLevelUpChance:
1: 20
2: 15
3: 12
4: 10
5: 8
6: 6.5
7: 5
8: 3.5
9: 1.5
10: 1
11: 0.5
12: 0.25
In vanilla there are few creatures which can be colorized when they level up. Star Level Systems changes that. Most all creatures can be colorized, it should be noted that some creatures (Yagluth eg) do not colorize well and the effect is generally not very noticable.
There are two different ways to apply colorization values to creatures.
Greydwarf:
1:
hue: -0.06
saturation: 0.1
value: 0.05
DefaultGenerator:
- characterSpecific: false
startColorDef:
hue: 0.07130837
saturation: 0.05205864
value: 0.01721987
endColorDef:
hue: -0.07488244
saturation: 0.09342755
value: -0.1008582
rangeStart: 1
rangeEnd: 15
Star level systems provides full optional configuration to control in detail all loot drops. Loot configuration can be found in the LootSettings.yaml file.
You may find it useful to see what existing drops look like within the SLS system.
You can do this by dumping a debug configuration of all loot drops (as they are) with the in-game console command sls-dump-loottables, this is output to the SLS config folder in the file LootTablesDump.yaml.
There are three core parts to configuring loot drops, but many options to modify if you wish to fine tune loot configurations.
Lets take a look at the character specific loot drop. Here is one of the example configurations, and it is here to address a specific challenge.
Oozers create blobs when they die, this scales with the level of the creature. However, when you have a very high level oozer you can end up with 20,30 or more blobs.
Which can be impossible to deal with. This deals with that in a few ways, the final - drop: entry is for the Blob, spawning a minimum of 2 and a maximum of 2. But scaling with
the level of the BlobElite (Oozer), however that scaling is capped at a maximum of 6 drops, and only scales .5 per level. So every other level another blob can be spawned
up to a maximum of 6.
Another useful entry to look at here is the drop for TrophyBlob, this has a 0.1 (10%) chance of happening, but it scales x0.01 per level, so a level five is (0.01 x 5) = 0.05 (5%) higher chance of happening.
This can be combined with a drop count to scale the drops for the entry, so a level 5 could drop more trophies. But this is disabled by setting the maxScaledAmount: 1
characterSpecificLoot:
BlobElite:
- drop:
prefab: Ooze
min: 2
max: 3
levelMultiplier: true
amountScaleFactor: 0.5
- drop:
prefab: IronScrap
chance: 0.33
levelMultiplier: true
amountScaleFactor: 0.2
- drop:
prefab: TrophyBlob
chance: 0.1
levelMultiplier: true
chanceScaleFactor: 0.01
maxScaledAmount: 1
- drop:
prefab: Blob
min: 2
max: 2
levelMultiplier: true
amountScaleFactor: 0.5
maxScaledAmount: 6
This is the section which allows you to configure all of the non-creature related loot in detail. It follows a similar structure to character loot configuration.
You can use this to modify or add loot to any existing objects which have the option to drop loot. For example, falling stalagtites. This configuration gives them a chance to drop crystals.
The chance scales per level (yes inanimate objects can be leveled, tree, rock or destructible based on type). If loot configuration is not defined here then the generic configuration values from
the main config file apply here PerLevelDestructibleLootScale, PerLevelMineRockLootScale, and PerLevelTreeLootScale along with their max level values.
Level scaling can be ignored by setting dontScale: true
nonCharacterSpecificLoot:
caverock_ice_stalagtite_falling:
- drop:
prefab: crystal
chance: 0.3
min: 1
max: 3
dontScale: true
EvilHeart_Forest:
- drop:
prefab: AncientSeed
onePerPlayer: true
levelMultiplier: true
maxScaledAmount: 3
This is similar to the character distance modifier in that it applies a bonus to the minimum and maximum drops that an entry can have based on distance. Loot rings are not drawn on the map, but behave exactly the same as Character distance rings (if the object is greater than x distance and less than the next once it recieves that bonus).
distanceLootModifier:
1250:
minAmountScaleFactorBonus: 1.02
maxAmountScaleFactorBonus: 1.02
SLS supports significantly overhauled and configurable raids. These can be disabled if you wish to revert to vanilla style raids.
By default all raids are per-player, server controlled and concurrent raids are enabled. This means with SLS it is possible that every player on a server gets an appropriate raid during an event.
The number of players, frequency, and most all details of each raid is configurable through RaidSettings.yaml.
Below is an example of many of the details that can be configured for a given raid
- Name: foresttrolls # Each raid has its own name, these should be unique or can be incorrectly selected
Duration: 180 # Duration of the raid, in seconds
RaidCoolDownMinutes: 120 # The number of minutes between when this raid triggers and the player becomes eligble for a new raid
ForceEnvironment: Crypt # Environment that will be set when the raid starts available options: Clear, Misty, Darklands_dark, DeepForest_Mist, Heath_clear, InfectedMine, GDKing, Rain, LightRain, ThunderStorm, Eikthyr, Fader,
# GoblinKing, nofogts, SwampRain, Bonemass, Snow, SnowStorm, Twilight_Clear, Twilight_Snow, Twilight_SnowStorm, Moder, Crypt, CryptHildir, Ghosts, Queen, SunkenCrypt, Mistlands_clear, Mistlands_rain,
Activation: # Mistlands_thunder, Ashlands_ashrain, Ashlands_ashrain_clear, Ashlands_CinderRain, Ashlands_meteorshower, Ashlands_misty, Ashlands_SeaStorm, Ashlands_storm, Caves, CavesHildir
Chance: 50 # Chance that this raid is selected when it is a valid option, only one raid can be selected for a given player at a time
RequiredGlobalKeys: # The global keys required for this raid to activate
- defeated_eikthyr
NotRequiredGlobalKeys: # The global keys that must be missing for this raid to activate
- defeated_bonemass
RequiredPlayerKeys: # Player keys that must be set to activate
- Deathlink
AnyRequiredPlayerKeys: # Player must have at least ONE of the listed player keys for the raid to be selected for them
- Deathlink Deathbringer
- Deathlink Hardcore
NotRequiredPlayerKeys: # Player must not have any of the following player keys for the raid to be selected for them
- Deathlink Vanilla
Spawns:
- PrefabName: Troll # Prefab name of a creature to spawn in the raid
CreatureAI: AgitatedByBuild # Type of creature AI setting to apply, valid values are: Alert, AgitatedByBuild, HuntPlayer
SpawnInterval: 30 # Number of seconds between when another of this monster can spawn
Faction: Demon # Faction this creature will be assigned to Valid options: Players, AnimalsVeg, ForestMonsters, Undead, Demon, MountainMonsters, SeaMonsters, PlainsMonsters, Boss, MistlandsMonsters, Dverger, PlayerSpawned
MaxSpawned: 3 # Maximum number of this creature that can be alive (from this specific spawn group)
SpawnGroupSize: 2 # Number of creatures to spawn at once
LevelMax: 3 # Max level, if using RaidLevelSystem
UseRaidLevelSystem: true # Wether to use the default leveling system or the custom level defintion defined here
ModifiersNotAllowed: # Modifiers the creature can't get
- Poison
RequiredModifiers: # Modifiers that the creature must spawn with, this also requires the modifier type (Boss, Major, Minor)
Fire: Major
CustomCreatureLevelUpChance: # Custom level chances for this creature
1: 50
2: 25
3: 20
4: 15
5: 7
6: 3
7: 1
StartMessage: $event_foresttrolls_start # Start of the raid message
EndMessage: $event_foresttrolls_end # End of the raid message
ForceMusic: Zblackforest # Music that starts when the raid happens eg: ZCombatEventL1, ZCombatEventL2, ZCombatEventL3, ZCombatEventL4, Zboss_eikthyr, Zboss_gdking, Zboss_bonemass, Zboss_moder, Zboss_goblinking, Zboss_queen, Zboss_queen_ambience, Zboss_fader,
# Zblackforest, Zmeadows, Zswamp, Zmountain, Zplains, Zplainstower, Zmistlands, Zashlands,
Maybe you've tried out CLLC's modifiers, or Monster Modifiers? Both really add variety to the game that is much needed. Star Levels Systems modifiers are designed to be extremely flexible, both in configuration- but also in effect.
There are however a number of modifiers and it can be a bit unclear what each does. So to start off here is a table of all current modifiers and how they work.
Modifiers are split into three categories. Boss, Major, and Minor. Which allows customization into the random selection process for modifiers,
along with separate tuning for modifiers that appear on bosses vs minor creatures.
These modifiers are by default only available on bosses.
| Modifier | Description | Config Adjustment | Icon |
|---|---|---|---|
| BossSummoner | Summons minion creatures at regular intervals up to a certain limit. | BasePower = Max number summoned PerlevelPower = Time between summon BiomeObjects = Biome specific minion (prefab name) |  |
| SoulEater | Creature grows in strength and size when other creatures die near it. Creature heals slightly. | PerlevelPower = how much health & damage to gain |  |
| LifeLink | Creature will redirect a portion of damage it takes to another creature in the area. | BasePower = Base damage redirection PerLevelPower = Additional damage redirection based on level |  |
| ResistPierce | Reduces damage the creatures takes from all pierce sources (like arrows) | BasePower = Base damage reduction PerLevelPower = Additional damage reduction granted per creature level |  |
| Brutal | Increases creature attack speed | BasePower = Increases attack speed by base amount PerLevelPower = Increases attack speed by amount per level |  |
These modifiers are attainable by most creatures, and are typically the more impactful modifiers.
| Modifier | Description | Config Adjustment | Icon |
|---|---|---|---|
| Brutal | Increases creature attack speed | BasePower = Increases attack speed PerLevelIncrease = Increases attack speed per level | |
| Fire | Adds Fire damage | BasePower = Percentage of total damage added PerLevelIncrease = Additional damage added per level |  |
| Frost | Adds Frost Damage | BasePower = Percentage of total damage added PerLevelIncrease = Additional damage added per level |  |
| Poison | Adds Poison Damage | BasePower = Percentage of total damage added PerLevelIncrease = Additional damage added per level |  |
| Lightning | Adds Lightning damage | BasePower = Percentage of total damage added PerLevelIncrease = Additional damage added per level |  |
| Elemental Chaos | Random typed elemental damage on each hit | BasePower = Percentage of total damage added PerLevelIncrease = Additional damage added per level |  |
| Splitter | Creature spawns replacements when it dies | Config values are combined and for each whole value, an additional creature is spawned BasePower = Number of creatures to spawn on replacement PerLevelIncrease = Additional value added to give a chance for more spawns |  |
| ResistPierce | Reduces damage taken from Pierce | BasePower = base damage reduction PerLevelIncrease = per level additional damage reduction | |
| ResistSlash | Reduces damage taken from Slash | BasePower = base damage reduction PerLevelIncrease = per level additional damage reduction |  |
| ResistBlunt | Reduces damage taken from Blunt | BasePower = base damage reduction PerLevelIncrease = per level additional damage reduction |  |
These modifiers are attainable by most creatures and are typically less directly impactful than others, but can be none the less dangerous.
| Modifier | Description | Config Adjustment | Icon |
|---|---|---|---|
| FireNova | Explodes when it dies, damaging everything. | BasePower = Base damage of the explosion, based on creature damage PerLevelPower = Increase to the damage added per level |  |
| PoisonNova | Explodes when it dies, damaging everything. | BasePower = Base damage of the explosion, based on creature damage PerLevelPower = Increase to the damage added per level |  |
| Lootbags | Doubles creature health and gives 25% more movement speed, drops more loot. | BasePower = Increases drops PerLevelPower = Increases drops by amount per level |  |
| Alert | Increases creature hearing range | BasePower = Increase hearing by PerLevelPower = Increase hearing by amount each level | |
| Big | Increases creature size and health | BasePower = Increases health and size PerLevelPower = Increases health and size by amount | |
| Fast | Increases creature speed | BasePower = Increases movement speed PerLevelPower = Increases speed based per level | |
| Evolving | After X kills the creature gains a level | BasePower = Base number of kills required PerLevelIncrease = Additional kills required per level |  |
| StaminaDrain | Attacks by the creature drain your stamina | BasePower = Drain amount PerLevelPower = Drain increase by amount per level |  |
| EitrDrain | Attacks by the creature drain your Eitr | BasePower = Drain amount PerLevelPower = Drain increase by amount per level |  |
| ResistFire | Reduces damage taken from Fire | BasePower = base damage reduction PerLevelIncrease = per level additional damage reduction |  |
| ResistFrost | Reduces damage taken from Frost | BasePower = base damage reduction PerLevelIncrease = per level additional damage reduction |  |
| ResistPoison | Reduces damage taken from Poison | BasePower = base damage reduction PerLevelIncrease = per level additional damage reduction |  |
| ResistSpirit | Reduces damage taken from Spirit | BasePower = base damage reduction PerLevelIncrease = per level additional damage reduction |  |
Localization is available for everything in the mod. I accept community translations! If you would like to contribute localizations or improve them please reach out on discord.
Otherwise localizations are available at Bepinex/config/StarLevelSystems/localizations, new languages can be made using any of Jotunns language specific names
Star Level Systems provides a number of terminal commands for debugging and testing and cleanup.
sls-killall [range:500] - kills creatures within the specfiied range (default 500m), skips players and tamed creatures.sls-give-modifier [modifier_type:major] [modifier_name:fire] - gives nearby creatures the specified modifier (must be very close)sls-dump-loottables - provides dumps all loot table configurations in the game, in SLS format, to Bepinex/config/StarLevelSystems/LootTablesDump.yamlStar Level Systems provides a public API for other mods to interact with. The API currently allows reading, modifying and managing creature stat modifiers, color, and level. Check out the API Documentation here
I also directly contribute to Epic Loot! If you like new features and bugfixes always happy to hear feedback.
Modded Valheim requires Bepinex to load mods. If you have not modded before or are trying to simplify how easy it is for you to mod the game I recommend taking a look at a mod manager. Gale is an excellent mod manager. Download it manually, install and start it up.
If you are proceeding manually you will need to ensure that you have installed Bepinex from the Thunderstore, it has required configuration.
Once you are ready to install mods, they must be unzipped first and go into the Bepinex/plugins folder.
Compatibility is being worked on for the following mods:
This mod is still in active development and is not considered complete yet.
Planned Features