Discord Roster, Event Bot

A Discord bot for managing rosters, events, leaderboards, maps and hierarchies with a JSON backed config system. Built with discord.py.

✨ Features

• Roster Management
  • Create, configure, and delete rosters.
  • Add/remove members with /add-to-roster and /remove-from-roster.
  • View rosters with /view-roster.
• Event Management
  • Create, edit, delete, and link events.
  • Scheduler loop sends reminders pingMinutesBefore minutes before start.
  • View events with /view-event (with pagination).
• Leaderboard & Maps
  • Track scores with /leaderboard.
  • Create, view, and delete maps.
  • Submit results with /submit.
• Hierarchy System
  • Add ranks with /add-rank-to-hierarchy.
  • View hierarchy with /view-hierarchy.
  • Reset hierarchy with /reset-hierarchy.

📜 Commands

Command	Description
----------Roster Bot----------	--------------Roster Bot--------------
/create-event	Create an event
/edit-event	Edit an event
/delete-event	Delete an event
/link-event	Link a Discord event
/view-event	View event details
/config-roster	Configure roster settings
/create-roster	Create a new roster
/delete-roster	Delete a roster
/add-to-roster	Add a member to a roster
/remove-from-roster	Remove a member from a roster
/view-roster	View roster details
/add-permissions-roster	Add role/member permissions for roster commands
/remove-permissions-roster	Remove role/member permissions for roster commands
------------Leaderboard Bot-----------	---------------Leaderboard Bot--------------
/add-permissions-leaderboard	Add role/member permissions for leaderboard commands
/remove_permissions-leaderboard	Remove role/member permissions for leaderboard commands
/leaderboard	View leaderboard standings
/create-map	Create a new map
/view-map	View map details
/delete-map	Delete a map
/submit	Submit a score or result
/add-rank-to-hierarchy	Add a rank to the hierarchy
/view-hierarchy	View the rank hierarchy
/reset-hierarchy	Reset the rank hierarchy
-------------Main Bot------------	-------------Main Bot-------------
/setup-bot	Get invite link for each sub bot/division

🔑 Permissions Required

• Manage Roles → to assign roster roles.
• Send Messages → to post reminders.
• Read Messages/View Channels → to access channels.
• Use Application Commands → for slash commands.

🛠 Usage

<<<<<<< HEAD
1. Guild owner runs /setup-bot to initialize the bots.
======= >>>>>>> 6d2dcb580c7c3844b35de52fccaf5dce86830aa5
2. Admins configure rosters with /create-roster and add members.
3. Events are scheduled with /create-event, linked to rosters.
4. Scheduler loop automatically sends reminders before events.
5. Members link their Minecraft accounts with /link-mc.
6. Admins and owners manage permissions with /add_permissions_mc, /remove_permissions_mc, and view them with /view-permissions-mc.
7. Leaderboards, maps, and hierarchies are maintained with their respective commands.

Proper Setup ⚠️⚠️⚠️

You must do /setup-bot and select what you need and use the provided Oauth2 links to invite the bot(s), the bot(FootBot) has been intentionally split up to create a more organized and streamlined experience.