Over-engineered open-source Minecraft anarchy server โ made in Brasil ๐ง๐ทโจ
This monorepo uses npm as a package manager. It includes the following applications:
apps
: web applications related to the serverpackages
: libraries shared between appsplugins
: first-party Minecraft plugins source codeservers
: the Minecraft servers configuration files and plugin binaries
Make sure you have Node.js v20 installed with npm v8 or up. You can easily change your Node version using nvm:
$ nvm install 20
$ nvm use 20
For plugin development, you will need JDK 17 and Maven. To install them on macOS using Homebrew, run:
$ brew install openjdk@17 maven
Finally, you will also need to have Docker and Docker Compose installed. You can easily get both by installing the much recommended Docker Desktop.
First off, install the dependencies by running the following command:
$ npm install
Then, you will need to setup your environment variables. You can do this by copying the example file:
$ cp .env.example .env
Now, open your /etc/hosts
file and add these lines to the end:
127.0.0.1 ssn.local id.ssn.local gk.ssn.local rcon.ssn.local cmd.ssn.local
::1 ssn.local id.ssn.local gk.ssn.local rcon.ssn.local cmd.ssn.local
You can now start all the containers by running this command:
$ npm run start
๐ You should now be able to join the Minecraft server using the IP ssn.local and open http://ssn.local in your browser.
To build a plugin and copy the artifact to the server, you can run this command:
# npm run build:plugin-name
$ npm run build:catraca
To build (and publish) the server Docker images, run:
$ chmod +x ./scripts/build-and-publish.sh # once
$ ./scripts/build-and-publish.sh
For deploying in production, clone this repository to your server. Alternatively, copy only the following files to your server:
- docker-compose.prod.yml
- .env.example (rename this to .env)
- /servers
Setup the environment variables inside ".env" properly:
- Generate random and strong passwords for the keys
- Configure the memory allocation according to your server
- Fill in external sevice keys (like Discord, Turnstile and SendGrid)
- Update the volume mount points to local paths
You will need to expose the 25565
and 80
ports from your server according to your hosting provider instructions.
Then simply run:
$ chmod +x ./scripts/start.sh # once
$ ./scripts/start.sh
To enable automatic restarts, you'll need to setup a cron job to run the scripts/restart.sh
script. Begin by making all scripts in the scripts directory executable:
$ find scripts -type f -iname "*.sh" -exec chmod +x {} \;
Then, get the full path to the restart script:
$ realpath ./scripts/restart.sh
# /path/to/restart.sh
Finally, you can use crontab
to add your cron job as you wish. I like to run it every day, a minute before 6am (to account for the restart warning) โ remember to check your system time beforehand!
$ crontab -e
# if vim opens by default you can also use:
# EDITOR="nano" crontab -e
59 5 * * * /path/to/restart.sh
If you need help with cron, you can refer to crontab.guru.
First of all, thank you for your interest in making SSN better! Contributions are always welcomed. Feel free to open an issue with your suggestion or bug report, preferably in Brazilian Portuguese. Please, read our contribution guidelines before working on an issue.
The SSN project is licensed under the GPLv3 License.