# Loadout

It's far easier to use the **Loadout** prefab provided in the kits than it is to build the entire loadout menu from scratch, as the menu is quite complex and involves a lot of different UI elements. 

As such, this documentation is going to cover modifying and setting up the loadout menu rather than building a new one.

### Creating A Loadout Menu

To create a new loadout menu, drag the Loadout prefab into the scene.

This brings in the entire loadout menu which you can now modify to your liking.

### Adding Your Vehicles And Modules

To add your own vehicles and modules to a loadout menu, create a new Loadout Items object:

1. Create a new game object and add a **Loadout Items** component
2. Add vehicle prefabs you want to appear in the loadout in the *Vehicles* list
3. Add module prefabs that you want to appear in the loadout in the *Modules* list
4. Drag the object into the Project tab to create a new prefab
5. Drag the prefab into the *Starting Items* field in the inspector of the **Loadout Manager** component on the loadout prefab

### Saving/Loading Loadouts

The **Loadout** prefab comes with a **Loadout Data Manager JSON** component that saves and loads loadout data to a file at the [Application.persistentDataPath](https://docs.unity3d.com/ScriptReference/Application-persistentDataPath.html) in JSON format.

If you wish to create your own loadout save/load script:

1. Create a new script that extends the **Loadout Data Manager** base class 
2. Add your own code for saving/loading
3. Add your component to the loadout menu and drag it into the *Loadout Data Manager* field in the inspector of the **Loadout Manager** component

### Loadout Slots

The loadout enables you to load and save multiple loadouts in slots.

To create multiple slots:

1. Open the inspector of the **Loadout Manager** component
2. Set the *Num Slots* value to however many slots you want
3. Uncheck the *Slot Per Vehicle* checkbox

To get rid of slots so that the player can only choose one loadout, simply check the *Slot Per Vehicle* checkbox.

### Exclusive Vehicles

When you have multiple loadout slots, you may want the player to only be able to create one slot for each vehicle on the **Loadout Items** *Vehicles* list. To make this happen, simply check the *Exclusive Vehicles* checkbox in the inspector of the **Loadout Manager** component.

### Exclusive Modules

You may want the player to only be able to add a module once for each module on the **Loadout Items** *Vehicles* list - that is, each module in the list can only appear on a single module mount. To make this happen, simply check the *Exclusive Modules* checkbox in the inspector of the **Loadout Manager** component.

### Loadout Spawning

To spawn the loadout vehicle in the scene:

1. Create a new gameobject and add a **Loadout Vehicle Spawner** component
2. Add a **Loadout Data Manager JSON** component (or whatever data manager component you're using in the loadout menu) and drag it into the *Loadout Data Manager* field in the inspector of the **Loadout Vehicle Spawner** component
3. Make sure the *File Name* in the inspector of the loadout data manager component matches the file name on the same component in the loadout menu
4. Customize the rest of the settings in the inspector of the **Loadout Vehicle Spawner** component


---

# 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://vsxgames.gitbook.io/universal-vehicle-combat/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.