Configuration
All configuration options for legacy-reports
All options are set in config.lua.
General#
| Option | Type | Default | Description |
|---|---|---|---|
Config.Version | string | '1.0.0' | Resource version (used by the automatic version checker) |
Config.Locale | string | 'en' | Language file from the locales/ folder |
Config.Debug | boolean | false | Enable debug logging in the server console |
The UI accent color is now configured globally in legacy-lib. See the Legacy Lib Configuration page.
Permissions#
| Option | Type | Default | Description |
|---|---|---|---|
Config.AdminGroups | table | {'god', 'admin', 'mod', 'superadmin'} | ACE permission groups with admin access to the report panel |
Admin access is also granted to anyone who passes the framework's built-in admin check via legacy-lib.
Report Settings#
| Option | Type | Default | Description |
|---|---|---|---|
Config.MaxImages | number | 5 | Maximum number of image URLs allowed per report |
Config.MaxChatImages | number | 3 | Maximum number of image URLs allowed per chat message |
Config.ReportCooldown | number | 60 | Cooldown in seconds between creating reports (prevents spam) |
Priorities#
Report priorities with their display labels and colors:
Config.Priorities = {
{ id = 'low', label = 'Low', color = '#22C55E' },
{ id = 'medium', label = 'Medium', color = '#EAB308' },
{ id = 'high', label = 'High', color = '#F97316' },
{ id = 'critical', label = 'Critical', color = '#EF4444' },
}
| Priority | Color | Intended Use |
|---|---|---|
| Low | Green | Minor issues, general suggestions |
| Medium | Yellow | Standard reports needing attention |
| High | Orange | Urgent issues requiring prompt response |
| Critical | Red | Server-breaking bugs, active exploits |
Statuses#
Report statuses with their display labels and colors:
Config.Statuses = {
{ id = 'open', label = 'Open', color = '#3B82F6' },
{ id = 'claimed', label = 'Claimed', color = '#EAB308' },
{ id = 'in_progress', label = 'In Progress', color = '#F97316' },
{ id = 'resolved', label = 'Resolved', color = '#22C55E' },
{ id = 'closed', label = 'Closed', color = '#6B7280' },
}
| Status | Description |
|---|---|
| Open | Newly created, no admin has claimed it yet |
| Claimed | An admin has claimed the report and is reviewing it |
| In Progress | Admin is actively working on the issue |
| Resolved | The issue has been resolved |
| Closed | The report has been closed (no further action) |
Do not change the id values as they are used internally. You can freely customize label and color.
Report Types#
Report types are managed through the database (legacy_report_types table) and can be created, edited, or disabled through the admin panel. The default types seeded on first startup are:
| Type | Icon | Color |
|---|---|---|
| Player Report | user-x | #EF4444 |
| Bug Report | bug | #F97316 |
| Exploit Report | shield-alert | #EAB308 |
| Staff Report | flag | #8B5CF6 |
| Suggestion | lightbulb | #3B82F6 |
Types can be deactivated (soft-deleted) if they have existing reports, or fully deleted if no reports reference them.
Webhooks#
Discord webhook URLs for receiving notifications about report events. Leave a value as an empty string ('') to disable that webhook.
Config.Webhooks = {
ReportCreated = '', -- Fires when a player submits a new report
ReportClaimed = '', -- Fires when an admin claims a report
ReportClosed = '', -- Fires when a report is closed or resolved
ReportEscalated = '', -- Fires when a report is escalated to a higher priority
MessageSent = '', -- Fires when a message is sent in a report chat
AdminAction = '', -- Fires when an admin performs an action (delete, assign, etc.)
}
| Event | Description |
|---|---|
ReportCreated | Sent when a player submits a new report |
ReportClaimed | Sent when an admin claims an open report |
ReportClosed | Sent when a report is closed or resolved by an admin |
ReportEscalated | Sent when a report's priority is escalated to a higher level |
MessageSent | Sent when a message is posted in a report's chat (by either a player or admin) |
AdminAction | Sent when an admin performs an administrative action such as deleting a report or reassigning it |