ARC - Automated Role & Category Management

ARC is a Discord bot that helps server administrators quickly set up organized groups for courses, labs, projects, or any other team-based activities.

What This Bot Does

This bot automates the tedious process of creating multiple groups in your Discord server. Instead of manually creating dozens of channels and roles, you can use simple commands to:

• Create organized group structures - Set up categories with multiple channels and matching roles
• Let members self-assign to groups - Post interactive menus where users can pick their group
• Clean up when done - Delete entire group structures safely with confirmation

How It Works

1. Create Groups

Use one command to create everything at once:

?create_groups Lab_1 team number 5

This creates:

• A category called "Lab 1"
• 5 channels: team-1, team-2, team-3, team-4, team-5
• 5 roles: Lab 1 1, Lab 1 2, Lab 1 3, Lab 1 4, Lab 1 5
• Each channel is only visible to members with the matching role

2. Let Users Pick Their Groups

Post a dropdown menu where members can select their group:

?roledrop #general Lab_1

This creates an interactive menu in the specified channel. When someone selects a group:

• They're automatically given that group's role
• Any previous group role from the same category is removed
• They gain access to their group's private channel

3. Clean Up When Done

Remove everything related to a group structure:

?delete Lab_1

This safely removes:

• The category and all its channels
• All related roles
• Any dropdown menus you posted
• Asks for confirmation before deleting anything

Commands Reference

Command	What It Does	Example
?create_groups <category> <channel_base> <mode> <amount>	Creates a full group structure	?create_groups Project_A team letter 8
?roledrop <channel> <category>	Posts a group selection menu	?roledrop #lobby Project_A
?delete <category>	Removes entire group structure	?delete Project_A
?help	Shows command help	?help

Command Options

Category: The main group name (use _ instead of spaces)

• Example: Lab_1 becomes "Lab 1"

Channel Base: What to call the channels (use _ for -)

• Example: study_group becomes study-group-1, study-group-2, etc.

Mode: How to number your groups

• number → 1, 2, 3, 4, 5...
• letter → a, b, c, d, e...

Amount: How many groups to create (up to 99)

Setup Requirements

To use this bot, you'll need:

1. A Discord bot token - Get this from the Discord Developer Portal
2. Bot permissions - The bot needs to manage roles, channels, and messages
3. Admin access - Only specified users or server administrators can create/delete groups

Configuration File

Create a file called private.json with your bot token and authorized user IDs:

{
  "token": "YOUR_BOT_TOKEN_HERE",
  "allowed_ids": [123456789012345678, 987654321098765432]
}

Features

✅ Smart role management - Users can only be in one group per category
✅ Automatic cleanup - Removes old roles when switching groups
✅ Persistent menus - Dropdown menus work even after bot restarts
✅ Safe deletion - Always asks for confirmation before removing anything
✅ Detailed logging - Keeps track of all actions for troubleshooting
✅ Flexible naming - Supports both numbered and lettered group systems

Example Workflow

1. Teacher/Admin: ?create_groups Biology_Lab experiment number 6

   • Creates 6 lab groups with private channels

2. Teacher/Admin: ?roledrop #announcements Biology_Lab

   • Posts a menu for students to pick their lab group

3. Students: Click the dropdown and select their preferred group

   • Automatically get access to their group's private channel

4. End of semester: ?delete Biology_Lab

   • Safely removes all lab-related channels and roles

Support

• Use ?help in Discord for quick command reference
• Check the bot's log file (bot.log) for detailed activity
• The bot automatically handles most edge cases and provides helpful error messages

---

Created by Victor Sandi
Making Discord group management simple and efficient