boiii-free

Ezz BOIII ☄️: Call of Duty® Black Ops III Client

---

[!NOTE]

Feel free to open up Pull requests

---

Table of Contents

• About BOIII
• Client Download
• Prerequisites
• Install Instructions
• Loading Mods & Custom Maps
• Workshop Downloader
• Command Line Arguments
• Hosting a Dedicated Server
  • Requirements
  • Server Setup
  • Connecting
  • Port Forwarding Alternatives
• Zombies Server Setup
• Compile from Source
• GSC Scripting Additions
• Credits
• Disclaimer

---

About BOIII

BOIII is a free, community-driven modification for Call of Duty: Black Ops III that removes Steam ownership verification and enhances the multiplayer and zombies experience. Whether you own the game or not, BOIII lets you jump in and play!

Key Features:

• ✅ No Steam ownership required
• Cross-platform server browser
• Full multiplayer & zombies support
• ️ Custom maps and mods support
• Dedicated server hosting
• Steam Workshop integration

---

Client Download

Latest Release: Download BOIII Client

Available Downloads:

• boiii.exe - Main BOIII client executable
• BOIII-Full.zip - Complete package with all files
• Source code available on GitHub

Quick Links:

• Full Installation Guide
• Discord Community
• Report Issues

---

Prerequisites

• Operating System: Windows 10/11 (64-bit)
• Game Files: Call of Duty: Black Ops III installation
• Storage: ~60GB free space (for full game + DLC)
• Required: Steam

---

Install Instructions

1. Download the latest BOIII.exe from Releases
2. Place the executable in your Call of Duty: Black Ops III game directory
3. Run BOIII.exe
4. Play!

[!TIP]

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

---

Where Can I Get the Game?

Option 1: Steam

Purchase and download from Steam Store
If you struggle with this step, join our Discord and ask for help!

---

Loading Mods & Custom Maps

[!TIP]

Default Workshop Location (Steam): C:/Program Files (x86)/Steam/steamapps/workshop/content/311210/

BOIII comes with a built-in Workshop Downloader - see the Workshop Downloader section!

Installation Steps:

1. Download Mods/Maps

   • Use the built-in BOIII Workshop Downloader
   • Or copy from your Steam workshop folder (if you own the game)
   • Or use external workshop downloaders

2. Create Folders (if they don't exist):

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

3. Place Files:

   • Mods: Extract to mods/ folder
     • Example: mods/zombie_mod_v2/zone/
     • The folder structure should be: mods/[MOD_NAME]/zone/
   • Custom Maps: Extract to usermaps/ folder
     • Example: usermaps/zm_castle/zone/
     • The folder structure should be: usermaps/[MAP_NAME]/zone/

4. Launch Ezz BOIII and select your mod/map from the menu!

[!IMPORTANT]

For Workshop Downloads from Steam:

• Workshop items are in numbered folders (e.g., 311210/1234567890/)
• Copy the entire numbered folder
• Rename it to match the mod/map name if needed
• Make sure the zone/ folder is inside

Troubleshooting:

• If a mod shows "unsafe Lua" warning, launch with -unsafe-lua argument
• If a map doesn't load, verify the folder structure matches [type]/[name]/zone/
• Check forum.ezz.lol for detailed guides

---

Workshop Downloader

BOIII has a built-in Steam Workshop Downloader!

You can download Steam Workshop content directly through the BOIII client without needing Steam ownership.

How to use:

1. Launch boiii.exe
2. Navigate to the Workshop Downloader section
3. Enter the Workshop ID or URL
4. Download directly to your game folder

External Tool (Alternative): If you prefer a standalone tool, check out BOIIIWD by faroukbmiled

Finding Workshop IDs:

• Go to any Steam Workshop item page
• Look at the URL: steamcommunity.com/sharedfiles/filedetails/?id=XXXXXXXXX
• The numbers after id= are the Workshop ID

---

Command Line Arguments

Launch BOIII with these arguments for extra features:

Argument	Description
-unsafe-lua	Allow mods to use unsafe Lua functions (required for some mods like All-Around Enhancement).
-dedicated	Launch as a dedicated server.
-nosteam	Bypass Steam entirely.
-nointro	Skip intro videos.
-windowed	Launch in windowed mode.
-borderless	Launch in borderless fullscreen mode.
-safe	Launch in safe mode (disable mods).
-console	Enable developer console.
-nologs	Disable all patches to developer console.
-fulllogs	Disable console buffer size limit.
-port XXXX	Set server port (default: 27017).
-launch	Start the game immediately, skipping some launcher UI and pre-checks.
-noupdate	Disable automatic updates (not recommended).
-update	Force enable updates (including host binary in debug builds).
-norelaunch	Skip automatic relaunch after updates.
-headless	Run in headless mode (no GUI).
-noplugins	Disable plugin load.
-plugins	Load additional plugins from the plugins/ directory.
-trimlogs	Trim or rotate old log files on startup.
-keep-launcher	Keep the launcher process running after starting the game.
-ultrawide	Enable ultrawide UI scaling. Note: this is unstable and commonly breaks UI alignment where implemented assuming [!WARNING]

The -unsafe-lua argument is required for certain mods that need to modify the UI, menus, or game scripts (like All-Around Enhancement Mod). Only use this with trusted mods!

The -headless option may not behave correctly on non-server systems.

---

Hosting a Dedicated Server

Requirements

• ✅ Visual C++ 2015-2022 Redistributable
• ✅ Text editor (VS Code, Notepad++, or Sublime Text)
• ✅ Computer or VPS with 24/7 uptime
• ✅ Decent internet connection (10+ Mbps upload recommended)
• ✅ Basic technical knowledge
• ⚠️ Port forwarding access (or see alternatives)

Server Setup

For detailed server setup instructions, check out: BO3 Server Installer by framilano

Quick Steps:

1. Download BO3 Unranked Dedic