boiii-free - GitLite

KO | EN

gitlite — search

#javascript #ai #llm #android #machine-learning #deep-learning #linux #macos #cli #kubernetes #vue #awesome-list #openai #open-source

boiii-free

(★ 402)

Ezz!!!

파일 탐색기

최종 버전 다운로드 (.zip)

- - bug_report.yml
  - config.yml
  - feature_request.yml
- - build-and-publish-beta.yml
  - build-and-publish.yml
  - build-new.yml
  - check-formatting.yml
- dependabot.yml
- - bigboiii.jpg
  - main.css
  - main.html
  - main.js
  - verification.json
- - dvar_list.txt
  - hash_names.txt
- - LICENSE.txt
  - NOTICE.txt
- - asmjit.lua
  - brotli.lua
  - curl.lua
  - discord-rpc.lua
  - imgui.lua
  - libtomcrypt.lua
  - libtommath.lua
  - minhook.lua
  - minizip.lua
  - rapidjson.lua
  - stb.lua
  - udis86.lua
  - zlib.lua
  - zstd.lua
- argparse
- asmjit
- brotli
- curl
- discord-rpc
- frozen
- gtl
- imgui
- libtomcrypt
- libtommath
- minhook
- rapidjson
- stb
- SteamworkSDK
- udis86
- zlib
- zstd
- gsc-scripting.md
- pre-commit
- - cross.sh
  - env.sh
  - install-hooks.sh
- - env.ps1
  - install-hooks.ps1
- - main.cpp
  - resource.aps
  - resource.hpp
  - resource.rc
  - std_include.cpp
  - std_include.hpp
- - hash.hpp
  - macros.hpp
  - str.cpp
  - str.hpp
- - dllmain.cpp
  - resource.rc
  - tlssup.cpp
.clang-format
.clang-format-ignore
.editorconfig
.gitattributes
.gitignore
.gitmodules
.luarc.json
.prettierignore
.prettierrc.json
.stylua.toml
.styluaignore
build.bat
generate.bat
LICENSE
package.json
premake5.lua
README.md
yarn.lock

# 설치 가이드

1. 코드 내려받기

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

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd boiii-free

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. Node.js

쉬움 추천

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Node.js npm 명령어를 쓰려면 Node.js가 설치되어 있어야 합니다. LTS(장기지원) 버전을 추천합니다.

npm install

package.json에 명시된 라이브러리들을 내려받아 설치합니다.

npm start

개발/실행 서버를 켭니다.

✅ 명령어 실행 후 터미널에 나타나는 주소(보통 http://localhost:3000 형태)를 브라우저에서 열어보세요.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

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

[![github](https://img.shields.io/badge/GitHub-Repository-blue)](https://github.com/Ezz-lol/boiii-free)

---

> [!NOTE] Feel free to open up Pull requests 😑

---

## Table of Contents

- [About BOIII](#about-boiii)
- [Client Download](#client-download)
- [Prerequisites](#prerequisites)
- [Install Instructions](#install-instructions)
- [Loading Mods & Custom Maps](#loading-mods--custom-maps)
- [Workshop Downloader](#workshop-downloader)
- [Command Line Arguments](#command-line-arguments)
- [Hosting a Dedicated Server](#hosting-a-dedicated-server)
  - [Requirements](#requirements)
  - [Server Setup](#server-setup)
  - [Connecting](#connecting)
  - [Port Forwarding Alternatives](#port-forwarding-alternatives)
- [Zombies Server Setup](#zombies-server-setup)
- [Compile from Source](#compile-from-source)
- [GSC Scripting Additions](#gsc-scripting-additions)
- [Credits](#credits)
- [Disclaimer](#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](https://github.com/Ezz-lol/boiii-free/releases/latest)

**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](https://forum.ezz.lol/topic/5/bo3-guide)
- 💬 [Discord Community](https://dc.ezz.lol)
- 🐛 [Report Issues](https://github.com/Ezz-lol/boiii-free/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](https://github.com/ezz-boiii/boiii/releases/latest)
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](https://store.steampowered.com/app/311210/Call_of_Duty_Black_Ops_III/)
💰 \
If you struggle with this step, join our [Discord](https://dc.ezz.lol) 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](#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](https://forum.ezz.lol/topic/5/bo3-guide) 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](https://github.com/faroukbmiled/BOIIIWD)

**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 <= 1920x1080 aspect ratio.                                                                                                   |
| `-cheats`             | Enable cheat dvar modification and cheat command execution. Note: usage when hosting a private match in client or when running dedicated server allows non-host players to execute cheat commands (e.g. `god`, `noclip`) - use with caution. |
| `-noconsole`          | Hide the external console window without disabling logs.                                                                                                                                                                                     |
| `-nobranding`         | Disable EZZ watermark and console prefix.                                                                                                                                                                                                    |
| `-nocinematics`       | Disable playing all cinematics.                                                                                                                                                                                                              |
| `-log-script-errors`  | Log all script errors, regardless of severity or `developer` dvar value.                                                                                                                                                                     |
| `-noratelimit`        | Disable rate limiting in dedicated server.                                                                                                                                                                                                   |
| `-quiet-crash`        | On crash, disable message box and minidump directory popups.                                                                                                                                                                                 |
| `-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.                                                                           |
| `-nosnd`              | Disable attempt to load and use sound assets in dedicated server.                                                                                                                                                                            |
| `-dump`               | Dump game or server executable to file in containing directory after Arxan unpack.                                                                                                                                                           |

**Example:**

```bash
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

- ✅
  [Visual C++ 2015-2022 Redistributable](https://aka.ms/vs/17/release/vc_redist.x64.exe)
- ✅ Text editor ([VS Code](https://code.visualstudio.com/),
  [Notepad++](https://notepad-plus-plus.org/), or
  [Sublime Text](https://www.sublimetext.com/))
- ✅ Computer or VPS with 24/7 uptime
- ✅ Decent internet connection (10+ Mbps upload recommended)
- ✅ Basic technical knowledge
- ⚠️ Port forwarding access (or see
  [alternatives](#port-forwarding-alternatives))

### Server Setup

**For detailed server setup instructions, check out:** 🔗
[BO3 Server Installer by framilano](https://github.com/framilano/BlackOps3ServerInstaller)

**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:**

```bash
   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](https://www.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

- [Visual Studio 2022 or newer](https://visualstudio.microsoft.com/downloads/)
  (Community Edition is free), with the **Desktop development with C++**
  workload
- [Git](https://git-scm.com/downloads)
- Windows 10/11 SDK
- [clang-format](https://releases.llvm.org/) (for C/C++ formatting — install via
  VS "C++ Clang tools" component or standalone LLVM)
- [StyLua](https://github.com/JohnnyMorganz/StyLua/releases) (for Lua
  formatting)
- VS Build Tools
  ([vs config you can import to quickly get the right ones](https://app.filen.io/#/d/52faaefc-2331-4904-897f-97bc2b36e4f1%23373366412d6a5456715853426253475063347531343161793171796d726d7445))<img width="1128" height="399" alt="image" src="https://github.com/user-attachments/assets/8f3a7a4d-b933-4d47-a193-c67260b96f16" />

### Build Steps

1. **Clone the repository:**

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

2. **Generate project files:**

```bash
   generate.bat
   ```

This initializes all Git submodules and downloads the pinned Premake version
   automatically.

To generate the project and build `Release|x64` entirely from the command
   line, run `build.bat` instead. The script pauses at the end so you can review
   the build result.

3. **Open in Visual Studio:**
   - Open `build/boiii.sln`
   - Set configuration to `Release` and platform to `x64`
   - Build the solution (Ctrl+Shift+B)

4. **Find your build:**
   - Output will be in `build/bin/x64/Release/`

---

## GSC Scripting Additions

This project supports loading raw GSC code with a more relaxed syntax and adds
extra utility functions to make scripting and mod development easier.

For the full guide and examples, see
[docs/gsc-scripting.md](docs/gsc-scripting.md).

---

## Credits

**BOIII Development Team** 💪

- Developers, contributors, and the entire BOIII community

**Special Thanks:**

- [Likeicareaboutit](https://github.com/Likeicareaboutit) - Steam Workshop
  Downloader
- [framilano](https://github.com/framilano) - BO3 Server Installer
- Everyone in the [BOIII Discord](https://dc.ezz.lol) community! 😎

---

## 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.

---

<p align="center">
  <strong>Join our community!</strong><br>
  <a href="https://dc.ezz.lol">Discord</a> • 
  <a href="https://github.com/Ezz-lol/boiii-free">GitHub</a> • 
  <a href="https://github.com/Ezz-lol/boiii-free/issues">Report Issues</a> •
  <a href="https://forum.ezz.lol/topic/5/bo3-guide">Installation Guide</a>
</p>

<p align="center">
  Made with ❤️ by the BOIII community ☄️
</p>