Ninja Bear Studio Plugins Help

Equipment Layout

The Equipment Layout is a specialized container layout for managing gear items—such as weapons, armor, or tools that require an equipment state and a defined attachment point.

It integrates directly with the Ninja Equipment System and allows items to be stored in specific equipment slots, with state transitions managed through gameplay tags.

This layout provides:

  • Integration with the equipment system, including states like Equipped, Stored, or Sheathed.

  • A way to organize items by their equipment state, instead of physical position.

  • Automation of state transitions, using the layout logic and item fragment behavior.

Prerequisites

To use this layout correctly, the following must be present:

Layout Properties

This layout implementation defines the following properties:

Property

Description

DefaultStateTag

Equipment state tag applied to items added to this container. Determines how the item is treated on initial add (e.g., equipped, stored).

DefaultEquipSocketName

Default socket name for items in the equipped state. Used to attach actors to the skeletal mesh (e.g., "RightHandSocket"). Can be overridden per equipment.

DefaultStoredSocketName

Default socket name for items in the stored state. Common for sheathed or holstered positions. Can be overridden per equipment.

Position Type

This layout uses the Single position type, since only one item can be added to an equipment slot.

Linked Containers

This layout integrates with the Linked Container fragment, allowing you to define connections between a primary container, to which the equipment is added to, and a linked container (such as "off-hand") that will also be occupied by the item.

Example Use Cases

This layout is ideal for:

  • Character equipment panels (e.g., Head, Chest, Weapon, Accessory slots).

  • Quick-access bars for consumables or tools.

  • Any system where items represent gear and should transition through equipped states.

Last modified: 01 August 2025