A Discord bot designed to randomize nicknames within your server. It offers a fun and interactive way to mix things up and keep your server lively.
Setting up NickNamer is straightforward. You'll need to have Python installed on your server, along with the discord.py library. The bot uses a .env
file to securely store the API_TOKEN
required for Discord bot authentication.
- Ensure Python 3.8 or higher is installed.
- Install discord.py using pip:
pip install discord.py
. - Clone this repository to your server.
- Create an env var and add your Discord bot token as
API_TOKEN=your_token_here
. - Run the bot using
python src/main.py
.
NickNamer implements several commands to manage nicknames within your server:
?remember [word]
: Adds a word to the pool of nickname parts.?forget [word]
: Removes a word from the pool of nickname parts.?forgetall
: Clears the pool of nickname parts.?names
: Lists all words currently in the pool.?randomizeme [num_of_words]
: Randomizes the nickname of the command issuer using the specified number of words from the pool.?randomize [user] [num_of_words]
: Randomizes the nickname of the specified user.?randomizeall [num_of_words]
: Randomizes the nicknames of all server members with the specified role.?rolename [role_name]
: Sets the role name required to use the randomization commands.?flip [user]
: Reverses the order of words in the user's nickname.
- The bot will only change the names of users with the specified role. Change the role with
?rolename
.
- Python 3.8 or higher.
- discord.py library.
- A Discord bot token.
Remember to keep your API_TOKEN
secure and never share it publicly.