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
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
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
Select the newest upload and under the Additional Files select the Server File
Select Download
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
I use the standalone app
Search for Vault Hunters 3 and select Install
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
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
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:
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-athend
To reconnect
screen -list
screen -r ####
To stop the server
stop