Editing Halo: Combat Evolved Mod Tools

From Halopedia, the Halo wiki

You are not logged in. Your IP address will be publicly visible if you make any edits. If you log in or create an account, your edits will be attributed to your username, along with other benefits.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then publish the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
{{Title|''Halo: Combat Evolved'' Mod Tools}}
{{Era|RW}}
{{Status|RealWorld}}
{{References}}
{{References}}
The '''Halo: Combat Evolved Modding Tools''', abbreviated as '''Halo: CE Modding Tools''' or '''H1A Editing Kit''', is an editing software released by [[343 Industries]] for the ''[[Halo: The Master Chief Collection|Master Chief Collection]]'' version of ''[[Halo: Combat Evolved]]'' and distributed via [[Steam]]. The [[modding]] software itself is quite similar to the ''[[Halo Editing Kit]]'' released by [[Gearbox Software]] for ''[[Halo Custom Edition]]'', although with several improvements, and an additional program called H1A standalone build for loading tags instead of maps. H1A-EK includes updates to the game engine and tools, bug fixes QoL improvements, extended limits, and new features. A complete source tag set for the game's stock campaign and multiplayer maps, plus source scripts for the campaign is also available.{{Ref/Site|Id=Release|URL=https://store.steampowered.com/news/app/976730/view/3007823106801144958|Site=Steam|Page=Halo: Combat Evolved Mod Tools|D=23|M=6|Y=2021}}
The '''H1A Editing Kit''', abbreviated as H1A-EK, is an editing software released by [[343 Industries]] for the ''[[Halo: The Master Chief Collection|Master Chief Collection]]'' version of ''[[Halo: Combat Evolved]]'' and distributed via [[Steam]]. The [[modding]] software itself is quite similar to the ''[[Halo Editing Kit]]'' released by [[Gearbox Software]] for ''[[Halo Custom Edition]]'', although with several improvements, and an additional program called H1A standalone build for loading tags instead of maps. H1A-EK includes updates to the game engine and tools, bug fixes QoL improvements, extended limits, and new features. A complete source tag set for the game's stock campaign and multiplayer maps, plus source scripts for the campaign is also available.


==Install==
== Mapping programs ==
The ''Halo: CE Mod Tools'' are a free download for all players via Steam, regardless of if they own ''The Master Chief Collection'' or not. The tools can be found in the "Tools" section of the Steam Library, or installed by clicking the link provided in [https://store.steampowered.com/news/app/976730/view/3007823106801144958 this post].{{Ref/Reuse|Release}}
Much like ''Halo Custom Edition'', H1a Editing Kit comes with several programs designed to assist users in making custom content.


==Mapping programs==
=== Tool ===
Much like ''Halo Custom Edition'', H1a Editing Kit comes with several programs designed to assist users in making custom content.{{Ref/Reuse|Release}}


===Tool===
=== Guerilla ===
Tool is a command line program for compiling tags and maps.


===Guerilla===
=== Sapien ===
Guerilla is a program that allows users to edit tags. Tags house game data and their values such as weapons, vehicles, models, and textures. These tags are called upon in game to spawn objects.


===Sapien===
=== H1A Standalone Build ===
Sapien is a program that creates a visual representation of the game world for users to make physical edits to such as creating NPCS, vehicles, and cameras.
===H1A Standalone Build===
H1A Standalone Build is an executable that runs a modified version of ''[[Halo: Custom Edition]]''. The main difference being that H1A Standalone Build does not load maps, but individual tags. This negates the need for compiling, allowing for quicker iteration and editing.
 
==Changes from the Halo Editing Kit==
<center>''Changes list sourced from [https://c20.reclaimers.net/h1/tools/h1a-ek/ The Reclaimers Library].''</center>


== Changes from the Halo Editing Kit ==
=== General ===
=== General ===
Stability improvements:
Stability improvements:
Line 30: Line 21:
**Fixed bitmap group sequence blocks crashing when crosshair overlay sequence index was out of bounds.
**Fixed bitmap group sequence blocks crashing when crosshair overlay sequence index was out of bounds.
**Fixed exception when AI try to fire weapons without projectile references.
**Fixed exception when AI try to fire weapons without projectile references.
**Fixed a crash resulting from ejection from flipped vehicles, not resetting unit animation state.
**Fixed a crash resulting from ejection from flipped vehicles not resetting unit animation state.
**Removed an incorrect assertion related to drawing HUD numbers and bitmap sequences.
**Removed an incorrect assertion related to drawing HUD numbers and bitmap sequences.
**AI debug code now safely checks for an actor's secondary look direction prop index being NONE.
**AI debug code now safely checks for an actor's secondary look direction prop index being NONE.
**Various buffer overflow, index out of range, and stale pointer fixes.
**Various buffer overflow, index out of range, and stale pointer fixes.
**Increase MAXIMUM_NUMBER_OF_BUILD_SPRITE_BITMAPS from 8 to 16 (renderer stability).
**Increase MAXIMUM_NUMBER_OF_BUILD_SPRITE_BITMAPS from 8 to 16 (renderer stability).
*The engine will now check and log when an invalid particle_system using rotational complex render mode has a particle state where the sprites' bitmap does not include another "sideways" sequence after the given "forward" sequence index.
*The engine will now check and log when an invalid particle_system using rotational complex render mode has a particle state where the sprites bitmap does not include another "sideways" sequence after the given "forward" sequence index.
*The tools are in general faster and more responsive (in part due to manual optimizations, in part due to play builds built with a modern optimizing compiler being used instead of test builds).
*The tools are in general faster and more responsive (in part due to manual optimizations, in part due to play builds built with a modern optimizing compiler being used instead of test builds).
*Asserts can be disabled using the -noassert command line flag.
*Asserts can be disabled using the -noassert command line flag.
*The tags, data, and maps directories can now be set when running all tools. See custom content paths for more info. This makes it easier to work with different tag sets.
*The tags, data, and maps directories can now be set when running all tools. See custom content paths for more info. This makes it easier to work with different tag sets.
*All tools are still 32-bit, but they are now large address aware (LAA). This allows them to use up to 4 GiB of virtual memory instead of 2, which prevents Sapien from running out of memory when editing scenarios with many large assets.
*All tools are still 32-bit but they are now large address aware (LAA). This allows them to use up to 4 GiB of virtual memory instead of 2, which prevents Sapien from running out of memory when editing scenarios with many large assets.
*Various cases of unnecessary/confusing logging in the tools have been removed, such as "Couldn't read map file toolbeta.map" and "Sound card doesn't meet minimum hardware requirements".
*Various cases of unnecessary/confusing logging in the tools have been removed, such as "Couldn't read map file toolbeta.map" and "Sound card doesn't meet minimum hardware requirements".


===Visual===
=== Visual ===
*The tools now use the modern DX11 graphics API instead of the obsolete D3D9 API. This should result in better performance and support on modern systems.
*The tools now use the modern DX11 graphics API instead of the obsolete D3D9 API. this should result in better performance and support on modern systems.
*First person models now use the highest LOD available instead of the lowest.
*First person models now use the highest LOD available instead of the lowest.
*Increased MAXIMUM_RENDERED_ENVIRONMENT_SURFACES from 16k to 32k. This means BSPs can now have more visible triangles without culling happening. It is still important to use portals to manage visible clusters.
*Increased MAXIMUM_RENDERED_ENVIRONMENT_SURFACES from 16k to 32k. This means BSPs can now have more visible triangles without culling happening. It is still important to use portals to manage visible clusters.
Line 58: Line 49:
**Widget alignment in mirror reflections
**Widget alignment in mirror reflections


===Tool===
=== Tool ===
*Lots of new verbs have been added.  
*Lots of new verbs have been added.  
*A -verbose flag can be added to see additional logging.
*A -verbose flag can be added to see additional logging.
Line 65: Line 56:
*Bitmaps compilation
*Bitmaps compilation
**Bitmap DXT1-3 (BC1-3) encoding now uses DirectXTex instead of some S3TC code. This should result in higher quality similar to the original XDK.
**Bitmap DXT1-3 (BC1-3) encoding now uses DirectXTex instead of some S3TC code. This should result in higher quality similar to the original XDK.
**The bitmaps verb now accepts both .tiff and .tif extensions, like bitmap does.
**The bitmaps verb now accepts both .tiff and .tif extensions like bitmap does.
*Map compilation (build-cache-file):
*Map compilation (build-cache-file):
**Script data is properly recompiled from source files when available now. A bug previously caused Tool to always fall back to sources stored in the scenario tag.
**Script data is properly recompiled from source files when available now. A bug previously caused Tool to always fall back to sources stored in the scenario tag.
**Resource maps can optionally be updated to include all the resource data for the scenario being packaged.
**Resource maps can optionally be updated to include all the resource data for the scenario being packaged.
**Maps can target "classic" or "remastered" mode.
**Maps can target "classic" or "remastered" mode.
**loc.map resource maps are no longer generated or used, as they are not used by H1A (aside from H1CE backwards compatibility).
**loc.map resource maps are no longer generated or used as they are not used by H1A (aside from H1CE backwards compatibility).
**Tool will now log errors when the user attempts to use swarm actors in firing-position based combat; always charge at enemies must be set to prevent runtime crashes.
**Tool will now log errors when the user attempts to use swarm actors in firing-position based combat; always charge at enemies must be set to prevent runtime crashes.
*Model and structure compilation:
*Model and structure compilation:
Line 79: Line 70:
**Model and collision importing have more verbose output. Use -verbose for the most troubleshooting information.
**Model and collision importing have more verbose output. Use -verbose for the most troubleshooting information.
*Usage and feedback clarity:
*Usage and feedback clarity:
**Argument parsing is now less primitive. Verbs can include optional arguments and flags, and any unrecognized options are presented to the user.
**Argument parsing is now less primitive. Verbs can include optional arguments and flags and any unrecognized options are presented to the user.
**The usage printout when Tool is run without arguments is now sorted. The names and argument descriptions of some existing verbs have been updated for clarity and consistency.
**The usage printout when Tool is run without arguments is now sorted. The names and argument descriptions of some existing verbs have been updated for clarity and consistency.
**zoners_model_upgrade and strings verbs have been removed since they weren't useful.
**zoners_model_upgrade and strings verbs have been removed since they weren't useful.
**Tool will now tell you if it couldn't find a directory, rather than simply logging nothing like some verbs previously did (looking at you model).
**Tool will now tell you if it couldn't find a directory rather than simply logging nothing like some verbs previously did (looking at you model).
**Verbs which accept a tag path as an argument will now automatically strip data\ and tags\ prefixes, allowing you to use tab completion on the command line (Halo 3 backport).
**Verbs which accept a tag path as an argument will now automatically strip data\ and tags\ prefixes, allowing you to use tab completion on the command line (Halo 3 backport).
**Tool will no longer exception (but will log errors) when compiling a gbxmodel where the JMS has invalid node weights (two nodes where one has weight 1.0).
**Tool will no longer exception (but will log errors) when compiling a gbxmodel where the JMS has invalid node weights (two nodes where one has weight 1.0).
*Tool supports a -pause flag, which keeps the process running after completion until the user presses Enter. This was meant for community-made launchers like Osoyoos.
*Tool supports a -pause flag which keeps the process running after completion until the user presses Enter. This was meant for community-made launchers like Osoyoos.
*Stability improvements:
*Stability improvements:
**ogg/vorbis upgraded to 1.3.5/1.3.7 which should improve sound compilation stability.
**ogg/vorbis upgraded to to 1.3.5/1.3.7 which should improve sound compilation stability.
**Fixes for various unsafe code: uninitialized variables, bad printf args, etc.
**Fixes for various unsafe code: uninitialized variables, bad printf args, etc.


==Sources==
{{Ref/Sources}}
==External links==
*[https://store.steampowered.com/news/app/976730/view/3007823106801144958 ''Steam'' release announcement]
*[https://c20.reclaimers.net/h1/tools/h1a-ek/ ''The Reclaimers Library'' guide for the modding tools]
{{Navbox/Media/Tools}}
[[Category:Modding]]
[[Category:Modding]]
[[Category:Halo: Combat Evolved]]
[[Category:Halo: Combat Evolved]]

Please note that all contributions to Halopedia are considered to be released under the Attribution-ShareAlike 3.0 Unported license (see Halopedia:Copyrights for details). If you don't want your writing to be edited mercilessly and redistributed at will, then don't submit it here. You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

Cancel Editing help (opens in new window)

To view or search uploaded images go to the list of images. Uploads and deletions are also logged in the upload log. For help including images on a page see Help:Images. For a sound file, use this code: [[Media:File.ogg]].

Do not copy text from other websites without permission. It will be deleted.

This page is a member of 1 meta category: