bfx-waypoints — 3D Waypoint Beams via DUI

Standalone resource that renders 3D waypoint beams in world space using runtime DUI textures. Each waypoint shows a colored beam with live distance and a label. No framework dependencies.

🎥 Preview

⚠️ Important — Developer Resource

This is NOT a plug-and-play waypoint system for players.

🔧 This resource is developer-focused, meaning you must add, update, and remove waypoints manually via exports from your own scripts.

There is no UI, no player commands, and no automatic GPS integration by default.

✨ Features

• Real 3D geometry (DrawMarker type 9) — depth-tested, clips behind buildings
• Per-waypoint color, label, and live distance counter
• Scales with distance — small up close, tall from far away
• Fades out when you get close
• Optional auto-remove on approach (enabled by default)
• Lazy render loop — zero overhead when no waypoints are active
• Fully controlled via exports, drop it in and call from any resource

📦 Installation

1. Drop bfx-waypoints into your resources folder
2. Add ensure bfx-waypoints to your server.cfg
3. Call the exports from any client-side script

Usage

-- spawn a red waypoint
local id = exports['bfx-waypoints']:AddWaypoint(vector3(200.0, -800.0, 30.0), {
  label = "DELIVERY",
  color = "#E74C3C",
})

-- spawn with defaults (white, auto-removes at 5m)
local id = exports['bfx-waypoints']:AddWaypoint(vector3(200.0, -800.0, 30.0))

-- persistent waypoint (won't auto-remove)
local id = exports['bfx-waypoints']:AddWaypoint(pos, {
  label = "HQ",
  color = "#3498DB",
  autoRemove = false,
})

-- remove it manually
exports['bfx-waypoints']:RemoveWaypoint(id)

-- update color/label/position on the fly
exports['bfx-waypoints']:UpdateWaypoint(id, { color = "#2ECC71", label = "DONE" })

-- find a waypoint near a coord
local id = exports['bfx-waypoints']:GetWaypointForCoord(vector3(200.0, -800.0, 30.0), 10.0)

-- nuke everything
exports['bfx-waypoints']:ClearWaypoints()

⚙️ Config

image740×672 46.1 KB

🔗 Source

GitHub - iWanheda/bfx-waypoints

Contribute to iWanheda/bfx-waypoints development by creating an account on GitHub.