Troubleshooting & FAQ

Troubleshooting & FAQ

Something not working? Start here. Find your problem, try the fix, and ask in our Discord if you are still stuck.

My bot is offline

  • The black window must stay open, and the computer must be on. Or use a bot host.
  • Check the secret key in my-secrets.txt. Did you copy all of it? It is very long (about 70 letters).
  • If you pressed Reset Token again, the old key stopped working. Copy the new one.
  • Look for a red line in the black window. It explains the problem in plain words.

My bot does not see messages

Switch on Message Content Intent on the developer page: your app, Bot, Privileged Gateway Intents, then press Save Changes. Restart the bot.

My /command does not show up

  • Wait a few minutes, or restart Discord (Ctrl+R).
  • Put your test server’s ID in Bot settings and your /commands appear instantly in that server.
  • Make sure the bot was added with the applications.commands permission. Using the invite button on Finish & host does this for you.

“I am not allowed to do that”

The bot is missing a power. Drag the bot’s role higher in Server Settings, Roles (above any role it should give out) and give it the power in the invite step.

Nothing happens when I use a block

  • Look for a line in the black window. It explains the problem.
  • Check the event’s ONLY IF blocks. All of them must be true.
  • On the Blocks page look at Smart tips and the warning signs on folded events.
  • Is the event or its group switched off?

Connect says the server list is empty

  • The bot is not in any server yet. Invite it first from Finish & host, step 3. It must be a member. Being online is not enough.
  • If channels and roles load but people do not, switch on Server Members Intent, press Save, then press Refresh on My server.
  • In a browser, turn off VPNs and ad-blockers for the page, or use the desktop app, which has no browser limits.

My image is blurred, or does not show in Discord

Cubevate only hands your picture link to Discord. Discord’s own servers then fetch the picture. A blurred grey placeholder, or no picture at all, means Discord could not get the file. This is almost always the website the picture is on, not Cubevate.

  • Paste the link into a normal Discord message first. If no picture shows there either, the host is the problem.
  • Use a direct link that ends in .png, .jpg or .gif, not a link to a web page that shows the picture.
  • Some free image hosts block or slow down Discord. Try another host, or your own website.
  • Keep pictures modest, under about 5 MB. Resizing a huge picture helps.
  • Links from Discord’s own file uploads stop working after a while, so they are not good for a bot that runs for a long time.

The preview shows grey boxes instead of pictures

That is on purpose, for your privacy. To see them, press the picture button on the preview, or switch on Show pictures in previews in Settings. Only links that start with https:// are loaded. They show up normally in Discord either way.

“There is no message here to use.”

A block like Delete a message was told to use the message that woke the bot up, but there is none (a /command, button or timer has no message). Send a message first and use the one the bot just sent, or use the Delete this message by itself after (seconds) option on the message block itself.

Cubevate asks for my secret key again

Cubevate only remembers your key if Remember my bot’s secret key is ticked (Settings, Safety & privacy, or on the My server page). With it off, the key is forgotten when you close Cubevate. That is the safe default.

My bot forgets things when it restarts

Your memory boxes need a place to live. Open Bot data and choose one. Many free hosts erase files at every restart. If yours does, choose a cloud database. Use the test-storage checker in your download to make sure it works.

“Cannot find module ‘discord.js’”

The host started your bot without installing its helpers. The newest download installs them by itself on the first start, so download your bot again and replace bot.js. Or run npm install on the host first.

The host says index.js is missing

Your host is set to start index.js. Upload the index.js from the newest download, or change the host’s startup file to bot.js.

The Dashboard cannot reach my bot

  • The address must start with http://, followed by the host’s address and the port from its Network or Ports page.
  • Put DASHBOARD_KEY on the host (Environment tab or my-secrets.txt) and restart. The console says Dashboard link is on (port …) when it works.
  • Use a bot downloaded after you switched the dashboard on. Some hosts keep ports closed. Ask their support.

The quick tools bar is gone

It may be switched off or tucked away. Turn it on in Settings or View, Quick tools bar. If it is tucked away, click the small round button at the edge of the screen. Customize quick tools has a Back to normal button if you hid too many tools.

A quick tools shortcut says it is gone

The thing it pointed to was deleted or renamed (an event, a group, a Live page or a draft). Open the customize window and delete the old shortcut, then add a new one by right-clicking the thing.

My temporary voice rooms do not disappear

Use the newest version. Rooms your bot makes are removed when the last person leaves, even in Pretend mode. Make sure the bot has the Manage Channels power.

Questions people ask

Who makes Cubevate, and how can I support it?

Cubevate is made by Cubefem. If it helps you, you can support it on Ko-fi.

Do I need to know how to code?

No. Blocks read like sentences. If you do know JavaScript, there are code blocks and an Extra code box in Bot settings for your own code.

Where is my work saved?

Automatically on your own computer. Use Save (Ctrl+S) to make a file. File, Save a full backup saves everything in one file (without keys and IDs), and Settings, Data & backups has restore points.

Does Cubevate run my bot for me?

No. Cubevate builds the bot. You run it on your computer or a bot host. Live mode can run it for testing while Cubevate stays open.

How do I move Cubevate to another computer?

Use Export everything in Settings, Data & backups and Import everything on the other computer. A backup holds all your bots (blocks and boxes), but never your keys, so type each bot’s secret key in again.

How do I update to a new version?

Back up first (Export everything). Then run the new Cubevate-Setup.exe: it installs over the old version and keeps your bots and settings. Cubevate also tells you by itself when a new version is ready (a window called Update available).

Can I make more than one bot?

Yes. Use the bot switcher at the very top of the left menu, or open My bots to add, rename, copy or delete bots. Each bot keeps its own blocks, key, dashboard link and restore points.

I used the old version that ran from a folder. How do I keep my work?

Install the new version, then open Settings, Data & backups, Coming from the portable version? and press Bring in my old folder. Pick your old Cubevate-data folder. This only works in the desktop app, and it replaces what is in the new app, so do it first.

My YouTube feed says error 404, but the address is right.

That is on YouTube’s side. YouTube’s feed service is sometimes unreliable and can answer with errors like 404 even when the address is correct. It usually works again later. Cubevate shows a warning on the feed block and in the Dashboard Alerts tab. Nothing is wrong with your link.

The new Dashboard tabs say my bot is an older version.

The new tabs (Giveaways, Polls, Scheduled posts, Server stats, Scores & lists, Tickets, Mod log, Alerts and Health) need the newest bot code. In Cubevate open Finish & host, download your bot again and replace bot.js on your host, then restart it.

The Mod log is empty.

The bot needs the View Audit Log permission. In Discord open Server Settings, Roles, pick your bot’s role and turn on View Audit Log. The log fills from the moment the newest bot is running, so older bans and kicks do not appear.

Where did Help, Check for updates go?

It was removed. Cubevate checks quietly for a new version every time it opens, and you can still check by hand in Settings, Updates, Check now.

The Dashboard shows the channels of my other bot.

This was fixed in 1.6.0. Update Cubevate, then open the Dashboard again: each bot now shows only its own server, channels and roles. Also check that each bot has its own host address saved in Connection & help. If two bots use the same address, they talk to the same bot on that host.

Are my coins, shop and achievements included in a backup?

Yes. The Economy, Achievements and other Dashboard pages keep everything in your bot’s memory, and Backup & restore in the Dashboard saves that whole memory. Your blocks and templates are saved with Save my work in the app. The bot token and the Dashboard key are never part of a backup.

What is the Dashboard tip on a template or block?

Some things are easier on a Dashboard page than with blocks, for example welcome messages, giveaways, polls, coins and achievements. The tip tells you which page, and a button opens it. Your blocks keep working either way. You can switch the tips off in Settings.

How do I stop mods and staff from earning coins, XP, achievements or giveaway entries?

Open the matching Dashboard page and use its role list: Economy (Roles that never earn coins), Levels & XP (No XP for role), Achievements (Roles that cannot gain achievements) and Giveaways (Who cannot join). Pick the roles, press Save, and that is it. Giving things by hand still works for those roles. This needs the newest bot.js.

What do gwe, gww and the other boxes in Memory & data mean?

Hover the name of a box in Memory & data: known ones (like gwe for giveaways entered and gww for giveaways won) explain themselves. For boxes you made yourself, press Note and write what the box is for. The note shows when you hover the name and is saved in your backup. This needs the newest bot.js.

Where can I see all the commands of my bot?

Open Command Legend in the Dashboard and switch it on. Your bot then gets a /legend command that lists every command in groups. You can rename it, sort commands into your own categories, hide some and write your own explanation for each one. To switch commands off or limit them to roles, use the Command manager.

A new event block never wakes up.

The new events (time-out, pinned message, channel or role changed and so on) need a bot made with Cubevate 1.8.0. Download your bot again, replace bot.js on your host and restart it. AutoMod events also need the Manage Server permission. The “is changed” events skip changes your own bot made a moment ago, on purpose.

How do I wait for days, like a reminder or a timed ban?

Use Run a mini-program later. It starts one of your “My own mini-program” blocks after minutes, hours or days (up to a year) and is remembered when the bot restarts. Wait a bit stops at one hour and is forgotten on a restart.

One failing action stops the rest of my event.

Put If an action fails, keep going first. After it, a failing action (a missing role, closed private messages) is written to the log and the next one runs. The reason is in {temp.error}.

Can I use my own roles and channels in a template?

Yes. After you add a template, a card asks Use your own roles and channels?. Press it, fill in your names (or pick them from your server) and press Use these. Undo works if you change your mind.

I found a bug, or I have an idea.

Tell us in the Cubefem Discord. Say which version you use (Settings, Credits) and what you clicked.