H1A standlone build (343i)

The H1A-EK includes a standalone build of that game (halo_tag_test.exe). This build doesn't include network functionality and it intended for testing single-player maps. It includes AI debugging code not included in other published builds of the engine. Using custom content paths is supported.

The standalone build is still somewhat experimental and bugs should be expected. Again, only single-player maps are officially supported at this time. Maps should always receive final testing as map cache files loaded by MCC itself.

Usage

The UI works to a limited degree but loading maps is best done using the map_name command in the console. Note: you need to use the full scenario tag path as this is a tag build. For example:

; load tags\levels\a30\a30.scenario:
map_name levels\a30\a30
; load tags\levels\test\bloodgulch\bloodgulch.scenario:
map_name levels\test\bloodgulch\bloodgulch

This build supports some of the same arguments that H1CE does, such as -vidmode 2560,1440,120 to set resolution and -windowed mode.

Use cases

This build offers a number of benefits for testing over compiling cache files for H1A:

  • Since it loads tags, you can edit tags then simply reload the map with map_name to see changes. Pair this with game_save to return to the same place. This is not quite real-time tag editing, but it's close.
  • Script stack space is validated unlike release builds.
  • You have access to all console functions and globals in a much more interactive environment than Sapien to help you troubleshoot your content.

Debug camera controls

To enter into the debug camera, open the console and enter debug_camera_save followed by debug_camera_load or press Backspace until you are in flying camera mode. Movement of the camera is a little different than in Sapien or H1CE. You do not need to hold the middle mouse button and the camera moves in the direction it's pointed rather than its vertical movement being controlled exclusively with buttons.

  • Backspace: Cycle camera modes (1st person, 3rd person, flying)
  • Use the mouse to aim
  • Move with W, A, S, and D
  • Go up with R and down with F (camera relative, not world relative)
  • Increase/decrease camera speed by scrolling down/up
  • Temporarily boost camera speed by holding Ctrl
  • Rotate clockwise with G

You can also use a gamepad to control the camera:

  • Right bumper (hold): Cycle camera modes (1st person, 3rd person, flying)
  • Right stick click: toggle gamepad control of the debug camera
  • Right stick: aiming
  • Left stick: horizontal movement
  • Right trigger: move up
  • Left trigger: move down
  • Left stick click: speed boost
  • D-pad up/down: speed increase/decrease (make sure to enable framerate_throttle 1 first)
  • D-pad left/right: roll

Analog control of the camera with the gamepad makes a great filming tool for your custom map trailers.

Object spawning

You can quickly spawn a variety of objects for testing:

  • Spawn all bipeds by pressing Ctrl + F7.
  • Spawn all vehicles by pressing Shift + F7 or entering cheat_all_vehicles into the console.
  • Spawn all weapons by pressing F7 or entering cheat_all_weapons into the console.
  • Spawn just a Warthog by entering cheat_spawn_warthog into the console.

Known issues

  • Sound cuts out - ensure framerate_throttle 1 is set.
  • Menus are rendered at their native size of 640x480 in the top left corner of the screen rather than stretched to the entire game resolution.
  • Low mouse sensitivity in vehicles and when zoomed in.
  • Some AI may behave differently than in a cache build. For example, the sentinels during d40's Warthog run are inactive.
  • Player cannot be controlled while in debug camera mode.
  • Some transparent geometry like lights and decals may be visible even when they are behind an obstruction.
  • Crashes that happen in H1A Sapien may also occur.

Acknowledgements

Thanks to the following individuals for their research or contributions to this topic:

  • num0005 (Documenting H1A standlone build)
  • Zeddikins (Finding the spawning hotkeys)