Vault Hunters 3 Server on Linux (No GUI) - travisriddle/docs GitHub Wiki

Description

This describes the steps I used to create a Vault Hunters 3 server running on a Ubuntu Linux server. While a Linux Desktop (GUI) is required to for part of the Curse Forge setup, it isn't required to run the server. On my system, the Ubuntu Linux server is virtualized using Proxmox.

Resources

  • Proxmox 8.0.4
  • Ubuntu Server 22.4.3 LTS
    • 2 cores, 12GB memory
    • IP Address 192.168.0.40 in this example.
  • OpenJDK 17
  • unzip
  • Minecraft 1.18.2
  • Vault Hunters 3rd Edition 3.12.4

Prepare Linux environment

I decided to run all of my minecraft instances from the folder /mc. You can run it from the home directory of a dedicated user if you like, or /opt/myfavoriteminecraftvaulthuntersinstallationlocation to keep root clean. You do you. I am going with /mc because I would like to add a couple of users to a group that has write permissions on my installation folder, and I don't care if / has one more folder as this is a system dedicated to minecraft. In addition, I don't want to type /usr/local/mc or even /opt/mc.

sudo mkdir -p /mc/vaulthunters

sudo mkdir /mc/server - This is where I keep the Vault Hunters server files

sudo mkdir /mc/mods - This is where I keep the mod packs I copy over from my PC

I also want to run my instances with a dedicated user account.

sudo useradd -b / -s /bin/bash mc - (-b / sets the home folder to /mc, -s sets the user shell to bash, mc is the user)

sudo pw mc - This sets the password for the mc user.

Add group write permisions to my folder

sudo chmod -R g+w /mc - (the -R sets the permission recursively through the sub-folders)

Add my user to the mc group:

sudo usermode -G mc -a myusername - (The -G mc adds the user to the group mc, the -a appends the user to the requested group)

Install Java 17

sudo apt install openjdk-17-jre -y

You will also want to install unzip for later use

sudo apt install unzip -y

Your linux system should be ready to go

Preparing the base Forge install

Download the latest installer:

Minecraft Forge - MC 1.18.2 Installer

wget https://maven.minecraftforge.net/net/minecraftforge/forge/1.18.2-40.3.0/forge-1.18.2-40.3.0-installer.jar

chmod u+x forge-1.18.2-40.3.0-installer.jar

cd /mc/vaulthunters

java -jar /mc/01-gamefiles/forgeserver/forge-1.18.2-40.3.0-installer.jar --installServer

This will be the foundation of your Vault Hunters 3 server

Prepare the Minecraft Server Instance

As the mc user:

cd /mc/vaulthunters

rm run.bat - We do not need this file on Linux

./run.sh

Change eula=true:

vi eula.txt - You can use nano to edit the file instead of vi

image

vi user_jvm_args.txt - You can use nano to edit the file instead of vi

Remove the # and update memory value to at least 8G of memory

image

Download and extract the Vault Hunters server files

Because CurseForge is the way they are, they want to show you a bunch of ads and garbage links for stuff you don't want. This also makes it difficult to get an actual link to download the file directly, so I just download the file and copy it to my server.

Vault Hunters 3 Curse Forge Files

image

Select the newest upload and under the Additional Files select the Server File

image

Select Download

image

This should start a download which saves to your default download location.

Open Terminal and copy the file to your server (I am using a Windows 11 PC)

scp C:\Users\travi\Downloads\Vault-Hunters-3rd-Edition-3.12.4-server-files.zip 192.168.0.40:/mc/server

We will extract this file a little later on.

Install CurseForge and Vault Hunters on the PC you will be playing from

CurseForge Installer

I use the standalone app

Search for Vault Hunters 3 and select Install image

Once installation is complete, you will copy some of the folders over to your dedicated server. You can find where your files are located by right clicking Vault Hunters and selecting Open Folder

image

Using terminal run this command to copy these five folders (config, defaultconfigs, mods, patchouli_books, scripts)

scp ~/curseforge/config [email protected]:/mc/mods/

scp ~/curseforge/defaultconfigs [email protected]:/mc/mods/

scp ~/curseforge/mods [email protected]:/mc/mods/

scp ~/curseforge/patchouli_books [email protected]:/mc/mods/

scp ~/curseforge/scripts [email protected]:/mc/mods/

Update your Minecraft instance with the Vault Hunters server files and folders

ssh to your Linux server

Extract the Vault Hunters server files that you uploaded earlier

cd /mc/vaulthunters

unzip /mc/server/Vault*.zip

If asked to replace files, select A

image

Copy the folders you uploaded from your PC.

It is important to remove 2 mods that are client side only. If you do not remove these files, the server will not start.

rm /mc/mods/mods/torohealth-1.18-forge-2.jar

rm /mc/mods/mods/LegendaryTooltips-1.18.2-1.3.1.jar

The last step is to copy the folders from the mods directory (these are the folders you copied from your PC)

cp -r /mc/mods/* /mc/vaulthunters

Start your Vault Hunters 3 instance for the first time

cd /mc/vaulthunters

./run.sh --nogui

Once the server is up and running you should see the following:

image

Stop the server:

stop

Starting the Minecraft instance for regular use

I like to use the screen command to start the instance. This way I can disconnect without shutting down the server.

cd /mc/vaulthunters

screen - Press Enter

./run.sh --nogui

Once the server is up and running, you can disconnect from screen

ctrl-a then d

To reconnect

screen -list

screen -r ####

To stop the server

stop