Mitch's Level Exchange, A Super Mario Maker 2 Discord Bot!

A bot that allows the user to share and discover levels from Super Mario Maker 2 all from the comfort of their Discord server!

Table of Contents

• Bot Installation
• Requirements
• Project Structure
• Features and Commands
• Changelog
• To Do

Bot Installation

Click the following link to get the bot installed on your server!

🌱 Mitch's Level Exchange

Requirements

All required libraries can be found in the requirements.txt file. If you want to directly install them into your environment, run the following command:

pip install -r requirements.txt

Project Structure

.
├── commands 
│       ├── clearvideos.py            # Bot commands related to Clear Videos  
│       ├── credits.py                # Bot commands related to Bot itself and owner (me!)
│       ├── helpc.py                  # Bot commands related to Help
│       ├── levels.py                 # Bot commands related to Levels
│       ├── tables.py                 # Bot commands related to Table Queries
│       ├── users.py                  # Bot commands related to User data
│       └── viewer.py                 # Bot commands related to Level Viewer
├── .gitignore    
├── CHANGELOG.md
├── LICENSE       
├── LICENSE         
├── README.md            
├── creds.py                          # Area where you will place your Discord bot token! ⚠️
├── main.py                           # Main start file.
└── requirements.txt         

Features and Commands

Clear Video Commands

• addclearvid
• clearvid
• removeclearvid

Credits Commands

• about

Help Commands

• help
• help2

Level Commands

• add
• remove

Table Commands

• mylevels
• random
• levelcount

User Commands

• register
• unregister
• myid

Viewer Commands

• peek
• viewer
• viewersimple

---

About

Returns general infomration about bot and creator!

!about

---

Add

Allows you to add a level to the server's list!

!add LEV-ELC-ODE

---

AddClearVid

Allows you to add a clear video to a level from the server.

!addclearvid LEV-ELC-ODE URL

---

ClearVid

Recalls Clear Video to a level if one is set.

!clearvid LEV-ELC-ODE

---

Help

Returns Page 1 of available bot commmands.

!help

---

Help2

Returns Page 2 of available bot commands.

!help2

---

LevelCount

Returns count of levels currently stored on the server.

!LevelCount

---

MyId

If registered, returns the Maker ID associated with the user.

!myid

---

MyLevels

Returns a list of levels User has submitted to the server.

!mylevels

---

Peek

Returns an image of the full overworld of a level.

!peek LEV-ELC-ODE

---

Random

Returns a random level from the server's level list.

!random

---

Register

Allows you to link Discord user with Super Mario Maker 2 Maker ID.

!register MAK-ERC-ODE

---

Remove

Removes level from server list.

!remove LEV-ELC-ODE

---

RemoveClearVid

Removes a Clear Video from a level if one is already assigned to it.

!removeclearvid LEV-ELC-ODE

---

Unregister

Allows you to unlink Discord user with Super Mario Maker 2 Maker ID.

!unregister

---

Viewer

Returns a direct link to the Wizul SMM2 Level Viewer for given level.

!viewer LEV-ELC-ODE

---

ViewerSimple

Returns a direct link to the Wizul SMM2 Level Viewer for given level without accessing API.

!viewersimple LEV-ELC-ODE

---

Changelog

You can access the CHANGELOG by checking the CHANGELOG.md file or click here!

---

To Do

• Improve database management
• Add more commands!