Chupathingy on the Xbox 360.
Get the test build · Games online now · The game · chupathingy.org
Play Chupathingy as homebrew on an Xbox 360, and join the same online games as PCs and other consoles.
Status: early test builds. Multiplayer is the focus, and testers are trying the campaign too. Testers play the test builds on real consoles. Builds are also checked in the Xenia emulator, to the main menu and a game of Blood Gulch.
Get the newest test build from Releases. You can also build it yourself (below).
You need your own copy of Halo. No game files or SDK files are included.
This repository holds the Xbox 360 port. The game itself is the
chupathingyce submodule. The original Xbox port is
warthog-xbox.
- A console that runs homebrew. An RGH/JTAG 360, or one running a softmod like BadUpdate or BadAvatar, with a launcher such as Aurora. A development kit works too.
- Your own Halo maps. The
mapsfolder from your own original Xbox Halo disc: the North American (NTSC) release, 01.10.12.2276, as every Chupathingy build and server uses. Warthog never provides maps, disc images or other game data, and never links to them. Don't share yours. - To build it yourself (below): a Mac or Linux computer, and your own Xbox 360 SDK.
- Download the newest test build from Releases and unzip it.
- Copy its folder to the console's hard drive, for example
Hdd1:\Games\Warthog360\(FTP or XBDM). - Put your own Halo maps in its
mapsfolder. At leastui.mapis needed. - Add the folder to Aurora's content paths, or start
default.xexfrom your launcher's file browser.
To update, copy the new default.xex, shader_cache.bin and shaders
folder over the old ones. Keep config.toml, the maps folder and your
Delta link files (delta_device.key, delta_link.txt).
- Online Games: lists the games online and joins them, dedicated servers too. It joins OpenCE's current servers (network version 44) and older ones. Co-op games are listed too, with a filter.
- Up to 32 players. A game that grows past 32 players is left, as a full one is.
- Link your Delta profile: on Online Games, press Start, then A for a code. Enter it at stats.chupathingy.org/connect, signed in on your phone or computer, then press A on the console.
- Split screen: when you join a game in progress, the host waits a few seconds for the other players on your console.
- Multiplayer maps load and play offline.
- Two renderers. The default draws through an OpenGL layer. A faster native renderer is being tested (Settings).
- Lag. A full Halo Universal game drops to a single-digit frame rate (#40).
- Shadows and dark areas are much darker than on the original Xbox (#45).
- Settings and the button layout don't save from the menus
(#8). Edit
config.tomlinstead. - Joining games in progress and OpenCE games may still fail (#10).
- No movies. The intro and attract videos are skipped.
- The campaign is still being tested. 343 Guilty Spark is dark and slow (#16).
- The native renderer is a test. Menus, the HUD and the weapon can be missing, and two-player split screen shows a black screen (#37, #51).
- Copy
port.txt,debug.txtandlogs\debug.txtfrom the game's folder to your computer. - Send them at dump.chupathingy.org, with "Xbox 360" as the platform. You get a reference code.
- Tell us in #xbox-360 on the Discord what you were doing, and give the code.
- The game doesn't start. Check that
maps\ui.mapis in the game's folder. Start it from Aurora or another launcher, so the folder is writable. - A black screen, or the menus are missing. Set
display.renderer = "gl"inconfig.tomland start the game again. - Online Games lists nothing. Check that the console is online. Check
that
network.onlineisn'tfalseinconfig.toml. Then sendport.txt: itsnet test:lines show each network step. - A setting doesn't stick. Change it in
config.tomlover FTP, then restart the game.
The settings are in config.toml in the game's folder. The first start
writes it with every setting, commented out at its default. To change one:
- Copy
config.tomlto your computer, or open it over FTP. - Remove the
#in front of the setting and change its value. - Copy it back and restart the game.
These are the 360's own settings:
| Setting | What it does |
|---|---|
display.renderer |
"gl" (the default) draws through the OpenGL layer. "native" is the console's own renderer, a test. If the native one can't start, the game uses "gl". |
console.native_tiled_textures |
A test for the native renderer: true keeps textures in the GPU's tiled layout. Off by default. |
console.native_in_place |
The native renderer reads the map's vertices where they are. false copies them each frame instead, to compare when models look broken. On by default. |
console.visibility_test_runs |
Draws the lens flares' visibility tests as one run. The picture is the same. false draws each one in full, to compare. On by default. |
console.perf_log |
true writes a line to debug.txt once a second with the frame time and each part of the frame. For finding what makes a scene slow. |
console.widget_pool_log |
true logs each new high in the menus' widget memory. For development. |
console.picture_frame |
For comparing the renderers: saves the picture of this frame number beside the game. 0 (the default) saves none. |
The file also has the PC builds' settings. Game ones work as on a PC: field
of view, the HUD's timers, chat, the scoreboard, and music and effects
volume. The window and resolution settings do nothing: the 360 always draws
at 1280x720. The original Xbox's [console] settings, such as
bypass_security, aren't used on the 360.
config.toml: the settings, written at the first start.debug.txtandlogs\debug.txt: the game's log.port.txt: the console layer's log (also on the debug channel).shader_cache.binandshaders: compiled shaders. They come with the build, so the game doesn't stop to compile them in play.delta_device.keyanddelta_link.txt: your Delta link. Keepdelta_device.keyto yourself, and keep both when you update.
port/xbox360/README.md has the port's details, how it draws, the networking and the developer tools.
Clone with the game:
git clone --recursive https://github.com/ChupathingyCE/warthog-360.git
cd warthog-360(In a clone you already have: git submodule update --init.)
You need:
- Python 3 and ninja.
- OXDK, whose
xbox360folder has the 360 tools:~/OXDK/xbox360(or--oxdk360 DIR), with itscxexbuilt. - OXDK's patched LLVM (
./oxdk build-llvmbuilds it), in~/llvm-xenonor given with--llvm-xenon DIR(--llvm-xenon ~/oxdk-llvmfor where OXDK puts it). - Your own extracted Xbox 360 SDK, the folder holding
lib/xbox/xboxkrnl.lib(--xdk360 DIR, orXDK_DIR).
Build:
python3 chupathingyce/configure.py --console-port port/xbox360 --console-no-debug-asserts \
--console-players 32 [--xdk360 /path/to/XDK]
ninja xbox360 # build/xbox360/default.xex--console-no-debug-asserts is the build testers get, as on the Wii U
and the original Xbox. It is faster on the console: the debug decomp's
asserts are compiled out, as the retail game had them, except the memory
checks. Leave it out for a build that stops at the first failed assert.
--console-players 32 is the 32-player build testers get, as on the
original Xbox. Without it the game's configure builds 16.
Without the toolchain or the SDK, ninja xbox360 says what is missing.
--console-debug-tools adds the developer tools (the debug build's
profiler and debug data, the GL layer's timers, the bring-up logs and test
switches). A normal build has none. docs/building.md has every step.
Changes to the game itself go to ChupathingyCE/chupathingyce first; this repository then moves its submodule to them. Nothing from Microsoft's SDKs is in this repository, and none of it may be committed.
Warthog 360 is free software: you can redistribute it and modify it under
the terms of the GNU General Public License as published by the Free
Software Foundation, either version 3 of the License or (at your option) any
later version (GPL-3.0-or-later), with the console SDK permission below.
It comes with no warranty. The full text is in LICENSE.
- From the GPL change onward. Warthog follows Chupathingy, which is GPL from release 0.8.0. The source at every commit before the change was released under CC0 1.0 and stays that way.
- What Warthog builds on. The Halo CE decompilation (punpckhdq/halo and bnunu/halo-1) and OpenCE were released under CC0 1.0 when Chupathingy took them, which lets anyone build on them under any terms. Their later work is under their own licenses.
- The game (the
chupathingycesubmodule) is under its own repository's license, with its third-party code, fonts and art under theirs. - Halo itself is not covered. The license covers the work of Warthog's and Chupathingy's authors. It gives no rights in Halo, its maps or anything else Microsoft owns, and no SDK is included.
You may build Warthog yourself with a console maker's SDK (see "Building it yourself"), and share what you build:
Additional permission under GNU GPL version 3 section 7
If you modify this Program, or any covered work, by linking or combining it with the libraries of a Microsoft Xbox or Xbox 360 software development kit (such as the Xbox Development Kit and the Xbox 360 SDK, including their
xnet.liband Direct3D libraries), or a modified version of those libraries, containing parts covered by the terms of those kits' licenses, the licensors of this Program grant you additional permission to convey the resulting work. Corresponding Source for a non-source form of such a combination shall include the source code of the covered work, and need not include the source code of those libraries.
The permission only lifts the GPL's own objection. It grants no rights in Microsoft's libraries, whose own terms still apply, and you may remove it from your copies (section 7). Warthog's own published builds are made only with free, legally available tools and libraries; none contains code from Microsoft's SDKs.
Chupathingy is free and always will be. Support through Ko-fi or Patreon goes to running the site and the servers. If there's a specific developer or port you'd like to support, ask them: they may not be part of our community.
- The decompilation: punpckhdq/halo and bnunu/halo-1, of the Xbox build 2342.
- The game: Chupathingy, and OpenCE and its contributors, up to October 9, 2026.
- Warthog 360: Milenko and contributors. The toolchain: OXDK.
- Libraries: zlib, KCP, Monocypher, Expat, tomlc17 and the other libraries
the game uses, with their licenses in the game's
port/third_party.
The port's history up to this repository is in
ChupathingyCE/warthog-xbox#28
(branch xbox360-next).
- The game: ChupathingyCE/chupathingyce
- The original Xbox: ChupathingyCE/warthog-xbox
- Games online now: stats.chupathingy.org
- Discord: discord.gg/chupathingy (#warthog-support for help, #warthog-dev for development)
Warthog is an unofficial fan project. It isn't affiliated with or endorsed by Microsoft, Xbox Game Studios, Bungie or Halo Studios. Halo is a trademark of Microsoft. No game files are included: you bring your own copy. The code is released under the GNU GPL, version 3 or later (see License).
