⚙️Full Configuration Breakdown
🌍 Language Configuration
-- Set the default language for notifications
Config.Language = 'en' -- Available options: 'en', 'de', 'es', 'fr', 'it'Adding New Languages
To add a new language, edit the shared/translation.lua file and extend the Translations.Languages and Translations.Messages sections.
📢 Notification Configuration
-- Default display duration for notifications (in milliseconds)
Config.DefaultDuration = 5000🛠️ Framework Configuration
-- Choose the framework to use ('auto', 'esx', or 'qbcore')
Config.Framework = 'esx'
-- Set to 'true' for older ESX versions that use TriggerEvent instead of Export
Config.UseOldESX = false⏱️ Cooldown Configuration
-- Global cooldown for automatic announcements (in seconds)
Config.AnnounceCooldown = 60
-- Cooldown for admin announcements (in seconds)
Config.AdminAnnounceCooldown = 30
-- Cooldown for internal admin announcements (in seconds)
Config.AdminInternalAnnounceCooldown = 15
-- Cooldown for job announcements (in seconds)
Config.JobAnnounceCooldown = 120
-- Cooldown for internal job announcements (in seconds)
Config.JobInternalAnnounceCooldown = 30
-- Cooldown for player-specific announcements (in seconds)
Config.PlayerAnnounceCooldown = 20🔄 Automatic Announcement Configuration
-- Enable or disable automatic announcements
Config.EnableAutoAnnounces = true
-- Interval between automatic announcements (in seconds)
Config.AutoAnnounceInterval = 6000
-- List of automatic announcement messages
Config.AutoAnnounces = {
{message = "Welcome to our server! Have fun playing.", type = "info", duration = 8000},
{message = "Visit our Discord server for more information.", type = "info", duration = 6000},
{message = "Need help? Contact an admin with /report.", type = "warning", duration = 7000},
{message = "Respect other players and follow the rules.", type = "error", duration = 9000},
{message = "Don't forget to read our server rules!", type = "success", duration = 5000},
}🔒 Admin Permissions Configuration
-- Admin groups that can send announcements to ALL players
Config.AdminAnnounceAllPerms = {
['superadmin'] = true,
['admin'] = true,
['moderator'] = true,
['supporter'] = true
}
-- Admin groups that can send announcements ONLY to team members
Config.AdminAnnounceTeamPerms = {
['superadmin'] = true,
['admin'] = true,
['moderator'] = true,
['supporter'] = true
}
-- Admin groups that can send announcements to specific players
Config.AdminAnnouncePlayerPerms = {
['superadmin'] = true,
['admin'] = true,
['moderator'] = true,
['supporter'] = true
}👮♂️ Job Announcements Configuration
-- Jobs that can send announcements to all players
Config.JobsWithAnnouncePerms = {
['police'] = true,
['ambulance'] = true,
['mechanic'] = true,
['taxi'] = true,
['reporter'] = true,
}
-- Jobs that are primarily intended for internal communication
Config.JobsWithInternalAnnounce = {
['police'] = true,
['ambulance'] = true,
['mechanic'] = true,
['taxi'] = true,
['reporter'] = true,
}
-- Minimum job ranks required for public announcements
Config.JobAnnounceLevels = {
['police'] = 3, -- From rank 3 (e.g., Sergeant)
['ambulance'] = 2, -- From rank 2 (e.g., Paramedic)
['mechanic'] = 1, -- Any mechanic
['taxi'] = 2, -- Only taxi managers (rank 2)
['reporter'] = 3, -- Only senior reporters
}
-- Minimum job ranks required for internal announcements
Config.JobInternalAnnounceLevels = {
['police'] = 2, -- From rank 2 (e.g., Officer)
['ambulance'] = 1, -- Any medic
['mechanic'] = 0, -- Any mechanic
['taxi'] = 1, -- Taxi drivers from rank 1
['reporter'] = 1, -- Reporters from rank 1
}🔄 TxAdmin Integration
-- Enable or disable TxAdmin integration
Config.EnableTxAdminIntegration = true
-- Configuration for displaying TxAdmin announcements
Config.TxAdminConfig = {
-- General TxAdmin announcement configuration
announce = {
enabled = true, -- Enable/disable TxAdmin general announcements
prefix = "[TXADMIN]", -- Prefix for TxAdmin announcements
duration = 10000, -- Display duration in milliseconds
},
-- Restart announcement configuration
scheduledRestart = {
enabled = true, -- Enable/disable TxAdmin restart announcements
prefix = "[SERVER RESTART]", -- Prefix for restart announcements
duration = 12000, -- Display duration in milliseconds
showCountdown = true, -- Whether to show countdown in the message
message = "Server will restart in %d minutes" -- Message format for restart announcement
},
-- Warning announcement configuration
warnings = {
enabled = true, -- Enable/disable TxAdmin warning announcements
prefix = "[ADMIN WARNING]", -- Prefix for warning announcements
duration = 15000, -- Display duration in milliseconds
message = "You have been warned by %s. Reason: %s", -- Format for the warning message (admin, reason) - direct to player
staffMessage = "Player %s was warned by %s. Reason: %s", -- Format for staff notification
notifyStaff = true -- Whether to notify all staff members about warnings
},
-- Direct message configuration
directMessage = {
enabled = true, -- Enable/disable TxAdmin direct messages
prefix = "[ADMIN DM]", -- Prefix for direct messages
duration = 10000, -- Display duration in milliseconds
notifyStaff = true, -- Whether to notify all staff members about direct messages
message = "%s", -- Format for direct message to player (just the message)
staffMessage = "Admin %s sent DM to %s: %s" -- Format for staff notification (sender, target, message)
}
}📤 Discord Logging
Config.DiscordLogs = {
enabled = false, -- Enables/Disables Discord logging in general
forceDisableIfNoHTTP = false, -- Don't touch
-- Discord Webhook URLs for different announcement types
webhooks = {
admin = "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE", -- Admin announcements to all
team = "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE", -- Team-internal announcements
player = "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE", -- Player-specific announcements
job = "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE", -- Job announcements to all
jobInternal = "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE", -- Job-internal announcements
auto = "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE", -- Automatic announcements
txadmin = "https://discord.com/api/webhooks/YOUR_WEBHOOK_HERE" -- TxAdmin announcements
},
-- Bot name displayed in Discord
botName = "X_HUD_Announce",
-- Avatar URL for the bot (optional)
botAvatar = "https://i.imgur.com/.png", -- URL to an image for the bot avatar
-- Embed colors for different message types (decimal value of the color)
colors = {
admin = 15105570, -- Orange
team = 16727113, -- Red
player = 16766720, -- Gold
job = 3447003, -- Blue
jobInternal = 2067276, -- Dark Blue
auto = 5763719, -- Green
txadmin = 10181046, -- Purple
-- Colors for different notification types
info = 3447003, -- Blue
success = 5763719, -- Green
error = 15548997, -- Red
warning = 16776960 -- Yellow
},
-- General settings
serverName = "Your Server Name", -- Name of the server displayed in logs
includeTimestamp = true, -- Add timestamp to embed
-- Content displayed in logs
logContent = {
showPlayerId = true, -- Shows player ID in logs
showPlayerIdentifiers = false, -- Shows player identifiers (steam, license, etc.) in logs
includeType = true -- Shows the type of announcement in the log
}
}🎨 Notification Appearance and Styles
Notification Types
Config.notificationTypes = {
'info': {
accentColor: '#3498db', -- Blue
icon: {
fontawesome: 'fas fa-info-circle',
ionicons: 'information-circle'
}
},
'success': {
accentColor: '#2ecc71', -- Green
icon: {
fontawesome: 'fas fa-check-circle',
ionicons: 'checkmark-circle'
}
},
'error': {
accentColor: '#e74c3c', -- Red
icon: {
fontawesome: 'fas fa-times-circle',
ionicons: 'close-circle'
}
},
'warning': {
accentColor: '#f39c12', -- Orange
icon: {
fontawesome: 'fas fa-exclamation-triangle',
ionicons: 'warning'
}
},
'default': {
accentColor: '#7f8c8d', -- Light Grey
icon: {
fontawesome: 'fas fa-bell',
ionicons: 'notifications'
}
},
'txadminrestart': {
accentColor: '#c0392b', -- Darker Red for restart warnings
icon: {
fontawesome: 'fas fa-power-off',
ionicons: 'power'
}
},
'txadminwarning': {
accentColor: '#d35400', -- Dark Orange for admin warnings
icon: {
fontawesome: 'fas fa-exclamation-circle',
ionicons: 'alert-circle'
}
},
'txadmindm': {
accentColor: '#8e44ad', -- Purple for direct messages
icon: {
fontawesome: 'fas fa-comment',
ionicons: 'chatbubble-ellipses'
}
},
'txadminannounce': {
accentColor: '#2980b9', -- Blue for general TxAdmin announcements
icon: {
fontawesome: 'fas fa-bullhorn',
ionicons: 'megaphone'
}
},
'police': {
accentColor: '#1a237e', -- Dark Blue
icon: {
fontawesome: 'fas fa-shield-alt',
ionicons: 'shield'
}
},
'ambulance': {
accentColor: '#b71c1c', -- Dark Red
icon: {
fontawesome: 'fas fa-ambulance',
ionicons: 'medkit'
}
},
'mechanic': {
accentColor: '#424242', -- Dark Grey
icon: {
fontawesome: 'fas fa-wrench',
ionicons: 'construct'
}
}
}Sound Settings
Config.sound = {
enabled = true, -- Enable or disable notification sounds
volume = 0.5, -- Volume from 0.0 to 1.0
sounds = {
'adminannounce': 'sound1.mp3', -- Sound for admin public announcements
'admininternal': 'sound2.mp3', -- Sound for admin internal team announcements
'jobannounce': 'sound1.mp3', -- Sound for job public announcements
'jobinternal': 'sound2.mp3', -- Sound for job internal announcements
'playerannounce': 'sound3.mp3', -- Sound for player-specific announcements
'txadmin': 'sound4.mp3', -- Sound for TxAdmin announcements
'txadminrestart': 'sound5.mp3', -- Sound for TxAdmin restart announcements
'txadminwarning': 'sound5.mp3', -- Sound for TxAdmin warning announcements
'txadmindm': 'sound5.mp3', -- Sound for TxAdmin direct messages
'autoannounce': 'sound1.mp3', -- Sound for automatic server announcements
'announce': 'sound1.mp3', -- Sound for general announcements (fallback)
'notification': 'sound5.mp3' -- Sound for normal notifications (fallback)
}
}🔄 Feature Toggles
Config.Features = {
adminAnnounce = true, -- Admin announcements to all players
adminInternalAnnounce = true, -- Admin announcements only for team members
jobAnnounce = true, -- Job announcements to all players
jobInternalAnnounce = true, -- Job announcements only for members of the same job
autoAnnounce = true, -- Automatic announcements
txAdminIntegration = true, -- TxAdmin integration
testCommand = true, -- Test command for displaying different message types
showAdminName = true, -- Shows the admin's name in admin announcements
showAdminGroup = true, -- Shows the admin's group in admin announcements
useRoleplayNames = true -- Uses RP names instead of Steam names in job announcements
}📊 Notification Duration
Config.AdminDuration = 7000 -- Display duration for admin announcements
Config.TeamDuration = 6000 -- Display duration for team announcements
Config.PlayerDuration = 10000 -- Display duration for player-specific announcements📊 Notification Prefixes
-- Prefix for admin announcements to all players
Config.GetAdminPrefix = function(adminName, adminGroup, showName, showGroup)
local prefix = "[ADMIN"
if showGroup then
prefix = prefix .. " " .. adminGroup:upper()
end
if showName then
prefix = prefix .. ": " .. adminName
end
prefix = prefix .. "]"
return prefix
end
-- Prefix for admin announcements to team members
Config.GetTeamPrefix = function(adminName, adminGroup)
return "[TEAM INTERNAL " .. adminGroup:upper() .. ": " .. adminName .. "]"
end
-- Prefix for admin announcements to specific players
Config.GetPlayerAnnouncePrefix = function(adminName, adminGroup, showName, showGroup)
local prefix = "[ADMIN"
if showGroup then
prefix = prefix .. " " .. adminGroup:upper()
end
if showName then
prefix = prefix .. ": " .. adminName
end
prefix = prefix .. " → YOU]"
returnLast updated