A RPG game for Discord.
Rewrite
This project is currently going under a rewrite. If you want to do any changes or PRing, please do so on the new dev branch.
๐ค How can I add her?
If you want to use NoManaRPG on your server, you can add our public instance by clicking here! We recommend using the public instance, after all, more than 40 guilds already use, trust and love her, so why not try it out?
You can also host NoManaRPG yourself, however we won't give support for people that are trying to selfhost her, we don't want to spend hours trying to troubleshoot other people issues that only happens on selfhosted instances, so you should at least know how to troubleshoot issues, if you find any.
๐ Selfhosting NoManaRPG (Discord)
๐ Selfhosting conditions and warnings
If you are planning to selfhost NoManaRPG, here are some stuff that you should keep in mind...
- We keep the source code open so people can see, learn and be inspired by how NoManaRPG was made and, if they want to, they can help the project with features and bug fixes.
- This is a community project, if you make changes to NoManaRPG's source code you need to follow the AGPL-3.0 and keep the changes open source! And, if you want to help NoManaRPG, why not create a pull request? ๐
- We won't give support for selfhosted instances, you need to know how to troubleshoot the issues yourself. We tried to make the selfhost process as painless as possible, but it is impossible to know all the different issues you may find.
- Don't lie saying that you "created NoManaRPG". Please give credits to the creators!
- NoManaRPG requires a lot of different API keys for a lot of features. While they aren't required, you may encounter issues when trying to use some of the features.
- NoManaRPG's assets (fonts, images, etc) aren't not distributed with the source code, you will need to create and include your own assets.
- We use Ubuntu 18.04 to run her, she may work on other Linux operating systems or even in Windows, but we recommend hosting her on Ubuntu!
- To avoid problems and confusions, we do not allow using the name "NoManaRPG", "ClastRPG" or any similar names on your selfhosted versions. Call her "Nii RPG" if you aren't creative enough to create your own name to give to your selfhosted version. Don't like "Nii RPG"? Generate your own here!
Seems too hard but you really want to use NoManaRPG? Don't worry, you can use our free public instance by clicking here clicking here!
๐ท Prerequisites
- PowerShell (Windows) or Terminal (Linux).
โ ๏ธ While Windows' command prompt may work, it is better to use PowerShell!
- You need to have the .net core installed on your machine.
- You need to have Git installed on your machine.
- You need to have Mongo installed on you machine.
- If you want to help to develop NoManaRPG, or if you only want a good C# IDE, then download Visual Studio IDE! The community edition is enough, so you don't need to be like "oh my god I need to pay for it". ๐
๐งน Preparing the environment
- Clone the repository with git:
git clone https://github.com/TalionOak/NoManaRPG.git
๐ป Compiling
- Go inside the source code folder and open PowerShell or the terminal inside of it.
Linux:
make build
Windows:
dotnet build
Publish
Linux:
make publish
Windows:
dotnet publish -c Release -r win10-x64 --self-contained true -o published
Update the configurations with your own values. You don't need to configure everything, just the bare minimum (bot token, folders, databases, etc) to get her up and running!
Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.