Skip to content

Ezz-lol/boiii-free

BranchesTags

Repository files navigation

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

github

Note

Feel free to open up Pull requests 😑

Table of Contents

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:

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
-safe Launch in safe mode (disable mods)
-console Enable developer console
-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)
-nopatch Disable selected runtime patches
-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
-noconsole Suppress the external launcher console window
-noratelimit Disable rate limiting in dedicated server
-mitigatepacketspam In dedicated server, attempt to reduce unnecessary reliable command packets sent by some custom maps' scripts. Fixes Kowloon and Daybreak client load-in failures.

Example:

boiii.exe -nointro -console -unsafe-lua

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

Server Setup

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

Quick Steps:

  1. Download BO3 Unranked Dedicated Server from Steam (Tools section)

  2. Add BOIII files to your server directory

  3. Configure server settings:

    • Edit zone/dedicated.cfg
    • Set server name, map rotation, game mode
    • Configure player count and rules

  4. Setup firewall rules:

    • Allow UDP port 27017 (or your custom port)
    • Allow TCP port 27017 (optional but recommended)

  5. Launch server:

    boiii.exe -dedicated

  6. Monitor the console for any errors

Connecting

Option 1: Server Browser

  • Open Ezz BOIII client
  • Navigate to "Server Browser"
  • Find your server and join!

Option 2: Direct Connect

  • Open console (press ~)
  • Type: /connect IP:PORT

Examples:

  • Local: /connect 192.168.1.100:27017
  • WAN: /connect 45.123.67.89:27017

Tip

Find your local IP: Press Win + R, type cmd, then type ipconfig Find your WAN IP: Visit WhatIsMyIP.com

Port Forwarding Alternatives

Don't want to mess with port forwarding? Use these VPN tools to play with friends! 😎

Recommended Options:

  • ZeroTier (Best for gaming)
  • Radmin VPN (Easy setup)
  • Hamachi (Classic choice)

Setup:

  1. Download and install your chosen VPN tool
  2. Create/join a network
  3. Start your BOIII server
  4. Friends connect using your VPN IP: /connect VPN_IP:27017

Zombies Server Setup

Hosting Zombies requires additional files that don't come with the dedicated server package.

Required Files

Copy these from your full game installation to your dedicated server:

Common Zombies Files:

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

Map-Specific Files (Example: Shadows of Evil):

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

Installation

  1. Copy files from Call of Duty Black Ops III/zone/ to your server's zone/ folder
  2. Repeat for each map you want to host
  3. Skip .xpak files (these are textures/sounds that servers don't need)

Note

If the server crashes on startup, check console_mp.log for missing zone files

Common Maps:

  • zm_zod - Shadows of Evil
  • zm_factory - The Giant
  • zm_castle - Der Eisendrache
  • zm_island - Zetsubou No Shima
  • zm_stalingrad - Gorod Krovi
  • zm_genesis - Revelations

Compile from Source

Want to build Ezz BOIII yourself? Here's how! 🔨

Prerequisites

Build Steps

  1. Clone the repository:

    git clone https://github.com/Ezz-lol/boiii-free.git
cd boiii-free

  2. Initialize submodules:

    git submodule update --init --recursive

  3. Generate project files:

    generate.bat

  4. Open in Visual Studio:

    • Open boiii.sln
    • Set configuration to Release and platform to x64
    • Build the solution (Ctrl+Shift+B)

  5. Find your build:

    • Output will be in build/bin/x64/Release/

Tip

You can also use build.bat to compile directly from the command line!

Credits

BOIII Development Team 💪

  • Developers, contributors, and the entire BOIII community

Special Thanks:

Disclaimer

This software has been created purely for the purposes of academic research and to preserve access to Call of Duty: Black Ops III multiplayer and zombies modes. It is not intended to be used to harm others or violate any terms of service.

Project maintainers are not responsible or liable for misuse of the software. Use responsibly.

This is a non-profit, community-driven project. We do not condone piracy. If you enjoy the game, please consider supporting the developers by purchasing it legally.

Join our community!
Discord • GitHub • Report Issues • Installation Guide

Made with ❤️ by the BOIII community ☄️

About

Ezz!!!

forum.ezz.lol/topic/5/bo3-guide

Topics

free blackops3 bo3 bypassed boiii boiii-free boiii-bypassed

Resources

Readme

License

GPL-3.0 license
Activity
Custom properties

Stars

326 stars

Watchers

5 watching

Forks

55 forks
Report repository

Releases 12

Release v1.1.1-p2 Latest
Apr 10, 2026
+ 11 releases

Contributors

Languages