📋 LUDWIG MAPALERTS

Notify your playerbase about active events — without breaking immersion.

Ludwig MapAlerts lets you trigger location-based alerts for any in-game event — robberies, ambushes, emergencies — with full control over who gets notified, where the blip appears, and for how long.

Designed with immersion in mind: no intrusive HUD spam, just clean, configurable alerts that fit naturally into your server's roleplay flow.

---

🛒 Get your Version

---

🚀 Key Features

• Map Alerts — notify players by job (in Radius or globally), in radius, or specific player ID with configurable label, message, duration, sprite & color
• Source obfuscation — blips are placed randomly within a configurable radius, hiding the exact location
• Sonar mode — replace static blips with a continuously pinging sonar animation
• Cry for Help — dead or dying players can broadcast a distress call to nearby players
• Hostage Alert — alert all online law enforcement officers instantly, regardless of distance
• 10 blip aliases — use friendly names like "lightning" or "star", or pass native backend names directly
• Discord webhook logging — every alert is logged with position, player info, and recipient count
• Server & client triggered — fire alerts from either side with the same payload

---

🖼 Preview

🛠 Technical Excellence

🔴 Native VORP, RSG and QB Support

Ludwig txLogs ships with a ready-bridge for both VORP Core, RSG and QB Core. Character data, job checks, are handled through the bridge automatically — swap Config.Framework and you are done.

🌉 Bridge Architecture

If you run a custom framework, drop in your own adapter and the entire system works without touching a single line of core logic.

---

📝Usage

TriggerEvent('ludwig_mapalerts:triggerMapAlert', {
	coords = vector3(2618.77, -1297.93, 52.19), -- required
	exactPos = false, --optional - places blip on exact coords, no obfuscation
	notifyRadius = 500, -- optional* - only players within given radius will get the Marker
	jobs = { "police", "sheriff" }, -- optional — only notify players with these jobs in Radius
	serverId = nil, -- optional — notify a specific player only (ignores jobs/notifyRadius)
	label = "Robbery in progress", -- optional*
	message = "Armed robbery at the bank!", -- optional*
	duration = 60, -- optional, [seconds]*
	ignoreRadius = false, -- optional — notify all matching players server-wide
	color = "red", -- optional (see colours below)
	markerRadius = 64, -- optional*
	sprite = "question", -- optional, ignored when useSonar is true (see sprites below)
	useSonar = false, -- optional — use sonar instead of a static blip
})

-- Optional Values with the Star (*) will  fallback to Values predefined by you in the Config

---