Table of contents:

Adding Items to NPC inventory

To add item to NPC Inventory you can use Inventory tab in NPC Template Editor.

Open

To add new inventory item use Add item button (red sign button)

Open

After selecting category can add new Item. You can do that by using red arrow in initializer row. To select specific item select - CInventoryInitializerUnifrom to select random item form chosen category select CInventoryInitializerRandom.

After selecting CInventoryInitializerUnifrom you can choose item from dropdown (red arrow button in itemName row)

Adding custom items

Items represent a number of different objects that can be purchased, found in the world or received during quests.

To add custom item you need to add new item definition to existing .xlm file (check .xml files named def_item .xml) or create your own .xml (preferred method - creating new one will prevent from modifying original files).

Item Definitions

Every item has an intended use and generally falls into one of the following categories, Equipment, Components or Other.

Item Abilities

Every item has an intended use and can be examined in the player inventory.

Once acquired, an item might be equipped, used, sold, given or dropped.

Example:

• Equipped to grant the player unique abilities during combat.

• Used to augment other items.

• Given to a crafter to crafter new items.

• Sold to a merchant for money.

• Given to an NPC to complete a challenge or quest.

Creating an XML Item Definition

When creating a new item definition in xml, the following properties must be defined:

• name ="Short sword 2"

• category ="steelsword"

• price ="16"

• initial_durability ="100"

• max_durability ="100"

• enhancement_slots ="0"

More detailed information for every property type has been included below, but only for properties driven by game design. Other aspects of an item's design like attachment points and user interface options are outside the scope of this documentation.

Name

___

To keep schematic names consistent, use the crafted item’s name followed by ‘schematic’.

Naming Convention

• name_name = "Name of Item"

Example

• name_name = "Short sword 2”

Category

___

The category of an Item should represent its intended use.

Naming Convention

• category ="Category Name"

Example

• category ="steelsword"

Durability

___

An Item's Durability represents how much damage it can sustain before becoming ineffective in combat.

Durability is determined by setting two values, the initial durability and the max durability.

Naming Convention

• initial_durability ="0 - 100"

• max_durability ="0 - 100"

Example

• initial_durability ="80"

• max_durability ="100"

Price

___

The price of an item represents it's base worth to the player and is unmodified by merchants.

Naming Convention

• price ="XXXX"

Example

• price ="16"

Enhancement Slots

___

The number of enhancement slots represents the amount of Upgrades (Runestone or Glyph) an item can hold.

The maximum number of enhancement slots is 3.

Naming Convention

• enhancement_slots ="X"

Example

• enhancement_slots ="3"

Example of an item’s full xml definition

Adding attributes

To add custom attributes to NPC Entity Template you need to add new gameplay parameter in gameplay tab. To do that use red button with plus icon next to Gameplay params label:

To add new gameplay attributes select CCharacterStatsParam from dropdown list.

After adding new CCharacterStatsParam you can add new ability that contain attributes definitions.

New ability definitions are defined in separate .xml file.

Adding custom attribute

To add custom attribute you need to add new ability definition to existing .xlm file (check .xml files named monster_base_abl.xml) or create your own .xml (preferred method - creating new one will prevent from modifying original files).

You can use example below to create an abilities definition file:

You can modify Base Stats:

• vitality

• essence

• stamina

• toxicity

• focus

• morale

• air

• panic

• panicStatic

• swimmingStamina

Power stats:

• attack_power

• spell_power

Regeneration stats:

• vitalityCombatRegen

• vitalityRegen

• essenceRegen

• staminaRegen

• moraleRegen

• airRegen

• panicRegen

• swimmingStaminaRegen

Resistance Stats:

• physical_resistance

• poison_resistance

• fire_resistance

• frost_resistance

• shock_resistance

• force_resistance

• slashing_resistance

• piercing_resistance

• bludgeoning_resistance

• rending_resistance

• elemental_resistance

• burning_DoT_damage_resistance

• poison_DoT_damage_resistance

• bleeding_DoT_damage_resistance