Skip to content

A character's gear

In the first mission we simply duplicated the characters: vanilla roles come dressed and armed. When you want a kit of your own — inherit from the faction’s base character and put the gear together from nothing, or fix up a duplicated one — that is what the ECHO Loadout Editor is for, a World Editor tool that comes with the mod. Since 1.6.0.

It edits the whole character prefab: what is worn, what is carried, what sits in the pockets and the backpack. By hand the same thing would mean BaseLoadoutManagerComponent and its nested slot configs.

Open the character prefab with Edit Prefab and press the t-shirt button in the World Editor toolbar. The panel opens on the right, next to Object Properties.

The ECHO Loadout Editor button in the World Editor toolbar

The tool always works on a single prefab and picks it up in one of three ways:

  • the prefab open with Edit Prefab — the usual path;
  • the character selected in the world;
  • a prefab picked by hand in the Base Character field — then press Load From Prefab.

The fields fill up with whatever the character has right now.

The ECHO Loadout Editor panel with a character loaded

The Worn section, a field per item: Hat, Jacket (or shirt), Vest (the load-bearing one), Armored Vest, Back (the backpack), Hand Wear, Pants, Boots. An empty field means there is no such item.

An item is swapped in one of two ways:

  • the magnifying glass next to the field shows the current prefab in the Resource Browser — drag a neighbour from there into the field, another helmet from the same folder, say;
  • «…» opens the resource picker with a search, which is easier when you know the name.

Swapping the headgear by dragging from the Resource Browser

Everything else is swapped the same way.

Swapping the jacket

Swapping the load-bearing vest

Swapping the body armour

Swapping the trousers

Swapping the boots

A backpack picked through the search

The Weapons section:

Field What it is
Primary Weapon the main weapon, right shoulder
Launcher a launcher or a second long weapon, left shoulder
Sidearm the holstered pistol
Grenade a grenade
Throwable a second thrown item, smoke for example

The primary weapon changed to an M14

An M72 in the Launcher field

A pistol in the Sidearm field

Gadgets → Gadget Slots — what the character carries on itself rather than in a pocket: binoculars, a wristwatch. A flashlight or a radio does not belong here, those go into Items.

The Gadget Slots section with binoculars and a watch

The Items → Groups section — a group per item with pockets: the jacket, the load-bearing vest, the backpack, the trousers. The groups are built from whatever is selected above in Worn.

Item groups by container

Expand a group and its Items — a row per item, with a prefab and a count.

The groups expanded with everything inside

Swapping the magazines for the primary weapon

The amount is the Count field, and rows are added and removed with the + and − buttons next to Items.

More morphine, bandages and tourniquets in the trousers

To move a thing from one container to another, delete its row in one group and add it in another — here the compass and the map moved from the trousers into the jacket.

Adding rows to the jacket’s group

The compass and the map in the jacket

The tool adds up the volume of the items and the capacity of the containers, and complains in the Log Console when they do not add up. Fifteen grenades in a backpack, for instance:

Fifteen grenades in the backpack

Capacity warnings in the Log Console

What the messages mean:

  • over capacity — it does not fit. The items and the counts stay as you set them, but the game will not put all of it in the container. Lower the count until the warning is gone — seven grenades in the example;
  • a container capacity or an item volume could not be read — the capacity or the volume could not be read, so no check was made. That is not a “does not fit”, but it is no promise either.

Apply writes everything into the prefab and saves the file. The log gets an EPE: applied and saved … line, and the character in the editor changes clothes right away.

The character after Apply and the line in the log

The other buttons:

Button What it does
Load From Prefab re-reads the character and fills the fields again — anything unapplied in the panel is lost
Refresh Containers rebuilds the item groups for the clothing selected right now. Needed after changing the vest, the backpack or the jacket
Redistribute Items lays the items of each group out across its pockets again, by volume
List Destinations opens a report: where everything lands, which slots the clothing, the weapons and the gadgets have, and what is inherited from the base prefab

Opening the prefab is not required. Place the character in the world, select it, fix the gear up, press Apply — the changes go into its prefab — and then remove the character from the world.

Editing a character selected in the world

That way you see the result in a finished scene instead of the empty backdrop of prefab edit mode.