Items

Items are one of the most important part in most RPGs.

In RPG Builder, you can create many different types of items, each with their own use and functions.

Generic Fields

Field Name	Function
ID	The ID of this asset data element. Automatically generated.
Name	Name of the asset data in the project and editor.
Display Name	The name that will be displayed to the player.
File Name	The name of the file in the project. Automatically generated.
Description	The item its description.

Item Data

Types

Field Name	Function
Rarity	The quality / rarity of this item. Defined in Types > Item Rarities. Default Rarities: Common Uncommon Rare Epic Legendary
Type	The type of this item. Defined in Types > Item Types. Default Item Types: Armor Consumable Currency Enchantment Gem Material Recipe Resource Weapon
Weapon Type	The weapon type of the item. Defined in Types > Weapon Types. Default Weapon Types: Axe Bow Staff
Slot	The slot type of the weapon. Defined in Types > Weapon Hand Slots Default Weapon Slots: Two Hand Main Hand Off Hand Any Hand
Armor Type	The armor type of the item. Defined in Types > Armor Types. Default Armor Types: Cloth Leather Plate
Slot	The slot of the armor piece. Defined in Types > Armor Slots. Default Armor Slots: Helmet Chest Cape Shoulders Gloves Pants Belt Boots

Enchantments

Field Name	Function
Enchantment	The enchantment attached to this item.
Consume Item?	Should this item be consumed when using the enchantment?

Learn more about Enchantments here

Gem Bonuses

Gem settings are only available for items of type Gem.

Field Name	Function
Socket Type	The socket type for this gem. When socketing a gem in an item, the socket type has to match on the gem and the item socket. You can create more Socket Types under Types > Gem Socket Types.
Add Stat	Adds stat bonuses this gem gives. You can add as many as you'd like. Stat: The stat that will be altered Amount: The amount the stat will be altered by Is Percent?: Is the amount the stat will be altered by a percentage?

Sockets

Sockets are only available for items of type weapon or armor.

Field Name	Function
Socket Type	The type of the socket.

Loot Settings

Field Name	Function
Drop In World?	If on, this item will physically drop in the world, similar to ARPG games.
In World Model	The 3D model representing the item in the world.
Duration	How long the item will stay in the world after dropping.
World Interactable Layers	The layers the item can interact with when dropped in the world

Action Abilities (Weapons & Armors)

Field Name	Function
Ability	The ability to be used.
Key Type	Override Key Action Key
Key	The pre defined keybind for this ability to be used. This field opens upon selecting Override Key
Action Key	The action key to trigger this action ability. Action Keys are set under Settings > Action Keys > Action Key List.

Visuals (Weapons & Armors)

Field Name	Function
Model Name (For Armors)	The name of the game object inside the character model that will be enabled/disabled when equipping/unequipping the armor piece.
Weapon Model (For Weapons)	The prefab of the weapon to be spawned inside the proper weapon slot of the character prefab.
(Optional) Material	Set a material for the weapon or armor to use.
Body Culling (For Armors)	This will disable the underlying body part. For example you equip a chestplate with sleeves, then the Body Culling Template will disable the chest & arms body part.

Learn more about Body Culling Templates here

Weapon Transform Values

You can define Weapon Transform Values for your weapons for each race and gender.

This tab opens when you click on the Visuals tab on a weapon.

Field Name	Function
Use Template?	Allows you to define a Weapon Transform Template.
Race	The race for this weapon position data.
Gender	The gender for this weapon position data
Scene Reference	Drag a scene object (weapon model) in this field to automatically assign its transform data.
In Combat P	The position of this weapon while in combat.
In Combat R	The rotation of this weapon while in combat.
In Combat S	The scale of this weapon while in combat.
Out Of Combat P	The position of this weapon outside of combat.
Out Of Combat R	The rotation of this weapon outside of combat.
Out Of Combat S	The scale of this weapon outside of combat.

Learn more about Weapon Transform Templates here

Combat (Weapons)

Field Name	Function
Attack Speed	The speed of this weapon for its auto attack. You can think of this value as the interval time between each auto attack. If it is 1 it will do an auto attack every 1 second. If it is 3 it will do it every 3 seconds. For example: You set the ability to PlayerAutoAttack then you can set the cooldown of the ability to 3, then in the item (weapon) its combat settings you define this ability and set attack speed to 3 as well to match the timing. Now your weapon based auto attack happens every 3 seconds.
Min DMG	The base minimum damage for this weapon.
Max DMG	The base maximum damage for this weapon.
Auto Attack	The auto attack ability for this weapon.

Stats

Field Name	Function
Stat	The Stat to alter.
Amount	The amount to alter the stat by.
Is Percent?	Is the amount a percentage?

Random Stats

Field Name	Function
Max Stats	The maximum amount of random stats
Stat	The Stat to alter.
Min	The minimum random value.
Max	The maximum random value.
Is Percent?	Is the amount a percentage?
Is Integer?	Should the random value be integer?
Chance	The chance for this stat to be added on the item upon generation.

Requirements

Field name	Function
Use Template?	Allows you to define a requirements template.
Add Requirement Group	Allows you to define requirements on this given item without the use of a template.

Learn more about Requirements here

On Use Actions

Field Name	Function
Use Template?	Allows you to define a Game Actions Template.
Add Game Action	Allows you to add a Game Action without the use of a template.

Learn more about Game Actions here

General

This section is important for when you want to sell the item.

First you define the currency and then the amount. For example Currency = Copper Coin, Amount = 10. Then when you sell the item you will get 10 Copper Coins.

To sell items, talk to a merchant and have the merchant panel opened, then open your inventory and right click the item you want to sell.

Field Name	Function
Currency	The currency of the resell price.
Amount	The resell price.
Stack Limit	The maximum amount of this item that can be stack on the same inventory slot.

Last updated on