This page is incomplete! You can contribute information using GitHub issues or pull requests.
H3 Guerilla (
guerilla.exe) is part of the Halo 3 Editing Kit, is a visual tag editor. Although it can visualize bitmaps and is primarily focused on editing and viewing the structured fields which comprise tags. It does not offer ingame previews or interactive placement of objects, which is Sapien's role.
Right clicking a tag will bring up a menu that lets move or copy the tag to a different path. Moving a tag will automatically fix references to the tag. You can also copy the tag name to clipboard or open the path in File Explorer. The X-drop menu item does nothing.
Currently the tag moving functionality is somewhat broken, references will be automatically updated as expected but you need to manually move the tag.
Seems to be designed to browse images, doesn't seem to work well right now.
Shows some basic information about the tag, seems designed to integrate with source control.
- File > New - Opens a dialog for creating a new empty tag, keep in mind that many tags are not meant to be created like this but are instead meant to be created using Tool.
- File > Open - Lets you select an existing tag using the windows file selection UI, useful if you know the partial tag name since you can use windows search.
- File > Close - Self explanatory, closes the currently active tag (one who's window is in the foreground).
- File > Save - Save the currently active tag.
- File > Save as - Save the active tag under a new name, references to the old name will not be updated, effectively creates a copy of the tag with the current changes applied.
- File > Fix Tag Dependencies - Builds a database of all tags (this takes a while) and then uses it to help you fix any issues with missing/renamed dependencies.
- File > Find referent tags - Find tags that refer to the current tag.
- File > Import/Export - Import or export the current tag to a plaintext format. Not very useful as it will break any tag that uses a
datafield and XML is a nicer format for inspecting tag content. In short if trying to import results in a broken tag that is by design.
Guerilla can run Tool commands using the File > Run tool menu item, the UI makes it easy to select the command you wish to run and arguments.
Using File > Save/Load Workspace, you can save and reload a file which contains the current state of open tags and their window positions.
The File > Undo menu item can undo the most recent change but can't go further back than that. In case the menu is disabled you can try undoing/redoing with Control + z. If you need more than just the most recent change you can use File > Hold and File > Fetch. Hold will save the current state of the tag and fetch will restore that saved state. If you need to use certain advanced features you can enable File > Expert Mode, this will let you edit certain fields and blocks. Don't enable this unless you know what you are doing or need it for something specific as it makes it easier to accidentally corrupt your data.
- File > Show block sizes - shows how much data each tag block uses, not very useful for non-developers - there isn't much you can do to optimise this usage other than deleting things.
- Window - Lets you automatically arrange tag windows
- Holding Alt while opening a tag will open the tag as a column in a "grid view"/"multi-tag view". This makes comparing values across tags easier.
- File > Remote console - doesn't do anything
- Edit > Remote command view - doesn't do anything
- Edit > Drop object - doesn't do anything
- File > Mixing board - not sure what this does
- File > Print - The print menu items don't do anything.