WAK Levels & Engrams
Players learn the engrams of their level on their own, for free. You decide how wild creature levels are spread. Everything runs on the server and is set in Game.ini.
Made by Quentin for the WAK servers · Free · Works on every server · wakserver.eu · Discord
What it does
Auto engrams
- Engrams of your level, learned for you. At login and reconnection, after each level-up and after a Mindwipe (or any other loss of engrams), the server learns every engram the player's level allows. Each of these is picked up within a few seconds.
- Free, and points are kept. The point cost of each engram the mod learns is given back at once. Players keep earning engram points as usual and can spend them on anything the mod leaves out. Prefer paid learning?
FreeEngrams=False. - Follows your server's engram settings. Engrams your server hides (
EngramHidden=TrueinOverrideNamedEngramEntries, or left out bybOnlyAllowSpecifiedEngrams) are never learned, whatever the mod's settings. Level changes made withOverrideNamedEngramEntriesandOverrideEngramEntriesare used. Prerequisites are respected, and a chain unlocks in order. - Only what players could learn by hand. Engrams the game doesn't let players learn with points (such as boss engrams) are left out, unless you turn on
UnlockAllAtLevel. - No Tek by default. The mod never learns Tek engrams (the game's Tek group, or "tek" in the engram or item class name), not even with
UnlockAllAtLevel. Players still get them the game's usual way. Want the mod to give them too?AllowTekEngrams=True. - Your own exclusions.
ExcludeEngramkeeps any engram away from the mod, by engram class or by item class. Players can still learn it by hand. - Unlock everything at a level. With
UnlockAllAtLevel=100, players from level 100 also get boss engrams and the other engrams that can't be learned by hand, whatever their level or prerequisites. Tekgrams only withAllowTekEngrams=True. Hidden and excluded engrams still stay out. - Plugin-friendly. The mod learns only through the game's own unlock function. If a server plugin refuses an engram for a player, nothing is learned, no point is spent, and the mod tries again at the player's next level-up or login.
- Base-game and modded engrams, read from the game's full engram list.
- Short message to the player, such as "12 new engrams learned" (can be turned off).
- The game's own auto-unlock list (
EngramEntryAutoUnlocks) keeps working as before: the mod never touches it. - Light on the server. The engram list is prepared once when the map starts, and each check is spread over small batches.
Wild creature levels
- Four modes, one setting (
DinoLevelMode):Vanilla: the mod leaves creature levels alone.Equal(default): every base level fromMinBaseLeveltoMaxBaseLevelis equally likely. With 1-30 at difficulty 5, wild creatures go from level 5 to 150, and high levels are as common as low ones.High: each creature's own level tiers are reversed, so the highest tier becomes the most common.Custom: your own tiers (CustomTier=Min,Max,Weight), as many as you want.
- Per creature.
DinoLevels=Rex_Character_BP_C,20,30gives one creature its own range. - Exclusions.
ExcludeDinolets a creature keep the game's own level table. - Creatures with their own range keep it. Wyverns (base 1-38), fixed-level creatures and modded creatures with their own level table keep their range: spread evenly in
Equal, reversed inHigh, unchanged inCustom. - Level bias.
LevelBiaspulls rolled levels toward the top of each tier.0(default) = no pull,-1= keep the map's own value. - Safe values. A creature never gets an empty level table (that would spawn level 0 creatures) or a zero total weight. Minimums are at least 1, maximums never below minimums.
Server only
Everything runs on the server (a dedicated server, or the host of a non-dedicated session). No menu, no item, no client setting, nothing for players to do. It works on any server, WAK or not.
Server settings
Everything goes in your server's Game.ini (ShooterGame/Saved/Config/WindowsServer/Game.ini), section [WAK_LEVELS]. Settings are read when the map starts: edit the file, restart the map, done. The mod never writes to your INI files.
- A missing key uses its default value. A wrong value is ignored, with one line in the server log (
[WAK_LEVELS] Ignored ...), and the default is kept. - Repeatable keys (
ExcludeEngram,CustomTier,DinoLevels,ExcludeDino): one line per entry. - Decimals use a dot (
0.5). Comments go on their own line and start with;.
The full section, every key at its default value:
[WAK_LEVELS]
; ----- Auto engrams -----
; Players learn the engrams of their level by themselves
; (at login and reconnection, after each level-up, after a Mindwipe).
LearnEngrams=True
; True: free. The point cost of each engram the mod learns is given back at once.
; False: points are spent like a manual unlock, and an engram is learned
; only when the player has enough points.
FreeEngrams=True
; 0: off. From this player level on, the mod also learns the engrams that
; can't be learned by hand (such as boss engrams), whatever their level or
; prerequisites. Tekgrams only with AllowTekEngrams set to True.
; Hidden and excluded engrams are never learned.
UnlockAllAtLevel=0
; False: the mod never learns Tek engrams (Tek group, or "tek" in the engram
; or item name), not even with UnlockAllAtLevel. They count as excluded in the
; server log. True: Tek engrams follow the same rules as the others.
; Engrams hidden by the server are never learned, whatever this setting.
AllowTekEngrams=False
; Message "N new engrams learned" to the player after a check that learned something.
NotifyPlayers=True
; Seconds between two checks for logins and level-ups (1 to 60).
CheckIntervalSeconds=5
; Repeatable. An engram the mod never learns (players can still learn it by hand).
; Engram class (EngramEntry_..._C) or item class (PrimalItem..._C), "_C" optional, any case.
;ExcludeEngram=EngramEntry_TekGenerator_C
;ExcludeEngram=PrimalItem_WeaponRocketLauncher_C
; ----- Wild creature levels -----
; Every level below is a BASE level. The game multiplies it by the difficulty value:
; at difficulty 5 (OverrideOfficialDifficulty 5.0), base 30 gives level 150, base 40 gives 200.
; Vanilla: levels untouched
; Equal: every base level from MinBaseLevel to MaxBaseLevel equally likely
; High: each creature's level tiers reversed (high tiers most common)
; Custom: your own tiers (CustomTier lines)
DinoLevelMode=Equal
; Equal mode: base level range for creatures on the game's standard level table.
; Creatures with their own table (wyverns, fixed-level creatures, many modded
; creatures) keep their own range, spread evenly.
MinBaseLevel=1
MaxBaseLevel=30
; Custom mode, repeatable: Min,Max,Weight (base levels). A higher weight makes a tier more common.
; With at least one line, only your lines are used. Default: the game's standard tiers.
;CustomTier=1,5,1.0
;CustomTier=6,12,0.5
;CustomTier=13,20,0.25
;CustomTier=21,30,0.1
; Repeatable, every mode except Vanilla: Class,Min,Max (base levels).
; This exact creature class gets an even spread between the two levels.
;DinoLevels=Rex_Character_BP_C,20,30
; Repeatable: this exact creature class keeps the game's own level table.
;ExcludeDino=Gigant_Character_BP_C
; Pulls rolled levels toward the top of each tier: 0 no pull, 1 always the top.
; -1: keep the value of the map and of its spawn zones. Ignored in Vanilla mode.
LevelBias=0
; ----- Server log -----
; True: one line per engram check. False: only the summary at map start.
LogPasses=False
| Key | Default | What it does |
|---|---|---|
LearnEngrams |
True |
Auto engrams on or off. |
FreeEngrams |
True |
True: the point cost of each engram the mod learns is given back. False: points are spent like a manual unlock, and an engram is learned only when the player has enough points. |
UnlockAllAtLevel |
0 |
0 = off. From this player level, also learns engrams that can't be learned by hand (such as boss engrams), without checking their level or prerequisites. Tekgrams only with AllowTekEngrams=True. Hidden and excluded engrams still stay out. |
AllowTekEngrams |
False |
False: Tek engrams (the game's Tek group, or "tek" in the engram or item class name, any case) are never learned by the mod, even with UnlockAllAtLevel, and count as excluded in the server log summary. True: they follow the same rules as any other engram, so tekgrams come with UnlockAllAtLevel. Hidden engrams stay out either way. |
ExcludeEngram |
none | Repeatable. Engram class (EngramEntry_..._C) or item class (PrimalItem..._C), _C optional, any case. Never learned by the mod; players can still learn it by hand. |
NotifyPlayers |
True |
"N new engrams learned" message after a check that learned something. |
CheckIntervalSeconds |
5 |
Seconds between two checks for logins and level-ups, 1 to 60. |
DinoLevelMode |
Equal |
Vanilla, Equal, High or Custom. |
MinBaseLevel / MaxBaseLevel |
1 / 30 |
Equal mode: base level range. |
CustomTier |
the game's 4 standard tiers | Repeatable, Custom mode: Min,Max,Weight in base levels. |
DinoLevels |
none | Repeatable, every mode except Vanilla: Class,Min,Max. Even spread between two base levels for this exact class. |
ExcludeDino |
none | Repeatable: this exact class keeps the game's own level table. |
LevelBias |
0 |
Pull toward the top of each tier, 0 to 1. -1 = keep the map's and spawn zones' own value. Ignored in Vanilla mode. |
LogPasses |
False |
One server log line per engram check (otherwise only the summary at map start). |
Level modes in detail
All level settings are base levels. The game multiplies them by your difficulty value: with OverrideOfficialDifficulty=5, base level 30 = level 150, and base level 40 = level 200.
| Mode | Creatures on the game's standard table | Creatures with their own table |
|---|---|---|
Vanilla |
unchanged | unchanged |
Equal |
evenly spread from MinBaseLevel to MaxBaseLevel |
evenly spread over their own range |
High |
tiers reversed: high tiers most common | tiers reversed |
Custom |
your CustomTier lines |
unchanged |
ExcludeDino and DinoLevels come first, in every mode except Vanilla. Class names are exact: a variant with its own class (an Alpha, an event creature) needs its own line.
Examples
Higher wild creatures, still up to 150
[WAK_LEVELS]
DinoLevelMode=Equal
MinBaseLevel=10
MaxBaseLevel=30
At difficulty 5, creatures on the standard table spawn from level 50 to 150, every level equally likely. Wyverns keep their own range, spread evenly.
Mostly mid-level, a few low and high ones
[WAK_LEVELS]
DinoLevelMode=Custom
CustomTier=1,10,0.5
CustomTier=11,25,1
CustomTier=26,30,0.5
At difficulty 5: about half of the creatures from level 55 to 125, a quarter from 5 to 50, a quarter from 130 to 150.
Beginner-friendly PvE
[WAK_LEVELS]
LearnEngrams=True
FreeEngrams=True
NotifyPlayers=True
DinoLevelMode=Equal
MinBaseLevel=1
MaxBaseLevel=30
ExcludeDino=Gigant_Character_BP_C
Every engram of their level, free, with a message. Plenty of good creatures to tame, while the Giganotosaurus keeps the game's own level table.
Tekgrams at level 120, except the Tek Generator
[WAK_LEVELS]
UnlockAllAtLevel=120
AllowTekEngrams=True
ExcludeEngram=EngramEntry_TekGenerator_C
AllowTekEngrams=True is needed: without it, UnlockAllAtLevel gives boss engrams but never a tekgram.
Only one half of the mod
Auto engrams only:
[WAK_LEVELS]
DinoLevelMode=Vanilla
Wild creature levels only:
[WAK_LEVELS]
LearnEngrams=False
Good to know
- New spawns only. Creatures already in the world keep their level. After installing the mod or changing a level setting, restart the map, then wipe the wild creatures (admin command
DestroyWildDinos) so they respawn with the new levels. - Sea creatures are spawned by the game's separate ocean system, which the mod can't reach: they keep the game's level tables.
LevelBiasalso sets a map-wide value, so it still applies to them. ExcludeDinokeeps the creature's level table, but the map-wide part ofLevelBiasstill applies. WithLevelBias=-1, excluded creatures and sea creatures keep exactly the game's levels.- Fixed-level creatures keep their level: bosses, and creatures spawned at an exact level by the game or by a server plugin.
- Admin summons (
summon) follow the mod's settings, like natural spawns. - Only the level of wild spawns changes. Tamed creatures and bred babies are never touched, and your difficulty settings are never changed.
UnlockAllAtLevelgives every engram of the game's list that is not hidden, excluded or Tek: boss engrams of every map and every loaded mod, and tekgrams too only withAllowTekEngrams=True. Hide or exclude what you want to keep out.- Hidden engrams are never learned. An engram your server hides (
EngramHidden=True, or left out bybOnlyAllowSpecifiedEngrams) is never learned by the mod, whatever its settings,UnlockAllAtLevelandAllowTekEngramsincluded. - The Tek filter also goes by name. Any engram whose engram or item class name contains "tek" counts as Tek, modded ones included. It is left out like the others while
AllowTekEngrams=False. To let Tek in but keep a few engrams out, setAllowTekEngrams=Trueand list those inExcludeEngram. - Restart the map after editing the settings: they are read once, at map start.
FAQ
Do players need to install or set anything? No. They get the mod with your server's mod list like any other mod, and everything happens on the server.
Are engram points lost?
No, with the default FreeEngrams=True: the mod gives back the cost of every engram it learns. Players keep their points for anything the mod leaves out.
Can players still learn engrams by hand?
Yes, as usual, including the ones in ExcludeEngram.
Will players get tekgrams from the mod?
Never, unless you set AllowTekEngrams=True, and that holds even with UnlockAllAtLevel. With AllowTekEngrams=True, tekgrams come with UnlockAllAtLevel (players can't learn them with points). Either way, players still get them the game's usual way.
Will the mod learn engrams I hid on my server?
No, never: engrams hidden with EngramHidden=True or left out by bOnlyAllowSpecifiedEngrams stay out, whatever the mod's settings.
I already use EngramEntryAutoUnlocks in Game.ini.
Keep it. The game keeps giving those engrams at their level; the mod skips what is already learned and learns the rest.
A plugin blocks some engrams for some players. The mod respects it: a refused engram is not learned and costs nothing. The mod tries again at the next level-up or login, so the engram comes as soon as the plugin allows it.
Can I run it with another mod that learns engrams or changes wild levels?
Not for the same job: for wild levels, the last one to write wins, and for engrams both would act. Turn off the part you don't need here instead: LearnEngrams=False or DinoLevelMode=Vanilla.
Wild creatures are still low after installing.
They spawned before the mod. Restart the map, then use DestroyWildDinos.
My creatures never go above 150.
Levels are base levels × difficulty. At difficulty 5, MaxBaseLevel=30 gives 150. Set a maximum above 30 (MaxBaseLevel, a CustomTier or a DinoLevels line) to go higher.
What happens if I remove the mod? Engrams already learned stay learned: they are normal engrams. Wild creatures keep their levels until they despawn or you wipe them.
Developed by Quentin for the WAK servers
A French ARK: Survival Ascended community. wakserver.eu · Discord