Rule packs
Tune enemy health and damage, loot, experience and day length with simple multipliers, without adding anything new.
A rule pack is the simplest kind of mod. It adds no items; it just multiplies a few of the game’s numbers by the values you write. If you want the game harder, easier, more generous with loot, or with longer days, one rule pack is enough.
You do not even have to write anything: press New rules pack on the Make Mods page (or open the Rules tab in the mod editor), move the sliders, and the game writes the file for you.
In the editor#
Open the Rules tab, which sits in the Rules group in the left column. There is nothing to add: the tab is one page of sliders, and it starts a rules file for you the first time you move one.
| Field | What it does |
|---|---|
| Enemy health, Enemy damage, Attack warning, Elite frequency, Loot, Experience, Day length, Party boss health | A row of multiplier sliders. 1 is the base game (shown as Default); right is more, left is less. These are the same sliders as the Rules pack tool on the Make Mods page. |
| Advanced: per-difficulty details | Starts collapsed. Tune how enemies fight separately for Easy, Normal and Challenge: attackers at once, time between attacks, warning time, combo chance, enemy damage, awareness, flanking, player stagger and more. Each has a one-line hint, and untouched values stay as in the base game. |
| Reset all to default | Puts every slider back to the base game. |
If a slider is controlled by a player option in your mod, the page tells you. Moving the slider fixes the value. This tab has no preview. To test, press the top-bar Test.
Advanced: writing the JSON by hand#
Below is the same content as it looks in the file. The editor saves exactly this format. You can also press Open folder at the top of the editor and edit the file in an outside text editor; when you save, the editor picks up the change. Fields the form does not show are kept as they are. Where the file goes and how it is listed: Mod folder and mod.json.
The table is one JSON file; put its path under content.rules in mod.json.
Smallest working example#
Enemies with 1.5 times the health and 1.3 times the damage, a shorter warning before attacks (harder to dodge), half again as many elites, but 20% less loot and 10% more experience. Write only the fields you want to change; the rest stay as they are:
{
"enemyHealth": 1.5,
"enemyDamage": 1.3,
"telegraph": 0.85,
"eliteRate": 1.5,
"loot": 0.8,
"xp": 1.1,
"dayLength": 1,
"partyBossHp": 1.2,
"difficulty": { "challenge": { "comboChance": 1 } }
}Fields#
Every multiplier is a number from 0.25 to 4, where 1 means no change. A value out of range is never quietly clamped; the table is skipped and you are told why.
| Field | Required? | What it means | Allowed values |
|---|---|---|---|
enemyHealth | No | Enemy health | 0.25 to 4 |
enemyDamage | No | Enemy damage | 0.25 to 4 |
telegraph | No | The warning time before an enemy attacks; higher is easier to dodge | 0.25 to 4 |
eliteRate | No | How often elite enemies appear | 0.25 to 4 |
loot | No | Amount of loot | 0.25 to 4 |
xp | No | Experience gained | 0.25 to 4 |
dayLength | No | Length of a day; higher means longer days | 0.25 to 4 |
partyBossHp | No | Extra boss health when playing in a group | 0.25 to 4 |
difficulty | No | Advanced: set the fine settings of one difficulty directly, see below | An object whose keys are easy (Relaxed), normal (Standard), challenge (Challenge), legendary (Legendary) |
Advanced: difficulty settings#
difficulty lets you set the fine settings of Relaxed, Standard, Challenge or Legendary directly. These are set to the number you give, not multiplied. For example { "challenge": { "comboChance": 1 } } makes Challenge enemies always follow up with a second swing.
| Setting | Meaning | Range |
|---|---|---|
attackSlots | How many enemies can attack you in melee at once | 1 to 6, whole number |
pressureSlots | How many enemies can attack at once with ranged shots, charges or dives | 1 to 5, whole number |
cooldown | Multiplier on enemy move cooldowns | 0.4 to 2.5 |
telegraph | Multiplier on the warning time before an attack | 0.5 to 2.5 |
recover | Multiplier on recovery time after an attack | 0.5 to 2 |
breather | Multiplier on the pause after you are hit during which nobody may start an attack | 0.2 to 2 |
comboChance | Chance a first hit is followed by a second swing | 0 to 1 |
awareness | How quickly enemies notice you | 0.5 to 1.5 |
dodge | Multiplier on how long your dodge keeps you safe | 0.5 to 1.5 |
damage | Enemy damage multiplier | 0.25 to 4 |
tracking | How quickly enemies turn to follow you | 0.5 to 1.5 |
flank | Share of melee enemies that come at you from the side | 0 to 1 |
hitbox | How generous enemy attack reach is | 0.5 to 1.5 |
eliteRate | Elite spawn rate multiplier | 0 to 4 |
killHealCap | Most health you can heal per kill, as a share of max health | 0 to 0.2 |
leechCap | Most life-steal per second, as a share of max health | 0 to 0.05 |
playerStagger | Multiplier on how much being hit throws you off balance | 0 to 2 |
staggerGuardMs | After a stagger, how long before you can be staggered again, in milliseconds | 200 to 1500, whole number |
poiseHits | Extra hits your attacks need to interrupt an enemy wind-up (can be negative) | -2 to 3, whole number |
chainOnWhiff | Multiplier on the follow-up chance when the first swing missed | 0 to 1 |
maxChain | Most swings in one chain | 1 to 3, whole number |
bossCooldown | Multiplies the wait between two boss attacks | 0.5 to 2 |
bossTelegraph | Multiplies boss wind-ups (the warning circle scales too) | 0.6 to 2 |
bossRecover | Multiplies the opening after a boss attack | 0.5 to 2 |
bossPhaseShift | Added to boss phase health thresholds | -0.2 to 0.2 |
potionCooldown | Multiplies the shared potion and meal cooldown | 0.5 to 3 |
combatRegen | Multiplies natural regen in combat | 0 to 3 |
idleRegen | Multiplies natural regen out of combat | 0 to 3 |
bleedOut | Multiplies the time a downed player has (multiplayer) | 0.4 to 2 |
reviveHp | Multiplies the health a revive gives back | 0.2 to 2 |
morale | Whether enemies can flee (1 yes, 0 no) | 0 or 1 |
How it points at other things#
A rule pack does not point at any item or creature, it is only numbers, so there is nothing to "not find". If you want the player to pick a multiplier when creating a world, replace the number with an option: "enemyHealth": { "$option": "enemyHealth" }. See Mod folder and mod.json.
Common mistakes#
- Writing the whole table as a list,
[ { ... } ]. The game says the whole table should be a set of settings, and skips it. - A multiplier of 0 or 10. It has to be between 0.25 and 4.
- A misspelled field name such as
enemyHP. The game says "enemyHP" cannot be changed by mods. - Writing nothing at all (
{}). The game says this entry does not change anything. - A
difficultykey ofhard. Onlyeasy,normal,challengeandlegendarywork. - A decimal in
attackSlots. It has to be a whole number.
Related pages#
- Mod folder and mod.json: turn a multiplier into a choice when creating a world.
- Patches: change the numbers of just one enemy or one item.
- Species: make a new, stronger or weaker enemy.
- The mod editor: build this kind of content with forms and test it in the game.