- 1. Overview
- 2. What are SAPP, Phasor and Chimera?
- 3. Scripts, Releases and Knowledge Base
- 4. SAPP Archive & Mirrors
- 5. SPCLib Web Interfaces & Apps
- 6. Halo Custom Edition Installer
- 7. Community Hubs
- 8. Shoutout to Clans (Past and Present)
- 9. Contributors, Community Guidelines & Request Features
- 10. Support My Work
- 11. License
SPCLib (SAPP, Phasor and Chimera Library) is the largest public archive of Lua scripts and resources for the SAPP and Phasor dedicated server extensions and the Chimera client-side mod for Halo PC and Custom Edition. All Lua scripts in SPCLib are written and curated by Chalwk, unless otherwise noted.
Here, you will find a wide range of scripts, guides, and insights to enhance, customize, and extend your multiplayer server experience.
SAPP and Phasor are server-side extensions for haloded.exe/haloceded.exe that provide advanced scripting and
customization capabilities for dedicated servers.
SAPP was developed by sehé and is the most feature-rich and widely used extension. It provides powerful Lua scripting support, anti-cheat tools, event hooks, command handling, player management, logging, and numerous under-the-hood features.
Phasor is an earlier extension with similar goals.
SAPP and Phasor are no longer actively maintained, but stable and complete in their final released versions.
Chimera is a client-side mod for Halo Custom Edition, PC, and Trial that also exposes a Lua API. Developed by SnowyMouse, it is actively maintained and provides event hooks, commands, built-in map downloads, and dozens of quality-of-life fixes. Chimera scripts are fully supported in SPCLib.
Note
Start with the category that matches your setup: SAPP or Phasor for server-side scripting, or Chimera for client-side scripting.
SAPP & Phasor Lua scripts are organized into the following categories:
- admin: Strictly moderation & enforcement (bans, kicks, anti-cheat, rule enforcement)
- chat: Chat formatting, messages, and command handling
- gameplay: Gameplay mechanics, modifiers, and fun items
- gametypes: Custom game modes and gametype variations
- modules: Library modules for other scripts
- notifications: Console output, timers, and event alerts
- utility: Server configuration, spawning, map control, and miscellaneous tools
| Section | Resource | Description |
|---|---|---|
| Scripts & Releases | SAPP Scripts | Server-side Lua scripts |
| Phasor Scripts | Server-side Lua scripts | |
| Chimera Scripts | Client-side Lua scripts. | |
| Script Packages | Bundled projects with multiple files and resources available as downloadable ZIP packages. | |
| Server Setup & Hosting | How to Host a Linux VPS (Ubuntu 22.04) | Full setup with Wine, VNC, firewall, SSH, and fail2ban. |
| Server Port Forwarding | Router configuration for UDP ports 2302 & server port, plus firewall rules for Windows/Linux. | |
| SAPP Server Guide | Pre-configured package walkthrough covering file structure, launch, and multi-server expansion. | |
| Scripting Guides & References | Scripting with SAPP | Server-side Lua API: signature scanning, globals, and core functions. |
| Scripting with Phasor | Server-side Lua scripting with version handling and hardcoded addresses. | |
| Scripting with Chimera | Client-side Lua scripting with event callbacks, script placement, and version compatibility. | |
| SAPP Command Reference | Complete reference for SAPP server commands, admin levels, and usage. | |
| Common Lua References | Common Lua patterns, utilities, and helpers for Halo server/client scripting. | |
| Understanding Memory Offsets | Addresses, offsets, signature scanning, and tools for Halo PC/CE. | |
| Modding References | Tag editing, map rebuilding, asset injection, and community tooling references. |
📦 Archival SAPP binaries and documentation (click to expand)
The official SAPP website (halo.isimaginary.com) is no longer accessible. To ensure historical versions remain available, this repository mirrors all released SAPP binaries.
You'll find the full archive of SAPP versions in the ./assets/sapp_downloads folder.
This repository also preserves:
- SAPP Documentation Revision 2.4 and 2.5 (by 002 / SnowyMouse)
- Memory offsets reference list originally created by Wizard
These documents and binaries are redistributed for preservation only. Licensing remains with their original authors.
Live search and filtering for all SPCLib scripts.
- Alias Browser - for alias_system.lua
- Rank System - Stats Browser - for rank_system.lua
- Track Master - Stats Browser - for track_master.lua
Java-based integration for connecting Halo servers to Discord with rich event embeds.
- HaloDiscordBot - Main application
- Config.yml Editor - GUI editor for
config.yml
Note
You must own a valid CD key to install Halo Custom Edition.
Note
Large Address Aware (LAA) patches allow Halo to use more than 2 GB of RAM on 64-bit systems.
🌐 Active and legacy Halo PC/CE communities (click to expand)
Community activity varies across hubs. Some are active, others are legacy archives.
| Hub | Description |
|---|---|
| Chalwk - Website · Discord | Personal site & portfolio. |
| Open Carnage - Website · Discord | Former major CE modding forum (now read‑only after DDoS attacks). |
| Chimera - Forum · Discord | Essential client‑side mod with map downloads, renderer fixes, quality‑of‑life improvements. |
| Halo Net - Website | HAC2 map repository & update server - auto‑downloads thousands of custom maps. |
| XG Gaming - Website (archived) | Former clan community (servers, forums, downloads); domain now offline. |
| POQ Clan - Website | One of the oldest Halo PC/CE clans (2006) with 19 public servers & custom mods. |
| BK (BlacksHalo) - Website | Well‑known clan running popular servers for 15+ years. |
| Liberty - Discord | Active CE community (founded 2024) hosting CTF, Slayer, Oddball, Racing servers. |
| Reclaimers - Website · Discord | Community wiki & resource hub for Halo CE and MCC modding tools. |
| Realworld CE - Website | Guild & custom map blog offering hundreds of exclusive multiplayer maps. |
🎖️ Honouring Halo PC/CE clans across decades (click to expand)
This list represents historical and current Halo PC/CE clans and communities over many years of multiplayer history.
\- YAS -, -db-, «§», «Ag~, «Ð²Ä», «MAD», [Aķ], [CV], [GTV], [HGE], [IG], [IS], [K2], [McK], [Nbk], [VR], [WFFF], ]
ZTA[. VSA, {ATP}, {BK}, {CK}, {CRG}, {HWS}, {LoH}, {NR}, {OTH}, {ØZ}, {PWH}, {SK}, {SSC}, {V3}, {X}, {XF} = SL =,
{XG}, = EP =, = NcS =, = XA=, =DN=, =RDA=, £V», ÄÄÄ, AOD, AR, BR, BZ, C#w, CAF, CB, CES, CGD, CHr, CK, ÇM, CODE, CSI,
CST, DFS, DR, Ðu¥, EK, ev, FCM, Fem1, Fez`, FIG, FooK, GDS, GoD, GRO, HH, HSF, HTK3, IR, KB, KMT, KoD, KoF, LaG, LF,
LIB, LNZ, LP, LTD2, M5, MR, MVL, ňc, ÑE», ñuß, OSR, OWV, P§ycho, PÕQ, PRO, RC, RSF, SAR, SB, SDR, ßE, TBR, TCS, TFT,
TM, ToR, X¬, xOSHx, xT
Contributions, bug reports, and feature requests are welcome via GitHub issues and discussion templates.
See the Contributing Guide. All community interaction is governed by the Code of Conduct
Enjoy these projects? Help me continue development:
- ☕ Donate via PayPal
- Star ⭐ this repository to show appreciation and stay updated!
Caution
Halo is a trademark of Microsoft. This project is not affiliated with or endorsed by Microsoft or its subsidiaries, including Halo Studios (formerly 343 Industries).
SPCLib is licensed under the MIT License.