Waypointer

Description

A client-side mod that scans your surroundings for points of interest and drops a colored waypoint on each one, so you never lose a trader, translocator pair or sticky pine again. Everything is kept in a single HUD: a searchable, filterable list of every marker the mod has placed plus your own user waypoints, with a per-marker action strip (pin, show on map, share, copy, delete).

Press ' (apostrophe) to open the HUD, or run .wayp hud in chat.

What it detects

• Traders — all 9 vanilla roles (Agriculture, Artisan, Building Materials, Clothing, Commodities, Furniture, Luxuries, Survival Goods, Treasure Hunter). Each role gets its own color; trader names are localized in the HUD.
• Repaired static translocators — both endpoints of a working translocator pair are marked at once (the mod reads tpLocation from the block entity). Each waypoint title shows where the other end leads, e.g. "TL to (−1234, 64, 5678)".
• Resin-bearing logs — vertically-oriented pine and acacia logs with resin (both fresh and harvested). Additional log codes can be added in the config.

Anti-duplication is built in — you won't get a flood of identical waypoints when you walk past the same trader twice.

HUD features

• Scrollable marker list, always sorted by 3D distance from the player.
• Search bar — matches both the saved marker name and the current name on the map (so a renamed waypoint is still findable).
• Right-side filter sidebar — Translocators / TL by pairs / Resin / All traders / Traders by type / User waypoints / Waypoint icons.
• Per-marker actions:
  • Pin / unpin (uses the vanilla /waypoint modify path)
  • Show on map (centers the world map on the marker)
  • Share — drops X Y Z into the chat input without sending
  • Copy — copies X Y Z to the system clipboard
  • Delete — removes both the waypoint and the local record

Scan radii

Traders — up to 128
Translocators — up to 256
Resin — up to 64

Amortized scan

Option for weaker PCs and huge radii — it spreads the scan's work across several ticks under a per-tick time budget, fully eliminating stutter. Details below.

Resources

The new "Resources" tab lists resources that the mod can automatically mark on your map as you pass by (scan radius: 3 blocks):

• Ores — each mineral has its own row (tin, copper, gold, silver, titanium, uranium, etc.). Grades (poor/rich) and host rocks are merged: one mineral = one row. Iron ore appears as three separate rows with a tag: "Iron ore (hematite/magnetite/limonite)".
• Meteoric iron
• Stone — all 24 rock types as separate rows (granite, basalt, marble, obsidian, etc.).
• Trees — by wood type (oak, pine, birch, redwood, etc.).
• Clay — red, blue, and fire clay.
• Peat and high-fertility soil
• Lava and moving water (scanned in the fluid layer).
• Broken static translocators — to find candidates for repair.

Names are pulled directly from the game's own localization, so the list automatically matches your game language (English, Russian, German, etc.).

Per-resource customization

Clicking a row opens the editor:

• Icon — a grid of all waypoint icons.
• Color — a full HSV color picker (saturation square + hue strip) with a live preview of the icon in the chosen color.
• Anti-duplicate radius — defines how close repeat markers must be to be suppressed.
• Scanning toggle — the checkbox in each row instantly toggles scanning for that resource.

TLPath Integration

Waypointer collects data from translocators. The TLPath mod can route through your network of translocators in any world, not just on servers with a public online map. The "Find TLPath" button in the mod sends the selected marker to TLPath.

Commands

• .wayp — list subcommands
• .wayp on / off / toggle — master scanner
• .wayp scan — force a single scan now
• .wayp list — print all markers for this world
• .wayp hud — open / close the HUD
• .wayp status — current state + radii