OpenSauce (often just "OS") is a mod for Halo Custom Edition, its Halo Editing Kit, and dedicated server. For players, it offers customization and some QoL features. For modders, it offers engine extensions and modified tools for more extensive modding of the game.

It wasn't typically used for multiplayer maps since all clients would need to use OpenSauce, but was used for several large singleplayer mods like TSCE:E and SPV3. It only supports CE v1.10.

OpenSauce is incompatible with current Chimera versions. Attempting to use both at the same time will result in crashes or a white screen when launching the game.

It's recommended that you create a separate copy of the Halo Custom Edition installation to use with OpenSauce and Yelo maps exclusively.

Features

OpenSauce is mostly used for its extended modding features:

  • New tool commands,
  • New script functions,
  • unit extensions,
  • actor_variant transforms,
  • BSP modifiers (lightmap and sky sets),
  • Directional lightmaps,
  • Shader extensions,
  • Post-processing shaders,
  • Map downloads (from OS dedicated server).

For players, OS offers customized post-processing, FOV, HUD, and FP origins. Most players today tend to prefer Chimera, especially because it integrates with the HaloNet automatic map download repository.

Modding with OpenSauce

The OpenSauce HEK provides modified versions of the official HEK tools, called OS_Tool, OS_Guerilla, and OS_Sapien. These tools must be used when creating and editing OpenSauce tags.

OS_Tool produces maps with the extension .yelo. These maps are intended to be played with the OpenSauce mod enabled, since they can contain tags that rely on OpenSauce features and tag groups. Refinery supports extracting OpenSauce tags from these maps, but Invader does not.

Crash reports can be found in <DRIVE>:\Users<USER>\Documents\My Games\Halo CE\OpenSauce\Reports.

Note that OpenSauce uses the filename initc.txt for init scripts instead.

New tag groups

These extended tag groups may be found in .yelo maps and are only supported by the OpenSauce mod:

Tag name

Group ID

actor_variant_transform_collection

avtc

actor_variant_transform_in

avti

actor_variant_transform_out

avto

effect_postprocess

efpp

effect_postprocess_collection

efpc

effect_postprocess_generic

efpg

equipment_hud_interface

eqhi

model_animations_yelo

magy

multilingual_unicode_string_list

unic

project_yellow

yelo

project_yellow_globals

gelo

project_yellow_globals_cv

gelc

shader_postprocess

shpp

shader_postprocess_generic

shpg

shader_postprocess_globals

sppg

string_id_yelo

sidy

tag_database

tag+

text_value_pair_definition

sily