Note: This documentation covers all configuration options available to server owners. The script automatically detects your framework (ESX, QBCore, QBox) and handles phone number integration from vari
1) Overview
Risk Life Invader is a dynamic announcement system for FiveM servers featuring:
Or disable: RISK.UsePhoneNumberInPublicAnnounce = false
16) Best Practices
✅ Balance pricing with server economy — Don't make too expensive or too cheap
✅ Use cooldowns to prevent spam — 5-15 minutes recommended
✅ Maintain blacklist regularly — Add problematic words as they appear
✅ Test job announcements — Ensure all jobs can use the system
✅ Use webhooks for moderation — Monitor admin logs channel
✅ Keep UI text clear — Explain pricing and rules in info box
✅ Test phone integration — Verify phone numbers display correctly
✅ Customize themes — Match your server's branding
✅ Monitor usage patterns — Adjust pricing based on activity
✅ Communicate changes — Tell players about pricing/cooldown updates
RISK.Marker = {
drawDist = 25.0, -- Distance at which marker is visible
useDist = 1.5 -- Distance required to interact (press E)
}
RISK.Price = {
perChar = 5, -- Price per character
min = 0, -- Minimum price (even if message is short)
max = 0, -- Maximum price (0 = no limit)
countTitleInPrice = true -- Include title in character count
}
RISK.JobNotify.titleFallback = true -- Auto-fill title with job label if no title provided
RISK.JobNotify.titleFallback = false -- No auto-fill (leave title empty)
RISK.Blip = {
enabled = true,
sprite = 521,
color = 1,
scale = 0.8,
name = "Life Invader"
}
RISK.Marker = {
enabled = true,
type = 21,
scale = vector3(0.3, 0.3, 0.3),
color = {r = 255, g = 255, b = 0},
drawDist = 25.0,
useDist = 1.5
}
-- Yellow (default)
color = {r = 255, g = 255, b = 0}
-- Red
color = {r = 255, g = 0, b = 0}
-- Blue
color = {r = 0, g = 100, b = 255}
-- Green
color = {r = 0, g = 255, b = 0}
Config.UseCustomNotify = false
Config.UseCustomHelpNotify = false
Config.Functions = {
["notify"] = function(ntype, title, text, time)
exports['risk-notify']:Notify({
type = ntype or 'info',
message = text,
title = title or 'LIFE INVADER',
duration = time or 10000
})
end,
["helpnotify"] = function(key, text)
exports["risk-notify"]:HelpNotify(key, text)
end,
}
RISK.Notify = {
duration = 10000 -- Notification duration in milliseconds
}
RISK.Locales = {
open_menu_prompt = "to open Life Invader",
not_enough_money = "You don't have enough money (%s via %s required).",
blacklist_message = "Forbidden word: %s! Ad not sent.",
cooldown_message = "You still have a cooldown of %s."
}
RISK.Locales = {
open_menu_prompt = "um Life Invader zu öffnen",
not_enough_money = "Du hast nicht genug Geld (%s über %s benötigt).",
blacklist_message = "Verbotenes Wort: %s! Nachricht nicht gesendet.",
cooldown_message = "Du hast noch %s Abklingzeit."
}
RISK.Locales = {
open_menu_prompt = "para abrir Life Invader",
not_enough_money = "No tienes suficiente dinero (%s vía %s requerido).",
blacklist_message = "Palabra prohibida: %s! Anuncio no enviado.",
cooldown_message = "Todavía tienes %s de espera."
}
RISK.Locales = {
open_menu_prompt = "pour ouvrir Life Invader",
not_enough_money = "Vous n'avez pas assez d'argent (%s via %s requis).",
blacklist_message = "Mot interdit: %s! Annonce non envoyée.",
cooldown_message = "Vous avez encore %s de temps d'attente."
}
RISK.Info = {
Title = "INFORMATIONS",
Text = "You can send your advertisements anonymously or publicly. Charges are calculated per character. Please write responsibly."
}
RISK.UI = {
Title = "LIFE INVADER",
Subtitle = "Broadcasting"
}
RISK.Info = {
Title = "GUIDELINES",
Text = "All announcements are public record. Abuse of this system will result in consequences. Pricing: $5 per character."
}
RISK.UI = {
Title = "ANNOUNCEMENT BOARD",
Subtitle = "Community Messages"
}
RISK.Info = {
Title = "HOW IT WORKS",
Text = "Share your message with everyone! Choose anonymous or public. Be respectful - all messages are logged."
}
WebhookConfig.Public = {
Enabled = true,
WebhookURL = "https://discord.com/api/webhooks/YOUR_WEBHOOK",
Username = "LifeInvader",
AvatarURL = "https://files.catbox.moe/rfmge1.webp",
Color = 16711680, -- Red
EmbedTitle = "New LifeInvader Message",
ThumbnailURL = "https://files.catbox.moe/wud9k5.png",
FooterText = "Sent via LifeInvader",
}
WebhookConfig.JobColors = {
police = 0x2E8CFF, -- Blue
ambulance = 0xFF4444, -- Red
mechanic = 0xFFD700, -- Gold
government = 0x8B00FF, -- Purple
taxi = 0xFFF000 -- Yellow
}
WebhookConfig.JobColors = {
police = 0x0080FF, -- Bright blue
sheriff = 0x8B4513, -- Brown
ambulance = 0xFF0000, -- Red
fire = 0xFF4500, -- Orange-red
mechanic = 0x32CD32, -- Lime green
taxi = 0xFFFF00, -- Yellow
realestate = 0x9370DB, -- Purple
government = 0x4B0082 -- Indigo
}
Color = 0xFF0000 -- Red
Color = 0x00FF00 -- Green
Color = 0x0000FF -- Blue
Color = 0xFFFF00 -- Yellow
Color = 0xFF00FF -- Magenta
Color = 0x00FFFF -- Cyan