Skip to content

feat(waypoint-tools): a way into the game for Waypoint's tools, without the client bridge - #30

Merged
Wrathen merged 3 commits into
mainfrom
feat/waypoint-tools
Nov 10, 2026
Merged

Wrathen merged 3 commits into
mainfrom
feat/waypoint-tools

Conversation

@Wrathen

@Wrathen Wrathen commented Nov 10, 2026 •

Copy link
Copy Markdown
Member

What it does

Waypoint Tools (waypoint-tools) is a project mod that lets Waypoint's tools reach the game without the client control bridge (Frida + client_control.py), so they work the same on a LocalExile release and on a source checkout. The first use is Waypoint's item crafter: it used to give items through /item_give over the bridge, which a release doesn't have, and the game's chat box (175 characters) is too short to paste a rare's command by hand.

  • Waypoint writes a request to data/waypoint-tools/requests/<id>.json (written as .tmp, then renamed): {"action": "item_give", "character": "<name>", "item": <an item in the crafter hook's format>}. character is optional: without it the request goes to the one character in game, and with several in game it is answered asking to name one.
  • The mod carries it out on the next Tick of that character's connection: it builds the item with the Gateway's own ItemCrafter.Build, finds a free cell, puts it there and sends the inventory change, all on the connection's own task, as a chat command does.
  • It writes the answer to replies/<id>.json (ok, message) before removing the request, and says it in the character's chat (Waypoint: Added …).
  • A request that waits more than 30 s for its character is answered "not in game", so an item never shows up long after it was asked for. A request read once is never read again in that load, so an item can't be given twice.
  • data/waypoint-tools/loaded.json (protocol, version, the Gateway's pid, the actions) is written on load and removed on unload, so Waypoint can tell whether the running Gateway has the mod.
  • No chat commands, no settings, no network listener. It needs no other mod: it uses the server and LocalExile's Game module directly, and lists Game (the module) in depends. So it needs LocalExile v0.4.0-beta or later; compatibleClientVersions is 0.4.2-beta.

The README documents the request and reply files.

Tested in game

LocalExile v0.4.2-beta (a6e3b6a2), on a source checkout started with scripts/dev/live.ps1 and on the extracted release, the real client in Lioneye's Watch:

  • [mods] loaded waypoint-tools 1.0.0 (feature, 1 hook(s)), and loaded.json written with the Gateway's pid.
  • item_give of a rare ring, by character name and with no name: the reply was ok, the request file was removed, and the ring appeared in the main inventory with the chat line.
  • Reload (touching mod.json), and disable then enable through mod-state.txt: unloaded and loaded again cleanly, with no still in memory line.
  • Waypoint's item crafter gave items through it on the release.

dotnet build is clean with warnings as errors, and tools/build-index.ps1 updated mods.json.

The Waypoint side is LocalExile/Waypoint#30.

🤖 Generated with Claude Code

Wrathen and others added 3 commits November 11, 2026 00:49
…ut the client bridge

A project mod that carries out requests Waypoint writes to data/waypoint-tools/requests/ and answers in
replies/. The first action is item_give, what gm-commands' /item_give does, so Waypoint's item crafter can
give its items on a release, where there is no client control bridge, and without the chat box's length
limit. A request runs on the next tick of that character's connection, so the inventory change and its
message go through the connection's own task; one that waits 30 s for its character is answered "not in
game". loaded.json says the mod is loaded in which Gateway. Nothing listens on the network.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…t names none

Waypoint does not know which character is in game without the client bridge, so a request without
"character" goes to the one whose connection ticked in the last 2 s; with several in game it is answered
"name one", with none "No character is in game" after the 30 s wait.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
It builds and places items with the Gateway's own ItemCrafter.Build and the Game module; Game in depends is
LocalExile's module, not a mod.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@Wrathen Wrathen changed the title feat(waypoint-tools): give Waypoint's tools a way into the game without the client bridge feat(waypoint-tools): a way into the game for Waypoint's tools, without the client bridge Nov 10, 2026
@Wrathen
Wrathen merged commit 99e9770 into main Nov 10, 2026
1 check passed
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.

1 participant