In this tutorial we’ll add items to pick up.

You can use Item Collector components to add items to your scene that can be collected by the player. Item collectors can be used in 2 ways – either to collect a single kind of item (e.g. a potion) or as a box, containing multiple items that can be selected.

We’ll only place single items for now, this also allows us to spawn a prefab at the place of the item collector for the item that is used.

Pick Up Animation #

Before handling our item collection, let’s add a pick up animation that we’ll play when collecting an item.

Animation Type #

Navigate to Base/Control > Animation Types and add a new animation type.

Animation #

Navigate to Base/Control > Animations and add a new animation setting.

Base Settings #

Legacy Settings #

Combatants General Settings #

Navigate to Combatants > Combatants > General Settings, we’ll add the pick up animation as a default animation for all combatants.

Animations & Movement > Default Animations #

Item Collection Setup #

Navigate to Inventory > Inventory Settings and change the following settings.

Inventory Settings > Default Item Prefab #

First, we’ll set up the default item prefab that’ll be used by all items, equipment, etc. – individual items/equipment/etc. can optionally override that to use a different prefab.

This prefab is a simple game object with a Box Collider (for being able to interact with it) and a particle effect to make it noticable.

If you use a different prefab, check where the game object’s root position is, i.e. local X=0, Y=0, Z=0. The Item prefab used here is set up to have that position at the bottom of the collider. If the prefab’s root position would be somewhere else, e.g. in the center of a collider, you can use the Spawn Offset to adjust for that position, otherwise items could spawn in the ground.

Item Collection #

These settings handle how collecting single items (not item boxes) is handled. We’ll set up using our pickup animation and the item collection dialogue.

After Collection (Ok) #

You can play an animation and sound when picking up something – we’ll do both.

Collection Dialogue #

Collection Dialogue > Collect Item #

Collection Dialogue > Collect Currency #

Collection Dialogue > Choice Settings #

That’s it four our editor setup – don’t forget to save your changes by clicking on Save Settings at the bottom of the editor.

Scene Setup #

I’ll just give you a few examples of how to set up an Item Collector in the scene, feel free to add additional items.

You can add an item collector either via the scene hierarchy context menu (ORK Framework > Item Collector) or the Makinom scene wizard (Create Game Object > 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.

Potion #

Now, let’s add a first item to the scene. Add an Item Collector to the scene using the context menu or scene wizard.

I’m adding mine near the trees at the town’s exit.

Change the following settings on the Item Collector component in the inspector.

Collection Settings #

Item Settings #

Start Settings #

The item collector is by default set up as an interaction, i.e. using the Interact start type. You can also use different start types, e.g. on trigger enter (requires a collider with Is Trigger enabled).

Currency, but only from the front #

Add another item collector on the crates beside the river.

To be more precise, add it so that it’s on a crate behind the fence.

With that setup, we player could collect it from behind the fence or going around the building – we want to limit that, so that the player has to go around the building to collect the item.

For this, we’ll first change the rotation

Transform #

Change the following settings on the Item Collector component in the inspector.

Collection Settings #

Item Settings #

Conditions #

We’ll add an Orientation condition to limit interaction to the front.

Now, the player can only interact with this item collector when standing in front of it.

More! #

Add more items throughout the World scene, e.g. collecting various potions, equipment and other riches.

You can also add them to the dungeon levels if you want.

Testing #

And that’s it – save the scene.

Hit play, run to one of your items and collect it by interacting with it.

Next, we’ll add visible equipment.