Giter VIP home page Giter VIP logo

majo.exe's Introduction

Header

Discord Discord.js CodeQL Checks GitHub License

โœจ Features

  • โš™๏ธ Fully Customizable: Tailor Majo.exe to your preferences with comprehensive customization options.
  • ๐ŸŒ† Built-in Dashboard: Manage your Majo.exe settings effortlessly through our intuitive dashboard.
  • ๐Ÿ“ Easy Configuration: Streamlined configuration process that makes setting up a breeze.
  • ๐Ÿ’ฏ 150+ Commands: Access over 150 versatile commands to enrich your server's experience.
  • ๐Ÿ“š Easy Hosting: Effortlessly host Majo.exe on your servers and keep it online 24/7.

๐Ÿ”— 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

๐Ÿ–ฅ๏ธ Hosting

We are hosting Majo.exe on our own servers. Majo.exe will be online 24/7. Invite Majo here!
However, if you want to host Majo.exe yourself, you can do it. Check out our tutorials to learn how to do it.

Important

This project is not for beginners. If you are not familiar with Node.js, Prisma, Discord.js or any other technology used in this project, you should not host Majo.exe yourself!

๐Ÿ“ Tutorials

โš™๏ธ System Requirements

Ensure your setup meets these prerequisites before setting up Majo.exe:

  • PostgreSQL 14x or higher
  • Node.js 18x or higher
  • (Any) Linux x64ยน
  • ~512MB of RAM (minimum)
  • ~3GB of hard drive space (minimum)

Note

  1. Debian based distros are recommended, bot can also run on Windows and MacOS but it's not recommended.

๐Ÿ”’ Global .env file

Variable Description Required (Bot) Required (Dashboard)
TOKEN Discord bot token โœ… Yes โœ… Yes
CLIENT_ID Discord client ID โœ… Yes โœ… Yes
CLIENT_SECRET Discord client secret โŒ No โœ… Yes
DATABASE_URL Main database connection string โœ… Yes โœ… Yes
DIRECT_URL Non-pooling database connection string โŒ No โŒ No
REDIS_URLยน Redis Cache connection string โŒ No โŒ No
SECRET Secret string (minimum 32 characters) โŒ No โœ… Yes
NEXTAUTH_URL NextAuth.js URL (e.g., http://localhost:3000) โŒ No โœ… Yes
NEXT_PUBLIC_URL Next.js public URL (e.g., http://localhost:3000) โŒ Noยฒ โœ… Yes
HOTJAR_ID Hotjar ID โŒ No โŒ No
DISCORD_SUPPORT_SERVER_ID Discord support server ID โŒ No โŒ Noยณ
TOPGG_API_KEY top.gg API key โŒ No โŒ Noโด

Note

  1. REDIS_URL enables caching. If you don't want to use Redis caching, leave this variable empty. Majo.exe will use Memory caching instead.
  2. NEXT_PUBLIC_URL is required only if you want to also include the dashboard.
  3. DISCORD_SUPPORT_SERVER_ID is required only if you want to automatically add users to your own Discord server when they log in to the dashboard. Please note that the bot needs Manage Server permission in the server!\
  4. TOPGG_API_KEY is required only if you want to automatically post server count to top.gg.

Warning

There is one global .env file for all projects. Do not create .env file in apps/bot, packages/database or apps/dashboard folders! This can cause problems and potential security issues.

๐Ÿ“ Contributors

๐Ÿ’ 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
TrestHost Logo TrestHost TrestHost is a good and powerful hosting provider providing servers from the USA and Germany. Try us out today!

โ›” Hosting Agreement

By hosting the project, you agree to the following terms:

  1. ๐Ÿ“œ Attribution:

    • You are not allowed to claim authorship or affiliation with the Majo.exe team.
    • Proper credit must be given to the original author when hosting the project.
    • You are not allowed to use the Majo.exe name or logo in any way that implies affiliation with the Majo.exe team.
  2. ๐Ÿ’ป Hosting Rights:

    • The bot can be hosted on your server, provided the terms outlined here are respected.
  3. ๐Ÿšง Modifications:

    • The footer in the Dashboard, such as "Powered by Majo.exe," must not be modified or removed.
    • The /about command must not be modified or removed. This command contains information about the project and its authors.
    • The project's source code must not be modified in any way that would remove or alter the original attribution.
    • The license must be included with any public distribution of the project or its modified source code.
  4. ๐Ÿ“ฆ Distribution:

    • You may not distribute the bot or its modified versions without adhering to the terms mentioned in this agreement.
    • Any public release or distribution must include clear attribution to the original author and a link to the original repository or source.
  5. โš–๏ธ Compliance:

    • Failure to comply with these terms may result in a violation of the agreement.
    • Legal action may be taken if these terms are not respected.

โ‰๏ธ Issues

If you have any issues with the page please create new issue here. When creating new issue please provide as much information as possible. If you can, please provide logs from console.

We will review your pull request as soon as possible. We might suggest some changes or improvements.

๐Ÿ“ฅ Pull Requests

When submitting a pull request:

  • Clone the repository (git clone https://github.com/igorkowalczyk/majo.exe)
  • 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 ๐Ÿฐ

Github repository views

majo.exe's People

Contributors

igorkowalczyk avatar renovate[bot] avatar dependabot[bot] avatar r-kjha avatar whxyu1337 avatar plsletmeee avatar 0armaan025 avatar binary-blazer avatar dairyweb3638077 avatar imgbotapp avatar ddiabla avatar mridulsharma03 avatar phpxcoder avatar wafelowski avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.