Knowledgebase

Vintage Story is a sandbox game that focuses on exploration, crafting, and survival in a procedurally generated world. Players can build, trade, and explore in a rich, dynamic world with realistic systems of weather, geology, and resource management. Setting up a dedicated server allows you to host a private world that you and your friends can access anytime.

In this guide, we will walk you through the process of setting up a Vintage Story dedicated server on your AnonVM VPS.

Prerequisites

Before starting the installation, make sure you have the following:

• A VPS from AnonVM with at least 2-4 GB of RAM and 2 CPU cores (depending on the number of players).
• SSH access to your VPS.
• Java 8 or higher installed (Vintage Story requires Java to run).
• Basic knowledge of Linux commands.

Step 1: Access Your AnonVM VPS

1. Log in to your AnonVM account and access your VPS dashboard.
2. Use an SSH client like PuTTY (for Windows) or the terminal (for Linux/Mac) to connect to your VPS:
    

   ssh root@your-vps-ip
   Replace your-vps-ip with the actual IP address of your VPS. Enter your password when prompted.

Step 2: Install Java 8 or Higher

Vintage Story requires Java to run. To install Java, follow these steps:

1. Update your system:

    

   apt-get update && apt-get upgrade -y

2. Install OpenJDK (Java 8 or higher):

    

   apt-get install openjdk-11-jdk -y

3. Verify Java installation: To ensure Java is installed correctly, run:

    

   java -version

   You should see something like openjdk version "11.x.x". If so, Java is installed successfully.

Step 3: Download and Install Vintage Story Server Files

Now, let’s download and install the server files for Vintage Story.

1. Create a directory for the server:

    

   mkdir /home/vintagestory cd /home/vintagestory

2. Download the latest server files: Use wget to download the server package from the official Vintage Story website. At the time of writing, the server files can be found at https://www.vintagestory.at/download/.

   For example:

    

   wget https://www.vintagestory.at/download/server.zip

3. Extract the server files: Once the download is complete, unzip the server files:

    

   unzip server.zip

Step 4: Configure the Server

Once the files are extracted, you will need to configure the server.

1. Navigate to the server directory:

    

   cd /home/vintagestory/VintageStory

2. Edit the server configuration file: The configuration file is located in the configs directory. You can modify various settings such as world size, server name, and more.

   Open the worldgenconfig.json and serverconfig.json files for editing:

    

   nano configs/serverconfig.json
   • Server Name: Set the name of your server.
   • Max Players: Define the maximum number of players allowed (e.g., maxPlayers: 10).
   • Password: If you want a password-protected server, set a password in the configuration file.

   Save and exit the file by pressing CTRL + X, then Y to confirm.

3. Adjust world generation settings: You can also modify the worldgenconfig.json file to adjust world generation settings, such as biomes and resource distribution.

Step 5: Open Required Ports

To allow players to connect to your server, you need to open the necessary ports.

1. Open the default game port (TCP/UDP 19100):
    

   ufw allow 19100/tcp ufw allow 19100/udp ufw reload

Step 6: Start the Vintage Story Server

1. Start the server: Use the following command to start your Vintage Story server:

    

   java -jar VintageStoryServer.jar

   This will launch the server. The console will display log messages and various server events, such as player connections and world saving.

2. Run the server in the background: To run the server in the background so that it continues running even after you disconnect from SSH, use screen or tmux:

    

   screen -S vintagestory java -jar VintageStoryServer.jar

   Press CTRL + A, then D to detach from the screen session. You can reattach to it anytime using:

    

   screen -r vintagestory

Step 7: Connect to Your Server

1. Launch Vintage Story on your PC.
2. Go to the Multiplayer menu and select Join Game.
3. Enter the IP address and port of your server (e.g., your-vps-ip:19100).
4. If your server has a password, you will be prompted to enter it.

Step 8: Maintain and Update the Server

To keep your server up to date, follow these steps:

1. Stop the server by pressing CTRL + C in the screen session or closing the terminal window if running in the background.

2. Download the latest server files using the same steps you used to install the server initially, replacing the old files with the new ones.

3. Restart the server with the updated files:

    

   java -jar VintageStoryServer.jar

Conclusion

You have now set up your own Vintage Story dedicated server on your AnonVM VPS! You can modify the server's settings, invite friends, and enjoy exploring the world of Vintage Story together. If you need further customization or have any issues, the Vintage Story community and official documentation provide helpful resources.