• Magicord used to be a bot primarily hosted on Botghost but since it was unreliable and had limitations, I decided to move it to Discord.js and Discordx, everything is still being moved so not everything has been added here.

• Modern reaction roles
• Setup applications as an alternative to google forms
• Safety system against raids
• Configuration to your liking
• Edit the bot's code to your liking! (Need js knowledge)
• Silly commands (cuz why not)

NOTE THAT MOST OF THESE FEATURES HAVE NOT BEEN IMPLEMENTED YET

• Here is the list of current commands of magicord!

❤️ Contributing is heavily appreciated in this project, as of right now, only 1 dev (me) is working on this project, so helping in any way possible is very appreciated, thanks! ❤️

Do not open pull requests in the main branch, any pull request done there will need to be moved to the Magicord-RollRelease branch, always open pull requests there.

• Firstly, you will have to clone this repository using git or gh cli, if you plan on using git for long term purpose (as in a project) then you may want to keep using git after cloning.

• "How do i clone a repository?"

• You have 2 options to clone the repository, either by using git as listed ealier or by forking the repository then using github desktop, i recommend using git, but if you aren't experienced with terminals and such, you may use github desktop.

• Run the following command in git bash or in terminal (if you are using windows), this guide should work perfectly with linux systems and unix systems (like MacOS and FreeBSD)

You may not have git installed by default, so, install it depending on the OS

Another thing you will have to install is npm (Node Package Manager) for JS, or node

to install git on windows you can either run this in command prompt

winget install --id Git.Git -e --source winget 
# to install npm
winget install -e --id OpenJS.NodeJS

or by installing it from The official git website

• Debian

sudo apt install git
# to install npm
sudo apt install npm

• Arch Linux

sudo pacman -S git
# to install npm
sudo pacman -S npm

• Fedora

sudo dnf install git
# to install npm
sudo dnf install git nodejs 

If you are using any other distro, you should be able to do it on your own

• MacOS

Firstly, install Homebrew if you haven't yet

brew install git
# to install npm
brew install node

• FreeBSD

sudo pkg install git
# to install npm
sudo pkg install node

With git installed now its time to clone the repository

git clone https://github.com/Bikoil/Magicord

If you forked the repository, then you should do the following instead

git clone https://github.com/<YourUsername>/<YourMagicordForkName>

WARNING: THIS PART BELOW IS NOT RECOMMENDED. If you want to use the latest version of Magicord with the latest changes

git clone -b Magicord-RollRelease https://github.com/Bikoil/Magicord

ONLY DO THIS IF YOU KNOW WHAT YOU ARE DOING. THIS WILL MOST LIKELY CAUSE MANY ERRORS OR STRAIGHT UP NOT WORK

Now, your bot repository is setup in your device, you are missing 2 more steps before the bot is setup

• Go to your bot folder

• Then run the following

• Windows

// For cmd
set BOT_TOKEN=YourBotToken
// For powershell
$env:BOT_TOKEN="YourBotToken"

• Linux/BSD/MacOS/GitBash

export BOT_TOKEN=YourBotToken

After this, you are all set! you just need to do the following to run the ot and make it online

• Go to your terminal/command prompt
• change directory to the bot folder

cd <TheBotFolderName>

• You will need to install all the dependencies

npm install 

• And finally...

npm run build && npm run start

And viola! your bot is online, now you can go ahead and customize it all you want

You can make a startup script for your bot if you do not want to deal with running multiple commands to start up the bot.

• Make script called start
• Copy the contents of the StartMagicord script into the start script
• This should be the contents of the start script

#!/bin/sh
echo "Checking for updates using git..."
git pull 
echo "Exporting BOT_TOKEN variable..."
export BOT_TOKEN=PlaceYourTokenHere
echo "Compiling Typescript to Javascript..."
npm run build
echo "Starting the bot..."
npm run start

If you do not want the bot to auto check for updates and update, then you can remove git pull from the script

• Replace PlaceYourTokenHere with your actual bot token

• Make the file executable.

chmod +x start

• Then, your bot should start upon running the script

./start

• Make a script named start.bat in your bot directory
• Copy this into the script

@echo off
echo Checking for updates using git...
git pull

echo Exporting BOT_TOKEN variable...
set BOT_TOKEN=PlaceYourTokenHere

echo Compiling Typescript to Javascript...
npm run build

echo Starting the bot...
npm run start

If you do not want the bot to auto check for updates and update, then you can remove git pull from the script

• Replace PlaceYourTokenHere with your actual bot token

• Then, your bot should start upon running the script

./start.bat

Soon...

Development Team: !!Cords!! - Currently not public.