Majo.exe

Majo.exe have almost everything - Fun, Memes, Images, Giveaway Moderation, Anime, NSFW and even more! Majo.exe serve over 150 commands!

🔗 Invite

Go to this link and add the bot (this requires MANAGE_GUILD permission) to your server.

Or to make it easier, visit our website

✨ Features

⚙️ Fully customizable
🌆 Build-in Dashboard
📝 Easy Config
💯 150+ Commands
📚 Easy Hosting

🖥️ Hosting

We host this bot. Majo.exe will be online 24/7. Invite Majo here!
However, if you want to host Majo.exe yourself - take a look here

Replit	Terohost

🤖 Self-Hosting (Bot)

Clone this repository git clone https://github.com/IgorKowalczyk/majo.exe.git
Run npm i to install all dependencies,
Grab a Discord Bot token and client secret on Discord's developer portal Tutorial
Fill /config/config.js, /config/emojis_config.js with your values
Create new file named .env Remember - the file is super secret, better to not share it.
In .env file set this values:
- TOKEN - Discord bot token [Tutorial]
- ID - Your Discord Bot ID
- SUPPORT_SERVER_ID - Your Support Server ID
- AMEAPI - your Amethyste API token [Tutorial]
- MYSQL_DATABASE - Your MYSQL database name
- MYSQL_HOST - Your MYSQL Host Endpoint
- MYSQL_PASSWORD - Your MYSQL user password
- MYSQL_USER - Your MYSQL User name who can acces the database
- ERRORS_WEBHOOK - Your errors webhook URL (Discord)
Run npm run majo:bot

Note: See the example .env file below!

💾 Self-Hosting (Dashboard)

Note: API Process is children of Dashboard!

Clone this repository git clone https://github.com/IgorKowalczyk/majo.exe.git
Run npm i to install all dependencies,
Grab a Discord Bot token and client secret on Discord's developer portal Tutorial
Create new file named .env Remember - the file is super secret, better to not share it.
In .env file set this values:
- TOKEN - Discord bot token [Tutorial]
- DOMAIN - Your website domain (eg https://example.com)
- AMEAPI - Your Amethyste api token [Tutorial]
- ID - Your Discord Bot ID
- MYSQL_DATABASE - Your MYSQL database name
- MYSQL_HOST - Your MYSQL Host Endpoint
- MYSQL_PASSWORD - Your MYSQL user password
- MYSQL_USER - Your MYSQL User name who can acces the database
- CONTACT_WEBHOOK - Your Contact Webhook URL (Discord)
- PORT - Your website port
- RECAPTCHA_SITE_KEY - Google recaptcha v2 site key
- RECAPTCHA_SECRET_KEY - Google recaptcha v2 secret key
- SECRET - Discord bot secret [Tutorial]
Fill dashboard config in /config/main_config.js

Add these redirect URI's (https://discord.com/developers/applications/<YOUR-BOT-ID>/oauth2)

 https://your-domain.com
 https://your-domain.com/callback
 https://your-domain.com/dashboard
 https://your-domain.com/login

Run npm run majo:dashboard in your terminal
If everyting is ok go to your dashboard in browser (eg. to localhost:8000)

Note: See the example .env file below!

If you are hosting dashboard on Replit please run this command to install Node.js 16x:

npm init -y && npm i --save-dev node@16 && npm config set prefix=$(pwd)/node_modules/node && export PATH=$(pwd)/node_modules/node/bin:$PATH

🧱 Self-Hosting (API)

Clone this repository git clone https://github.com/IgorKowalczyk/majo.exe.git
Run npm i to install all dependencies,
Grab a Discord Bot token and client secret on Discord's developer portal Tutorial
Create new file named .env Remember - the file is super secret, better to not share it.
In .env file set this values:
- TOKEN - Discord bot token [Tutorial]
- DOMAIN - Your website domain (eg https://example.com)
- PORT - Your website port
Run npm run majo:api in your terminal
If everyting is ok go to your dashboard in browser (eg. to localhost:8001/api)

Additional info

Note: You can run API & Dashboard at the same time by running npm run majo:web

Note: You can run Dashboard, API & Dashboard at the same time by running npm run start

🧱 API Endpoints

🔗 API Link: https://majoexe.xyz/api/

API Endpoint (`/api`)	Values	Response (`json`)	Conditions	Error Codes
`/`	`None`	`Endpoints list`	`None`	`None`
`/v1/info/bot`	`None`	`JSON Object`	`None`	`None`
`/v1/fun/cat_fact`	`None`	`JSON Object`	`None`	`None`
`/v1/fun/eightball`	`None`	`JSON Object`	`None`	`None`
`/v1/fun/fortunes`	`None`	`JSON Object`	`None`	`None`

Note: Any other endpoint will return error code 0 and error message

💾 `.env` File (Main Config)

`.env` config table

`.env` varriable	Description	Type	Required (Bot)	Required (Dashboard)	Required (API)
`TOKEN`	Discord bot token	String	✅	✅	✅
`ID`	Your Discord Bot ID	Number	✅	✅	❌
`SUPPORT_SERVER_ID`	Your support server ID	Number	✅	❌	❌
`AMEAPI`	Your Amethyste api token	String	✅	✅	❌
`MYSQL_DATABASE`	Your MYSQL database name	String	✅	✅	❌
`MYSQL_HOST`	Your MYSQL Host	String	✅	✅	❌
`MYSQL_USER`	Your MYSQL user	String	✅	✅	❌
`MYSQL_PASSWORD`	Your MYSQL password	String	✅	✅	❌
`MYSQL_PORT`	Your MYSQL Port (default is `3306`)	Number	❌	❌	❌
`DOMAIN`	Your website domain (eg `https://example.com`)	URL	❌	✅	✅
`PORT`	Your webiste port eg. `8080`	Number	❌	✅	✅
`SECRET`	The bot client secret	String	❌	✅	❌
`ANALYTICS`	Google analytics tracking ID, used in Web-Dashboard	String	❌	❌	❌
`RECAPTCHA_SITE_KEY`	Google recaptcha v2 site key	String	❌	✅	❌
`RECAPTCHA_SECRET_KEY`	Google recaptcha v2 secret key	String	❌	✅	❌
`CONTACT_WEBHOOK`	Your contact form webhook URL	URL	❌	✅	❌
`STATUS_WEBHOOK`	Your status webhook URL	URL	❌	❌	❌
`ERRORS_WEBHOOK`	Your errors webhook URL	URL	✅	✅	✅
`NODE_ENV`	Environment variable (production/development)	String	✅	✅	✅

Example `.env` file

.env.example

# Environment Config

# Required for everything (Bot, Dashboard & API)
TOKEN=YOUR_TOKEN_GOES_HERE
ERRORS_WEBHOOK=YOUR_ERRORS_WEBHOOK_URL
MYSQL_DATABASE=YOUR_MYSQL_DATABASE_NAME
MYSQL_HOST=YOUR_MYSQL_HOST
MYSQL_PASSWORD=YOUR_MYSQL_USER_PASSWORD
MYSQL_USER=YOUR_MYSQL_DATABASE_USER

# Required for bot
ID=YOUR_BOT_ID
SUPPORT_SERVER_ID=YOUR_SUPPORT_SERVER_ID
AMEAPI=YOUR_AMETHYSTE_API_TOKEN

# Required for Dashboard
CONTACT_WEBHOOK=YOUR_CONTACT_FORM_WEBHOOK
ERRORS_WEBHOOK=YOUR_ERRORS_WEBHOOK_URL
RECAPTCHA_SITE_KEY=YOUR_RECAPTCHA_SITE_KEY
RECAPTCHA_SECRET_KEY=YOUR_RECAPTCHA_SECRET_KEY
SECRET=YOUR_BOT_CLIENT_SECRET

# Required for web workers (Dashboard or API)
PORT=YOUR_WEBSITE_PORT

# Not required (optional)
ANALYTICS=YOUR_GOOGLE_TRACKING_ID
STATUS_WEBHOOK=YOUR_STATUS_WEBHOOK_URL

# Note: !majo is the default , you can change it later.

🗜️ Requirements

MySQL 5.7 or higher
Node.js 16x or higher
(Any) Linux x64*
256MB of RAM
512MB/1GB of hard drive space

*Debian based distro recommended

🔓 Tokens tutorials

🔑 Discord Credentials

🔏 Discord Token

Go to Discord Developer Portal
At the top right of the screen, click "New application" and assign it a name. Next in the left part of the screen on the navigation bar, find "Bot" then click it and find button named "Add Bot"
After confirming the bot creation, click the "Copy token" button
Paste your token in .env file - TOKEN=BOT_TOKEN

🔓 Discord Bot Secret

Go to Discord Developer Portal
In the left part of the screen on the bar, find "OAuth2" then click it
Find section named "Client Secret", under the bot secret click "Copy" button
Paste client secret to .env - SECRET=CLIENT_SECRET

Written by: _index1337

🔐 Amethyste API

Go to Amethyste Register Page to create an new account
Fill in all the required infomation
Check your email to active your account
After login, you'll be redicted to home page, scroll down and click Generate

Token will appear on top of that button, you can regenerate it in any time

Paste your token in .env file - AMEAPI=TOKEN

Written by: _index1337

📈 Analytics ID

Soon!

🔐 Re-Captcha Key

Go to Google reCAPTCHA About Page
Choose v3 Admin Console.
If you have never generated a reCAPTCHA key before, you will be redirected to the key generation page.

If you have generated a reCAPTCHA key before, you will be redirected to the reCAPTCHA dashboard. Here will display the statistics of your past key. And to generate a key, tap the + button on the top right.

Fill in the information in the form:

Label: Enter the label to identify the site.

reCAPTCHA type: Choose the type of reCAPTCHA for this site key

reCAPTCHA v3 : allows you to verify if an interaction is legitimate without any user interaction [Not recommended!]

reCAPTCHA v2 [Recommended!] :

I’m not a robot" Checkbox [Recommended!]

Invisible reCAPTCHA badge

reCAPTCHA Android

Domains: Enter your domain where the keys will be used.

Owners: By default, it will receive the email address you log in with. If you want to register for more accounts, enter the email addresses you want to specify

Terms of Service: Check the box to accept the reCAPTCHA Terms of Service

Send alerts to owners: Check the box to get alerts if Google detects issues with your site

When complete, click the SUBMIT button.

Written by: _index1337

📝 Contributors

@r-kjha (Emoji config support, Bug fixes, New features, Testing)
@Joao-Victor-Liporini (Bug fixes, Command handler improvements, Testing, New features)
@krzesl0 (New Features, Bug fixes, Testing)
@_index1337 (Readme tutorials)
@Wafelowski (Translation improvements)
@Sakshyam6966 (New Features, Bug fixes, Testing)

💝 Sponsors

These wonderful people and services have helped develop Majo.exe, without them this project would not exist. Thanks goes to these wonderful people!

Sponsor	Description	Sponsored
Terohost	TeroHost is a Discord Bot hosting provider that helps take care of all your needs regarding your Discord Bot to ensure your bot perfect uptime, ping and speed.	.xyz Domain & MySQL Database

⁉️ Issues

If you have any issues with the page please create new issue here

📥 Pull Requests

When submitting a pull request:

Clone the repo.
Create a branch off of master and give it a meaningful name (e.g. my-awesome-new-feature).
Open a pull request on GitHub and describe the feature or fix.

📋 License

This project is licensed under the MIT. See the LICENSE file for details

The cake is a lie 🍰

Name		Name	Last commit message	Last commit date
Latest commit History 3,927 Commits
.github		.github
api		api
bot		bot
client		client
config		config
dashboard		dashboard
database/backups		database/backups
src		src
utilities		utilities
web		web
.gitignore		.gitignore
.npmrc		.npmrc
.prettierignore		.prettierignore
.prettierrc		.prettierrc
.replit		.replit
README.md		README.md
index.html		index.html
index.js		index.js
license.md		license.md
package-lock.json		package-lock.json
package.json		package.json
pm2.config.js		pm2.config.js

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Repository files navigation

Majo.exe

🔗 Invite

✨ Features

🖥️ Hosting

🤖 Self-Hosting (Bot)

💾 Self-Hosting (Dashboard)

🧱 Self-Hosting (API)

🧱 API Endpoints

💾 `.env` File (Main Config)

`.env` config table

Example `.env` file

🗜️ Requirements

🔓 Tokens tutorials

🔑 Discord Credentials

🔏 Discord Token

🔓 Discord Bot Secret

🔐 Amethyste API

📈 Analytics ID

🔐 Re-Captcha Key

📝 Contributors

💝 Sponsors

⁉️ Issues

📥 Pull Requests

📋 License

About

Releases

Packages

Languages

License

chri1ss/myillness

Folders and files

Latest commit

History

Repository files navigation

Majo.exe

🔗 Invite

✨ Features

🖥️ Hosting

🤖 Self-Hosting (Bot)

💾 Self-Hosting (Dashboard)

🧱 Self-Hosting (API)

🧱 API Endpoints

💾 .env File (Main Config)

.env config table

Example .env file

🗜️ Requirements

🔓 Tokens tutorials

🔑 Discord Credentials

🔏 Discord Token

🔓 Discord Bot Secret

🔐 Amethyste API

📈 Analytics ID

🔐 Re-Captcha Key

📝 Contributors

💝 Sponsors

⁉️ Issues

📥 Pull Requests

📋 License

About

Resources

License

Security policy

Stars

Watchers

Forks

Releases

Packages 0

Languages

💾 `.env` File (Main Config)

`.env` config table

Example `.env` file

Packages