• The script does not require a graphical desktop environment and can be run from CLI environments - it prints text to terminal, not graphics!

1. Make a folder and place your folder of mods and any others like config, defaultconfigs, scripts inside.
   Or, if using a server pack extract the Zip file for the server pack to the folder.
2. Download the Universalator zip file, then extract the *.sh extension script file from it.
   Or use the direct download method as shown in specific Distro examples.
3. Open a terminal window with prompt in the same folder
4. Run the script, first installing any required depedency packages (See Distro specific instructions below).

• From Terminal in server folder:

curl -O https://raw.githubusercontent.com/nanonestor/universalator/latest-linux/Universalator-linux.sh
sudo apt update
sudo apt upgrade
sudo apt install xmlstarlet jq dnsutils zip unzip
chmod +rwx Universalator-linux.sh
bash Universalator-linux.sh

• From Terminal in server folder:

curl -O https://raw.githubusercontent.com/nanonestor/universalator/latest-linux/Universalator-linux.sh
sudo pacman -Sy
sudo pacman -S xmlstarlet jq dnsutils zip unzip
chmod +rwx Universalator-linux.sh
bash Universalator-linux.sh

• From Terminal in server folder:

curl -O https://raw.githubusercontent.com/nanonestor/universalator/latest-linux/Universalator-linux.sh
sudo yum update
sudo yum install xmlstarlet jq perl-Digest-SHA zip unzip
or this: sudo dnf check-update
or this: sudo dnf install xmlstarlet jq perl-Digest-SHA zip unzip
chmod +rwx Universalator-linux.sh
bash Universalator-linux.sh

1. It is highly suggested to install the command line utility homebrew to install required packages from macOS terminals.
   https://brew.sh/

2. NOTE: MacOS (previously known as OSX) Comes by default installed with an absurdly old version of the 'bash' utility due to newer versions of 'bash' having licensing requirements apple wishes to avoid (publishing all of their source code publicly).

   • Universalator requires you to install 'bash' version 5.0 or newer to function.
   • If you have the homebrew utility (see 1. above), you can install the newest bash version from terminal:
     brew install bash

3. From Terminal in server folder:

   • Download the latest version of the Universalator script:
     curl -O https://raw.githubusercontent.com/nanonestor/universalator/latest-linux/Universalator-linux.sh
   • Install any system utilities which the script requires using the homebrew package manager:
     brew install xmlstarlet jq bind zip unzip
   • Add the relevant permisions to the script so that it can be allowed to work:
     chmod +rwx Universalator-linux.sh
   • Run the script:
     bash Universalator-linux.sh

   For any future script use, merely run the script file again with bash Universalator-linux.sh

• Use main menu to manage settings and then launch server!
  Modloader (Forge/Neoforge/Fabric) and Java files will be downloaded and installed automatically when launching.
• From now on you may start the script again by doing simply:
  bash Universalator-linux.sh

Example Settings

1. Set OS firewall - to allow the port to be used (default 25565) through.
   • The command below works using the ufw package ('Uncomplicated Firewall') to set the OS firewall to allow programs to send/recieve the 25565 port number.

sudo ufw allow 25565

2. Set port forwarding rule - to allow traffic through network router - ( TCP protocol / port number / host computer or VM local IPv4 )
   • Log into your network router and set a port forwarding rule - entering your local ipv4 address, port number(s) to be used, and TCP. If using a voicechat mod - add additional rules for whichever ports are used (usually 24454 UDP)