The game engine has various configuration settings available that tweak how the engine functions. Many of these are unimplemented and will be introduced at a later date.
Whether or not to clear the log file at startup (only applies for standard logs and reports)
true or false
true
enable_multi_log
Whether or not to enable "multi-logging", which creates a new log file for each run
true or false
true
log_format
The log format to use, HTML has the option to have stylized logs
html, txt, or both
html
multi_log_dir
The directory to store multi-logs
any valid relative path
logs
reports_dir
The directory to store reports
any valid relative path
reports
use_reports
Whether or not to use reports instead of just debug.txt/debug.html.
true or false
true
stylized_html_logs
Whether or not to enable CSS styling for HTML logs
true or false
true
console_color_set
The color set to use for the console
classic, new, or custom
new
show_header_in_stylized_reports
If enabled, the log header will be included even in stylized reports. The header was originally only visible in plain HTML or text logs.
true or false
true
include_extras_in_stylized_reports
If enabled, the additional blank line and Ώ ∞ messages will be printed after the header. These serve no purpose other than as a cosmetic feature.
true or false
false
bypass_queue
If enabled, the logger queue will not be used outside of initial startup. May cause increased IO usage, but can be used to ensure that no log messages are lost in the event of an exception.
Fonts should be placed in /maps/fonts. If sys_font_force_extension is set to true, the file extension must be set to .bin extension, and this config option should be the font name without the extension. Ex: if the font file is "font-package-en.bin", then this value should be "font-package-en".
sys_font_force_extension
Whether or not to force a .bin file extension for fonts
Whether or not to keep some space between console output (equal to 1 line) or not. (original games did not have extra spacing)
true or false
true
useEnhancedBooleanCommands
Whether or not to use enhanced boolean command handling
true or false
false
useEnhancedGvarMessages
Whether or not to use more informative messages for setting script gvars from console. When disabled, messages will display as they did in the official Bungie games.
Whether or not use an alternative display mode for missing globals in the debug menu. Defaults to false which uses the classic display style seen in Halo 2
true or false
false
autoGenerateNewDebugMenuFile
If disabled, the engine will not generate the default debug_menu_init.xml file if it isn't found. As such, it will attempt to load debug_menu_init.txt but this will almost certainly fail.
Many of these settings may not get implemented for reasons that will soon seem obvious. Many of these were conceptualized by a young boy who had little knowledge at the time of how any of this shit works. They describe ambiguous and random features that, in some cases, flat out don't make any sense. They remain here as a reference only in the event that some of these get implemented in the future - just to satisfy that young boy's visions and make them into reality (or something like that).
fpsMax - Controls the maximum framerate that the engine can run at
Valid values: Any number between 1 and 60
Default: 60
bink-enabled - Whether or not intro videos will play upon starting the game
Valid values: true or false
Default: true
useSwitches - Whether or not to respect command-line switches, such as -console or -devmode
Valid values: true or false
Default: true
useMulti - Whether or not to ignore levels whose scenario path starts with /levels/multi
Valid values: true or false
Default: true
useMulti - Whether or not to ignore levels whose scenario path starts with /levels/solo
Valid values: true or false
Default: true
useLegacyFileStructure - Whether or not to use the traditional Bungie-style file structure /maps, /bink, etc.
Valid values: true or false
Default: true
useDedicated - Whether or not to use Dedicated servers in favor of Peer-to-Peer networking.
Valid values: true or false
Default: true
dedicatedHost - The default host IP for dedicated servers
Valid values: any valid DNS hostname or IP address
Default: 343.host.elaztek.com
dedicatedFallback - A fallback host in the event that the primary dedicated host is offline or unreachable
Valid values: any valid DNS hostname or IP address
Default: i01.host.elaztek.com
dedicatedFallback2 - A secondary fallback host in the event that the primary dedicated host and fallback server are both offline or unreachable
Valid values: any valid DNS hostname or IP address
Default: contingency.host.elaztek.com
ui - The type of UI to use upon starting the game
Valid values: default, classic, halo3, imgui
Default: default
mp3Enabled - Whether or not to support MP3-format sound
Valid values: true or false
Default: true
checkSignatures - Whether or not to check cache file signatures
Valid values: true or false
Default: true
enableElaztekExtended - Whether or not to enable the Elaztek Extended Framework
Valid values: true or false
Default: true
launchMode - The release mode to launch the engine in