.github | ||
assets/github | ||
cache | ||
cfg | ||
data | ||
deps | ||
files | ||
installer | ||
src | ||
tools | ||
.editorconfig | ||
.gitignore | ||
build.bat | ||
build.md | ||
ext.dll | ||
generate.bat | ||
LICENSE | ||
notice.md | ||
premake5.lua | ||
README.md |
T7x Client
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 NOT required to own Call of Duty: Black Ops 3 in order to play this client. Steam Ownership Verification has been removed.
-
You can view the changes made from original repository here.
Installer (Easiest)
- Download the T7xInstaller.exe from Releases
- Place in Call of Duty Black Ops III game directory and run
Note: Run as Administrator if your game installation is in a protected folder
(The installer is fully Open Source, created using Nullsoft Scriptable Install System)
Download
Clone the Git repository or download as ZIP.
-
Download Release
- Click on
Releases
at the top and navigate to the latest release - Download
t7x.zip
- If you plan on running a server, download
T7xDedicatedConfigs.zip
- Click on
-
Download ZIP
- Click on the three dots at the top of the repo (
◘◘◘
) - Click
Download ZIP
- Click on the three dots at the top of the repo (
-
Clone the repository:
- Open a terminal or command prompt.
- Run the following command:
git clone https://git.rimmyscorner.com/Parasyn/t7x.git
Installation
- Place the executable
t7x.exe
in yourCall of Duty Black Ops III
directory.Note
: Default location is
C:\Program Files (x86)\Steam\steamapps\common\Call of Duty Black Ops III
- Place the
localappdata\t7x
folder into your Local AppData. Place ONLY thet7x
folder in, notlocalappdata\t7x
. Your final path should look likeC:\Users\%USERPROFILE%\AppData\Local\t7x\*
Note
: On Windows, press
Win + R
, type%localappdata%
, click ok. Default location isC:\Users\%USERPROFILE%\AppData\Local
- Launch
t7x.exe
. - You can change your name by modifying
Call of Duty Black Ops III\t7x\players\properties.json
or use/name PLAYERNAME
in-game. - If running a server, extract
T7xDedicatedConfigs.zip
into yourCall of Duty Black Ops III
folder.
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 executable icon to match original
- Add files.json for users to host their own Master Server/HTTP fastDL Index
Getting Game Files
- You can download the
Call of Duty Black Ops III
game files directly or torrent them here. - The DLC torrent is included.
Installing Git (Optional)
If you don't have git
installed on your machine, follow these steps:
- Visit the Git download page.
- Download the appropriate version for your operating system.
- 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.
- After installation, open a terminal or command prompt and type
git --version
to ensure Git is correctly installed.
Compile from Source Code
Prerequisites
- Visual Studio 2022
- The required code libraries installed using VSBuildTools
Build
- Clone the Git repository using
git clone https://git.rimmyscorner.com/Parasyn/t7x.git
(It is recommended to clone, however you canDownload ZIP
as all submodules have been localized). - Run
generate.bat
to initialize the submodules and build the VS .sln file. - Open the project in Visual Studio, change the top drop down lists to
Release
,x64
. You can also modify (or leave same) the Visual Studio edition/path in thebuild.bat
file and build the solution via the batch script. - Build the application.
T7 Server Config
Config for T7 Dedicated Servers for use with the T7x Client.
How to use
- Download the BO3 Unranked Dedicated Server via Steam (It's located in the "Tools" section in your steam library.)
- Add t7x.exe to the
Call of Duty Black Ops 3
folder. - Download this repository and extract startup batch files as well as the t7x and zone folder to the UnrankedServer Folder
- Edit the config(s) in
/zone/
to your liking. - (Optional) Edit your game rules under
Call of Duty Black Ops 3/t7x/gamesettings/mp
. - Port forward UDP 27017.
- Start the Server using T7x_MP_Server.bat or T7x_ZM_Server.bat
Additional Steps required for hosting Zombies Dedicated Servers
As of right now you need to take additional Steps to host Zombies Servers. For Zombie Dedis to work they need to have the Zombies Maps and common FastFiles, these do not come with the UnrankedServer Files. This means you need to copy those over from your installed BO3 game folder.
Copy common fastfiles that is needed for zombies.
zone/en_zm_patch.ff
zone/en_zm_common.ff
zone/zm_patch.ff
zone/zm_common.fd
zone/zm_common.ff
zone/zm_levelcommon.ff
Now for the map. Shadows of Evil is zm_zod.
zone/en_zm_zod.ff
zone/en_zm_zod_patch.ff
zone/zm_zod.ff
zone/zm_zod_patch.ff
from your BO3 Game folder into the UnrankedServer's zone
Folder. Do the same with the FastFiles of the Maps you want to host on the Server, you do not need to copy the .xpak files, those hold Textures and Sounds which the Server doesn't need. You can use the zm_server.cfg as a short name references if you want to grab the others.
You are now ready to start the Server using T7x_ZM_Server.bat
. If the server still instantly closes while opening the T7x_ZM_Server.bat
or T7x_CP_Server.bat
. Check the console_mp.log from identities\dedicatedpc\ folder. Scroll down until you see "Could not find zone: xxxx".
Disclaimer
This software has been created purely for the purposes of academic research. It is not intended to be used to attack other systems. Project maintainers are not responsible or liable for misuse of the software. Use responsibly.
Credits:
- Dss0 - Dedicated Server Files & Tutorial
- momo5502 - Arxan/Steam research, original developer
- AlterWare - T7x project revival and rebranding
End README
Legacy README.md
What is T7x ☄️
T7x is a discontinued game modification for Call of Duty: Black Ops 3.
The Steam version of Black Ops 3 is required to be owned and installed for T7x to work. You can get it from here.
Build
You can learn more about how you can build this project using the MSVC compiler by reading build.md
Writeups & Articles
- Reverse engineering integrity checks in Black Ops 3
- Gamers are fixing a video game ‘taken over’ by hackers
Credits
- Thanks to @shiversoftdev for providing the fixes from his community patch
Disclaimer
This software has been created purely for the purposes of academic research. It is not intended to be used to harm others. Project maintainers are not responsible or liable for misuse of the software. Use responsibly.