ORK Framework Logo - RPG Editor for Unity
  • Features
  • Showcase
  • Guide
    • Documentation
    • Tutorials
    • API
  • ORK 2
    • Tutorials
    • Plugins
    • API
  • Support
  • Forum
  • Get ORK

Getting Started

7
  • Introduction
  • First Steps
  • Game Starters
  • Components Overview
  • Player/Camera Controls
  • Game Over
  • Support: Sending Test Projects

Editor

9
  • Editor Overview
  • Base/Control Section
  • Game Section
  • UI Section
  • Templates Section
  • Status Section
  • Inventory Section
  • Combatants Section
  • Battles Section

Features

15
  • Animations
  • Areas & Teleports
  • Combatant Triggers
  • Control Maps
  • Difficulties
  • Factions
  • Formations
  • Formula Nodes
  • Logs
  • Loot
  • Move AI
  • Quests
  • Research Trees
  • Schematic Nodes
  • Shortcut Slots

Status System

8
  • Status Values
  • Status Effects
  • Attack/Defence Modifiers
  • Abilities
  • Combatants
  • Classes
  • Status Bonuses
  • Status Conditions

Inventory System

7
  • Inventory System Overview
  • Currencies
  • Items
  • Equipment
  • AI Behaviours/Rulesets
  • Crafting Recipes
  • Shops

Battle System

19
  • Battle Systems
  • Adding Battles to Scenes
  • Calculating Action Results
  • Battle Menus
  • Battle AI
  • Battle AI Nodes
  • Battle Ranges
  • Battle Camera
  • Target Selection
  • Battle Spots
  • Battle Texts
  • Battle End & Loot Dialogues
  • Action Combos
  • Damage Types
  • Cursor Prefab Components
  • Grid Battles
  • Adding Battle Grids to Scenes
  • Battle Grid Highlights
  • Battle Grid Formations

UI System

28
  • UI System Overview
  • Start Menu
  • Option Categories
  • Menu Screens
  • Notifications
  • Combatant Selections
  • Quantity Selections
  • Text Display Settings
  • Cursor Settings
  • Console (In-Game)
  • Menu Requirements
  • HUDs: Content Providers
  • HUDs: Conditions
  • HUDs: Click Actions
  • HUDs: Text Content
  • HUDs: Value Bar Content
  • HUDs: Status Values
  • HUDs: Status Effects
  • HUDs: Attack Modifiers
  • HUDs: Defence Modifiers
  • HUDs: Shortcuts
  • HUDs: Abilities
  • HUDs: Equipment
  • HUDs: Class Slots
  • HUDs: AI Behaviours
  • HUDs: AI Rulesets
  • HUDs: Quests
  • Timebar HUD

Scripting

8
  • Scripting Overview
  • Access Handler
  • Code Extensions
  • Custom Settings
  • Custom Targeting
  • Combatant Scripting
  • Custom Nodes
  • Custom Component Save Data
  • Home
  • Guide
  • Documentation
  • Inventory System
  • Items
View Categories

Items

Potions, quest items, learning scrolls or crafting ingredients, items cover them all.

Items #

Items are set up in Inventory > Items.

There are two types of items:

  • Useable items
    They are used on a target combatant and change their status (e.g. a potion recovering health or a learning scroll adding a new ability).
  • Unusable items
    They can’t be used and are mainly used for quest/key items.

This is determined by the Useable In setting found in the item’s Use Settings – None makes it an unusable item.

Useable Items #

A useable item works similar to an ability, i.e. it can have hit/critical chance, use cost, user/target changes, etc.

They are used to set up things like potions, learning scrolls to teach new abilities but can also be used to create readable books and other mechanics.

Useable items can either be used in the field, in battles, or in both. If the item can be used can also be decided by certain status conditions (like having a special stance in form of a status effect that must be applied to the user).

If the item will hit a target can optionally epend on a hit chance – an optional critical hit chance with other status changes is available as well.

An item can optionally be set up as a priority action, i.e. it’ll be used before other actions.

An item can optionally be cancelable, i.e. if the user is hit by another ability or item that is set up to cancel actions while using the item, the use is canceled. When the item is animated using schematics, only nodes that have Execute On Stop enabled will be used.

Target Selection #

The target selection uses target selection templates to define the target of the item.

You can either use a defined template, a custom setup or one of the default target selections, either coming from the item’s item type or the setup in Battles > Target Settings.

Use Costs #

An item can optionally require costs to use it – the item can only be used if the costs are covered.

The use costs also define if the item itself will be consumed when it’s used.

The following use costs are available.

  • Status Changes
    The use costs can perform status changes, e.g. subtract MP.
    See below for details on status changes.
  • Consume Items
    Using the item will consume defined (other) items.

Status Changes #

Status changes are used by use costs, user and target changes.

User changes (normal and critical) use the user of the item as both user and target in any calculation and are used once.

Target changes (normal and critical) use the user of the item as user, and each individual target as target – they’re used for each user/target combination. E.g. an item targeting multiple combatants will have a calculation for each target.

The following status changes are available.

  • Status Value
    Uses a defined status value change, e.g. dealing damage, healing, etc.
    This can change any status value and optionally consider attack/defence modifiers for the outcome.
  • Status Effect
    Uses a defined status effect change, e.g. adding poison.
    You can use status effects or status effect types, e.g. removing all negative status effects via a type.
    Learn more about status effects in this documentation.
  • Schematics
    Uses a defined schematic.
    The user is the Machine Object, the target the Starting Object.
    The item is available as local selected data via the selected key action.

You can extend the available status changes with custom classes by deriving from the BaseStatusChangeType class.

Animating an item’s use #

Using an item can be animated using schematics.

This can e.g. be used to let the user play a use animation and spawn a prefab on the target – the full potential of the schematic system can be used and also extended with custom code.

The schematics can also be used to greatly increase the functionality of an item, e.g. capturing an enemy by adding it to the player group, cause damage multiple times and many other things.

Items can also use default schematics before and after their own schematics. The Item Start Animation and Item End Animation schematics are set up in Combatants > Combatants > General Settings in Battle Settings > Default Battle Animations.

Unuseable Items #

Unuseable items are mainly used to serve as quest/key items or as ingredients for crafting recipes, i.e. simply having them in the inventory is their purpose.

You can check for items being in an inventory in status conditions, e.g. the Check Status node in schematics, formulas and battle AI.

Unusable items can also use custom schematics and item variables (see below).

Price #

Items define their purchase price in the default currency (i.e. the first currency in the editor list, index 0).

Optionally, items can also be sold back to shops – the price settings also define how much they’re sold for, as well as if that is in percent (e.g. 50% of the buy price) or an defined value (e.g. 1 gold).

Shops can also override item prices.

Using Advanced Prices allows you to set up prices consisting of one or more costs. This supports using status values, items, currencies, equipment and other inventory content as costs.

UI #

Define UI related settings for the item.

Shortcut UI #

Items are shortcuts and use the Shortcut UI settings to control how they’re displayed in menu screens and shortcut HUDs.

Learn more in this HUD documentation.

Portraits #

Add portraits to items and display them in menu screens or HUDs.

Items can also use prefab view potraits to display the prefab of the item as a portrait. This uses render textures and a camera.

Information Overrides #

Items can override default number formatting, battle info, notifications and console texts.

Custom Schematics #

Custom schematics can be used on an instance of an item in other schematics using a Custom Selected Data Schematic node. The item is available as (local) selected data via the key action.

They can be used to create custom systems, e.g. a custom item upgrade system.

Item Variables #

Both useable and unusable items can use custom variables that are attached to their individual instances. These variables can be accessed in schematics via items stored in selected data.

This allows adding custom systems and functionality to items. The item is available as selected data via the selected key action in all of it’s formula calculations, as well as all schematics used by it (e.g. for animating or in status changes).

Setup Examples #

Here are some examples for setting up different kinds of items.

These examples will only focus on the item setup, i.e. it’ll not cover setting up a used formula or animating via schematics.

Healing Potion #

A potion recovering health and available both in battle and the field.

Use Settings #

  • Useable In
    Select Both.

Target Selection Settings #

  • Target Type
    Select Ally.
  • Target Range
    Select Single.

User Settings > Use Cost #

  • Consume
    Enable this setting.

Target Settings > Target Changes #

Click on Add Target Changes.

Click on Add Status Change.

  • Change Type
    Select Status Value.
  • Status Value
    Select HP (or however your health consumable status value is named).
  • Operator
    Select Add.
  • Change Value
    Select Value > Value.
    Set the value to 150.
    Or use whatever other value/formula you want for the recovery.
  • Use Change Modifiers
    Disable this setting.
    Health recovery is usually not influenced by modifiers.

Learning Scroll #

A scroll learning a new ability to the target, only available in the field.

Use Settings #

  • Useable In
    Select Field.

Use Settings > Ability Settings #

  • Item Ability
    Select Learn.
  • Ability
    Select the ability you want to learn.
  • Ability Level
    Define the ability level you want to learn (e.g. 1)

User Settings > Use Cost #

  • Consume
    Enable this setting.

Curative Potion #

A potion removing a negative status effect.

Use Settings #

  • Useable In
    Select Both.

Target Selection Settings #

  • Target Type
    Select Ally.
  • Target Range
    Select Single.

User Settings > Use Cost #

  • Consume
    Enable this setting.

Target Settings > Target Changes #

Click on Add Target Changes.

Click on Add Status Change.

  • Change Type
    Select Status Effect.
  • Change
    Select Remove.
  • Use Effect Type
    Enable this setting.
    We remove based on status effect types.
  • Status Effect Type
    Select a negative effect type.
  • Remove Type
    Select Last.
    This’ll remove the last (newest) effect of the type.

Share This Article :
  • Facebook
  • X
  • LinkedIn
  • Pinterest
Table of Contents
  • Items
    • Useable Items
      • Target Selection
      • Use Costs
      • Status Changes
      • Animating an item’s use
    • Unuseable Items
    • Price
    • UI
      • Shortcut UI
      • Portraits
      • Information Overrides
    • Custom Schematics
    • Item Variables
  • Setup Examples
    • Healing Potion
      • Use Settings
      • Target Selection Settings
      • User Settings > Use Cost
      • Target Settings > Target Changes
    • Learning Scroll
      • Use Settings
      • Use Settings > Ability Settings
      • User Settings > Use Cost
    • Curative Potion
      • Use Settings
      • Target Selection Settings
      • User Settings > Use Cost
      • Target Settings > Target Changes
Sitemap
  • Features
  • Showcase
  • Guide
    • Documentation
    • Tutorials
    • API
  • ORK 2 Hub
    • Tutorials
    • Plugins
    • API
  • Support
  • Forum
  • Get ORK
  • Contact
  • Blog
  • Makinom
  • gamingislove.com
Categories
  • News (69)
  • ORK 2 (137)
    • Tutorial (137)
      • Game tutorial (50)
      • Gameplay (32)
      • How-to (55)
  • Release (150)
Search

© 2015 Gaming is Love e.U.

Disclosure: This site may contain affiliate links, which means I may receive a commission if you click a link and purchase something that I have recommended. While clicking these links won’t cost you any money, they will help me fund my development projects while recommending great assets!