---
title: 28 Item Collectors
description: "In this tutorial we'll add items to collect to the game. *Item Collectors* are used to pick up individual items or access item boxes. We'll add a few items to the *World* and *Dungeon* scene to pick up. We'll set up: -…"
url: "https://orkframework.com/guide/ork4/ork4-tutorials/ork4-unity-quickstart-tutorials-3d/28-item-collectors-q3d/"
updated: "2026-09-23"
category: ORK 4 Tutorials / ORK 4 Unity Quickstart Tutorials (3D)
---

# 28 Item Collectors

In this tutorial we'll add items to collect to the game.

*Item Collectors* are used to pick up individual items or access item boxes. We'll add a few items to the *World* and *Dungeon* scene to pick up.

We'll set up:

- [item collection](https://orkframework.com/guide/ork4/ork4-documentation/section-menus/item-collection/) dialogue
- item collectors

Let's get to it!

# Item Collection Setup

Open the ORK editor and navigate to **Menus > Item Collection**.

## Item Collection

These settings handle the collection of single items via *Item Collector* components.

### Before Collection

We'll play an audio asset.

- **Play Sound**
   *Enable*
- **Audio Asset**
   Select: *chainmail1*

### Collection Dialogue

We can stick with the default setup, which displays a message with the name of the thing we found. You can optionally also use a choice dialogue to let the player select if it should be collected.

All we need to do is select the UI box that's used to display the dialogue.

- **UI Box**
   Select: *Dialogue*

## Item Box > Item List Settings

We don't use item boxes in this tutorial series, but we can set it up just to have it working.

Like with the single item collection dialogue, we just need to select the UI box and can stick with the rest of the default settings.

- **UI Box**
   Select: *Blue Center*

## Save Changes

Don't forget to save your changes by clicking on *Save Settings* at the bottom of the editor.

# World Scene

Let's first add a chest to the *World* scene in the town.

You can add an item collector either via the scene hierarchy context menu (**ORK Framework > Scene > Item Collector**) or the ORK toolbar (search for: **Item Collector**).

I've added mine north of the gate, between two bushes.

[![](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector.png)](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector.png)

## Item Collector

Usually, an item should only be collected once - this is automatically handled for us by the *Scene ID* setup of the item collector. This is by default enabled and each new item collector will automatically receive a new, unused scene ID.

When the player collects the item, that scene ID is marked as collected (for the current scene) and the item will not be available again when returning to the scene.

When copying item collectors (i.e. duplicating them in the same scene), you'll need to manually get a new scene ID by clicking on the *Get New Scene ID* button, or reset all scene ID's in the scene using the *Reset All Scene IDs* button.

- **Use Scene ID**
   This should be *enabled* and have the scene ID *0* assigned, since this is the first item collector added to the scene.

### Start Settings

The item collector is by default set up as an interaction, i.e. the *Interact* start type is added.

If you want, you can also add *Mouse Up As Button* to collect the item on mouse click.

Click on *Add Start Type*.

- **Start Type**
   Select: *Interaction > Mouse Up As Button*

### Collection Settings

- **Collection Type**
   Select: *Single*
   We collect a single item and don't use this as an item box.

We can use the default setup, but let's take a look at some of the settings.

- **Destroy Object**
   *Enable*
   The item collector will be destroyed after collection (or when it is already collected when returning to the scene).
- **Show Dialogue**
   *Enable*
   The item collection dialogue will be displayed.

The *Control Block Settings* handle blocking player/camera controls as well as blocking the move AI for all combatants - this would e.g. prevent enemies hunting the player from getting closer during item collection (when spawning combatants in the scene and using *move AI* to move them). They should all be enabled by default, and we keep it that way.

### Item Settings

- **Spawn Prefab**
   *Enable*
   The item's prefab will be spawned, the player can also interact with the spawned prefab (or in our setup, only with the spawned prefab, since the item collector itself doesn't have a collider).

You can add multiple items to an item collector - in *Single* collection type, one of the added items will be used randomly. We'll just change the already added item.

- **Type**
   Select: *Equipment*
- **Equipment**
   Select: *Leather Armor*
- **Quantity**
   Select: *Value >Value*
   Set the value to: *1*

You can also use the item's *Chance* to determine if the item is available for collection or not. The item can be marked as collected if the chance fails when also enabling *Set On Fail*.

## Another Item Collector

Duplicate the *Item Collector 0* object we just created and move it to the upper right corner of the scene.

[![](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector2.png)](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector2.png)

We need to update the *Scene ID* and also collect a different equipment.

Click on *Get New Scene ID*.

The scene ID should now be set to *1*.

### Item 0

- **Equipment**
   Select: *Cloth Vest*

That's it for the *World* scene - don't forget to save the changes.

# Dungeon Scene

We'll also add some items to the dungeon, so open the *Dungeon* scene.

## Revive Potion

Add a new item collector to the upper right room using.

[![](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector_dungeon.png)](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector_dungeon.png)

The scene ID should be set to *0*. We just need to set up the item, as the rest of the default settings are already correct.

### Start Settings

Add the *Mouse Up As Button* start type if you want.

### Item Settings > Item 0

- **Type**
   Select: *Item*
- **Item**
   Select: *Revive Potion*

## Axe

Add another new item collector to the lower left room.

[![](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector_dungeon2.png)](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector_dungeon2.png)

The scene ID should be set to *1*.

### Item Settings > Item 0

- **Type**
   Select: *Equipment*
- **Equipment**
   Select: *Axe*

## Elemental Brooch

And add a last new item collector to the lower left room.

[![](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector_dungeon3.png)](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector_dungeon3.png)

The scene ID should be set to *2*.

### Item Settings > Item 0

- **Type**
   Select: *Equipment*
- **Equipment**
   Select: *Elemental Brooch*

And that's it - save the scene.

# Testing

Hit play and walk up to an item collector.

[![](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector_demo.png)](https://orkframework.com/wp-content/uploads/ork4_tutorials_unity_quickstart_3d__item_collector_demo.png)

Interacting with it shows the dialogue and collects the item, great!

 

That's it - we're done with the Quickstart 3D tutorials, but [this is not the end](https://orkframework.com/guide/ork4/ork4-tutorials/ork4-unity-quickstart-tutorials-3d/this-is-not-the-end-q3d/).
