Skip to content

z4ck-ftw/Customizer-Bot

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🎨 Customizer Discord Bot

A modern Discord.js v14 bot that allows server owners to customize guild member profiles using Discord's REST API. Built with a modular architecture, Components V2, and designed for performance, scalability, and ease of use.


📖 Project Information

Information Value
Project Name Customizer Discord Bot
Development Team Moon Development (MoonXDevs)
Author Zack (zackheey)
Runtime Node.js 22+
Framework Discord.js v14 (ES Modules)

✨ Features

  • 🎭 Update guild profile nicknames
  • 🖼️ Change guild profile avatars
  • 🌄 Update guild profile banners
  • 📝 Modify guild profile bios
  • 🔄 Reset individual or all profile properties
  • ⚡ Prefix and Slash Command support
  • 🛡️ Owner-only command access
  • 📦 Discord Components V2 responses
  • 📂 Dynamic command & event loading
  • 🎨 Colored console logging
  • 🖼️ Automatic image URL → Base64 conversion
  • 🚀 Lightweight and production-ready architecture

📂 Project Structure

src/
├── index.js
├── deploy.js
├── config/
│   └── config.js
├── handlers/
│   ├── commands.js
│   └── events.js
├── commands/
│   ├── customize.js
│   ├── reset.js
│   ├── ping.js
│   ├── botinfo.js
│   └── invite.js
├── events/
│   ├── ready.js
│   ├── interactionCreate.js
│   └── messageCreate.js
├── utils/
│   ├── logger.js
│   ├── image.js
│   └── containers.js

🚀 Installation

1️⃣ Clone the repository

git clone https://github.com/yourusername/Customizer-Bot.git
cd Customizer-Bot

2️⃣ Install dependencies

npm install

3️⃣ Configure the bot

Edit:

src/config/config.js

Example configuration:

export default {
  token: "YOUR_BOT_TOKEN",
  clientId: "YOUR_CLIENT_ID",
  prefix: ".",
  owners: ["YOUR_USER_ID"],
  emoji: {
    check: "✅",
    cross: "❌",
    edit: "✏️",
    reset: "🔄"
  }
};

4️⃣ Register Slash Commands

npm run deploy

5️⃣ Start the Bot

npm start

💻 Commands

🎨 Customize

Slash Commands

/customizer @user type:nick value:Example
/customizer @user type:avatar value:https://example.com/avatar.png
/customizer @user type:banner value:https://example.com/banner.png
/customizer @user type:bio value:Owner\nDeveloper

Prefix Commands

.customizer @user nick Example
.customizer @user avatar https://example.com/avatar.png
.customizer @user banner https://example.com/banner.png
.customizer @user bio Owner\nDeveloper

🔄 Reset

Slash Commands

/reset @user property:nick
/reset @user property:avatar
/reset @user property:banner
/reset @user property:bio
/reset @user property:all

Prefix Commands

.reset @user nick
.reset @user avatar
.reset @user banner
.reset @user bio
.reset @user all

⚙️ General

/ping
/botinfo
/invite

Prefix Equivalents

.ping
.botinfo
.invite

📦 Technologies Used

  • Node.js 22+
  • Discord.js v14
  • ES Modules (ESM)
  • Discord REST API
  • Components V2
  • Chalk
  • JavaScript

📝 Notes

  • Uses Discord's Guild Member Profile REST endpoint directly.
  • Automatically converts image URLs into Base64 Data URLs.
  • Supports newline conversion (\n) inside bio values.
  • All command responses are powered by Discord Components V2.
  • Built with a modular architecture for easy maintenance and future expansion.

📜 License

This project is licensed under the Moon Development Private License.

Please refer to the repository for licensing information.


Built with ❤️ by Moon Development

Modern • Fast • Reliable

About

Production-ready Discord.js v14 bot for customizing guild member profiles through Discord's REST API.

Topics

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Contributors