spacegho.st / ffxiv mods

Dalamud plugin · navigation · pointing only

XivWayfinder

Which way to go, softly

A softly pulsing bead floats a couple of yalms ahead of your character in the direction you need to head, and the game's own white pointing glove points there too, sliding to the edge of the screen when the way lies behind you. It follows a target you set, your map flag or your quest's next step, and with vnavmesh installed it points along the walkable path instead of through walls. It never moves your character.

Install Prove it in game Vote on features Source
XivWayfinder: a glowing bead with a trail of small beads and a pointing glove, under an aetheryte
Honest status

Host tests cover the direction and angle maths, the screen-edge clamping, the glove's placement and mirroring, the target priority, the pulse and tap timing, the command and IPC parsing and the state JSON. Nothing has been observed in the game yet: not the drawing, not the flag, quest and aetheryte reads, not vnavmesh. What this page describes is implemented intent. It is released (0.1.0); the changelog marks what has been seen working in game.

What it does

Pointing only. XivWayfinder never moves, turns or teleports your character, never presses a key, and never asks vnavmesh to move you. It asks vnavmesh for paths and nothing else.

It follows, in order and each one switchable: a target you or another plugin set (/wayfinder 11.2 14.5, or over IPC), your map flag, and your tracked quest's next step where the game gives it a place. When the target is in another zone it does not point: it names the aetheryte to teleport to, attuned ones first.

Features

Everything below is built and its logic is host-tested; none of it has been observed in game yet.

The bead

Floats 1.5 to 3 yalms ahead at chest height, bobbing and breathing. Dim while you face the right way, brighter as you turn away, so a glance says whether you are on course.

unverified in game

The glove

The classic white pointing hand, read at run time from your own game files (ui/uld/Cursor.tex), never shipped. Off screen it slides to the edge and points out, with a little tap. Without that texture it draws an original glove of its own.

unverified in game

The minion glove

/wayfinder minion: the Wind-up Cursor minion's own 3D model, found in your game data by name, floats beside the bead and points along the way, tilting on slopes. It is a model only you see: never a summoned minion, nothing shipped, nothing sent. Not the default.

unverified in game

Your flag, your quest

The map flag, then the tracked quest's next step: the map's own quest markers first, else the quest's to-do locations. Steps with no place (a duty, a cutscene) are skipped.

unverified in game

Coordinates, pasted

/wayfinder 11.2 14.5, (11.2, 14.5), X: 11.2 Y: 14.5, or with a zone name: 21.5 22.1 central shroud. Reaching it clears it.

unverified in game

Another zone

A small note above your character: Teleport to the aetheryte nearest the target, attuned ones first. XivWayfinder never teleports you.

unverified in game

The path, highlighted

With vnavmesh installed the trail lays its beads and a soft line along the walkable route ahead, not as the crow flies, and the glove points at the path's next stretch. Without a path it is a straight line and says so.

unverified in game

Trail, distance, arrival

The trail (on by default), the distance in yalms on hover or always, and a breathing ring when you arrive.

unverified in game

Steps aside

Hidden in cutscenes, zone changes, group pose and with the UI hidden; in combat and duties too, unless you say otherwise.

unverified in game

IPC for other plugins

XivWayfinder.v1.SetTarget, SetMapTarget, Clear and GetState, for Ghostty's coordinate links and XivMcp to call. No other plugin calls them yet.

unverified in game

Proving it in game

None of this has been done yet. /wayfinder test exists so that it can be, anywhere.

  1. In an open field, /wayfinder test: the bead 2.2 yalms ahead, dim, the glove above it pointing forward; /wayfinder status says about 20 yalms.
  2. Turn around: the bead brightens and the glove swings to point back past you, or moves to the screen edge.
  3. Walk to it: the distance counts down, the ring appears, and the target is cleared.
  4. Place a map flag, then track a quest with a marker and clear the flag: the pointer follows each. A flag in another zone names an aetheryte there.
  5. With vnavmesh, stand behind a wall from a flag: the pointer aims around it.

Please report what you see, with /wayfinder status and /xllog lines for anything that looks wrong.

Screenshots and clips

Planned shots. Empty frames are placeholders for screenshots and clips that will be captured in game.

Loading the shot list…

Install

Two ways, and both are kept on purpose: one click from the plugin repository, or build it from source and load it as a dev plugin.

One click

Add the repository once; every mod here installs and updates like any other plugin.

https://spacegho.st/mods/ffxiv/plugins.json
  1. In game, type /xlsettings → the Experimental tab.
  2. Under Custom Plugin Repositories, paste the URL into the empty row, press +, and leave its checkbox ticked.
  3. Save and Close.
  4. /xlplugins → All Plugins → search XivWayfinder → Install.

XivWayfinder has a stable release, so it shows under All Plugins straight away. Nothing in it has been marked verified in game yet; the changelog says which parts are.

Dalamud will warn you that this is a third-party repository nobody but its author has reviewed. That is true. The repository page says more, including how test builds work.

Build it yourself

The dev plugin path: exactly the code in your checkout, no repository, no auto-update. It is how the author runs it, and the honest way to read the code before you trust it.

git clone https://github.com/Spaceghost/xivwayfinder-dalamud
cd xivwayfinder-dalamud
tools/fetch-dalamud.sh && tools/install-dev.sh
  1. Needs the .NET 10 SDK. tools/fetch-dalamud.sh fetches Dalamud's reference assemblies. Rebuild after every Dalamud update.
  2. tools/install-dev.sh builds Release, stages it outside the checkout, and prints the path (a Z:\… path under Wine). It never edits Dalamud's configuration.
  3. In game: /xlsettings → Experimental → Dev Plugin Locations → add the path of the built XivWayfinder.dll → + → Save and Close.
  4. /xlplugins → Dev Tools → Installed Dev Plugins → enable XivWayfinder. Dev plugins are added disabled.
  5. Rebuilt while the game is running? Press the reload arrow on its entry. No relaunch.

If you later switch to the one-click install, disable the dev plugin first so the two copies cannot fight over the same name. The README has the details.

Requirements

  • FFXIV with Dalamud (API level 15). Windows and Linux under Wine alike; nothing in it is platform-specific.
  • Optional: vnavmesh, for walkable paths instead of straight lines.
  • Known limits: a quest step with no place in the game's data (a duty, a cutscene, an item to hand in anywhere) is skipped, and which quest markers the map offers depends on what it has loaded.

Community screenshots

Screenshots of XivWayfinder shared by players. Every one is reviewed by the site owner before it is shown here. Every mod's are in the gallery, and what XivWayfinder should do next is up for a vote.

Loading…

Add yours

Sharing a screenshot needs a sign-in, so that everything sent to this site comes from an account.

Sign in with GitHub Sign in with FFXIV

Signing in with FFXIV needs an XIVAuth account and shares no character.

Hide your own name and chat first, and never share a terminal showing tokens or private paths. Metadata is stripped from the image before it is stored. Your upload is linked to your GitHub or XIVAuth account id, which the site owner can see; the public sees only the image and the credit you typed. To have a shot removed, contact the owner through github.com/Spaceghost.