Halo Infinite's Forge and Scripting, especially for newcomers, can be an insurmountable obstacle without proper reference material. Our goal is to provide knowledge and information to help you navigate some of the obstacles that may come your way. Keep in mind, this is an entirely volunteer effort and all information here is provided and maintained by community members going out of their way to collect, organize, and format it appropriately.

Where to start?

For Forge related topics, head over to Forge Basics and UI, for Scripting information, go to Scripting Basics and UI and for User-Generated Content and working with files, Metadata and File Management.

The categories are structured in a way where the most useful and most commonly used information is at the top of each category/folder.

After reading the basics and the linked articles, you should be able to formulate ideas and questions with more confidence, as well as bridge your own knowledge gaps with trial and error. To browse more free-form knowledge that the Forge community has discovered about Forge, Scripting and UGC, check out the section.

I can't find the information I need on the wiki

The wiki is an ever-evolving work in progress largely managed by just a handful of people. The source of nearly all of the information on the wiki is The Scripter's Guild Discord server, where the information is collected and discussed.

If you've looked around the wiki and still have questions, hop to the discord and put a question in the [#🤷 | forge-help] or [#🤷 | scripting-help] forum. Your question and the answer to it may end up being the source of an article, as many others have been.

How do I contribute?

The TSG Forge Wiki works based off of a public and changes to the Wiki are made via Pull Requests to the repo. More information about how to contribute to the TSG Forge Wiki can be found here:

If you have questions or issues, or if you've submitted a pull request and haven't seen any action on it, reach out to Captain Punch (server admin) or a Guild Officer via Discord.

This section shows the basics of the Forge tool in Halo Infinite, what it's capable of and how it compares to previous Forge tools.

What is Forge?

Forge is a level editor for Halo. It started as a tool to move around objects on existing dev-made levels, but with Halo 5 and more recently Halo Infinite, the tool has grown to such complexity that parallels between other level editors like Unreal Engine 5 and Unity have been drawn with Forge. Read more about Forge's history on the Halopedia article.

Halo Infinite's Forge

Halo Infinite's Forge is the most feature-rich and complex Forge in the Halo franchise. While this complexity opens up a myriad of never-before-seen possibilities with the tool such as object scaling, undo-redo possibility, detailed lighting adjustment and more, it has also turned away players who just want to mess around on Forge and create quick and fun experiences due to there being so much options now.

Halo Infinite is missing a surface-level editor such as the Forge from Halo 3 or Halo Reach, and instead 343 Industries have doubled down on a game-engine type level editor as the direction for Forge, which has caused an effect where many people don't want to invest a large chunk of their time learning all the intricacies of the new Forge tool just to be able to create a level.

Always Online

Anything that you do in Forge and want to be saved will be saved to 343's servers. Forge can be loaded in or in , but saving of the map file is prevented in these modes. To learn more about managing your saved files, see .

TSG Forge Wiki

The TSG Forge Wiki aims to help new and experienced forgers fill in the gaps of knowledge of the tool that using Halo Infinite's Forge is bound to cause. 343 Industries has not provided any official documentation of Halo Infinite's Forge tool nor it's features ever since the launch of Forge in November, 2022, so this community-based Wiki aims to provide that.

Learn more about

Contributors

Okom

The Layout section focuses on the geometry and visual art of a level. As the design of each map is largely a creative process by the Forger, this section will focus on building up the knowledge required to use the Forge tool smartly in order to build out your level experience.

Learn more about

Contributors

Okom

The first step of using Forge is actually loading into the editor on your selected map. This guide will show how that is done in Halo Infinite.

Step-By-Step Process

Loading into Forge in Halo Infinite is simple. Once you're loaded into Forge, you can do all the Forge-related tasks within that session without having to load into separate modes for setting up different gamemodes for instance like in Halo Reach. Follow these steps to load into Forge on a map.

Levels

Void Ecliptic Institute Barrage Seafloor Permafrost Arid Mires

"Forgeable" Area

The region that can be used to build and can be occupied by players in Forge/Customs.

The Respawning section focuses on the different ways of respawning on a level, what are the properties of each associated Forge object and best practices.

Learn more about

Metrics in the context of level design mean the proportions and distances of the gameplay space and the players playing on it. It is important to have a good baseline knowledge of these standard values used in Halo Infinite so the scaling and movement on your level feels correct.

Learn more about

The Spawning section focuses on the different ways players can spawn on a level, and how the player spawning parameters can be influenced.

Learn more about

The Sandbox section focuses on the sandbox objects in Halo Infinite. The three main categories of these are Weapons, Equipment and Vehicles. Ordnance pods' technical properties fall into both Weapons and Equipment, but their general info is explained separately. The Spawn Properties category explains the function of the common spawn properties of sandbox objects.

Learn more about

• Nav mesh data file

• Audio data file

Bullet points of the topic:

• How to make smooth terrain

• Small Terrain Rugged issues (ref: )

Information about the weapons in Halo Infinite via Forge objects. A list of all weapons, how to spawn them on your level and extra researched information can be found.

Learn more about

All ways to spawn equipment in Halo Infinite. The first spawner objects in the list are the most common ones.

Learn more about

Information about the vehicles in Halo Infinite. A list of all vehicles, how to spawn them on your level and extra researched information can be found.

Learn more about

The Terrain section focuses on informing the reader about the different terrain objects available in Halo Infinite and how to manipulate them efficiently in order to create smooth and believable terrain.

Learn more about

Bullet points about the topic:

• Reasoning for following art techniques

• Link to art techniques explained in articles in the

Bullet points for the topic:

• Level Design methodologies

• How to design for Halo's arena gameplay

Contributors

Okom

• snap

• spaces

Fusion Coils

Fusion Coils are explosive objects found in various Halo games that can be used to deal significant damage to enemy players and vehicles. They are recognizable by their bright glowing colors and tall, rectangular, shape. In Halo Infinite they can be picked up, carried around the level, and thrown long distances.

One important thing to note about fusion coils is that the game mode setting for scaling weapon damage affects them even when they are not being carried or thrown. For example, if a player has turned down weapon damage to 10% and hits a fusion coil with a gravity hammer, the resulting explosion will also deal 10% damage. This applies to both the damage dealt to players and vehicles and any other damaging effects that occur when a fusion coil is damaged.

This is particularly notable with the large fusion coils that cannot be picked up. These are often strategically placed in certain areas of the map and can be used to deal significant damage to enemy players and vehicles if detonated at the right time.

Intro Cameras in Forge

Intro Cameras are objects used to create cinematic sequences for pre-game and round intermissions.

Usage

Intro Cameras require two cameras per sequence. Camera one is placed as "Order 1" and serves as the starting point, while camera two is placed as "Order 2" and serves as the ending point. For example, in sequence 1, camera three is placed as "Order 3" and serves as the starting point, while camera four is placed as "Order 4" and serves as the ending point. Similarly, in sequence 2, camera five is placed as "Order 5" and serves as the starting point, while camera six is placed as "Order 6" and serves as the ending point.

To create smooth transition shots, it is important to physically place, orient, and rotate the Intro Cameras in a way that their movement from start to end does not go through objects. The movement between the two cameras is calculated automatically based on how they are placed.

Contributors

b0b is here Captain Punch

Required Objects

• Spawn Volume Respawn

Non-Weighted Respawn Volumes

Non-weighted respawn volumes are meant to

Labels

• Label 1: Include CTF

Team

Select the desired team (Eagle or Cobra) just below the boundary settings.

Spawn Volume Properties

• Weight: 0

• Disable spawn points: ON

• Affects opposing team: ON

Weighted Respawn Volumes

Weighted respawn volumes can be useful for multiple reasons, mainly to help players spawn in to safe areas or potentially near combat action. This can useful after you have a baseline understanding of how your map is being played.

Since this example of the Spawn Volume Respawn is being setup for Capture the Flag game mode, the Include CTF label must be set on the object.

Label Set up

Settings under Gameplay -> Labels you will want to set the label to include CTF (or what ever game mode you are working with) this will make the volume only spawn up for CTF. Note: For example if you leave this blank you and decide to play slayer, Team sided spawns will still be on which can create a negative experience for spawn killing/ spawn control. So Just be mindful what volumes are set up for what mode

Designated Team

What this will do is will disable any spawn from any other teams expect the designated team that was set up above.

Why we set up the weight to be 0 so the volume doesn’t create any positive weighting for these zones the next section will set up weighted volumes. So its best to separate Team designated volumes from weighted volumes to give the user better control over how their map behaves.

After these are set up Feel free to scale the size and placement of the volume to your desire on how you want your map to play. Usually you will just want to cover the designated team side of the map. You can create over lap but this will make it so no one will spawn in this location. Flip side if you decide not to create over lap you will create a neutral location where both teams can spawn.

The Level Design section focuses on creating the fundamental geometry of a level with the Forge tool. Starting from the planning of the level and going through the major steps for getting a level layout that works and has the correct metrics.

Learn more about

Contributors

Okom

Information about the equipment in Halo Infinite via Forge objects. A list of all equipment and grenades, how to spawn them on your level, as well as extra researched information can be found.

Learn more about

Contributors

Okom

Information about the equipment in Halo Infinite. A list of all equipment and grenades, and how to spawn them on your level.

Learn more about

Contributors

Okom

Reverse-engineered technical data about Halo Infinite weapons. The information in the spreadsheets has been compiled by Implied Skill.

Learn more about

Contributors

Okom Implied Skill

All ways to spawn weapons in Halo Infinite via Forge objects. The first spawner objects in the list are the most common ones.

Learn more about

Contributors

Okom

Reverse-engineered technical data about Halo Infinite vehicles. The information in the spreadsheets has been compiled by Implied Skill.

Learn more about

Contributors

Okom Implied Skill

The Cameras section focuses on the different camera objects available in Halo Infinite's Forge tool, what they are used for and how to set them up correctly.

Learn more about

Contributors

Okom

The Level Art section focuses on some general guidance on how to start with arting a level and showcases some art techniques that are useful to know with Halo Infinite's forge Tool.

Learn more about

Contributors

Okom

The Initial Spawning section focuses on the different ways of initially spawning on a level, what are the properties of each associated Forge object and best practices.

Learn more about

Contributors

Okom

All ways to spawn vehicles in Halo Infinite via Forge objects. The first spawner objects in the list are the most common ones.

Learn more about

Contributors

Okom

The Gameplay section focuses on all things related to the gameplay of Halo Infinite excluding modes. Having a good gameplay setup on a level is fundamental to having a good playing experience. The sandbox topics, – Weapons, Equipment and Vehicles – along with Audio and Containment are split into multiple sections as they are the most involved, while the rest of the topics can be explained in a shorter form.

Learn more about

Implementing FFA Slayer respawns on maps that disallow spawn flipping in Slayer gametypes (designated with an Include Slayer label on spawn volumes with Affects Opposing Team & Disable Spawn Points set to "On") can be negatively affected by Spawn Volumes.

Solution: 'Exclude FFA All' Label

To address the issue, it is recommended to put an Exclude FFA All label on map-covering spawn volumes set to Eagle and Cobra teams. This ensures that these volumes are ignored in FFA gametypes. Without this exclusion, players in the Neutral team (FFA) would have limited safe spawn areas, potentially causing undesirable gameplay situations.

The Spawn Influence section focuses on the different ways player spawn weighting can be influenced with Forge objects and via player actions during gameplay. Also included are the properties of each associated Forge object and best practices.

Learn more about

The folder structure doesn't have to be overly complicated to work efficiently. Below are some examples of basic folder structures that experienced forgers have come up with, and are tuned to work for the common object groups in a Forge map. A basic folder structure is useful for categorizing objects into large categories that still differentiate them enough to be understandable.

Advantages

The advantages to having a basic folder structure are:

4v4

The Audio section focuses on all the ways audio can be manipulated on a Halo Infinite level using the Forge tool. What are the capabilities of audio manipulation via objects and scripting, and how to build audio data that makes audio on your level sound realistic.

Learn more about

Units in this table are Halo World Units. 1 WU = 10 Units in the Infinite Forge UI.

Note: N/A indicates that the value is not applicable or not available for that particular Halo game.

Contributors

Kwatzy Captain Punch

Variants

MA40 Longshot (Assault Rifle)

The Object Browser tab is the first tab at the top of the Forge Menu and it displays a list of objects to spawn in Halo Infinite Forge.

Interface

The Object Browser tab consists of object categories and subcategories, within which are spawnable objects. The categories can be opened and closed, and their state will persist until the Forge session is closed. A short description of the selected item is shown under the main interface. In addition to object categories, there are also categories for recently used objects, and Modes and Prefabs that you are a Collaborator on or have bookmarked.

Controls

Controls related to navigating the Object Browser tab. Options for both Keyboard and Mouse, and Controller are provided:

Categories ↓

The sections below detail the different categories within the Object Browser tab, and their contents in detail. The section acts as a searchable full object list for Halo Infinite Forge.

Recents

A list of the most recently placed objects. This list persists between Forge sessions, and only resets when the game is closed.

Modes

A list of Forge Modes that you are a collaborator on, or have bookmarked. The modes (consisting of only Mode Brains) can be placed on the map straight from the menu.

When a Forge session is loaded, each player requests all of their owned and bookmarked modes to be loaded so the game can display these in the Modes category. This happens for both modes and prefabs. For players who have a lot of these, it can cause upwards of 1000 network requests just from loading the same modes and prefabs every time a new Forge session is loaded.

Tool:

This results in not being able to easily select modes or prefabs from the corresponding categories when the requests are being made as the list of items is constantly changing, which resets the position of the scroll bar to the top of the category. Only after all of the requests have been fulfilled, will the scroll bar stop resetting.

Prefabs

A list of Object Prefabs that you are a collaborator on, or have bookmarked. The prefabs can be placed on the map straight from the menu. When a Forge session is loaded, each player requests all of their owned and bookmarked prefabs to be loaded so the game can display these in the Prefabs category.

Forge Object List

Full object list of all spawnable objects in Halo Infinite Forge:

Hidden Categories

There are hidden categories in the Object Browser which hold assets that have not been validated for Forge yet, but may have been used by 343 on their internal builds while making Forge maps. It also holds depreciated objects, that have been replaced by a new variant. Most of these are objects that have had their origin point changed.

A showcase of the hidden objects of Season 5 can be seen in this YouTube video:

Map:

Map: (alternative)

The hidden categories are named "Hidden", "Kits" and "Templates":

Learn more about:

Contributors

Okom Surasia

The folder structure doesn't have to be overly complicated to work efficiently. Below are some examples of advanced folder structures that experienced forgers have come up with, and are tuned to work for all object groups in a Forge map. An advanced folder structure is useful for categorizing every object type efficiently and semantically. Takes a bit longer to set up and takes up more budget, but is much more useful on larger projects or feature-rich maps.

Advantages

The advantages to having an advanced folder structure are:

Purpose

The purpose of the Spawn Point [Backup] object is to spawn the player or Forge monitor on the map when there are no other Spawn Points available.

Despite the object being able to be selected from the Forge Menu, it is rumored that it was accidentally left in the retail Forge Menu for players to use on their map, when it was never supposed to have been left there. This is backed up by the fact that any extra Backup Spawn Points placed on the map serve no purpose on a regular map experience.

Invisible Backup Spawn Points

On each map there is at least one invisible Backup Spawn Point object which can't be seen, selected nor deleted by the player. These are placed by 343 to prevent the player or Forge monitor from not being able to spawn on the map after deleting every object on the map.

A Team Intro Spawn is a Forge Kit object consisting of four Initial Spawn Points and a Camera. This object is used to spawn in four players at the start of a match or round, and it has a built-in camera movement cycle that showcases each player before the initial Gameplay Start.

Team Intro Spawns can be assigned to different Teams, and the Squad setting should be adjusted if more than four players per team should spawn on separate Team Intro Spawns.

The object names for the Team Intro Spawn are Team Intro Arrow Front, Team Intro Arrow Left & Team Intro Arrow Right.

Placing the object

Object path

• Gameplay

  • Match Flow

    • Team Intro Arrow Front

Placement

The Team Intro Spawn should be placed where a group of four players on a Team should initially spawn on. In most cases these are in or around the main bases. If some of the spawn points on the Team Intro Spawn are floating, the players will be put on the nearest surface, and won't float in the air.

Camera

After the sequence has ended and all players have successfully spawned in the game, the Camera in the Team Intro Spawn object will go through a static cycle showcasing all four players on it. After the four players have been shown, the Camera will move to the static position shown on the Forge Kit object.

Line-of-sight blockers

Make sure that no objects are blocking the view of the Camera. Otherwise, the Camera movement will look weird as it's passing through solid geometry or blocking the view towards the players at the end.

Height

The spawn points can intersect the ground by 1.5 units and still let a player spawn on them. Any floating spawns will set the player on the nearest surface underneath them.

In situations where the ground is uneven and some spawns may be floating, the view of the final Camera should be prioritized over the height positioning of the spawn points.

Blocked spawns

Placing the spawns lower than 1.5 units into the ground will cause them to be blocked. If a player can't spawn on their designated spawn point of the Team Intro Spawn, they will be relocated to a on the map. If no Respawn Points are available, will be used.

Rotation

The Team Intro Spawn can be rotated without issues, as long as no spawn points get blocked in the process. The final Camera view will take on the rotation of the Camera in the Forge Kit object.

If the Team Intro Spawn is placed upside-down, the player showcase order is reversed, and the final Camera rotation will be upside-down.

Properties

Physics

Setting the Physics value to "Phased" or "No Collision" will make moving the object easier as it won't collide with other objects.

Assigning a Team

The Team Designator property determines which Team spawns on the Team Intro Spawn.

Assigning a Squad

The Squad property determines which Squad spawns on the Team Intro Spawn. Squads are used to order which Team Intro Spawns are filled first.

Practical setup

Here are examples on how to set up Team Intro Spawns in practice.

4v4

Eagle Team

Team Intro Spawn 1

Cobra Team

Team Intro Spawn 1

12v12

Eagle Team

Team Intro Spawn 1

Team Intro Spawn 2

Team Intro Spawn 3

Cobra Team

Team Intro Spawn 1

Team Intro Spawn 2

Team Intro Spawn 3

Infection & Firefight:King of The Hill

Infection and Firefight:King of The Hill are modes where Team Intro Spawns are required only on the Eagle side.

Eagle Team

Team Intro Spawn 1

Team Intro Spawn 2 (Infection)

Team Intro Spawn 3 (Infection)

Read more about Infection and Firefight:King of The Hill:

Labeling

In some cases, it can be useful to have players spawn in a different location in asymmetrical modes that may be played on the same map where a symmetrical Team Intro Spawn setup is present. For these situations, Labels can be used to include and exclude certain spawns.

Assigning Labels

Regular spawns

Alternative spawns

Read more about: .

Contributors

Okom

The Object Properties tab is the second tab at the top of the Forge Menu and it displays properties for the selected object(s).

Interface

The Object Properties tab consists of categories and subcategories, within which are object options and settings. The categories can be opened and closed, and their state will persist until the Forge session is closed. A short description of the selected item is shown under the main interface. The common adjustable object properties include Object Mode, Transform, Visuals, and Gameplay.

The Folders tab is the third tab at the top of the Forge Menu and it allows users to create folders and subfolders where objects can be moved into.

Interface

The Folders tab consists of main folders and subfolders where forge objects placed on the map are stored. The main folders and subfolders can be opened and closed, and their state will persist until the Forge session is closed. The folders can be renamed, and their positioning is based on alphabetical order. A folder and the objects within the folder can be locked or hidden. These options prevent the object from being selected and hide their visibility respectfully.