Config
Every option in the common config: contracts, spawning, behavior and name lists.
Magic Realms ships with a single common config file at config/magic_realms-common.toml, generated automatically on first run.
Contracts
Controls the timing of the contract / hire system.
| Key | Default | Range | Purpose |
|---|---|---|---|
minutesPerContract | 10 | 1 – ∞ | How long a single contract lasts before it expires and the mercenary returns to neutral. |
minutesUntilPermanent | 200 | 1 – ∞ | Total contracted time (across renewals) needed before a mercenary can accept a permanent contract. |
Spawning and population
| Key | Default | Range | Purpose |
|---|---|---|---|
customTextureChance | 0.1 | 0.0 – 1.0 | Probability that a newly spawned mercenary uses a complete skin preset instead of compositing skin parts. 0.1 = 10%. Set to 0.0 to disable presets, 1.0 to make every mercenary use one (requires enough presets in the catalog or some will share). |
maxMercenariesInRadius | 8 | 1 – ∞ | Limits how many mercenaries can occupy chairs / bar stools inside a 20-block radius. Prevents tavern overcrowding inside taverns. |
Behavior tuning
| Key | Default | Range | Purpose |
|---|---|---|---|
immortalStunDuration | 10 | 1 – 60 | Seconds an immortal entity (e.g. a Mercenary with a Hell's Pass) stays stunned after being knocked out, before recovering. |
attemptCastUnclassifiedSpells | false | bool | If true, Mercenaries will try to cast spells from addons that haven't been categorized into Magic Realms' class spell tags (classes/mage/*, classes/warrior/*, classes/archer/*, classes/assassin/*). Set at your own risk - uncategorized spells may not work as expected, may target nothing useful, or may break combat AI. |
Name, hometown, and tip lists
These string lists are fully editable in the config - you can replace, add to, or trim them without writing a datapack. Translation keys in tavernTips need matching language entries in any active resource pack.
| Key | Type | Default size | Purpose |
|---|---|---|---|
maleNames | list of strings | ~140 entries | Pool used to name male mercenaries when no name comes from a fixed personality or skin preset. |
femaleNames | list of strings | ~120 entries | Same, for female mercenaries. |
hometowns | list of strings | 35 entries | Pool used to roll a hometown string for the personality panel ("Westhollow", "Stormkeep", etc.). Picked once per mercenary at spawn. |
tavernTips | list of strings | 5 entries | Translation keys the Tavernkeeper picks from when offering advice (message.magic_realms.tavernkeep_tip.1 through …tip.5 by default). Each entry must be a key, not the literal text - extend your language file in parallel to add new tips. |