Home

Awesome

MapleDiscBot

DEPRECATED PROJECT, THIS BOT WILL NO LONGER WORK DUE TO API CHANGES!

"Universal" plug and play MapleStory Discord bot for your private server.

If you have any questions or bug reports, my Discord ID is Not Brandon#4444

I tried to make this maplestory discord bot as plug n play as possible but you are still going to need to some work.

Make sure to use Visual Studio Code for any debugging or editing.

1. How to get a discord bot token? <h2>

  1. Visit the Discord Developer Portal

  2. At the top right corner of the page, click on the New Application button, and fill in the appropriate details

Discord Application Button

  1. Now click on your new application you just created

  2. Select the Bot option on the left side of the screen

Discord Bot Option

  1. At the right under Build-A-Bot, click on the Add Bot button

  2. Under Token, click on Click to Reveal Token. You can now see the hidden token ID; you may click on the Copy button to have it added to your clipboard

Token

2. How to set up the bot <h2>

  1. The first thing you want to fill out for it to work is config.json in the config Folder

config file

  1. YOU MUST FILL OUT ALL ASPECTS FOR IT TO WORK

  2. Starting with token, you want to put your bot token you just made into token area

  3. addRole : addRole defaults to false. If you set it to true, make sure to fill out the role ID that you want automatically assigned for newcomers to your Discord server.

  4. serverName : Insert your server name (e.g. whateverMS, nottakenMS, SpiritMS, etc.)

  5. serverWebsite : Insert your website URL.

  6. serverMascot : URL of a picture, you kinda need to fill this one out otherwise you will get errors

7.5: serverColor : The hexcode to a color that matches your server artwork.

  1. databaseName : Your database name.

  2. databasePass : Password of your database. It is empty by default, but that is where you would set your SQL password.

  3. databaseUser : Defaulted to root, change if otherwise.

  4. databaseHost : Again defaulted to localhost.

FINISH: If you matched all criterias(you probably won't), run the bot with start.bat and boom you should have a working bot (it will restart the bot if it crashes). It should look like this.

Console Bot

3. I get errors how to fix!1!!?? <h2>

mysql error

Make sure to type npm install mysql in terminal of visual studio code.

badAPI error

Make sure to fill out the serverMascot section of config.json

!givedp !character doesn't work!

  1. Open the files in commands folder, and read the comments

  2. You want account[0].dpoint to match the column name in your SQL. (e.g. account[0].dpoints, account[0].dp, or account[0].donationPoints)

dp

Similarly for the !givedp command, you'd want to change the dpoint column accordingly

  1. In the updateDp Variable change SET "dpoints" to whatever your donation points is called
  2. Do the same for realcash. Change it to rows[0].dpoints or whatever your column name is in SQL.

givedp

Extra: You can read through the source code and change it to your liking, in info.js I removed the setURL() but you can easily reenable features to your liking.

Gallery <h2>

rankings

online