Fluxer bot permissions, channels & emoji setup

Most "the bot isn't working" reports come down to permissions, not bugs. Fluxer, like Discord, gives bots access through roles and per-channel overrides. This page walks through what the bot needs, in the order that fixes problems fastest.

Quick triage

  1. Run !help in a public channel (one with no special permissions). No reply? It is a permissions or invite issue, not the command.
  2. Still nothing? Temporarily grant the bot's role Administrator and try again. If it now works, a specific permission or channel override was the cause. Narrow it down below, then remove Administrator if you prefer least-privilege.
  3. Works in one channel but not another? That is a channel/category override. See Channels & overrides below.

Role permissions the bot needs

When you invite the bot, it comes with a role (named after the bot). That role must keep at least:

The Administrator invite on your bot page includes all of these. If you invited with a stripped-down link, the fastest fix is to re-invite with Administrator (it only adds missing permissions, it will not remove the bot).

Tip: keeping the bot's role above the roles it needs to manage matters for role rewards and moderation. Fluxer never lets a bot act on a role higher than its own.

Channels & overrides

A bot that has a permission at the server level can still be blocked in a specific channel. This is the single most common "it only works in #gen-chat" cause.

If you locked a channel to mods/staff only, the bot is not a mod. Add its role explicitly.

Emoji pack setup

Pluuty ships button/menu icons (music controls, help, Kick / Twitch / YouTube / Spotify) as custom emoji it uploads into one server you manage.

  1. Invite the bot with Administrator so Create Emojis & Stickers and Manage Emojis & Stickers are included.
  2. In a channel the bot can see, run !emojipack sync as the bot owner, server owner, or someone with Manage Server.
  3. Confirm with !emojipack status.

If sync reports a permission error, the two emoji/expression permissions are missing. Re-invite with Administrator (or toggle them on the bot's role) and run !emojipack sync again.

Command prefix (and DMs)

Changing the bot's name & avatar

This trips people up, so it is worth stating plainly:

Related