https://github.com/atifahmed9461/quicknick
A Discord bot that lets users change their nickname by simply sending a message in a specific channel.
https://github.com/atifahmed9461/quicknick
bot bot-features change-nickname channel-based-nickname discord discord-bot discord-bots discord-utility discordjs moderation nickname-bot nickname-changer simple-bot
Last synced: about 1 month ago
JSON representation
A Discord bot that lets users change their nickname by simply sending a message in a specific channel.
- Host: GitHub
- URL: https://github.com/atifahmed9461/quicknick
- Owner: atifahmed9461
- Created: 2025-07-02T10:28:58.000Z (12 months ago)
- Default Branch: main
- Last Pushed: 2025-07-02T11:03:09.000Z (12 months ago)
- Last Synced: 2025-07-03T08:31:28.207Z (12 months ago)
- Topics: bot, bot-features, change-nickname, channel-based-nickname, discord, discord-bot, discord-bots, discord-utility, discordjs, moderation, nickname-bot, nickname-changer, simple-bot
- Language: JavaScript
- Homepage:
- Size: 4.88 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# QuickNick
A Discord bot that lets users change their nickname by simply sending a message in a specific channel.
## Features
- Change your nickname by sending a message in a designated channel
- Role-based permission system (allow specific roles to use the feature)
- Slash commands for configuration and logs
- Persistent settings and logs using Enmap
- Logging of nickname changes
## Setup
1. **Clone the repository:**
```bash
git clone https://github.com/atifahmed9461/QuickNick.git
cd QuickNick
```
2. **Install dependencies:**
```bash
npm install
```
3. **Create a `.env` file:**
```env
TOKEN=your_discord_bot_token
CHANNEL_ID=default_channel_id
REACTION_EMOJI=✅
```
4. **Configure `config.js` as needed:**
- Set up role-based permissions:
```js
nickname_role_require: {
enabled: true,
role_ids: ['ROLE_ID_1', 'ROLE_ID_2']
}
```
## Usage
- **Change Nickname:**
- Send a message in the configured channel. The bot will set your nickname to the message content (if you have permission).
- **Slash Commands:**
- `/setchannel ` — Set the allowed channel for nickname changes
- `/setemoji ` — Set the reaction emoji
- `/config` — Show current bot configuration
- `/log` — Show recent nickname change logs
> Only users with the `ManageGuild` or `Administrator` permission can use the slash commands.
## Logging
- Nickname changes are logged in a channel named `nickname-logs` and also stored in the database.
## Credits
- Built with [discord.js](https://discord.js.org/) and [Enmap](https://enmap.evie.dev/)
---
Feel free to contribute or open issues on GitHub!
## Support Server
Join our Discord for help and community support: https://discord.gg/tsbBKz2k53
## Creator
Created by Atif Ahmed 🖤