GW2-TrailTools

Full TacO/Blish trail & marker pack authoring for Guild Wars 2

---

---

Contributors

• Xydroc

---

### Authoring hub
- Side-rail tabs: **Content → Keybinds** (Content uses the former Editor anvil icon; Live pose / UberTool / world click). Pack build is collapsed on Content
- Pack-in-world / gizmo / pop-out checkboxes on Nexus Options, Pack editor, and Content. **Draw pack in world** starts off; overlay still works with the pad closed
- In-place `.taco` tools (open zip/folder, 2D map, tree, details, resources) live under Nexus Options → **Pack editor**. Save patches original XML. Wheel scrolls lists; **Ctrl+wheel** zooms the map
- Nexus Options footer: CREATED BY XYDROC + Ko-fi (Trail Tools)
- OverlayData New / Load / Save is on **Content** — **one XML file**
- **Content** lists trails and markers in that project and opens TrailsN / MarkersN editors
- TrailsN / MarkersN pop-outs own their own `.trl` / marker data until **Add to project**
- Cartographer UI theme (slate + teal), custom brand QuickAccess icon

### Pack workflow
- Pack name / display name, draft session save/load, reseed categories
- Import installed `.taco` into the draft
- **Build .taco** → `addons/GW2-TrailTools/pathing/`, enable root category, reload Pathing index
- Looks presets, asset browser, category tree editor
- Single OverlayData XML in TacO form (3-space indent, nested MarkerCategory, ``, assets in `Data/Images/`)
- Pack → Reseed for Lady Elyssa–style leaves (`example` / `circle` / `heart` / `square` / `triangle`)
- OverlayData **XML editor** pop-out: edit raw text (custom attrs/layout); Apply fills TrailsN/MarkersN; Save writes the buffer as-is

### Trails
- Default trail category on Content; up to **five** TrailsN windows
- Compact TrailsN: New / Load / Save / Save As · New Segment / Insert Vector / Select Nearest / Move to Feet / Delete Nearest / Undo
- Recording rail: **Start** and **Stop** are separate buttons (Stop cannot immediately Start); Pause/Resume; **Spacing in seconds** (0.3 = 1/3 s); samples only while the character moves
- World GPS for a draft trail does not appear until **Start** (or Insert Vector / world-click add point) in an open TrailsN. Start with no Trails window opens one
- **Clear world trail** (Content Live and Nexus Options) deletes a GPS that is not in any Trails window and turns pack overlay off
- After Stop, walking does not add points. Start on a trail that already has vectors does not insert a section or extra vertex (use New Segment / Insert Vector). Empty trails still get a first vector on Start
- New Segment: TacO `0,0,0` break + current MapID + vector at feet
- Draft vertices drawn as clickable circles; Select Nearest / Move to Feet move the UberTool onto that vector
- `.trl` stays with the pop-out until **Add to project** inserts it into OverlayData
- Per-`` attrs (texture, trailScale, fade, alpha, animSpeed)
- Geometry: reverse / densify / smooth / multi-select (Ctrl/Shift)
- Snapshot undo (Ctrl+Z) on TrailsN
- Live draft preview (world GPS + compass) follows the focused TrailsN trail

### Markers
- Default marker category on Content; MarkersN pop-outs for focused POIs
- Insert / Select Nearest / Delete / Move to Feet / Undo
- Drop / delete at feet, this-map filter, marker attribute editors
- Named behavior combo + Display (mapDisplaySize / minSize / maxSize) + Filters (achievement, festival, profession/race/mount, toggleCategory)
- Blish-style `script-*` attributes on POIs (stored in OverlayData)
- Snapshot undo (Ctrl+Z) on MarkersN
- Copy markers from currently loaded Pathing packs

### Live
- **3D UberTool** + **Draft preview** default **on** (persisted). **Ground snap**: plane fit from walked Mumble feet, draft points, and the open pack (same Mumble pose TacO uses — not game process memory, not a live mesh). Click a draft marker or trail vertex (stays selected while recording), drag the white hub to slide / RGB arrows for XYZ, Ctrl+click a trail to insert a point, right-click while dragging to cancel. Gizmo clicks are swallowed so camera look does not steal the drag; movement follows the mouse.
- **Hide trail near me** (Content → Live, and Nexus Options) toggles the player-clear bubble; **Trail player clear** is the radius
- World click / map Shift+click place against that plane when Ground snap is on. Disabled for that click when UberTool consumes it.
- Empty-world `LBUTTONDOWN` is seen through Nexus `WndProc` (`WorldClick`) because ImGui does not get clicks on empty game view.

### Keybinds
- Trail record / pause / section / delete-segment chords
- Marker delete + place-slot chords (Ctrl+Numpad-style)