Jean Discord Bot

A Discord bot built with Discord.js v14 focused on custom voice channel management.

Features

• 🎤 Custom Voice Channels: Automatic creation of private voice channels
• 👥 Member Management: Invite specific members or roles to channels
• 🔒 Permission Control: Lock/unlock channels and manage permissions
• 📝 Channel Editing: Rename channels and set user limits
• 🔄 Auto-Cleanup: Channels automatically delete when empty
• 🎛️ Interactive Controls: Easy-to-use buttons and menus
• 📊 Information Commands: Server information, bot latency, and statistics
• 🎮 Fun Commands: Coin flip and other entertainment commands

Setup

1. Install Dependencies

npm install

2. Environment Variables

Create a .env file in the root directory:

DISCORD_TOKEN=your_discord_bot_token_here
CLIENT_ID=your_client_id_here
GUILD_ID=your_guild_id_here

BOT_STATUS=online
BOT_ACTIVITY=/help for commands

3. Discord Bot Setup

1. Go to Discord Developer Portal
2. Create a new application
3. Go to the "Bot" section and create a bot
4. Copy the bot token and add it to your .env file
5. Enable the required intents:
   • Server Members Intent (required for invite system)
6. Go to "OAuth2" > "URL Generator"
7. Select "bot" and "applications.commands" scopes
8. Select the required permissions
9. Use the generated URL to invite the bot to your server

4. Run the Bot

Development mode (with auto-restart):

npm run dev

Production mode:

npm start

Project Structure

src/
├── commands/          # Slash commands
│   ├── admin/        # Administrative commands
│   └── info/         # Information commands
├── events/           # Discord.js events
├── handlers/         # Command and event handlers
├── utils/            # Utility functions
├── config/           # Configuration
└── index.js          # Main bot file

Voice Channel System

Setup

1. Use /setup-temp-channels to designate a voice channel as the "create channel"
2. When users join this channel, a new private voice channel is automatically created
3. The creator gets full control over their channel with interactive buttons

Features

• Private by Default: New channels are private (only creator can join)
• Member Invites: Invite specific members using Discord's native user selector
• Role Invites: Give access to entire roles
• Quick Lock/Unlock: Toggle between public and private
• Channel Editing: Rename and set user limits
• Auto-Cleanup: Channels delete when everyone leaves

Permissions

The bot requires these intents:

• Guilds: Basic guild access
• GuildVoiceStates: Voice channel management
• GuildMembers: Member management for invites

License

MIT