Equipment balance data
Change catalog equipment bonuses and spell storage limits through server datapacks.
Equipment overrides change an existing catalog item’s attribute bonuses and spell storage limits. The server sends the accepted balance to clients; you do not distribute a replacement client resource pack for these values.
Where the files live
Put one override at data/isekaiexpansion/equipment/<item_id>.json. The filename selects the registered catalog item. Other namespaces are ignored. If packs supply the same path, the highest-priority pack supplies the whole file; fields do not merge across packs.
This format cannot register new items or change their rarity, slot, appearance or held light. Those belong to the startup equipment catalog.
Minimal example
For data/isekaiexpansion/equipment/apprentice_fieldnotes.json, this changes storage while keeping the bundled attribute bonuses:
{
"vessel": {
"capacity": 4,
"max_spell_tier": 2,
"spells_per_tier": 2,
"access": "CONTAINED"
}
}
Fields
| Field | Type | Default | Effect |
|---|---|---|---|
stats | array<object> | Bundled item stats | Replaces the complete bonus list. An empty array removes all catalog bonuses. |
vessel | object | Bundled item storage | Replaces all storage settings. Only existing spellbooks and casting focuses support it. |
stats[].attribute | identifier | required | Registered attribute ID, including namespace. Unknown attributes reject the reload. |
stats[].amount | number | required | Finite, nonzero signed amount. Units depend on the attribute and operation; negative amounts are valid penalties. |
stats[].operation | enum | required | ADDITION, MULTIPLY_BASE or MULTIPLY_TOTAL. Additive values use the attribute’s native units; multiplier values are fractional modifiers. |
vessel.capacity | integer | required | Total stored entries, 1–16. A woven formula occupies one entry. |
vessel.max_spell_tier | integer | required | Highest admitted spell or evaluated formula tier, 1–13. A formula uses its full evaluated tier, not only its lead spell. |
vessel.spells_per_tier | integer | required | Entries permitted at the same evaluated tier, 1–capacity. This is independent of the maximum tier. |
vessel.access | enum | required | CONTAINED for spellbooks; MAGIC for casting focuses. Other values or a mismatched kind reject the reload. |
Full example
The same path can replace both groups:
{
"stats": [
{
"attribute": "isekaiexpansion:intelligence",
"amount": 4,
"operation": "ADDITION"
}
],
"vessel": {
"capacity": 4,
"max_spell_tier": 2,
"spells_per_tier": 2,
"access": "CONTAINED"
}
}
Validation
Unknown keys, unknown catalog items, unresolved attribute IDs, duplicate attribute entries, malformed JSON, missing nested fields and values outside the stated ranges reject the reload. Fractional values are invalid for integer fields. Null does not mean “use the default”.
An empty object keeps bundled defaults; an empty file is invalid. Omitting a group restores its bundled value, rather than retaining an earlier override. Removing an override restores both bundled groups.
Reloading
Apply changes with /reload. The server prepares a complete validated balance snapshot and publishes it only after the entire datapack reload succeeds. A failed reload keeps the previous active balance. Equipped catalog bonuses refresh, and clients receive the accepted snapshot on joining and successful reload.
Lowering storage limits preserves existing inscriptions. Entries outside capacity, above the maximum tier or beyond the same-tier allowance become dormant and cannot cast. Stored order decides which entries remain active. Unbinding remains available. New inscriptions and formula replacements must satisfy the live limits.