Configuration guide

Name Flip & Role Colours

Make up to 25 members' names flip back and forth, and make a role cycle through colours. This page covers every setting, the speed limits and the permissions the bot needs.

Time
10 minutes
You need
Staff role (Discord) or Manage Server (website)
Applies to
Per Discord server

Overview

Two features share one page:

  • Name Flip switches up to 25 members' server nicknames back and forth with a second name you choose. For example ItsRexxys flips to Owner and back.
  • Role Colours makes one role cycle through a list of colours, so everyone wearing it changes colour.

Both start off. The page and the commands share one database, so a change in either place shows in the other within seconds.

Setup & Configuration

On the website
  • Log in to the RustyWorks website, open Servers Configure, pick your server and select Name Flip & Role Colours.
  • Name Flip tab: search for a member (or paste their user ID), type the second name and press Add. Switch Name Flip on at the top.
  • Role Colours tab: pick a role, enter your colours and speed, then switch it on.
  • Press Save changes. The preview on the right shows what will happen, and nothing is sent to Discord until you save.
In Discord
  • /nameflip add, /nameflip remove, /nameflip list, /nameflip start, /nameflip stop and /nameflip speed.
  • /rolecolor set, /rolecolor colors, /rolecolor speed, /rolecolor start, /rolecolor stop and /rolecolor status.

Name Flip

Setting What it does Limits
People The members whose names flip Up to 25 per server
Second name The name each person switches to One per person. Type it before you press Add
Speed How often names switch 5 to 60 seconds
Remove Takes someone off the list and puts their original name back If you remove without restoring, their name is not put back. Use that only if the bot cannot reach them
  • The member's original nickname is saved when you add them, and restored when you remove them or switch Name Flip off.
  • People who leave, are kicked or are banned are removed automatically.
  • The server owner's nickname can never be changed by a bot, so the owner cannot be added.

Role Colours

Setting What it does Limits
Role The role whose colour cycles One role. If the role is deleted the feature switches itself off
Colours The colours it cycles through 2 to 20. Type names such as red, pink, orange or hex codes such as #ff9900
Speed How often the colour changes 15 to 600 seconds
  • The old colour is put back when you switch it off or choose a different role.
  • Members only see the cycling colour if it is their highest coloured role.

Discord's speed limit

The bot can send only about one nickname edit every 1.2 seconds per server. So the real speed per person is the larger of your interval and (people x 1.2 seconds). With 25 people that is about 30 seconds. The page works this out for you and shows the real speed.

Permissions

Permission Needed for
Manage Nicknames Name Flip
Manage Roles Role Colours
A top role above everyone on the list and above the colour role Both. It cannot be an integration role

Troubleshooting

Problem Cause Fix
"The bot is missing the Manage Nicknames permission" The bot's role lacks it Add it to the bot's role in Discord
"The bot is missing the Manage Roles permission" The bot's role lacks it Add it to the bot's role in Discord
A name will not change The member is the server owner, or has a role above the bot's Move the bot's top role higher. The owner's name can never be changed
"Name refused" or "Not in server" next to a person They left the server, or Discord refused the name Remove them and add them again
The flip is slower than I set Discord's limit of one edit per 1.2 seconds Reduce the number of people, or raise the interval
"Discord asked the bot to slow down" Discord's own rate limit Nothing to do. It carries on by itself
"Bot not responding" The bot is offline. Your settings are safe and apply when it returns Wait, or check the bot is online
Role Colours is "stuck" The role cannot be edited, for example it is above the bot's role Move the bot's role above it

Every flip appears in the Audit Log.

Checked against RustyWorks on 29 Oct 2026.

Stuck on this step?

Tell us which setting you are on and what the bot said, and paste a screenshot if you can. Staff in the support Discord can usually fix it in a minute.