Troubleshooting

What each message means and what to do about it, grouped by where you hit it. If nothing here matches, open a ticket in the FiveUnity Discord or email support@fiveunity.com; we reply within 24 hours.

#Signing in and the dashboard

#"No overlapping servers found"

There is no server that both you and FiveUnity are in where you hold Administrator or Manage Server.

Cause	Fix
The bot is not in that server	Press Add FiveUnity to a server.
You invited it to a different server	Repeat the invite and pick the right one.
You only have a staff role	Ask the owner for Administrator or Manage Server, either is enough.
You were just promoted, or just invited the bot	Press Refresh list.
Wrong Discord account	Sign out and back in with the account that manages the server.

#One server is missing from the list

The same three conditions are checked per server: the bot is in it, you are a member, and you have Administrator or Manage Server there. Opening a server you have lost access to gives "Administrator or Manage Server permission required." Permissions are read live from Discord on every request, so a role change applies at once. Press Refresh list if the card has not appeared.

#"Could not reach the bot API"

On our side, not yours. Nothing in your server or settings causes it and nothing is lost. Press Try again; if it lasts more than a few minutes, tell us in the FiveUnity Discord.

#Changes are not saving

Message	What to do
"This server does not have an active FiveUnity subscription. Open the Billing tab to reactivate."	The plan lapsed, so anything that reaches into Discord (creating channels, roles, webhooks or panels, posting, granting roles, rotating FiveM keys, restoring backups) is refused. Renew on Billing. Editing settings still works.
"AI Assistant is a PRO feature… changes will not save."	AI settings need Pro. Upgrade on Billing.
A red message naming a field	Validation. The message says exactly what is wrong, for example "Server IP must be a hostname or IP, optionally with a port." Fix that field and save.

Note

A renewal can take up to a minute to register. Wait a moment before assuming it failed.

#Discord

#Commands are missing, duplicated, or out of date

Discord caches your command list, so it needs a nudge after changes.

Symptom	Fix
No FiveUnity commands at all	Run `/refresh`, or press Re-sync slash commands under Dashboard → Server setup → Slash commands. Then reload Discord with `Ctrl+R`.
Every command appears twice	The same re-sync, then reload Discord.
Setup commands vanished	The hide-setup-commands toggle is on. Turn it off under Slash commands and re-sync.
A member cannot see a command	Grant their role under Dashboard → Server setup → Permissions, or check Server Settings → Integrations.
"Slash commands were re-synced less than a minute ago."	Re-sync is limited to once a minute. Wait and try again.

#The bot says something is turned off

Reply	What it means
"⛔ `/name` is turned off on this server."	Disabled under Dashboard → Server setup → Slash commands.
"⛔ `/name` can only be used in #channel."	A channel allowlist on that same page.
"⛔ Polls / Giveaways / The translator are turned off for this server."	The module is off under Server setup → Modules.
"⛔ You do not have permission to use this command."	Your roles are not in a permission group that grants it.

#"My highest role must be above @Role"

Discord's role hierarchy. FiveUnity can only manage roles below its own, and only moderate members whose highest role is below its own. Drag the FiveUnity role near the top of Server Settings → Roles.

Same root cause, different wording: "I am missing the Manage Roles permission.", "⚠️ Could not give @Role (check role hierarchy/permissions)." on an accepted application, and "Please check my permissions and role hierarchy." on a failed ban.

Warning

Auto-moderation fails silently when hierarchy blocks it: the member sees nothing and the attempt only shows in your log channel. If auto-mod seems to ignore certain people, check where their roles sit.

#Nothing arrives in a log channel

Check the channel still exists, that a log channel is set for that feature, and that FiveUnity can View Channel, Send Messages and Embed Links there. A channel-level override that denies the bot beats the server-wide permission, so check the channel's own permissions too.

#"This server does not have an active FiveUnity subscription"

The plan lapsed, so commands, buttons, drop-downs and modals all refuse. /subscription and /redeem keep working so you can reactivate from Discord. Nothing is deleted. See Plans and billing.

#Tickets

Symptom	Cause and fix
"❌ Failed to create ticket channel (Name collision or Permissions)."	FiveUnity cannot create the channel: usually a missing Manage Channels permission, or a full category (Discord allows 50 channels per category). Grant the permission, clear out old tickets, or point the panel at a second category.
"❌ Could not find or create a ticket category. Check bot permissions."	The same problem one level up. Grant Manage Channels, or create the category yourself and select it in the panel.
"You already have N open tickets (limit N)"	The member is at Max open tickets per member (default 5). Close one, raise the limit in the dashboard, or a moderator runs `/ticket-reset` on them.
"That ticket type is no longer available on this panel. Ask staff to refresh it."	The panel message is older than the panel's settings. Republish it from Dashboard → Support desk → Tickets.
"⚠️ Transcript: Generation Failed" in the close log	The transcript could not be built. The ticket still closes normally; tell us if it repeats.
A member never got their transcript	Transcript DMs are off, or they block DMs from server members. Turn on DM transcripts under Tickets. The link in your log channel always works.
An old transcript link no longer opens	Links are signed and expire after 30 days. Save anything you need to keep at the time.

#FiveM

Message	Cause and fix
"Unauthorized: Invalid Bridge Token"	The key in FiveUnity does not match the one on your game server. Make them identical and restart the bridge resource.
"Server Configuration Error: Token not set"	No bridge token on the game server. Set it and restart the resource.
"Endpoint Not Found", or "Ensure 'fivem-api-resource' is running and updated."	The command needs an endpoint your copy of the resource does not have, an older or edited build. Reinstall the current bridge resource and restart it.
"Security Audit Failed: No Audit Log Channel configured. Integration blocked."	Every in-game action is blocked until a FiveM log channel exists, so the audit trail cannot be bypassed. Set one under Dashboard → Roleplay → FiveM.
"FiveM server address resolves to a private or blocked range."	The address points at a private or LAN network. Use a public address, or switch on Allow private / LAN addresses if that is deliberate.
"FiveM Integration is not configured." / "FiveM not configured."	No address or bridge key saved. Fill both in under Roleplay → FiveM and press Test bridge: a working bridge replies "Bridge reachable."
"Player not found (Offline?)"	The player is offline, or their Discord is not linked in game.
The status embed never changes	It refreshes about once a minute and needs its original message intact. Check the address and port, that the server answers publicly, and that nobody deleted the status message.
"Invalid txAdmin credentials."	Re-enter the txAdmin username and password under FiveM → txAdmin.
"Received HTML response (likely login page) instead of JSON."	The txAdmin URL points at the web interface login page. Use the txAdmin address itself, with no page path.
"No linked FiveM account found for Discord ID …"	That player has never joined, so there are no identifiers to ban. They must connect once first.

#AI Assistant

The AI Assistant needs the Pro plan and your own Google Gemini key.

Message	Cause and fix
"Accept the AI data-use terms before enabling features that read ticket content."	Go to Dashboard → Support desk → AI Assistant → Data-use consent → Review and accept. An administrator has to do it.
"This Gemini API key was rejected. Re-enter it on the dashboard."	Wrong or revoked key. Paste a fresh one and press Test connection.
"That key has no access to the Generative Language API."	Enable that API on your Google project, then test again.
"That Gemini model is not available for this key."	Pick another model: the free tier covers the Flash models.
"Gemini free-tier quota reached."	Google's own limit. Wait the stated time; the bot backs off and resumes by itself.
"This server has used its daily AI budget. It resets at midnight UTC."	Raise the cap under Limits, or wait for the reset.
"You are asking too quickly. Give it a moment."	The per-member cooldown, 30 seconds by default. Adjust it under Limits.