# Loadout

### Examples

To find the existing Loadout examples, navigate to these areas:

Deathmatch Example Loadouts 

```
Engine > Plugins > Reality Content > Library > Gamemode > Example_DeathMatchClassic > Feature
```

### Creating your own Loadout 

{% stepper %}
{% step %}

### Create the Data Asset

Right click in your content browser, find miscellaneous, hover over it, then select the Data Asset Option. Search for and Select "Reality Loadout Data" (Not "Reality Feature Loadout Data" yet.)
{% endstep %}

{% step %}

### Configure The Data Asset

{% hint style="info" %}
To Create new Reality Tags, create a Data Table asset, and for the struct, choose `RealityTagRegistrationRow`

Then, add a new row at the top, select it. find and select the `Reality.Loadout` Category (Under Reality),  then, in the `tags` array, click +, and name it Loadout\_(NameofTheTeam)
{% endhint %}

Once you've opened the `RealityLoadoutData` Data Asset, go ahead and apply the Loadout Tag you just created in the Loadout Tag field, then click the + in the **Items** array just below the tag selection.

Open the drop down, and in **Item Data**, select the Interactable you would like for that slot. 

To choose what slot the interactable goes in, select the slot tag selection, expand Reality, then Holster. 

That is the minimum you need to do for a Loadout Data Asset to be complete! 

| Option               | Explanation                                                                                  |
| -------------------- | -------------------------------------------------------------------------------------------- |
| Loadout Tag          | The Identifier for the loadout                                                               |
| Items                | An array, each item being the interactable, the holster slot tag, and the cost for the item. |
| Is customizable      | Whether or not a player can modify the items within the loadout                              |
| Budget Cap           | The Maximum amount of money a player can spend on the Loadout                                |
| Category Limits      | How many times that loadout can be used at a time on a team                                  |
| Max Concurrent Users | How many players can use the loadout at a time                                               |
| Cooldown Duration    | How long until the loadout can be re-applied                                                 |
| Cooldown Scope       | Whether the cooldown is for each player or each team.                                        |
| Unlock Requirements  | If the player has this tag, they will be able to use the loadout                             |
| Locked by Default    | Whether the loadout starts locked                                                            |

***

{% endstep %}
{% endstepper %}

#### Reality Loadout Feature

{% stepper %}
{% step %}

### Create the Data Asset

Right click in your content browser, find miscellaneous, hover over it, then select the Data Asset Option. Search for and Select "RealityFeatureLoadoutData" (Not "RealityLoadoutData")

{% endstep %}

{% step %}

### Configure The Data Asset

Make sure **Enabled Loadout** is ticked, then, in **Default Loadout**, Select the Loadout you just created.

| Option                    | Use Case                                                                                                                |
| ------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| Enable Loadout            | Master toggle for the loadout                                                                                           |
| Available Loadouts        | Loadouts that are available to all teams                                                                                |
| Default Loadout           | Default Loadout for all players                                                                                         |
| Allow Custom Loadouts     | Whether or not players can create custom loadouts                                                                       |
| Apply on Spawn            | Auto applies the selected louadout on the players spawn                                                                 |
| Team Loadout Overrides    | Allows you to select a loadout for each team.                                                                           |
| Selection Policy          | Controls whether a player can initiate loadout selection, and the condition for initiating it                           |
| Apply Immediately in Zone | Applies the loadout instantly when player is in a loadout zone                                                          |
| Global Locked Loadouts    | A tag array selector, allows you to lock loadouts, incase they're to be unlocked at a later round or something similar. |
| {% endstep %}             |                                                                                                                         |
| {% endstepper %}          |                                                                                                                         |

### Adding the loadout to your gamemode

Open your GameData Data Asset, and find **Features**, Click the **+**, and enter the `RealityFeatureLoadoutData` Data Asset you created into it.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://beyond-sandbox.gitbook.io/realitysdk/documentation/gamemode/native-game-feature/loadout.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.