Server Install: Difference between revisions

Revision as of 00:44, 22 July 2025

This guide will walk you through installing and configuring a dedicated server for Vault Hunters 3rd Edition

System Requirements

Minimum Requirements
RAM: 6 GB base + 2 GB per concurrent player Example: 10 GB total for 2 players, 12 GB for 3 players, etc. Java Version: Java 17 (required) Minecraft Version: 1.18.2 Mod Loader: Forge Storage: At least 5 GB free disk space

Recommended Specifications
CPU: Modern multi-core processor RAM: 8 GB base + 2 GB per player (for optimal performance) Storage: SSD for better world loading performance

Hosting Options

3rd Party Host

By far, the easiest way to start your own Vault Hunters server is through a 3rd party hosting provider. We have partnered with Bisect Hosting as our official hosting provider. Better yet, if you use code Iskall85 at checkout, you can save 25% on your first server!

Host Your Own Server

If you don't want to use a a 3rd party hosting provider, or you already have your own server infrastructure, you can of course host your own server.

Manual Install

Windows

Linux / MacOS / BSD

Scripted Install

We have community-maintained scripted installers available at our GitHub

Memory Allocation Guidelines

Adjust -Xms and -Xmx values based on your expected player count:

2-3 players: -Xms6G -Xmx10G
4-5 players: -Xms8G -Xmx14G
6+ players: -Xms10G -Xmx16G or higher

Performance Optimization

Performance Mods

The Vault Hunters community maintains a list of compatible performance mods. Visit the Discord Server performance mod thread for the latest recommendations.

Important: Some performance mods overlap in functionality. Carefully review compatibility and avoid conflicting mods that modify the same game systems.

Alternative JVM Options

If you prefer GraalVM, install GraalVM JDK 17 and use similar flags with the GraalVM java executable for potentially better performance.

Troubleshooting

Common Issues

1. Insufficient RAM

Problem: Server crashes with OutOfMemoryError or runs extremely slowly

Solutions:

Increase -Xmx value in your start script
Ensure your system has enough available RAM
Check that -Xms and -Xmx are set appropriately for your player count
Verify no other memory-intensive applications are running

Example Error:

java.lang.OutOfMemoryError: Java heap space

2. Java Version Issues

Problem: Server fails to start with Java-related errors

Solutions:

Confirm you're using Java 17 (not Java 8, 11, or newer versions)
Update your PATH environment variable if needed
Use the full path to Java 17 in your start script

3. Port Already in Use

Problem: Server can't bind to port 25565

Solutions:

Change server-port in server.properties
Stop other Minecraft servers using the same port
Check for other applications using port 25565

4. Mod Loading Errors

Problem: Server crashes during mod loading

Solutions:

Ensure all mod files are properly downloaded
Verify you're using the correct server pack version
Check that no mods were corrupted during download
Re-download the server pack if necessary

Log Files

Server logs are located in:

Main log: logs/latest.log
Crash reports: crash-reports/ folder

When seeking help, always provide relevant log snippets showing the error.

Server Management

Regular Maintenance

Backups: Regularly backup your world/ folder and server files
Updates: Check for new Vault Hunters versions periodically
Monitoring: Keep an eye on RAM usage and server performance
Restart Schedule: Consider automatic restarts every 6-12 hours for optimal performance

Commands

Use standard Minecraft server commands:

/op <player> - Give operator permissions
/whitelist add <player> - Add to whitelist
/save-all - Force save the world
/stop - Safely stop the server

Getting Help

If you encounter issues not covered in this guide:

Check logs for specific error messages
Visit the Vault Hunters Discord for community support
Search existing discussions for similar problems
Provide detailed information when asking for help:
- Server specifications
- Java version
- Exact error messages
- Relevant log excerpts

Additional Resources

Last updated for Vault Hunters 3rd Edition v3.18.3

@@ Line 21: / Line 21: @@
 }}
-== From a Hosting Provider ==
+== Hosting Options ==
+=== 3rd Party Host ===
 By far, the easiest way to start your own Vault Hunters server is through a 3rd party hosting provider.  We have partnered with [https://bisecthosting.com/p/vaulthunters Bisect Hosting] as our official hosting provider. Better yet, if you use code <code>Iskall85</code> at checkout, you can save 25% on your first server!
-=== Host Your Own ===
+=== Host Your Own Server ===
 If you don't want to use a a 3rd party hosting provider, or you already have your own server infrastructure, you can of course host your own server.
@@ Line 79: / Line 79: @@
 #* Double-click <code>start.bat</code> to start your server. First startup may take several minutes as Forge loads all mods.
 }}
+{{Hidden
+ | Linux / MacOS / BSD
+ |
+# Install Java 17
+#* {{Hidden
+    | Ubuntu/Debian
+    |
+     <pre>
+     sudo apt update
+     sudo apt install openjdk-17-jdk
+     java --version
+     </pre>
+   }}
+#* {{Hidden
+    | CentOS/RHEL/Fedora/Rocky
+    |
+     <pre>
+     sudo dnf install java-17-openjdk-devel
+     java --version
+     </pre>
+   }}
+ #* {{Hidden
+    | MacOS (using Homebrew)
+    |
+     <pre>
+     brew install openjdk@17
+     java --version
+     </pre>
+   }}
+#* {{Hidden
+    | CentOS/RHEL/Fedora/Rocky
+    |
+     <pre>
+     sudo dnf install java-17-openjdk-devel
+     java --version
+     </pre>
+   }}
+#* {{Hidden
+    | FreeBSD/OpenBSD (via pkg)
+    |
+     <pre>
+     pkg install openjdk17
+     java --version
+     </pre>
+   }}
+#* If you followed the commands above, you should see an output similar the following, after running <code>java --version</code>
+#** <pre>openjdk version "17.0.12" 2024-07-16 LTS
+OpenJDK Runtime Environment Microsoft-9889599 (build 17.0.12+7-LTS)
+OpenJDK 64-Bit Server VM Microsoft-9889599 (build 17.0.12+7-LTS, mixed mode, sharing)</pre>
-==== Linux/MacOS/BSD ====
+# Create Server Directory
+#*<pre>mkdir ~/VaultHunters-Server
+cd ~/VaultHunters-Server</pre>
-===== Step 1: Install Java 17 =====
+# Download and Install Forge
-'''For Ubuntu/Debian:'''
+#* TBD
- sudo apt update
- sudo apt install openjdk-17-jdk
-'''For CentOS/RHEL/Fedora:'''
+# Download Server Files
- sudo dnf install java-17-openjdk-devel
+#* Navigate to the [https://www.curseforge.com/minecraft/modpacks/vault-hunters-1-18-2 Vault Hunters CurseForge page]
+#* Go to the "Files" tab
-'''For macOS (using Homebrew):'''
+#* Find version '''3.18.3'''
- brew install openjdk@17
+#* Click on the version to view details
+#* In the "Additional Files" section, download the '''Server Pack'''
-'''For BSD systems:'''
+#* Extract the server files to your server directory
- pkg install openjdk17
-Verify installation:
- java -version
-===== Step 2: Create Server Directory =====
-<pre>mkdir ~/VaultHunters-Server</pre>
-<pre>cd ~/VaultHunters-Server</pre>
-===== Step 3: Download and Install Forge =====
-TBD
-===== Step 4: Download Server Files =====
-# Navigate to the [https://www.curseforge.com/minecraft/modpacks/vault-hunters-1-18-2 Vault Hunters CurseForge page]
-# Go to the "Files" tab
-# Find version '''3.18.3'''
-# Click on the version to view details
-# In the "Additional Files" section, download the '''Server Pack'''
-# Extract the server files to your server directory
-===== Step 5: Create Start Script =====
-Create a file named <code>start.sh</code> in your server directory:
-TBD
+# Create Start Script
+#* Create a file named <code>start.sh</code> in your server directory:
+#* <pre>TBD</pre>
 '''Important''': Replace <code>[version]</code> in the jar filename with the actual Forge version number from your downloaded files.
-===== Step 6: Initial Server Setup =====
+# Initial Server Setup
-# Run the server for the first time:
+#* Run the server for the first time:
-  ./start.sh
+#** <code>./start.sh</code>
-# The server will create necessary files and then stop
+#* The server will create necessary files and then stop
-# Edit <code>eula.txt</code> and change <code>eula=false</code> to <code>eula=true</code>:
+#* Edit <code>eula.txt</code> and change <code>eula=false</code> to <code>eula=true</code>:
-  nano eula.txt
+#** nano eula.txt
-# Optionally, edit <code>server.properties</code> to configure server settings:
+#* Optionally, edit <code>server.properties</code> to configure server settings:
-  nano server.properties
+#** nano server.properties
-===== Step 7: Start Your Server =====
+# Start Your Server
-Execute <code>./start.sh</code> to start your server. First startup may take several minutes as Forge loads all mods.
+#* Execute <code>./start.sh</code> to start your server. First startup may take several minutes as Forge loads all mods.
+}}
-== Scripted Install ==
+==== Scripted Install ====
 {{Hatnote|The scripts provided below are offered AS-IS and may not work in all cases. They are provided for convenience but may require modification for your specific system configuration.}}