Troubleshooting

"No admins online — file a Discord ticket instead"

This is intentional behavior when Config.RequireAdminOnline = true AND no players with Config.AllowedGroups ACE are connected. Either:

• Wait for an admin to log in
• Use the Discord link shown in the dialog
• Disable the gate: Config.RequireAdminOnline = false

Admin badge HUD doesn't appear

Three checks:

1. You have one of the ACE groups in Config.AllowedGroups
2. Config.AdminBadge is set to a style name (not false)
3. You have at least one pending report (badge auto-hides at 0)

Screenshot button missing / does nothing

• Config.Screenshot = true
• screenshot-basic is started in server.cfg
• Config.ScreenshotWebhook is a valid Discord webhook URL

If the button is there but uploads fail, paste the webhook URL in a browser. You should see a JSON response, not an error.

Revive button does nothing

Config.ReviveMethod doesn't match an installed resource. Verify the resource is actually started:

restart suty-ems     # or qbx_medical, wasabi_ambulance, etc.

For custom systems, double-check Config.ReviveCustom.resource matches the actual resource name and name matches an export or event.

Voice notes don't record

• screenshot-basic is unrelated — voice uses the browser's MediaRecorder API directly
• The player must accept the microphone permission prompt the first time
• Check Config.VoiceMaxDurationMs > 0

"Voice rate limit exceeded"

Config.VoiceRateLimitSec defaults to 2 seconds between notes per sender. Lower it if you want faster back-and-forth, or raise it to prevent voice-spam.

Collation / "Illegal mix of collations" error

The script's tables use utf8mb4_general_ci. If your DB defaults to utf8mb4_uca1400_ai_ci (MariaDB 10.10+), joins against players may fail. Convert the players table:

ALTER TABLE players CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;

Still stuck?

Discord — include your Config.Framework, Config.ReviveMethod, and the error from F8 / server console.