Skip to content

feat(gm-commands): /cluster_jewel makes the jewel the game makes - #40

Merged
evrydayjunglist merged 2 commits into
LocalExile:mainfrom
evrydayjunglist:feat/cluster-jewel-themes
Nov 13, 2026
Merged

evrydayjunglist merged 2 commits into
LocalExile:mainfrom
evrydayjunglist:feat/cluster-jewel-themes

Conversation

@evrydayjunglist

@evrydayjunglist evrydayjunglist commented Nov 13, 2026 •

Copy link
Copy Markdown
Collaborator

Summary

/cluster_jewel built its jewel by hand with no theme: the client drew its small passives as the empty "Nothingness", the item had no "Added Small Passive Skills grant" line, and what the command called the theme was an "also grant" mod put in the enchant list.

It now goes through the server's own maker, ClusterJewels.Create (LocalExile/LocalExile#948), so it is the jewel /item, a drop and Waypoint's item crafter make:

/cluster_jewel <small|medium|large> [passives] [sockets] [theme] [mod ...]
  • theme: what the small passives grant, by its name with underscores (fire_damage, flask_duration, life) or its tag. A wrong word lists the size's themes. Without one the jewel gets one of its size's, as /item Large Cluster Jewel does; none makes a jewel without a theme, as the command made before.
  • mod: Mods Ids of its affixes, notables and "also grant" alike. A mod Id where the old command took its "theme mod" still works, as an affix.
  • The numbers may be left out (defaults 3 / 4 / 8 passives and 0 / 1 / 2 sockets, as before). The reply names the theme.

Version 1.3.0 becomes 1.4.0, the README has a "Cluster jewels" paragraph, and mods.json is rebuilt.

Requires LocalExile/LocalExile#948. The mod calls ClusterJewels, which no release has. compatibleClientVersions is 0.5.2-beta (second commit, 80b4434), taken as the release that will ship the LocalExile change: if that release gets another number, this line, the README's "Works with" and mods.json need it too. Not to be tagged before that release is out.

Testing

Built against the LocalExile branch of LocalExile/LocalExile#948 (28daa7ef6) and played with the real client (3.29.3d) on a release folder with a package built from that branch.

Command Result
/cluster_jewel large 8 2 fire_damage AfflictionNotablePrismaticHeart__ AfflictionNotableWidespreadDestruction "Cluster jewel (large, Fire Damage, 8 passive(s), 2 socket(s))"; saved with theme value 13, 8 passives, the two-socket enchantment and both notables
/cluster_jewel medium a medium jewel with one of the medium themes (Physical Damage over Time), 4 passives, 1 socket
/cluster_jewel small none "small, no theme, 3 passive(s), 0 socket(s)"
/cluster_jewel small life "small, Life"
/cluster_jewel large bogus_theme "bogus_theme" is neither a theme nor a mod, followed by the seventeen large themes
/cluster_jewel large 8 2 AfflictionJewelSmallPassivesGrantLife2_ (the old form) a large jewel with a theme of its size and the mod as an affix

With the first jewel socketed in tree cell 20, /stat fire_damage_+% read 0, then 12 and 24 as small passives 195 and 197 were taken; notables 196 and 200 gave elemental_damage_+% 50 and base_skill_area_of_effect_+% 6.

tools/build-index.ps1 -Check passes on the branch and on its merge with main (641e127).

/cluster_jewel built its jewel by hand with no theme: the client drew
its small passives as the empty "Nothingness", the item had no "Added
Small Passive Skills grant" line, and what the command called the theme
was an "also grant" mod put in the enchant list.

It now goes through the server's own maker (ClusterJewels.Create), so it
is the jewel /item, a drop and the item crafter make:

  /cluster_jewel <small|medium|large> [passives] [sockets] [theme] [mod ...]

- theme: what the small passives grant, by its name with underscores
  (fire_damage, flask_duration, life) or its tag. A wrong word lists the
  size's themes. Without one the jewel gets one of its size's; `none`
  makes one without a theme, as before.
- mod: Mods Ids of its affixes, notables and "also grant" alike. A mod Id
  where the old command took its "theme mod" still works, as an affix.
- The numbers may be left out. The reply names the theme.

1.4.0. Needs a LocalExile with ClusterJewels, which no release has yet:
compatibleClientVersions is left for the reviewer to set.
@evrydayjunglist evrydayjunglist added the Requires LocalExile Update This mod will only be compatible after a certain LocalExile PR is merged to support this mod. label Nov 13, 2026
@evrydayjunglist

Copy link
Copy Markdown
Collaborator Author

Requires LocalExile/LocalExile#948, which must be merged first: the command calls ClusterJewels.Create from it.

C:/Program Files/Git/cluster_jewel calls ClusterJewels (LocalExile/LocalExile#948), which no earlier release has.
@evrydayjunglist
evrydayjunglist merged commit 3fea683 into LocalExile:main Nov 13, 2026
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Requires LocalExile Update This mod will only be compatible after a certain LocalExile PR is merged to support this mod.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant