This Discord bot is designed to manage and facilitate gym battles for a Pokémon-themed server. It allows administrators to assign Gym Leader roles to users, manage challenges between players and Gym Leaders, and maintain a leaderboard of players who have won gym battles. The bot also supports handling wins and losses, as well as gym badges for challengers who defeat Gym Leaders.
The bot will also handle sending challenge requests, handling challenge acceptances and rejections, and notifying Gym Leaders and challengers about the status of their challenges. Additionally, it provides utilities for managing and displaying gym badges earned by players.
The bot will need the following permissions:
Read Message History
* Make sure to move the bot up underneath moderator roles, etc. so that it can manage the Gym Leader Roles and the Gym Badge Roles.
Here’s a summary of the main bot commands and their usage:
setup_server: Automatically sets up all Gym Channels and Roles for you. Admin only command.
assign: Assigns the Gym Leader role to a user. Usage:
.assign @User GymType. Only “League Manager” role can use this command. It will create a new role if not made already called “Gym Leader – Type” Type will be replaced by Fire, Water, Grass, Psychic, etc.
challenge: Challenges a Gym Leader to a battle. Usage:
.challenge @GymLeader GymType.
cancel: Cancels an ongoing challenge. Usage:
winner: Reports the winner of a challenge. Usage:
– When you report a winner, the winner will be logged and assigned the appropriate gym badge.
– Only the Gym Leader can report the winner.
– The badge that will be assigned to the user will be that of the Gym Leaders Gym Type. Example: If the Gym leader of the Fire gym with a role of “Gym Leader – Fire” runs the .winner command, the user will be assigned the “Fire Gym Badge”.
– The Gym Leader cannot report themselves the winner. They must either .winner or .loser the challenger only.
loser: If the challenger loses, type .loser @challenger to clear the challenge. No win will be logged and no badge given.
redact_win: Redacts a win for a user in case a winner is recorded incorrectly. Usage:
.redact_win @Winner. Only Gym Leaders can use this command.
add_win: Adds a win to a user. Usage:
.add_win @Winner. Only Gym Leaders can use this command.
leaderboard: Displays the gym battle leaderboard. Usage:
wins: Shows the number of wins for a specific user. Usage:
reset_wins: Resets all recorded wins. Usage:
.reset_wins. Only “League Manager” role can use this command.
removebadges: Remove all Badges from ALL members. To reset the Season. The bot needs to be above the Gym Badge roles in hierarchy to do this command. “League Manager” role only command.
gymbadges: Displays a png image of all of the users current badges defined in the bot script.
stats: Displays the specified users stats. Example: .stats @User will show their challenge requests, wins, losses, and win/loss ratio.
reset_stats: Usage: .reset_stats @User Will reset that users stats back to 0.
new_season: Resets everything and starts a new season. “League Manager” role command only. Cleans out all files, stats, challenges, and winners.
create_gyms: Creates a category named “Pokemon League” and automatically adds all of the gym type channels for you. Just be sure to set the permissions correctly in the Pokemon Leage category when finished. By default the @everyone permission will have view channel, send messages, and read message history on.
create_gym_leader_roles: This command will create all 18 gym type roles for you automatically. Make sure your bot has “Manage Roles” permissions. It will assign a badge icon, and color for you automatically as well. This can be changed later on. NOTE: This requires your server boost to be level 2 to unlock icons. If you are not level 2, run the command create_gym_leader_roles_no_icons
create_gym_badge_roles: This command will create all 18 gym badge roles for you automatically. Make sure your bot has “Manage Roles” permissions. It will assign a badge icon, and color for you automatically as well. This can be changed later on. NOTE: This requires your server boost to be level 2 to unlock icons. If you are not level 2, run the command create_gym_badge_roles_no_icons
set_gym_leaders: This command will set all permissions to the Gym Channels that were created for each gym leader to now have Manage Channel Permissions, Manage Messages, Manage Roles, and Manage Webhooks over their perspective channel. Example: Gym Leader – Rock will now have the correct perms in channel “Rock Gym”.
Add this bot to your server today! Contact Gengar via DM on https://genpkm.com (link to discord)
Bot Rental is $3 per month to help me cover the hosting fees each month. Your bot is on a dedicated server and will be up 24/7 with no interruption. I will set everything up in your server for you when the bot joins, I will also customize your gym badge background as well for the .gymbadges command to suit your server.