Skip to content

Latest commit

 

History

History
129 lines (99 loc) · 6.81 KB

README.md

File metadata and controls

129 lines (99 loc) · 6.81 KB
Raw

plutonium ubuntu

Server Installer for Linux

Simple installation and configuration of a T4/T5 server on Unix-like OSs with Wine support, this repo only provides instructions for T4/T5, but it's easily adjustable for T6 and other Plutonium supported games. This installer assumes you're using Ubuntu, but you can use it with every distro changing the dependencies links in install.sh. I actually use this on a Ubuntu AWS EC2 instance. Forked and based on T5Server

Synopsis

In this guide we'll cover the following topics:

  • Scripts usage, install.sh and T4/5_**_server.sh. The first one starts the configuration process (dependencies and firewall ports set-up), the second one starts the actual server using Wine.
  • Manual variables changing, depending on your needs (ports, IPs, folders).
  • Setting up FastDL for easier custom maps support on your server

Requirements

  • ~10GB dedicated for this server.
  • Root permissions.
  • T4-WaW/T5-BO1 gamefiles, you can easily find them on your own.

I highly recommend removing unnecessary game files on T4

I highly recommend removing unnecessary game files on T5

Instructions

  1. Clone the repository wherever you need to:
git clone https://github.com/framilano/PlutoniumLinuxHosting.git
  1. Move to PlutoniumLinuxHosting folder.
cd PlutoniumLinuxHosting/
  1. Run the Installation Script install.sh .
./install.sh

You'll be asked to type your OS root password, follow the instructions and you can choose to install:

  • UFW firewall for port forwarding. You'll be asked to choose which port to open for this Server and if you want to allow port 8000 for an HTTP Server (aka FastDL support on your Server)
  • Crossplatform plutonium-updater by mxve.
  • Wine dependencies.

These steps are necessary, but it allows the user to choose if they need them during configuration or they can provide their own versions (like using Wine Stable instead of Wine Staging).

I highly suggest to restart your VM/Container/OS after completing the installation, just to be sure that every env variable has been set correctly.

Configuration

Assuming you're configuring a T4 Server

  1. Copy your game files in /PlutoniumLinuxHosting/T4Gamefiles, if asked merge the main folder with the already existing one.
  2. Move to /PlutoniumLinuxHosting/T4Gamefiles/main Folder.
  3. Edit dedicated_zm.cfg or dedicated_mp.cfg according to your needs (change map rotation, enable FastDL).
  4. Move to /PlutoniumLinuxHosting/Plutonium Folder.
  5. Edit T4_**_server.sh with your informations. Specify /Plutonium and /T4Gamefiles directories with their full paths, type your Server Key.

Launch Server

  1. Move to /PlutoniumLinuxHosting/Plutonium Folder.
  2. Launch Server.
./T4_**_server.sh

It will update first your Plutonium files using plutonium-updater.

[Optional] FastDL support

For FastDL to work you need an HTTP Server serving your mods files. You can easily set up an http server with a single python module line:

python3 -m http.server --directory /home/ubuntu/PlutoniumLinuxHosting/Plutonium/storage/t4/

We're setting the HTTP Server to only serve files in /home/ubuntu/PlutoniumLinuxHosting/Plutonium/storage/t4/ you should type here the path to your mods directory, the default port is 8000. In this guide I assume that both HTTP and Plutonium Servers are on the same machine, but that's not required.

To easily start all the components and scripts I need at startup here's how I configured my crontab file:

#Dynamically updates the IP address for the HTTP Server
@reboot sed -i "/set sv_wwwBaseURL/c\set sv_wwwBaseURL \"http://$(curl ifconfig.me):8000\"" "/home/ubuntu/PlutoniumLinuxHosting/T4Gamefiles/main/dedicated_zm.cfg"

#Start HTTP Server for FastDL
@reboot (python3 -m http.server --directory /home/ubuntu/PlutoniumLinuxHosting/Plutonium/storage/t4/) &

#Start Plutonium Server
@reboot (cd /home/ubuntu/PlutoniumLinuxHosting/Plutonium && ./T4_zm_server.sh) &

#Start IW4MAdmin
@reboot ((sleep 60) && (cd /home/ubuntu/IW4MAdmin && ./StartIW4MAdmin.sh)) &

The first command is only useful if your VM/OS changes its public IP address every time you turn it ON, for instance, AWS EC2 instances. With the sed utility I replace the set sv_wwwBaseURL line value in dedicated_zm.cfg with my current public IP address. The fourth command just starts IW4MAdmin.

Usage Report

  • Removing the unnecessary game files, with default maps and a single custom map on a AWS EC2 t3a.micro Ubuntu instance, the occupied storage is around 9GB.
  • While the Server is running, the HTTP Server is working for FastDL and one player has joined the lobby, the average memory consumption is 620MB.

Important Notes!

  • Remember to open the server port using UFW with sudo ufw allow 28961/udp
  • There's a distinction for mods and maps when loading them. If you're loading a mod for a vanilla map, then your dedicated_zm.cfg will have this entry: 
    set sv_mapRotation "loadmod \"mods/mod_name_here\" map nazi_zombie_factory"
    This will load the mod mod_name_here for Der Riese

Issues

Wine display errors

  • You shouldn't care about these errors, Plutonium servers don't have any graphical support.

IW4MAdmin missing dotnet

  • sudo apt-get update && sudo apt-get install -y aspnetcore-runtime-8.0

Unable to load import '_BinkWaitStopAsyncThread@4' from module 'binkw32.dll'

  • Check your PAT variable in T4_**_server.sh. (It will be ping binkw32.dll dir)
  • Make sure to your user can read the file in all sub-dir of PlutoniumLinuxHosting.

Server doesn't appear in Plutonium Servers List

  • Check if your server port is open with UDP protocol. (Example: 28961)

Connection with nix socket lost

  • Check your plutonium key validity
  • Check if your plutonium key are correctly write in T4_**_server.sh

[DW][Auth] Handling authentication request

  • Check your plutonium key validity
  • Check if your plutonium key are correctly write in T4_**_server.sh

Source

• Plutonium
• Minami original topic
• Plutonium-Updater by mxve