From 1b4e540a0fb36586da5eba854db48df2a562e896 Mon Sep 17 00:00:00 2001 From: Rim Date: Wed, 6 Dec 2023 18:55:15 -0500 Subject: [PATCH] Update README.md --- README.md | 134 ++++++++++++++++++++++++++++++++++++++++++++++++++++-- 1 file changed, 129 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 3ccaac59..32ee6a69 100644 --- a/README.md +++ b/README.md @@ -1,22 +1,146 @@ -# What is T7x ☄️ +# T7x Client + +[![discord](https://img.shields.io/endpoint?url=https://momo5502.com/iw4x/members-badge.php)](https://discord.gg/sKeVmR3) +[![website](https://img.shields.io/badge/Repackers-_Website-blue)](https://rimmyscorner.com/) + +

+ +

+ +--- +### **IMPORTANT:** +### T7x is cross compatible with the BOIII Client. You can play the same servers on T7x and BOIII Client, however T7x is newer. + +## Download +Clone the Git repository or download as ZIP. + +- **Download Release (EASIEST)** + - 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` + +- **Download ZIP** + - Click on the three dots at the top of the repo ( `◘◘◘` ) + - Click `Download ZIP` + +- **Clone the repository:** + - Open a terminal or command prompt. + - Run the following command: + ``` + git clone https://git.rimmyscorner.com/Parasyn/t7x.git + ``` + +## Installation + +1. Place the executable `t7x.exe` in your `Call of Duty Black Ops III` directory. + > **Note**: Default location is `C:\Program Files (x86)\Steam\steamapps\common\Call of Duty Black Ops III` +2. Place the `localappdata\t7x` folder into your Local AppData. Place **ONLY** the `t7x` folder in, not `localappdata\t7x`. Your final path should look like `C:\Users\%USERPROFILE%\AppData\Local\t7x\*` + > **Note**: On Windows, press `Win + R`, type `%localappdata%`, click ok. Default location is `C:\Users\%USERPROFILE%\AppData\Local` +3. Launch `t7x.exe`. +4. You can change your name by modifying `Call of Duty Black Ops III\t7x\players\properties.json` or use `/name PLAYERNAME` in-game. + +## 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 + +## 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/Cloud Index + +## Getting Game Files + +- You can download the `Call of Duty Black Ops III` game files [directly](https://gofile.io/d/7pvpEs) or torrent them [here](https://git.rimmyscorner.com/Parasyn/cod-games-download/releases/download/v1.0.0/t7_full_game.zip). +- The DLC torrent is included. + +## Installing Git (Optional) + +If you don't have `git` installed on your machine, follow these steps: + +1. Visit the [Git download page](https://git-scm.com/downloads). +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. + +
+ +# T7 Server Config +Config for T7 Dedicated Servers for use with the t7x Client. + +## How to use +1. Download the BO3 Unranked Dedicated Server via [Releases](https://git.rimmyscorner.com/Parasyn/t7x/releases). It is also on Steam (It's located in the "Tools" section in your steam library.) +2. Open the Unranked Server folder in windows explorer (if you own BO3 on Steam and have it installed it will be in your BO3 Game Folder) +3. Add t7x.exe to the UnrankedServer Folder +4. Download this repository and extract startup batch files as well as the t7x and zone folder to the UnrankedServer Folder +5. Edit the config(s) in /zone to your liking. +6. (Optional) Edit your game rules under t7x/gamesettings/mp. +6. Port forward UDP 27017 or whatever port you choose. +7. 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 !start_zm_server.bat. If the server still instantly closes while opening the !start_zm_server.bat or !start_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. + +## ***End README*** + +# Legacy README.md + +### What is T7x ☄️ T7x is a [discontinued][notice-link] 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 +### Build You can learn more about how you can build this project using the MSVC compiler by reading [build.md][build-link] -## Writeups & Articles +### Writeups & Articles - Reverse engineering integrity checks in Black Ops 3 - Gamers are fixing a video game ‘taken over’ by hackers -## Credits +### Credits - Thanks to @shiversoftdev for providing the fixes from his community patch -## Disclaimer +### Disclaimer This software has been created purely for the purposes of academic research. It is not intended to be used to harm