Troubleshooting

You see

• Nothing happens
• I am not sure what is wrong

Why

Most problems are one of four things: a missing permission, a role in the wrong place, a game that is not connected, or a feature your plan does not include.

Fix it

1. Run /status in your Discord. It checks your games, your plan, the mod log and EzAdmin's own permissions, and says what needs attention.
2. Fix the first thing it lists, then run it again.
3. Still stuck? Search this page for the exact words of the message you see.

All commands →Contact support →

Copy a link to this fix

You see

• is at or above EzAdmin's own role
• sits above EzAdmin
• Missing Permissions
• EzAdmin cannot ban or give roles

Why

Discord never lets a bot manage a role that sits at or above its own role in the role list.

Fix it

1. Open Server Settings › Roles.
2. Drag the EzAdmin role above every role it should give, take or time out.
3. Try again. Nothing else needs changing.

Security: permissions →

Copy a link to this fix

You see

• has moderation or admin permissions
• Blueprints never give or take those
• Status roles never hand those out

Why

On purpose: automatic features (Blueprints, status roles, role items) never hand out a role that can ban, kick, manage roles or the server. A mistake there could give a stranger your server.

Fix it

1. Pick a role without Administrator, Manage Server, Manage Roles, Manage Channels, Ban, Kick, Timeout, Manage Messages, Manage Webhooks or Mention Everyone.
2. Or remove those permissions from the role if it does not need them.

How permissions work →

Copy a link to this fix

You see

• Not allowed
• You need the

Why

Every EzAdmin action has its own permission. Discord's Administrator does not unlock the elevated ones, so a moderator only gets what they were given.

Fix it

1. The reply names the permission they need.
2. The server owner grants it with /permissions grant, to a role or to one person.
3. On the dashboard: Team shows who has what.

Permission list →

Copy a link to this fix

You see

• No commands when I type /
• The command is missing

Why

Discord can take a minute to show commands after the bot joins.

Fix it

1. Wait a minute, then restart Discord (Ctrl+R on desktop).
2. Make sure you added the EzAdmin bot for Unity, which has the Unity commands.
3. Check the bot's role can see the channel, and that Use Application Commands is allowed there.

Pick your game →Command reference →

Copy a link to this fix

You see

• needs the Presence Intent
• Discord status needs the Presence Intent
• staff online

Why

Discord only tells bots who is online when the bot has the privileged Presence Intent switched on.

Fix it

1. In the Discord Developer Portal, open each EzAdmin bot's application.
2. Bot › Privileged Gateway Intents: switch on Presence Intent.
3. Then set EZADMIN_PRESENCE_INTENT=1 and restart the bots. Do this after step 2, or the bots will not start.

Blueprints →

Copy a link to this fix

You see

• PrivilegedIntentsRequired
• SERVER MEMBERS INTENT

Why

EzAdmin needs the Server Members Intent to see who joins and to give roles.

Fix it

1. Developer Portal › your bot › Bot › Privileged Gateway Intents.
2. Switch on Server Members Intent, save, and start the bot again.

Security →

Copy a link to this fix

You see

• In game role never given
• Not playing role stays

Why

Only linked members can count as in game, and EzAdmin swaps roles once a minute.

Fix it

1. Run /status-roles show: it shows the setup and how many linked members are in game.
2. Members link their game account with /link.
3. Drag the EzAdmin role above both status roles.
4. Status roles are a Plus and Studio feature.

Game Control →

Copy a link to this fix

You see

• CS0246
• The type or namespace name 'PlayFab' could not be found

Why

EzAdmin's Unity scripts talk to PlayFab through PlayFab's own Unity SDK. Either the SDK is not in the project, or Assets/EzAdmin sits inside a folder with its own .asmdef that does not reference PlayFab.

Fix it

1. No PlayFab SDK yet: download PlayFabSDK.unitypackage from PlayFab's Unity SDK releases on GitHub, then Assets › Import Package › Custom Package and Import.
2. SDK already there: check whether Assets/EzAdmin is inside a folder with an .asmdef. Move EzAdmin out of it, or add PlayFab to that assembly definition's references.
3. Wait for Unity to compile. The error goes away.

Unity setup: download →

Copy a link to this fix

You see

• CS0101
• already contains a definition for 'EzAdminNewsPost'
• CS0111

Why

An older EzAdmin package had a file called EzAdminLiveOps.cs. Its contents moved to EzAdminGame.cs, so a project updated by hand can have both.

Fix it

1. Delete Assets/EzAdmin/Runtime/EzAdminLiveOps.cs.
2. Or import the newest package: it replaces that file with an empty one by itself.

Unity setup: download →

Copy a link to this fix

You see

• Unity is blocking the plain http://
• Insecure connection not allowed

Why

Unity refuses http:// addresses unless you allow them. Real players should always reach EzAdmin over https://.

Fix it

1. Set EzAdminClient's address to your https:// address.
2. Only while testing on your own PC: Project Settings › Player › Other Settings › Allow downloads over HTTP › Always allowed.

Unity setup →

Copy a link to this fix

You see

• Cannot reach EzAdmin at
• Is EzAdmin running, and is the address right?
• localhost only works on the PC

Why

The game cannot connect to the address on EzAdminClient. On a headset or phone, localhost means the device itself, not your PC.

Fix it

1. Check EzAdmin is running and the address on EzAdminClient is exactly the one /playfab discord-app shows in Discord.
2. On a headset or phone use your online (https) address, or your PC's network address while testing on the same WiFi.
3. Open the address in a browser on the same device: you should see the EzAdmin site.

Unity setup →

Copy a link to this fix

You see

• there is no Title ID
• No Title ID

Why

PlayFab's SDK needs your title id in PlayFabSharedSettings before anything can sign in.

Fix it

1. In the Project window, search for PlayFabSharedSettings.
2. Type your Title ID (Game Manager › your title › the id under its name).
3. Press Play again.

Unity setup →

Copy a link to this fix

You see

• refused EzAdmin's sign in
• not authorized
• only lets your game's own login sign players in

Why

Your title only allows your game's own login method, so EzAdmin's fallback device sign in is refused.

Fix it

1. On EzAdminClient, turn Sign In If Needed off.
2. Put EzAdmin in the scene where your own login runs. EzAdmin then uses that signed in player.
3. Or run Tools › EzAdmin › Setup Wizard and pick My game signs players in.

Unity setup →

Copy a link to this fix

You see

• your game's own login has not finished
• Not signed in to PlayFab yet

Why

EzAdmin waits for your login. If it never finishes (or your game has no login), EzAdmin has no player to use.

Fix it

1. Check the Console for a PlayFab sign in error from your own code.
2. If your game has no login, turn Sign In If Needed on so EzAdmin signs players in itself.

Unity setup →

Copy a link to this fix

You see

• EzAdmin refused this game
• not on this server's plan

Why

The PlayFab title is not connected to a Discord server, or that server's plan does not cover this game.

Fix it

1. In Discord, run /setup on the server for this game and connect your PlayFab title.
2. Run /status to check the game shows as connected.
3. A game can be connected to one Discord server only.

Unity setup →Plans →

Copy a link to this fix

You see

• a player
• player ••••
• {player_name} is empty

Why

Your game does not send a name, and the player has no PlayFab display name. EzAdmin never shows a PlayFab ID instead: it is private.

Fix it

1. Set a display name when players sign in: PlayFabClientAPI.UpdateUserTitleDisplayName.
2. EzAdmin picks it up by itself from then on.

Developer reference: Unity →

Copy a link to this fix

You see

• Link code does nothing
• EzAdminRedeemLinkCode
• Function not found

Why

EzAdmin's CloudScript is not deployed to your PlayFab title, so the game's calls go nowhere.

Fix it

1. Open PlayFab Game Manager › Automation › CloudScript.
2. Paste EzAdmin.CloudScript.js (in the zip, and under Files on the setup guide), then Save and deploy.
3. Have the player link again with /link.

Unity setup: files →CloudScript reference →

Copy a link to this fix

You see

• The player did not get the item
• has not linked

Why

Items reach a game account through the player's link. Without a link EzAdmin cannot know whose account it is.

Fix it

1. The player links first with /link.
2. Then run /role-item sync for that member.
3. Still nothing: run /status. It says when EzAdmin cannot reach the game or give that item.

How items reach players →

Copy a link to this fix

You see

• Blueprints come with every paid plan
• blueprints on your plan are in use

Why

Blueprints come with every paid plan, and each plan allows a number of them.

Fix it

1. On the free plan? Upgrade the server to Plus or above.
2. All in use? Change one you have: each blueprint can hold up to 24 nodes, and a Sequence node lets one event do several things. Or upgrade: Studio and Enterprise allow many more.

Blueprints →Plans →

Copy a link to this fix

You see

• Ran 0 times
• Never
• I do not get the message

Why

Usually the game reports to a different Discord server than the one the blueprint is on, the blueprint is switched off, or the server is not on Studio.

Fix it

1. Make sure the blueprint is on the same server your game is connected to. A game connected on two servers reports to only one of them.
2. Check its switch is on, on the Blueprints tab.
3. Press Test run in the editor to see what it would do with sample values.
4. Look at Last run under the blueprint: it says why a run stopped.

Blueprints →

Copy a link to this fix

You see

• the player has not linked their Discord account
• that member has left the server

Why

Messaging a player, giving a role or an item needs to know their Discord account, and that comes from linking.

Fix it

1. The player links in game or with /link, on the same Discord server.
2. For a test that needs no link, use Post in a channel instead.

Blueprints →

Copy a link to this fix

You see

• Paused to be safe
• already punished
• already started
• this hour

Why

A safety cap: blueprints may only kick, ban, mute, freeze or time out so many players an hour, so a mistake cannot empty your game.

Fix it

1. Check the blueprint's branch: is it catching more players than you meant?
2. Use Test run to see the path it takes.
3. The cap resets by itself within the hour.

Blueprint safety →

Copy a link to this fix

You see

• I do not see the update
• Could not take port
• Another EzAdmin copy is probably still running

Why

An older copy of the bot is still running and holding the website's port, or the browser kept an old copy.

Fix it

1. In EzAdmin Control press Stop all, then Start all.
2. Press Ctrl+F5 in the browser.
3. Use Build website in EzAdmin Control: it restarts bots whose code changed by itself.

Support →

Copy a link to this fix

You see

• Invalid OAuth2 redirect_uri
• Log in with Discord is OFF

Why

Discord only sends people back to addresses listed on the bot's application, and EzAdmin needs its client id and secret.

Fix it

1. Developer Portal › your app › OAuth2 › Redirects: add your address followed by /dashboard/callback.
2. Make sure EzAdmin's client id and secret are set (EzAdmin Control › Setup).
3. Restart the bots.

Dashboard →Security: dashboard →

Copy a link to this fix

You see

• is not empty and was not made by this script; refusing to clear it

Why

The build only ever clears a folder it made itself (it leaves a marker file), so it can never delete the wrong folder.

Fix it

1. Stop the bots (they may hold files open), then build again.
2. If the folder really is the website's dist folder, delete it and build again.

Support →

Copy a link to this fix

You see

• is a Plus and Studio feature
• part of the Studio plan
• Your plan allows

Why

Safety features are free on every plan. Scale and convenience features (economy, automation, bigger teams) come with Plus or Studio.

Fix it

1. See what each plan includes on the pricing page.
2. Upgrade with /upgrade in Discord, or on the dashboard's Plan page.

Compare plans →

Copy a link to this fix

You see

• Payment went through but still on Free
• My plan is missing

Why

A plan is applied when the payment provider tells EzAdmin about it. That is usually seconds, occasionally a few minutes.

Fix it

1. Run /subscription to see what EzAdmin has.
2. If it is still missing after a few minutes, run /redeem with the claim code from your receipt.
3. Still missing: open a Billing ticket with your receipt.

Support →Refunds →

Copy a link to this fix