User:Mnooseman/TestServerInstall

This guide will walk you through installing and configuring a dedicated server for Vault Hunters 3rd Edition v3.18.3 running on Minecraft 1.18.2 with Forge.

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
• Network: Standard Minecraft port (25565)

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

Manual Install

Windows

Step 1: Install Java 17

1. Download Java 17 from Oracle JDK 17 or OpenJDK 17
2. Install Java 17 following the installer prompts
3. Verify installation by opening Command Prompt and running:

java -version

1. You should see output indicating Java 17

Step 2: Create Server Directory

1. Create a new folder for your server (e.g., C:\VaultHunters-Server)
2. Navigate to this folder

Step 3: Download Server Files

1. Navigate to the Vault Hunters CurseForge page
2. Go to the "Files" tab
3. Find version 3.18.3
4. Click on the version to view details
5. In the "Additional Files" section, download the Server Pack
6. Extract the server files to your server directory

Step 4: Create Start Script

Create a file named start.bat in your server directory with the following content:

@echo off
java -Xms6G -Xmx10G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true -jar forge-[version].jar nogui
pause

Important: Replace [version] in the jar filename with the actual Forge version number from your downloaded files.

Step 5: Initial Server Setup

1. Double-click start.bat to run the server for the first time
2. The server will create necessary files and then stop
3. Edit eula.txt and change eula=false to eula=true
4. Optionally, edit server.properties to configure server settings:
   • server-port=25565 (or your preferred port)
   • max-players=20 (or your preferred limit)
   • difficulty=normal

Step 6: Start Your Server

Double-click start.bat to start your server. First startup may take several minutes as Forge loads all mods.

Linux/MacOS/BSD

Step 1: Install Java 17

For Ubuntu/Debian:

sudo apt update
sudo apt install openjdk-17-jdk

For CentOS/RHEL/Fedora:

sudo dnf install java-17-openjdk-devel

For macOS (using Homebrew):

brew install openjdk@17

For BSD systems:

pkg install openjdk17

Verify installation:

java -version

Step 2: Create Server Directory

mkdir ~/VaultHunters-Server
cd ~/VaultHunters-Server

Step 3: Download Server Files

1. Navigate to the Vault Hunters CurseForge page
2. Go to the "Files" tab
3. Find version 3.18.3
4. Click on the version to view details
5. In the "Additional Files" section, download the Server Pack
6. Extract the server files to your server directory

Step 4: Create Start Script

Create a file named start.sh in your server directory:

#!/bin/bash
java -Xms6G -Xmx10G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true -jar forge-[version].jar nogui

Make the script executable:

chmod +x start.sh

Important: Replace [version] in the jar filename with the actual Forge version number from your downloaded files.

Step 5: Initial Server Setup

1. Run the server for the first time:

 ./start.sh

1. The server will create necessary files and then stop
2. Edit eula.txt and change eula=false to eula=true:

 nano eula.txt

1. Optionally, edit server.properties to configure server settings:

 nano server.properties

Step 6: Start Your Server

Execute ./start.sh to start your server. First startup may take several minutes as Forge loads all mods.

Scripted Install

Windows

Create a file named install-vh-server.bat and run it as Administrator:

@echo off
echo Installing Vault Hunters 3rd Edition Server...

REM Create server directory
mkdir "C:\VaultHunters-Server"
cd /d "C:\VaultHunters-Server"

REM Check for Java 17
java -version 2>&1 | find "17" >nul
if errorlevel 1 (
    echo Java 17 not found. Please install Java 17 first.
    pause
    exit /b 1
)

echo Java 17 detected.
echo Please download the server pack from CurseForge and extract it to this directory.
echo Press any key once you've extracted the files...
pause

REM Find the forge jar file
for %%f in (forge-*.jar) do set FORGE_JAR=%%f

if not defined FORGE_JAR (
    echo Forge jar file not found. Please ensure you extracted the server pack.
    pause
    exit /b 1
)

REM Create start script
echo @echo off > start.bat
echo java -Xms6G -Xmx10G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true -jar %FORGE_JAR% nogui >> start.bat
echo pause >> start.bat

echo Installation complete!
echo Run start.bat to start your server.
pause

Linux/MacOS/BSD

Create a file named install-vh-server.sh and make it executable:

#!/bin/bash

echo "Installing Vault Hunters 3rd Edition Server..."

# Check for Java 17
if ! java -version 2>&1 | grep -q "17"; then
    echo "Java 17 not found. Please install Java 17 first."
    
    # Attempt to install on common systems
    if command -v apt &> /dev/null; then
        echo "Detected apt package manager. Install with: sudo apt install openjdk-17-jdk"
    elif command -v dnf &> /dev/null; then
        echo "Detected dnf package manager. Install with: sudo dnf install java-17-openjdk-devel"
    elif command -v brew &> /dev/null; then
        echo "Detected Homebrew. Install with: brew install openjdk@17"
    elif command -v pkg &> /dev/null; then
        echo "Detected pkg package manager. Install with: pkg install openjdk17"
    fi
    
    exit 1
fi

echo "Java 17 detected."

# Create server directory
SERVER_DIR="$HOME/VaultHunters-Server"
mkdir -p "$SERVER_DIR"
cd "$SERVER_DIR"

echo "Please download the server pack from CurseForge and extract it to: $SERVER_DIR"
echo "Press Enter once you've extracted the files..."
read -r

# Find the forge jar file
FORGE_JAR=$(find . -name "forge-*.jar" | head -n 1)

if [ -z "$FORGE_JAR" ]; then
    echo "Forge jar file not found. Please ensure you extracted the server pack."
    exit 1
fi

# Create start script
cat > start.sh << EOF
#!/bin/bash
java -Xms6G -Xmx10G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true -jar $FORGE_JAR nogui
EOF

chmod +x start.sh

echo "Installation complete!"
echo "Server installed in: $SERVER_DIR"
echo "Run ./start.sh to start your server."

Make it executable and run:

chmod +x install-vh-server.sh
./install-vh-server.sh

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 performance 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.

Server.properties Optimizations

Consider these additional server.properties settings for better performance:

view-distance=10
simulation-distance=10
entity-broadcast-range-percentage=100

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:

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

Additional Resources

• Vault Hunters CurseForge Page
• Vault Hunters Discord Community
• Aikar's Flags Documentation
• Discord Performance Mods Thread

---

Last updated for Vault Hunters 3rd Edition v3.18.3