T7x: Call of Duty® Black Ops III Client

<p align="center"> <img src="assets/github/banner-t7x.png?raw=true" /> </p>

---

[!IMPORTANT] T7x is cross-compatible with the BOIII Client. You can play the same servers on T7x and BOIII Client, however T7x is newer. You are <u>NOT</u> required to own Call of Duty: Black Ops 3 in order to play this client. Steam Ownership Verification has been <u>removed</u>. You can view the changes made from original repository here.

---

Table of Contents

• Client Download
• Prerequisites
• Install Instructions
  • Installer
  • Zip Archive (Manual Installation)
• Cloning the Repository
  • Using Git
• Repository Contents
• Added Features
  • Installing Git (Optional)
• Where Can I Get the Game?
  • Downloading qBittorrent
  • What If I Have a Pirated version?
• Command Line Arguments
• Loading Mods & Custom Maps
• Hosting a Dedicated Server
  • Requirements
  • Server Setup
  • Connecting
  • Connecting to Friends Without Port Forwarding
• Additional Steps Required for Hosting Zombies Dedicated Servers
• Compile from Source Code
  • Prerequisites
  • Build
    • Build Using Scripts
    • Build Using Tasks
• Disclaimer
• Credits
• End README
• README.md (Legacy)
  • What is T7x ☄️
  • Build
  • Writeups & Articles
  • Credits
  • Disclaimer

Client Download

Click here for all client related downloads

Prerequisites

• Call of Duty Black Ops III game files
• Windows 10/11 Operating System (those using Wine most likely don't need this guide)
• Steam installed (optional)

Install Instructions

<u>Installer</u>

1. Download or compile t7x-Installer-Win64.exe
2. Place in Call of Duty Infinite Warfare game directory and run

(The installer is fully Open Source and created using NSIS)

[!TIP]

• Run installer as Administrator if your game installation is in a protected folder (e.g. C:/Program Files)
• You DO NOT need to disable your anti-virus to run the installer

[!NOTE] The Installer:

• Installs the t7x client files and scripts
• Places the server configuration files
• Gives you the option to a Desktop shortcut for the t7x Client
• Creates uninstaller to remove all files

[!WARNING] The Uninstaller:

Removes ALL files, including savegames, player stats, loadouts, etc. If you wish to uninstall and play in the future, make a backup of the t7x/players folder located in your game directory

<u>Zip Archive (Manual Installation)</u>

1. Download t7x-Release-Win64.zip
2. Extract the contents of t7x-Release-Win64.zip into your Call of Duty Infinite Warfare game directory

   Note: The default Steam installation path is usually C:/Program Files (x86)/Steam/steamapps/common/Call of Duty Black Ops III

3. Launch the game using either t7x.exe or !start_client.bat
4. You can change your name by modifying Call of Duty Black Ops III/t7x/players/properties.json or use /name PLAYERNAME in-game.

Cloning the Repository

<u>Using Git</u>

1. Ensure you have Git installed on your computer and added to your PATH environment variable

2. Open a terminal or command prompt

3. Run the following command:

   git clone http://git.rimmyscorner.com/Rim/t7x.git
   

Repository Contents

• T7x Client
• All Necessary Files (Including ext.dll)
• T7x Client Dedicated Server Configuration Files
• Python Script to format file hashes for files.json
• Localized dependencies

Added Features

• Remove Steam Ownership Verification
• Removed T7x Watermark
• No Auto-Update (The new ext.dll adds Steam Verification, this is CRUCIAL if you do not own the game)
• Reverted Launcher to the Original Style
• Changed Resource Icon to Match Original
• Binary Verification
• Intro Skip Flag
• Portable Mode
• Sample files.json for users to host their own Master Server/HTTP fastDL Index

Installing Git (Optional)

If you don't have git installed on your machine, follow these steps:

1. Visit the Git download page.
2. Download the appropriate version for your operating system.
3. Run the installer.
   • During the installation, you will be asked if you want to add Git to your system's PATH environment variable. Ensure you choose the option to do so. This allows you to use Git from the command line without specifying its full path.
4. After installation, open a terminal or command prompt and type git --version to ensure Git is correctly installed.

Where Can I Get the Game?

1. You can get the game on Steam (preferred)
2. If you can't afford the game. Oh well, you tried. You can get the game files for free directly or torrent them here.

[!NOTE] The DLC torrent is included.

Downloading qBittorrent

[!WARNING] Use a VPN to avoid copyright letters from your ISP (i.e. https://iknowwhatyoudownload.com)

1. Visit the qBittorrent Download Page and install the latest version of qBittorrent
2. Open .torrent files in qBittorrent
3. Set your game(s) folder as your download directory (e.g. C:/Program Files (x86)/Steam/steamapps/common/Call of Duty... or D:/Games/Call of Duty...)
4. Important: On the "Content layout" drop-down menu, select "Don't create subfolder"
5. Start the download and wait till it says "100% - Seeding"
6. You can now remove the torrent from qBittorrent (right click -> remove) or keep seeding to help others download faster
   • Make sure "Also Permanently Delete the Files" is UNCHECKED!
7. Once the game files are downloaded, move on to installing the client

[!TIP] Use a free, open source and ad-free torrenting software such as qBittorrent

What If I Have a Pirated version?

The client will work just fine with the pirated files. As the end user, you need to ensure that you have the most up-to-date and latest files/binaries. I have added a binary verification to the client. This means, that if you do not have the correct BlackOps3.exe or BlackOps3_UnrankedDedicatedServer.exe executables, the client will fail to launch. This is not the same thing as ownership verification.

Command Line Arguments

| Argument | Description | |:--------------|:-----------------------------------------------------------------------| | -unsafe-lua | Allow in-game mods to executable unsafe lua functions | | -nosteam | Bypass Steam proxy | | -launch | Bypass launcher window and launch game directly | | -nointro | Skip intro animation sequence | | -nocheck | Skip game binary hash checks | | -headless | Direct output of stdout and stderr to current terminal environment |

Loading Mods & Custom Maps

[!TIP] Default Workshop Location (If You Own the Game): C:/Program Files (x86)/Steam/steamapps/workshop/content/311210/

If you already have the workshop files downloaded through Steam, skip Step 1 below.

Steps:

1. Download the Mod or Map

   Use the T7x Workshop Downloader (T7xWD) to download the desired content.

2. Create the Folders (If They Don’t Exist)

   Inside your game directory, create the following folders if they don't exist:

   Call of Duty Black Ops III/
     ├─ mods/
     └─ usermaps/
   

3. Place the Files:

• Mods: Place each mod in the mods/ folder

  (Example: Call of Duty Black Ops III/mods/3413662211)

• Custom Maps: Place each map in the usermaps/ folder

  (Example: Call of Duty Black Ops III/usermaps/3435762796)

---

[!NOTE] After installing, you can launch the game and load your mods or custom maps from the in‑game menu.

Hosting a Dedicated Server

Requirements

• The Visual C++ 2010 Redistributable Package and the Visual C++ 2015-2019 Redistributable Package.
• Visual Code, Notepad++ or Sublime Text (You may use whatever editor you choose but we don't recommend Windows Notepad).