Skip to content

MendicantCE PRISM 1 (OpenH1 base, commit 07f07aa)

Pre-release
Pre-release

Choose a tag to compare

@Adam-AtlasSoftware Adam-AtlasSoftware released this 12 Nov 18:53

MendicantCE 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 is the first build on the OpenH1 base. It is a different program from the earlier mendicant-2 and mendicant-7 releases (new base, Vulkan, 64-bit only, MENDICANT AI off by default, other file names).

Source: commit 07f07aa of the branch mendicant-prism; 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.forge in config.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; the tools that made the author's are not in the repository. Without the files those settings draw the stock game, and halo.log says so once a map.

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, version and 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 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/openh1 with an OpenH1 on the same computer.
  • Some names still say OpenH1: the first-start window, the dedicated server's banner, the file names bin/openh1 and share/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 in debug.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