Repository navigation
MendicantCE PRISM 2 (pack tools)
Pre-releaseMendicantCE is a modified version of OpenH1 (Halo: Combat Evolved for the Xbox, ported natively), changed by Adam Wiley. It is not OpenH1's build. OpenH1's developers did not make it and do not support it: do not report its problems to OpenH1's tracker or Discord.
This build is prism-1 plus the PRISM pack tools: you can now build every PRISM pack yourself from your own copy of the game. The game is otherwise the same as prism-1.
Source: commit 40c3dbd of the branch main; SOURCE.txt in each zip says the same. Licence: AGPL-3.0-or-later.
What you need
- Your own copy of Halo: Combat Evolved for the Xbox, as a disc image. No game data is in the downloads. At the first start the game asks for the image and takes its maps from it.
- A 64-bit computer with Vulkan 1.3. Linux: x86-64, glibc 2.35 or later. Windows: x86-64, Windows 10 version 1903 or later.
- For ray tracing only: a graphics card with ray queries. Without one those rows are greyed out.
Install
| File | How |
|---|---|
MendicantCE-PRISM-linux-x86_64.zip |
Unzip into a new folder of its own and start bin/openh1. There is no installer. Do not unzip it into ~/Applications/OpenH1 or over an OpenH1. |
MendicantCE-PRISM-windows-x64.zip |
Unzip into a new folder of its own and start halo.exe. The program is not signed: if Windows says it protected your PC, choose More info, then Run anyway. |
SHA256SUMS |
sha256sum -c SHA256SUMS checks the two zips. |
README.md in each zip says more. The paths it names under docs/ and port/ are in the source at the commit above, not in the zip.
What is in it
Everything this build adds is off until you turn it on. As downloaded it plays as OpenH1 does.
Works as downloaded:
- MENDICANT AI: the campaign's Marines and Covenant fight as led units, with trained models, which come with the build. Turn it on under Settings › Profiles › CAMPAIGN AI › MENDICANT AI. It applies from the next map start, on the host of a campaign or co-op game.
- PRISM lighting (Settings › Mods › PRISM GRAPHICS): highlights, sun shadows, soft and traced shadows (with ambient occlusion World), smooth lightmaps, shade depth, bloom, tone.
- PRISM ray tracing (Settings › Mods › PRISM RAY TRACING): shadows; gi (the sky's and the sun's bounce only); pathtraced (a prototype).
- Theater (Settings › Mods › RECORD GAMES, THEATER): replays of network games you host or join. Voice chat is not recorded.
- Forge (
game.forgeinconfig.toml; no menu row) and tag packs.
Needs packs that are not in any download:
- Local reflections, rebaked lightmaps, the world remodel, and every row of PRISM ASSETS (texture detail, PBR materials, remodels, material and surface detail). These read files made from the game's data, so none can be published. Without the files those settings draw the stock game, and
halo.logsays so once a map.
PRISM pack tools (new)
The tools build those packs on your computer, from your own maps. They are in both zips: share/openh1/prism_packs/ on Linux, prism_packs\ on Windows. GUIDE.md there explains setup, each pack and its setting, what it costs, and troubleshooting.
prism_packs.py checklists what is missing;buildmakes the packs, writes them where the game reads them and adds them tomods/load_order.toml. A stopped build carries on where it stopped.- They need Python 3, Blender and Invader. The upscalers are not shipped: each is fetched from its own source only if you agree, checked, and its licence shown.
- The Linux zip has a static 32-bit map extractor,
bin/openh1-map-extract(glibc, LGPL; the notice says where its source is). On Windows the tools run that extractor through WSL. - Building is slow: the texture and lightmap packs are long jobs, even on a fast graphics card.
Different from OpenH1 on purpose
- It does not update itself and never looks at OpenH1's releases. New builds are on this page.
- It sends no crash reports.
- Discord status and Join are off unless you set your own application's id (
discord.application_id). - It does not take
openh1://links: join an invite by copying its link, or with JOIN BY LINK. - About,
versionand what a host is told name MendicantCE and this commit. - A game it hosts tells players of other builds, once, that the server runs a modified OpenH1 and where its source is.
Known problems
- The pack tools have not been run on Windows. On Linux every character and texture pack and b30's remodel and lightmaps were built and played; the other levels' remodels and lightmaps use the same steps but were not built in testing.
- The Windows build has not been played on Windows. It is compiled and started by CI without game data or a graphics card, and under Wine it reached the menu and a campaign level with no picture. Its window, Vulkan, sound, input, the disc image picker, PRISM and ray tracing have never run on Windows.
- Windows: TEXTURE DETAIL, TEXTURE MEMORY, PBR MATERIALS, REMODELS, MODEL MEMORY and SECONDARY MOTION are not available (greyed out), with or without a pack.
- The Linux build was run on NVIDIA cards only (RTX 2060, RTX 3070 Ti). Nothing was run on AMD, Intel or the Steam Deck. If the game does not start on a driver where OpenH1 does, set
HALO_VULKAN_NO_RT=1. - Ray tracing: the reflections and objects settings are read but trace nothing yet, whatever
config.toml's comments say. On a level loaded a second time in one session, traced shadows of some objects may be wrong; a fix is in but is not confirmed. - With MENDICANT AI on, do not take a checkpoint saved mid-fight to OpenH1. Hunters, the Flood, Sentinels and turrets keep the stock AI.
- The QUALITY PRISM preset can hitch the first time a level shows new effects.
- Internet games use OpenH1's brokers, master server and network version; a game you host is public by default, and OpenH1 and OpenCE players can join it at 30 ticks. An invite's text still points at openh1.com's join page.
- Linux shares
~/.local/share/halo-linux(saved games) and~/.cache/openh1with an OpenH1 on the same computer. - Some names still say OpenH1: the first-start window, the dedicated server's banner, the file names
bin/openh1andshare/openh1. The About panel cuts off the end of the source address. - On Linux a crash's report is at the end of
halo.log(in the folder the build was unzipped into), not indebug.txt. - Variants saved by earlier Forge builds after moving an AI character hold an inert copy of it: remove the copies with the tools and save again.
- This repository's Issues tab may not be open yet; until it is, there is no tracker for this build.
Checksums (SHA-256)
5ebdfe835691adc9abb0d33ba8990675820470d4f322c9c26d99eb5971a8850d MendicantCE-PRISM-linux-x86_64.zip
b5793f102a574011d2d7d6bb9261cdfc6f9649ebf914e927d1c054792afa99b1 MendicantCE-PRISM-windows-x64.zip