Installation & Quick Setup

Install the plugin and get started

Getting the MP_Inventory plugin up and running in your project takes only a few minutes.

1. Enabling the Plugin

  1. Open your project in Unreal Engine.
  2. Go to Edit > Plugins.
  3. Search for MP_Inventory and check the Enabled box.
  4. Restart the editor if prompted.

2. Setting Up the Player Controller (The Manager)

The UMP_InventoryManager is the central hub for handling RPCs and proximity loot.

  1. Open your custom PlayerController Blueprint.
  2. In the Components panel, click + Add and search for MP_InventoryManager.
  3. Add it to the Player Controller.
ℹī¸NOTE

The Manager does not store items itself. It simply coordinates actions between the player, the world, and different inventory components.

3. Setting Up the Component

The UMP_InventoryComponent is where the actual items are stored. It can be attached to any Actor in the game (Storage Chests, Vehicles, Dropped Bags, etc.). For a player's main inventory, it is recommended to attach it to the PlayerController but also works with Character and Pawn, PlayerState.

  1. Open the Blueprint you want to hold items (e.g., your PlayerController or a Chest).
  2. Click + Add and search for MP_InventoryComponent.
  3. Select the component and look at the Details Panel:
    • CRITICAL: Set the InventoryID (a unique name like PlayerInventory or Chest_123) and the OwnerID (used for security, e.g., Player_0 or GLOBAL).
    • Set Max Inventory Slots to your desired size (e.g., 20).
    • Configure Strict Slots depending on your UI design (True for Grid-based slots, False for infinite scrolling lists).
    • (Optional) Enable Enforce Weight Limit and set a Max Weight Capacity.

4. Creating Item Data Assets

You don't need to manually configure the internal Item Registry or subsystems. The plugin handles that entirely under the hood. You only need to create the actual data for your game items.

  1. Create your item data using the Unreal Engine Asset Manager.
  2. Create a new Data Asset based on UMP_ItemDefinition.
  3. Fill out the item properties (Name, Icon, Max Stack Size, Weight, Equipment Class, etc.).
  4. When you call an action like Add Item, simply pass in the unique ItemID corresponding to your Data Asset.

5. Testing Your Setup

You can now use Blueprints to interact with the inventory:

  1. In your UI or Player Controller Blueprint, get a reference to your MP_InventoryManager.
  2. Drag off the manager and call an RPC like Add Item or Transfer Item.
  3. Supply the Target InventoryID, a valid ItemID, and Quantity.
  4. The Manager will securely route the request to the server, validate permissions, and execute the action on the respective MP_InventoryComponent.
  5. Run the game in Play As Listen Server or Dedicated Server to verify that the item is successfully added and replicated!
💡TIP

For a deep dive into building the UI to display these items, check out theModular UI Integration guide!

← OverviewOverviewInventory Component →