Admin-Tools
Simple tools for admins - move channels and roles via commands or copy an emoji from another server to your server.
Features
- Move channels and roles via commands.
- Set the category of a channel via commands.
- Import an emoji from another server into your server.
- Assign temporary roles to users that are automatically added or removed after a specified duration.
- Configure "always-temporary" roles that are automatically removed after a set duration whenever assigned to a user, regardless of how they were assigned.
- Configure "role bans" - roles that automatically ban users from the server when assigned. Users with "Manage Roles" permission are exempt.
Setup
- Please set up permissions for slash commands to avoid unauthorized usage.
- Make sure your bot has the following permissions on your server:
- To import emojis from another server (
/stealemote): "Create expressions" - To update any channels (all
/admincommands): "Manage channels" - To assign or remove roles (
/rolescommands): "Manage roles" (the bot's role must be above the target roles) - To ban users via role bans: "Ban Members"
- To import emojis from another server (
Usage
- To import an emoji from another server, use
/stealemote. - To view the position of a channel or update it, use
/admin movechannel. - To view the position of a role or update it, use
/admin moverole. - To update the category of a channel, use
/admin setcategory.
Commands
name:<Type> is an option of a slash-command with name name and the type Type. Options that not required, are described as [name:<Type>]. If the action of a command is vastly different between required and not-required options, we might list them separately.Examples
/moderate ban user:<Member>: This command (/moderate ban) has an required option with the name "user" that only accepts one member as a value./moderate ban victim:<Member> reason:<Text>: This command (/moderate ban) has an required option with the name "victim" that only accepts one member as a value and another required option with the name "reason" that accepts any text as an value./moderate ban victim:<Member> reason:<Text> [proof:<Attachment>]: This command (/moderate ban) has an required option with the name "victim" that only accepts one member as a value, another required option with the name "reason" that accepts any text as an value and a not-required option with the name "proof" which allows one attachment as its value.
| Command | Description |
|---|---|
/admin movechannel channel:<Channel> | Displays the API-Position of the specified channel. |
/admin movechannel channel:<Channel> new-position:<Number> | Moves the specified channel to the specified API-Position. |
/admin moverole role:<Role> | Display the API-Position of the specified role. |
/admin moverole role:<Role> new-position:<Number> | Moves the specified role to the specified API-Position. |
/admin setcategory channel:<Channel> category:<Category> | Updates the category of the specified channel to the specified category. |
/stealemote emote:<Emoji> | Copies an emote from another server to your server. |
/roles give user:<User> role:<Role> [duration:<Duration>] | Assigns a role to a user. Optionally specify a duration after which the role will be removed automatically. |
/roles remove user:<User> role:<Role> [duration:<Duration>] | Removes a role from a user. Optionally specify a duration after which the role will be re-added automatically. |
/roles status user:<User> | Shows all pending temporary role changes for a user. |
Configuration
Always-Temporary Roles
This configuration allows you to define roles that should always be temporary. Whenever a user receives one of these roles - whether assigned manually, by a command, or by another bot - it will automatically be removed after the configured duration.
Open it in your dashboard.
| Field | Description |
|---|---|
| Role | The role that should always be temporary. When a user receives this role, it will be automatically removed after the configured duration. |
| Duration | How long the role should last before being automatically removed. Use the duration format (e.g., 24h, 7d, 30m). Minimum: 20 seconds. |
If a user receives the same always-temporary role again before it expires, the previous timer is replaced with a new one.
Role Bans
This configuration allows you to define roles that automatically ban users when assigned. Whenever a user receives one of these roles - whether assigned manually, by a command, or by another bot - they will be immediately banned from the server. Users with the "Manage Roles" permission are exempt and will not be banned.
Open it in your dashboard.
| Field | Description |
|---|---|
| Role | When a user receives this role, they will be immediately banned from the server. Users with "Manage Roles" are exempt. |
| Ban Reason | The reason shown in the audit log when a user is banned for receiving this role. Default: "Received a banned role". |
| Delete Message Days | Number of days of messages to delete when banning the user (0-7). Default: 0. |
Troubleshooting
Role ban is not working / user is not being banned
- Make sure your bot has the "Ban Members" permission on your server.
- Make sure the bot's role is above the user's highest role in the role hierarchy.
- Users with the "Manage Roles" permission are exempt from role bans - this is by design.
- Make sure the role is correctly configured in the Role Bans configuration.
Importing an emoji fails
- Make sure you select the emoji from the Emoji-Picker instead of typing it out.
- Make sure you only entered the Emoji and nothing more.
- Make sure your bot has the "Create expressions" permission on your server.
Moving a channel does not work / The bot is moving to the wrong position
- Make sure your bot has the "Manage channels" permission on your server.
- Discord is restricting some positions. For example, you might be unable to move a voice-channel above a text-channel in a category.
- Make sure you entered the right position. To do this, run the command without the "new-position" option and calculate the new position relative to the current position obtained.
