---
AutoNickname is a powerful Discord App, designed to automate and manage nicknames for your server members. Whether it's changing nicknames for new members or automatically updating them when members receive new roles, AutoNickname handles it all effortlessly.
automate and manage nicknames for your server members. From assigning nicknames to new members to dynamically updating them based on roles, AutoNickname streamlines server management effortlessly.
<iframe src="https://autonickname.ozoraa.com/commands" style="width: 100%; height: 500px; border: none;"></iframe>


## 🚀 Key Features
### 1. Nickname Customization
- Assign default nicknames to new members.
- Customize nicknames with placeholders:
  - `{uname}`: Username
  - `{gname}`: Global Name
- Add prefixes or suffixes based on roles or server-specific configurations.

### 2. Role-Based Nicknames
- Dynamically update nicknames when members gain or lose roles.
- Use `/role-add` or `/role-add-all` to integrate specific or all roles with AutoNickname.
- For role-based nicknames, you can add `{randomnumberX}`. A timestamp-based approach is used to ensure better randomness, providing unique values based on the current time. This handles the `{randomnumberX}` placeholders, where `X` is the number of digits requested, by dynamically extracting digits from the timestamp.

### 3. Welcome Messages
- Customize and send welcome messages via DM to new members.
- Toggle the welcome feature using `/status-welcome-dm`.

### 4. Logging System
- Track nickname changes and AutoNickname activities with `/log`.

---

## 📋 Command Categories

### **General Commands**
| Command              | Description                                                             | User Permission to Run Command  |
|----------------------|-------------------------------------------------------------------------|---------------------------------|
| `/help`              | Displays help information about the bot and its commands.              | None                            |
| `/info-bot`          | Shows bot-related information in the guild.                            | None                            |
| `/info-server`       | Get detailed information about the server.                             | None                            |
| `/getnick`           | Retrieve a nickname template used for new members.                      | None                            |
| `/setnickname`       | Set guildnickname for a user, .                      | None                            |

- **If /setnickname is used**: The set nickname overrides any role-based nicknames.
- **If no nickname is set**: The bot will use the default {uname} or {gname} format for roles.

### **Role Management Commands**
| Command              | Description                                                             | User Permission to Run Command  |
|----------------------|-------------------------------------------------------------------------|---------------------------------|
| `/role-add`          | Add a specific role for AutoNickname.                                  | Manage Server                   |
| `/role-add-all`      | Add all server roles for AutoNickname automatically.                   | Manage Server                   |
| `/role-remove`       | Remove a specific role from AutoNickname.                              | Manage Server                   |
| `/role-remove-all`   | Remove all server roles from AutoNickname.                             | Manage Server                   |

### **AutoNickname Configuration**
| Command              | Description                                                             | User Permission to Run Command  |
|----------------------|-------------------------------------------------------------------------|---------------------------------|
| `/nick-join`         | Set default nicknames for new members.                                  | Manage Server                   |
| `/status-join`       | Enable/disable AutoNickname for new members.                           | Manage Server                   |
| `/status-role`       | Enable/disable AutoNickname for role changes.                          | Manage Server                   |
| `/status-welcome-dm` | Enable/disable welcome messages sent via DM.                           | Manage Server                   |
| `/message-welcome-dm`| Set a custom welcome message sent via DM.                              | Manage Server                   |

### **Logging**
| Command              | Description                                                             | User Permission to Run Command  |
|----------------------|-------------------------------------------------------------------------|---------------------------------|
| `/log`               | Set up logging channels and features for AutoNickname.                 | Manage Server                   |

---

## 📌 Important Notes
- **Role Hierarchy:**
  - The bot cannot modify nicknames if the target role is higher than the bot's role.
  - Ensure the bot's role is at the top of the server role list for proper functionality.
- **Server Owner Nicknames:**
  - Discord does not allow bots to change the server owner's nickname.

---

## Role Position for AutoNickname

<a href="https://github.com/ichsanulaulia/AutoNicknameBoT">
  <img src="https://github.com/ichsanulaulia/AutoNicknameBot/blob/master/img/ForAutoJoinNickname.gif?raw=true" alt="AutoNickname for Only Joined Members" style="width: 100%;">
</a>
<p><em>The first GIF demonstrates the AutoNickname feature for new members. This is the recommended setup role position if your server has a members role.</em></p>

<a href="https://github.com/ichsanulaulia/AutoNicknameBoT">
  <img src="https://github.com/ichsanulaulia/AutoNicknameBot/blob/master/img/ForAutoNickname%20For%20Members%20Roles.gif?raw=true" alt="AutoNickname for Members Roles and Joined Members" style="width: 100%;">
</a>
<p><em>The second GIF ensures that the setup role position for changes nicknames based on members' roles (when a role is added or removed). Note that the bot will not be able to change nicknames if the target role or the role being set is higher than the bot's role itself. To resolve this, you must move the bot's role to the top like this.</em></p>

- If you are the server owner, the bot can't change your nickname! (This cannot be fixed due to Discord rules.)


AutoNickname

Changing nickname for joined members And Change nickname When Members Get Any Roles

Voting for AutoNickname