Workspace manager for LocalExile
A Windows desktop launcher for a LocalExile server checkout: set it up, play, start and stop the servers and the game client, switch branches and pull requests, manage mods, save backups and accounts, watch the services and their performance, read every log and send the Gateway's chat commands with suggestions.
Waypoint brings together two launchers: the interface, performance tools and console of JetStream's LocalExile Launcher, and the setup, mod, backup, account, appearance and language tools of the first Waypoint.
It is a separate tool: it references no server project and drives a checkout only through what the server offers outside
tools (scripts/dev/live.ps1, the Gateway's commands/values modes, the dev host's protocol, the client control bridge,
the logs) and through its own adapter in scripts/. Every start goes through live.ps1, so the server's rules apply
unchanged. It does not bundle Path of Exile or LocalExile, and does not offer a public server.
Requirements: Windows 10/11 x64, the .NET 10 Desktop Runtime, and a PoE 3.29.3c or 3.29.3d client: your own standalone or Steam install, or one Waypoint downloads from Steam with your own Steam account (The game client from Steam) (a player who has only 3.29.3b gets the last LocalExile made for it, see Game client builds). The setup guide offers two ways to get LocalExile:
- The ready-to-play release (recommended). Nothing else to install: Waypoint downloads the release, checks its SHA-256, and
runs its
LocalExile.exeto prepare your client and create your account. - The source code, for working on LocalExile, which also needs the tools below. The Setup section walks through what the checkout still needs; the server's GettingStarted is the full guide.
| A source checkout's requirement | Used for |
|---|---|
| A LocalExile source checkout | The server Waypoint manages: the folder with GameServer.slnx |
| .NET 10 SDK | Building and running LocalExile |
| Git | Branches and pull requests |
| Python 3.9+ | Data extraction, consistent save backups, the account tools. Tick the installer's Add python.exe to PATH; Waypoint also finds a Python installed without it |
| Node.js | The bundle-decompression dependency |
| A PoE 3.29.3c or 3.29.3d client, standalone or from Steam | A separate copy in the checkout's Client folder; other builds are unsupported |
Frida (pip install frida) is optional: it is needed for walk maps, the console and live mod control, not for ordinary play.
The item crafter's Give item uses the Waypoint Tools mod instead, which it offers to install.
- Download
Waypoint.exefrom the latest release on this repository's Releases page. - Put it anywhere and start it.
- On its first start the setup guide opens. It gets LocalExile to a folder you choose or finds the copy you have, finds your game client, copies and prepares it. You can skip it, and you can stop it at any point: what is finished stays finished, and the guide continues from there later (Play → Finish setup, or Setup → Run setup guide on a checkout).
The exe is not code-signed, so Windows SmartScreen may say "Windows protected your PC" the first time: More info → Run anyway.
Settings of an earlier Waypoint or LocalExile Launcher are taken over on the first start, and existing save backups stay where they are. Neither old file is changed.
Linux has its own executable and interface (src/Waypoint.Linux, Avalonia) over the same engine, and the Windows app is
built as before. It needs the .NET 10 SDK, umu-launcher and your own
PoE 3.29.3c or 3.29.3d client, standalone or from Steam. A source checkout also needs PowerShell 7 (dotnet tool install --global PowerShell), Git,
Python 3.9+ and Node.js.
dotnet run --project src/Waypoint.LinuxGame settings and the saved login are kept in ~/.local/share/LocalExile/wine-prefix: every LocalExile of yours shares them, they
stay when an install is deleted, and your normal Path of Exile does not use them.
The ready-to-play route needs a release with a -linux-x64 zip; LocalExile publishes one since v0.2.0-beta. For an older release
without one, the setup guide sets up the source code instead. Not on Linux yet: walk maps, the client control bridge (the Console copies commands instead of sending
them), the item crafter, the tray and the appearance editor.
On a release install some sections do less, because a release has no source, Frida or per-service control: Console copies
commands for you to paste into the game's chat, Mods installs a mod's release but cannot build one from source, Control starts and stops
everything together, and the item crafter's Give item goes through the Waypoint Tools mod, which it offers to install. When a newer LocalExile release is out, a green card offers to install it.
Nothing changes until you accept and the game is closed. Your saves are copied first, and data\ and Client\ are kept.
Settings → Keep LocalExile up to date turns the prompt off.
A new player starts in Simple mode: Play, Mods, Modules, Leagues, Backups, Accounts, Tools and Settings, with Console and Logs one click away on Tools. Simple mode plays the release. A source checkout is always shown in Advanced mode: it plays from Control and its user updates it from Versions. Waypoint never updates a source checkout by itself.
The folder Waypoint works on is at the top of the sidebar. A click lists your other LocalExile folders, a release or any number of source checkouts, and choosing one opens it: no file moves, and Waypoint asks before it stops anything. Add a folder you already have… puts another one in the list.
Modules and Leagues can be edited on a release from v0.2.0-beta on and on a source checkout that exposes the supported settings and league-choice hooks: which modules a league uses, their settings, and new leagues. Any installed module can be ticked for any league when what it needs is on, Player Bots among them; turning off a league's own bundle (Ruthless in a Ruthless league) asks first, the Survivors modules stay in isolated leagues, and the rules of a game mode (Ruthless) go with that mode's leagues and with leagues made in Waypoint. A release hides and shows only the leagues made in Waypoint. The league card's name, description and mode links have a read-only preview.
On a release install, Settings → Developer → Developer Mode adds a Simple | Advanced switch at the bottom of the sidebar: Advanced gives every section below, with full control over branches and pull requests. Someone coming from an earlier launcher starts there.
| Section | What it does |
|---|---|
| Control | Play, start and stop the servers and each service, with the switches of live.ps1 and its output |
| Setup | What the checkout still needs, each requirement with its next step; the setup guide, which does all of it in one go |
| Versions | LocalExile's branches and pull requests and your own, how far you are from LocalExile, with every switch guarded; build, hot reload status, fresh saves |
| Mods | The checkout's mods: build, enable, disable, reload, live status |
| Modules | Gameplay modules, the leagues using them, and shared settings |
| Leagues | The game's declared flags and linked mode options, guarded module choices, isolated custom flags and league settings; changes apply at the next server start |
| Backups | Consistent copies of the saves, made automatically before risky steps; restore, delete, saved mod choices |
| Accounts | Accounts and characters, read from the saves; register, create a character, duplicate, rename, set a password, delete |
| Performance, Server timings | Live CPU, memory and runtime counters; what each Gateway operation costs |
| Logs | Every server's log, the client's, Waypoint's own, and all errors in one place; a redacted diagnostic report |
| Console | The Gateway's chat commands for the character in game, with suggestions and pinned lines |
| Tools | The item crafter: any base, rarity, modifiers with their values, sockets and influences; saved items; give it to the character in game |
| Settings | Appearance and accessibility, language, what closing the window does, updates, the checkout |
English, Russian and Simplified Chinese are in Settings → Language, and switch at once; until one is picked, Waypoint follows the system's display language. Settings → Appearance has 19 color schemes in light, dark and system modes, custom colors, reading fonts (OpenDyslexic included), text size, color-vision profiles, stronger contrast and focus, and reduced motion: see appearance.
A release build looks for a newer release when it starts (Look for updates at start in Settings turns that off; Check for updates there looks at once). A newer one shows a green card at the bottom of the window: Update now downloads the new exe, checks it against the release's SHA-256, puts it in place of the running one and restarts Waypoint. The servers and the game keep running. What's new opens the release page.
git clone <this repository> Waypoint
cd Waypoint
dotnet publish src/Waypoint -o .
.\Waypoint.exeA build from source has no version and never offers updates. Everything else, from the sections to the code layout and how a release is made, is in docs/launcher.md; what comes next is in docs/roadmap.md.
Waypoint is under the MIT license. What a released Waypoint.exe carries of others' work (DepotDownloader, GPL-2.0; OpenDyslexic, the SIL Open Font License) is in THIRD-PARTY-NOTICES.md.
This project is not affiliated with or endorsed by Grinding Gear Games.