T6 Server - Plutonium Black Ops II Server Installer

<div style="display: flex; align-items: center;"> <img src="https://github.com/user-attachments/assets/3ee17ff5-25fa-494e-b874-610507794756" alt="image" width="400"/> <img src="https://imgur.com/bBrx8Hf.png" alt="Plutonium showLogo" width="400" style="margin-left: 10px;"/> </div>

T6 Server is a comprehensive management suite for setting up and running Plutonium Call of Duty: Black Ops II servers on Debian-based systems. This project aims to simplify the process of installing, configuring, and managing T6 servers, making it accessible to both beginners and experienced server administrators.

<center><b>Full video tutorial:</b> https://www.youtube.com/watch?v=iuTV-8hCv7M</center> <br><br>

⚠️ During the installation, the game binaries are downloaded using the Plutonium T6 torrent, as this was the historically recommended method for setting up a T6 server and avoids manual file handling for non-technical users.

Due to copyright issues, Plutonium cannot officially support this method publicly in order to avoid legal problems. However, it still works; the limitation is purely for legal reasons.

If you do not want to use this step and prefer to provide your own legally obtained game files, you will currently need to manually adapt the script and point it to your existing game directory.

Table of Contents

• T6 Server - Plutonium Black Ops II Server Installer
  • Table of Contents
  • Features
  • Prerequisites
    • System Requirements
    • Software Requirements
    • Network Requirements
    • Additional Considerations
  • Installation
  • Configuration
    • New Server Parameters
    • Default Ports
    • Directory Structure
    • File Organization
      • Custom Mods
      • Custom Maps
  • Launching the Server
  • Troubleshooting
    • Wine Display Errors
    • Unable to Load Import from binkw32.dll
    • Server Not Appearing in Plutonium Server List
    • Authentication Issues
  • Documentation
  • Contributing
    • Submitting Pull Requests
    • Ideas for Contributions
    • Reporting Issues
    • Improving Documentation
    • Code Review
  • Roadmap
    • Short-term Goals (1-3 months)
    • Medium-term Goals (3-6 months)
  • License
  • Acknowledgements
  • Support

Features

• Easy installation and uninstallation process
• Automated system updates and dependency management
• Firewall configuration and management with UFW
• Wine installation for Windows application support
• .NET Framework installation for IW4MAdmin support
• Multi-language support (English and French)
• Server binary installation and configuration
• User-friendly command-line interface
• MOD support with custom maps and game modes
• Advanced server configuration options
• Automatic server monitoring and resource tracking
• CPU and memory usage limits
• Detailed installation/uninstallation summaries
• System health monitoring and reporting
• Comprehensive logging and error handling
• Performance optimization tools

Prerequisites

System Requirements

• Operating System: Debian 10, 11, or 12 (64-bit)
• Architecture: x86_64 (AMD64)
• RAM: Minimum 512MB, 2GB recommended
• Storage: At least 15GB of free disk space

Software Requirements

• Root Access: Full system privileges (root or sudo)
• Package Manager: apt (comes pre-installed on Debian)
• Git: For cloning the repository

If you don't have sudo or git installed, you can install them as follows:

1. To install sudo (as root):

   apt install sudo
   

2. To install git:

   sudo apt install git
   

These commands will ensure you have the necessary software to proceed with the installation.

Network Requirements

• Internet Connection: Stable broadband connection
• Firewall: Ability to open and forward necessary ports
• Static IP: Recommended for consistent server accessibility

Additional Considerations

• Basic familiarity with Linux command line
• Understanding of server administration concepts
• Willingness to troubleshoot potential issues

Ensure all prerequisites are met before proceeding with the installation to guarantee a smooth setup process.

Installation

1. Navigate to the application installation directory:

   cd /opt
   

2. Download and extract T6Server archive in a single command:

   mkdir -p T6Server && wget -O T6Server.tar.gz https://github.com/Sterbweise/T6Server/releases/download/v3.1.1/T6Server.tar.gz && tar -xzvf T6Server.tar.gz -C T6Server && rm T6Server.tar.gz
   

3. Move into the newly created T6Server directory:

   cd T6Server
   

4. Make the script executable:

   chmod +x install.sh
   

5. Launch the installation script with sudo privileges:

   sudo ./install.sh
   

6. Follow the on-screen instructions to complete the installation. The script will guide you through:

   • Language selection
   • UFW firewall installation and configuration
   • SSH port configuration
   • .NET installation (optional, required for IW4MAdmin)
   • Wine installation
   • Game binary installation

Configuration

After installation, the primary configuration file to modify is /opt/T6Server/T6Server.sh. This file contains essential settings for your Plutonium Call of Duty: Black Ops II server. Below are the key variables you should configure:

| Variable | Description | Default Value | |-------------|-------------------------------------------------------|----------------------------| | SERVER_NAME | The name of your server as it appears in server lists | "SERVER_NAME" | | GAME_PATH | Path to your game files (Multiplayer or Zombie mode) | "/opt/T6Server/Server/Multiplayer" | | SERVER_KEY | Your unique Plutonium server key | "YOURKEY" | | CONFIG_FILE | Server configuration file (mode-specific) | "dedicated.cfg" | | SERVER_PORT | UDP port your server will listen on | 21889 | | GAME_MODE | Game mode selection ("t6mp" or "t6zm") | "t6mp" | | MOD | Path to your MOD directory (optional) | "" | | ADDITIONAL_PARAMS | Additional parameters for the server (optional) | "" |

To configure your server:

1. Open the configuration file:

   nano /opt/T6Server/Plutonium/T6Server.sh
   

2. Modify the variables according to your preferences. For example:

   readonly SERVER_NAME="My Awesome T6 Server" # The name of your server
   readonly SERVER_KEY="your_server_key" # Key provided by Plutonium
   readonly SERVER_PORT=4976 # Default port for T6 servers
   readonly GAME_MODE="t6mp" # "t6mp" for Multiplayer, "t6zm" for Zombies
   readonly MOD="mods/weapons" # MOD path
   readonly ADDITIONAL_PARAMS="" # Additional parameters for the server
   

3. Save the file and exit the editor by pressing Ctrl+x, then Y to confirm, and Enter to save.

Note: For Zombie mode, set GAME_PATH to "/opt/T6Server/Server/Zombie", CONFIG_FILE to "dedicated_zm.cfg", and GAME_MODE to "t6zm". Also, set the MOD variable to the path of the Zombie mode MOD.

Ensure all settings are correctly configured before launching your server.

New Server Parameters

• sv_allowAimAssist: Enable/disable aim assist (default: 1)
• sv_securityLevel: Server security level (recommended: 23)
• sv_kickBareGUID: Kicks players without valid GUID
• sv_allowDof: Controls depth of field effect

Default Ports

• T6 (Black Ops II): 21889 (UDP)

Directory Structure

| Directory | Path | Description | |-----------|------|-------------| | Mods | /opt/T6Server/Plutonium/storage/t6/mods/ | Custom game modifications | | Config - Multiplayer | /opt/T6Server/Server/Multiplayer/main/configs/ | Multiplayer configuration files | | Config - Zombie | /opt/T6Server/Server/Zombie/main/configs/ | Zombie mode configuration files | | Logs | /opt/T6Server/Plutonium/storage/t6/logs/ | Server log files | | Stats | /opt/T6Server/Plutonium/storage/t6/stats/ | Player statistics | | Playlists | /opt/T6Server/Plutonium/storage/t6/playlists/ | Custom game playlists | | Game Settings | /opt/T6Server/Plutonium/storage/t6/gamesettings/ | Game mode settings | | Player Data | `/opt/T6Ser