Reclaimer Kit · Lesson 9 of 11

Reuse tag edits across maps

Save one controlled weapon edit as a Tag Set, apply it to another map, and read the report before compiling.

Level
Intermediate
Before you start
Two Halo 3 maps, and the Halo 3 Editing Kit's tags folder set in Preferences, so fields have their names. Start with an edit to an existing tag, not imported media.
You will make
A reusable .rktags file and a second scenario with a verified, reversible edit.

Shortcuts use Ctrl; Cmd also works on macOS, and Alt is Option. Keep the pointer over the viewport for editing shortcuts. Save before switching projects.

Keep a Tag Set separate from a package

A Tag Set carries tag edits by group, path and field location. It is a way to reuse tuning across maps, not a complete mod, source asset bundle or list of placed objects. A new map must contain the tags and block elements the edits expect.

For this exercise, edit the ordinary assault rifle's magazine limit to 7. Unlike the duplicated-weapon tutorial, this intentionally changes the shared weapon definition in each target map. Do not include unrelated edits in the session you export.

Save a small set without loading a level

  1. Open a tag directlyStart the Kit with no map and choose File → Open Tag…. Search for assault_rifle, choose a Halo 3 map such as Guardian, and open its weapon tag.
  2. Check the sessionThe header says tags only. This reads the map without starting the game. Keep the map source explicit if the tag exists in several maps.
  3. Change one named fieldCheck that the Tags header says which file named the fields. Open magazines, choose element 0 and change rounds loaded maximum to 7. Check that the selected tab is the weapon tag, not its model.
  4. Save a Tag SetChoose File → Save Tag Set As… and name it tutorial_magazine. A .rktags file is saved, normally under the player folder's Kit Tags. In a tags-only session, Ctrl+S saves a Tag Set.
  5. Read the reportConfirm that your intended edit was included and note anything left out. A saved file is not evidence that every kind of session change can travel in it.

Apply it to another map

  1. Open the targetOpen Valhalla as a new scenario and save it as valhalla_magazine. Record the assault rifle's original magazine value before applying the set.
  2. Apply the fileChoose File → Apply Tag Set… and open tutorial_magazine.rktags. The Kit finds matching tags by group and full path.
  3. Inspect every omissionA missing tag, absent block element or unavailable reference is reported. Do not interpret a partially applied set as a complete success.
  4. Check Undo and RedoOpen the target weapon and inspect its magazine. Undo once to return to the previous value, then redo to return to 7. Applying the set is one undo step.
  5. Play a fresh weaponUse Load Level if you are still in a tags-only session, or play from Level. Check a newly created weapon, then save, compile and inspect the compiled map too.

Know what travels

Goes with a Tag SetKeep elsewhere
Supported tag field edits, references by name, string IDs by text and supported tag growthObject placements, your complete scenario and gameplay setup.
A new tag derived from a source tag the target also hasThe source tag itself when the target lacks it; imported tags do not become a portable asset library.
Edits that match the target's structureImported pictures, sounds, string-file imports and edited scripts; keep these in the scenario or package.

The same path does not guarantee that two tags have compatible content. A numeric value can be an index into another list. Review cross-map changes carefully, and use one game's set only with that game's supported maps. A set from another game is refused.

A tags-only map is different from loose tag files

In a tags-only map session, edits belong to a map and can be saved as a set or compiled into a package. Browse Tags Folder, Open Tags Folder and Open Tag File edit loose files directly. There, Save Tag writes the selected file. Work on a copy of a tags folder before trying that workflow.

A Tag Set is not a replacement for backing up loose tags. Likewise, editing Map Tags does not silently update the loose files from which an Editing Kit map was built.

Check the intended scope

  • Your original installed maps remain unchanged. The saved set is a separate file and the target changes belong to your scenario.
  • The target rifle has the new limit, Undo restores its recorded original value, and Redo reapplies the change.
  • The application report contains no unexplained omissions. A fresh rifle on the compiled target map behaves as expected.
  • Keep one set per purpose, with a descriptive name. A seven-round magazine set is easier to audit than a set containing every experiment from a long session.

Next step

Build and share a complete package. Reference: tags-only sessions, Tag Sets.