Gems & sockets

Equipment receives sockets from its socket profile. Each socket accepts exactly one kind of gem, and the four kinds do genuinely different jobs.

The four socket kinds

Socket rules can narrow this further — restricting stat domains, damage categories, magic schools, specific skills, or a minimum item level. A gem must satisfy every restriction on its socket, not just the kind.

Inserting

Put a compatible gem on the cursor and use it on socketed equipment. When more than one socket is available, a selection screen asks which one.

The bundled rules:

chance = min(success_cap, base_success + strain × bonus_per_strain)

Locked, sealed and cracked

A locked socket cannot accept, activate, reroll or release a gem. Two things lock one:

• a profile lock, which lifts when the equipment reaches the socket’s minimum item level;
• a persistent seal, stored on the item, toggled by an Artificer’s Lens while the socket is empty.

A cracked socket is disabled: its attribute bonuses and combat procs stop applying, and nothing new can go in until Kintsugi Resin repairs it. A gem already inside a cracked socket stays there and can still be extracted.

Reading the tooltip

The equipment tooltip always lists its socket rows, plus a “Hold Shift for socket details” hint. Holding Shift adds a footer with:

• current and maximum attunement strain;
• the next insertion chance;
• locked and cracked socket counts;
• any applied curse and its rolled multiplier.

Element and skill gems show their trigger and cooldown. Chance is only shown for random combat triggers — manual skill activation is deterministic and has none.

Extraction

Locked sockets block extraction. Cracked sockets do not.

Consumables

Consumables are checked before any roll or item consumption. An inapplicable consumable does nothing and is not spent.

Rerolling keeps a gem’s stored difficulty context, so a gem found in a hard place still counts as one afterwards.

Combat triggers

Element gems cannot use TRIGGERABLE. A manual skill gem uses its equipment-skill key, energy cost, per-socket cooldown and equipment search priority.

Curses

One curse can be bound to an equipment stack, its strength rolled inside the curse definition’s multiplier range. Bundled downside types:

• negative attribute modifiers;
• recurring harmful status effects;
• increased incoming damage.

Curse effects are collected from armour, both hands, and equipped trinkets. The tooltip shows the curse and its rolled multiplier.

Bundled socket progression

Profiles are evaluated highest priority first; the first match wins.

The numbers are equipment levels. This is the concrete reason to commit to one weapon: a wand only reaches its Skill socket at equipment level 20.

For datapack authors

All paths sit under data/isekaiexpansion/:

gem_system/settings.json
gem_attributes/random_roll/*.json
gem_attributes/fixed_attributes/*.json
gem_attributes/element_attributes/*.json
gem_attributes/skill_attributes/*.json
socket_profiles/*.json
curses/*.json
gem_consumables/*.json

Reloads are all or nothing: every gem resource is validated together, and one invalid resource voids the whole reload while the previous configuration stays active. Once validation passes, the complete configuration is sent to every client.

Cross-mod definitions

Every gem JSON resource supports Fabric’s standard fabric:load_conditions. Use a load condition rather than registering substitute items or weakening registry validation:

"fabric:load_conditions": [
  { "condition": "fabric:all_mods_loaded", "values": ["jewelry"] }
]

A resource whose conditions do not match is intentionally excluded. If the required mod is loaded, every referenced item and registry entry is still validated strictly. The bundled Citrine, Jade, Ruby, Sapphire, Tanzanite and Topaz fixed gems are Jewelry compatibility and load only with the jewelry mod present.

Localisation

Gem strings belong only in language_assemble/categories/gem/en_us.json and …/zh_cn.json. The assembly task rejects duplicate keys across categories, so a similarly named non-gem item — gem_ofcursedocean, for instance — stays in its own category.