BlackOps3ServerInstaller

Simplifying BO3 server installation for both vanilla BO3 and unofficial clients (like BOIII).
No copyrighted files are distributed using these scripts.

This repository merges configurations and scripts from these projects:
EZZ BOIII (currently the best custom client)
T7 Configuration files
BOIIIEasyServer

You can create servers on both Linux-based platforms and Windows.

Table of Contents

• How to install (Windows)
• How to install (Linux, tested on Ubuntu 24.04)
• Cool, but Zombies?
• Mods?
• Notes

How to install (Windows)

1. Clone this repository wherever you want to install the server
2. Double click on server_files_downloader.bat
3. Wait for server files to download through steamcmd
4. Wait for the custom client latest executable to download (currently EZZ BOIII)
5. (For Custom Clients like BOIII) You can now edit BOIII_Server.bat and zone/server.cfg (or zone/server_cp.cfg or zone/server_zm.cfg) with your desired settings
6. (For Custom Clients like BOIII) Launch your server using BOIII_Server.bat
7. (For official servers on vanilla BO3) Launch your server using Launch_Server.bat
8. Done!

How to install (Linux, tested on Ubuntu 24.04)

Official BO3 servers only aimed for Windows support, but Wine can help us run it on Linux too.

1. Clone this repository wherever you want to install the server
2. Make server_files_downloader.sh executable using chmod +x and execute it with ./server_files_downloader.sh
3. Follow the setup "wizard" and confirm a bunch of wine required steps. Wait for server files to download through steamcmd
4. Wait for the custom client latest executable to download (currently EZZ BOIII)
5. (For Custom Clients like BOIII) Make BOIII_Server.sh executable using chmod +x. Edit your BOIII_Server.sh and zone/server.cfg (or zone/server_cp.cfg or zone/server_zm.cfg) with your desired settings
6. (For Custom Clients like BOIII) Launch your server using BOIII_Server.sh
7. (For official servers on vanilla BO3) Launch your server using Launch_Server.sh
8. Done!

Cool, but Zombies?

The default server files only download MP-ready stuff. To serve a Zombies server you need to copy these fast files from your BO3 game files and put them into zone:

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

Let's say you want to create a Shadows of Evil server, you need to copy these fast files too.

zone/en_zm_zod.ff
zone/en_zm_zod_patch.ff
zone/zm_zod.ff
zone/zm_zod.fd
zone/zm_zod_patch.ff

Mods?

There's a difference between Custom Maps and Mods, this section will explain how to load a mod downloaded from the Steam Workshop. Let's say you subscribed to the The Kermit Mod, this will create a folder in your Steam folder in steamapps/workshop/content/311210/1638465081, create a new mods folder inside your BO3 Server installation folder and simply copy the folder named 1638465081 (this number changes depending on the mod) inside it. The resulting folders structure should look like this:

Now modify the set ModFolderName= in BOIII_Server.bat into set ModFolderName=1638465081, that's it, you're done!

Notes

1. Unless you're playing LAN with friends, you need to port forward you router and open the ports used by your server in Windows Firewall.
2. If you don't need any custom client, just delete boiii.exe.
3. Remember to change the port in BOIII_Server.bat if you're launching the server in the same machine where you're playing Black Ops 3.
4. To save space, you can delete any unused fast files in UnrankedServer/zone
5. (For Custom Clients like BOIII) To customise your server maps rotation and gamemodes just edit the files in UnrankedServer/zone, server_zm.cfg changes zombies configuration, server.cfg changes multiplayer configurations, server_cp.cfg changes coop campaign configuration. These files can be executed even with the vanilla Launch_Server.bat but you need to edit it first to execute the desired cfg file.