Skip to content

feat(gm-commands): add the /descendancy command - #31

Merged
evrydayjunglist merged 2 commits into
LocalExile:mainfrom
Qblolz:feat/descendancy-command
Nov 18, 2026
Merged

evrydayjunglist merged 2 commits into
LocalExile:mainfrom
Qblolz:feat/descendancy-command

Conversation

@Qblolz

@Qblolz Qblolz commented Nov 11, 2026 •

Copy link
Copy Markdown
Contributor

Adds the second ascendancy layer's dev command to the mod, next to /ascendancy. LocalExile's Core/Player/Commands lost the dev commands in #814, so the command moved here with them.

Command

/descendancy [name|none|open [row|name]|refund <node|all>]

  • Lists the Descendancy.dat rows and selects one. The row travels in 0x33's spare byte and is saved with the character.
  • open asks the Game module to offer a row (S→C 0x7b kind 0x4c); the Game records the offered row and its area, so the client's 0x3a Accept is admitted only for it.
  • Selecting a Wildwood row (1-3) also sets its Azmeri class and four point flags, which gate the tree and its own eight points in the client.
  • none clears the row; selecting or clearing reloads the area so the client rebuilds the tree.
  • refund reverts one node or all of the layer, charging the five refund points per node.
  • The unrestricted development selection goes through Game.SelectDescendancyForDevelopment, so the mod can switch rows without the game's offer/gate/refund checks.

Dependency

LocalExile/LocalExile#786 is merged. The command uses the Game module's public surface
(Game.SelectDescendancyForDevelopment, Game.OpenDescendancySelector, Game.Descendancies) as it stands in LocalExile
main (8329dad7 when this was rebased).

Validation

  • Rebased onto LocalExile-Mods main (3fea683); the mod.json version conflict resolved as 1.5.0 for
    LocalExile 0.5.2-beta (main was at 1.4.0).
  • Head cd809a2.
  • gm-commands builds against LocalExile main: 0 warnings, 0 errors.
  • The installed mod reloads with the command; the selection flow is not run in the client yet.

@Qblolz
Qblolz force-pushed the feat/descendancy-command branch from f51a069 to b62daa1 Compare November 12, 2026 13:26
@Wrathen
Wrathen marked this pull request as draft November 12, 2026 13:29
The second ascendancy layer's selection moved out of LocalExile's Core/Player/Commands with the rest of the dev commands (#814). Lists and selects a Descendancy.dat row, clears it, opens the client's selector (0x7b kind 0x4c), refunds its nodes, and sets the three Wildwood Azmeri flag groups.

Needs LocalExile/LocalExile#786, which makes Game.SelectDescendancy and Game.Descendancies public.
The game path now accepts 0x3a only for the row the server offered in the current area and checks the Wildwood gate and refunded nodes. The dev command keeps its unrestricted selection through Game.SelectDescendancyForDevelopment and opens the selector through Game.OpenDescendancySelector, so it still records the offer the client answers.
@Qblolz
Qblolz force-pushed the feat/descendancy-command branch from b62daa1 to cd809a2 Compare November 13, 2026 06:35
@Qblolz
Qblolz marked this pull request as ready for review November 13, 2026 08:37
@evrydayjunglist
evrydayjunglist merged commit 02fdd19 into LocalExile:main Nov 18, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants