Item Template

Overview

The Item template defines game items including weapons, armor, consumables, and materials.

Version Support

Version	Status
v92	Full
v90	-
v86	-

Required Attributes

Attribute	Type	Since	Description
`id`	`int`	v92	Unique item identifier
`boundType`	`BoundType`	v92	Item binding type
`combatItemType`	`CombatItemType`	v92	Combat item type
`coolTimeGroup`	`int`	v92	Cooldown group
`dismantlable`	`bool`	v92	Can be dismantled
`dropSound`	`string`	v92	Drop sound
`equipSound`	`string`	v92	Equip sound
`guildWarehouseStorable`	`bool`	v92	Can be stored in guild warehouse
`icon`	`string`	v92	Icon asset path
`itemUseCount`	`int`	v92	Use count
`maxDropUnit`	`int`	v92	Maximum drop unit
`maxStack`	`int`	v92	Maximum stack size
`name`	`string`	v92	Item name
`obtainable`	`bool`	v92	Can be obtained
`rank`	`int`	v92	Item rank
`rareGrade`	`RareGrade`	v92	Item rarity (0-4)
`relocatable`	`bool`	v92	Can be relocated
`requiredEquipmentType`	`string`	v92	Required equipment type
`searchable`	`string`	v92	Searchable flag
`slotLimit`	`int`	v92	Slot limit
`storeSellable`	`bool`	v92	Can be sold in store
`tradable`	`bool`	v92	Can be traded
`warehouseStorable`	`bool`	v92	Can be stored in warehouse

Optional Attributes

General

Attribute	Type	Since	Description
`category`	`ItemCategory`	v92	Item category
`level`	`int`	v92	Item level
`sortingNumber`	`int`	v92	Sorting order
`defaultValue`	`string`	v92	Default value

Pricing

Attribute	Type	Since	Description
`buyPrice`	`decimal`	v92	Purchase price
`sellPrice`	`decimal`	v92	Sell price

Combat Item Arguments

Attribute	Type	Since	Description
`combatItemSubType`	`CombatItemSubType`	v92	Combat item subtype
`combatItemArg1`	`int`	v92	Combat item argument 1
`combatItemArg2`	`int`	v92	Combat item argument 2
`combatItemArg3`	`int`	v92	Combat item argument 3
`combatItemArg4`	`string`	v92	Combat item argument 4
`combatItemArg5`	`string`	v92	Combat item argument 5

Requirements

Attribute	Type	Since	Description
`requiredLevel`	`int`	v92	Required character level
`requiredMaxLevel`	`int`	v92	Maximum allowed character level
`requiredClass`	`list[CharacterClass]`	v92	Required class (flags)
`requiredRace`	`string`	v92	Required race
`requiredGender`	`string`	v92	Required gender
`requiredGeo`	`bool`	v92	Requires geo-location check
`requiredGuildLevel`	`int`	v92	Required guild level
`requiredGuildMaster`	`bool`	v92	Requires guild master status
`requiredUserStatus`	`list[string]`	v92	Required user status

Links

Attribute	Type	Since	Description
`linkEquipmentId`	`int`	v92	Linked equipment ID
`linkEnchantId`	`int`	v92	Linked enchant ID
`linkSkillId`	`int`	v92	Linked skill ID
`linkSkillPeriodDay`	`int`	v92	Skill period in days
`linkPetAdultId`	`int`	v92	Linked pet adult ID
`linkPetOrbId`	`int`	v92	Linked pet orb ID
`itemMixId`	`int`	v92	Linked item mix ID
`linkCardId`	`int`	v92	Linked card ID
`linkChangeColorListId`	`int`	v92	Linked color change list ID
`linkCrestId`	`int`	v92	Linked crest ID
`linkCustomizingId`	`int`	v92	Linked customizing ID
`linkEquipmentExpId`	`int`	v92	Linked equipment experience ID
`linkLookInfoId`	`int`	v92	Linked look info ID
`linkMasterpieceEnchantId`	`int`	v92	Linked masterpiece enchant ID
`linkMasterpiecePassivityCategoryId`	`list[string]`	v92	Linked masterpiece passivity category ID
`linkMasterpiecePassivityId`	`list[string]`	v92	Linked masterpiece passivity ID
`linkMaterialEnchantId`	`int`	v92	Linked material enchant ID
`linkMaterialRepairId`	`int`	v92	Linked material repair ID
`linkPassivityCategoryId`	`list[string]`	v92	Linked passivity category ID
`linkPassivityId`	`list[string]`	v92	Linked passivity ID
`linkPcFigureTransformId`	`int`	v92	Linked PC figure transform ID
`linkRawStoneId`	`int`	v92	Linked raw stone ID
`linkSocialId`	`int`	v92	Linked social ID

Storage & Trading

Attribute	Type	Since	Description
`destroyable`	`bool`	v92	Can be destroyed
`userWarehouseStorable`	`bool`	v92	Can be stored in user warehouse
`tradeBrokerTradable`	`bool`	v92	Can be traded via trade broker
`unionVenderTradeable`	`bool`	v92	Can be traded via union vendor
`wareMaxStack`	`int`	v92	Maximum warehouse stack

Stacking

Attribute	Type	Since	Description
`divide`	`int`	v92	Division value

Visual & Audio

Attribute	Type	Since	Description
`dropEffect`	`string`	v92	Drop effect
`dropSilhouette`	`string`	v92	Drop silhouette
`usedSound`	`string`	v92	Use sound
`dropType`	`int`	v92	Drop type
`dropIdentify`	`bool`	v92	Show identify on drop
`dropEffectOnlyWhenMine`	`bool`	v92	Show drop effect only for owner
`changeEnchantFxId`	`int`	v92	Change enchant FX ID

Enchanting

Attribute	Type	Since	Description
`enchantEnable`	`bool`	v92	Can be enchanted
`enchantEquipPart`	`string`	v92	Enchant equipment part
`preSetEnchant`	`int`	v92	Preset enchant level
`dualOptionAble`	`bool`	v92	Can have dual options
`optionResetDisable`	`bool`	v92	Option reset disabled
`unbindCount`	`int`	v92	Unbind count
`unbindEnchant`	`int`	v92	Unbind enchant level

Conversion System

Attribute	Type	Since	Description
`conversion`	`bool`	v92	Enables conversion
`conversionBigGroup`	`int`	v92	Conversion big group
`conversionSmallGroup`	`int`	v92	Conversion small group

Appearance & Customization

Attribute	Type	Since	Description
`changeLook`	`bool`	v92	Can change appearance
`changeColorEnable`	`bool`	v92	Can change color
`extractLook`	`bool`	v92	Can extract appearance
`extractRatio`	`decimal`	v92	Extract ratio
`accessoryColorId`	`string`	v92	Accessory color ID
`styleCostumeId`	`int`	v92	Style costume ID
`customizingString`	`bool`	v92	Customizing string enabled

Item Behavior Flags

Attribute	Type	Since	Description
`artisanable`	`bool`	v92	Can be crafted by artisan
`awakenable`	`bool`	v92	Can be awakened
`ridingUseable`	`bool`	v92	Can be used while riding
`useOnlyTerritory`	`bool`	v92	Can only be used in specific territory
`availableInAbnormalC`	`bool`	v92	Available in abnormal C state
`isMaterialEquip`	`bool`	v92	Is material equipment
`isPvpEquipment`	`bool`	v92	Is PvP equipment
`isReputation`	`bool`	v92	Is reputation item
`uniqueEquippedItem`	`bool`	v92	Unique equipped item

Quest & Gamble

Attribute	Type	Since	Description
`autoStartQuestID`	`string`	v92	Auto-start quest ID
`execWhenCouponUse`	`bool`	v92	Execute when coupon used
`gambleItemGrade`	`int`	v92	Gamble item grade
`gambleItemType`	`list[string]`	v92	Gamble item type
`unidentifiedItemGrade`	`int`	v92	Unidentified item grade

Period & Time Management

Attribute	Type	Since	Description
`coolTime`	`decimal`	v92	Cooldown time
`periodByWebAdmin`	`bool`	v92	Period managed by web admin
`periodInMinute`	`int`	v92	Period in minutes
`periodItemCategoryId`	`int`	v92	Period item category ID

Equipment & Sets

Attribute	Type	Since	Description
`equipmentSetId`	`int`	v92	Equipment set ID
`itemLevelId`	`int`	v92	Item level ID

Material & Crafting

Attribute	Type	Since	Description
`decompositionId`	`int`	v92	Decomposition ID

Masterpiece System

Attribute	Type	Since	Description
`masterpieceBasicStatRevise`	`list[string]`	v92	Masterpiece basic stat revise
`masterpieceRate`	`decimal`	v92	Masterpiece rate

Package & Restrictions

Attribute	Type	Since	Description
`onlyForPackageId`	`int`	v92	Only for specific package ID
`combineOptionValue`	`int`	v92	Combine option value

Enum Types

BoundType

Value
`None`
`Equip`
`Acquire`

RareGrade

Value
`Common`
`Uncommon`
`Rare`
`Superior`
`Mythic`

DropType

Value
`Normal`
`Special`
`Rare`

CharacterClass

Value
`ARCHER`
`ASSASSIN`
`BERSERKER`
`ELEMENTALIST`
`ENGINEER`
`FIGHTER`
`GLAIVER`
`LANCER`
`PRIEST`
`SLAYER`
`SORCERER`
`SOULLESS`
`WARRIOR`

ItemCategory

Value
`TOKEN`
`accessoryFace`
`accessoryHair`
`alchemy`
`alchemyMaterial`
`armorComponent`
`armorMaterial`
`axe`
`belt`
`blaster`
`bodyLeather`
`bodyMail`
`bodyRobe`
`bow`
`brooch`
`chain`
`charm`
`circle`
`collection`
`collection_card`
`combat`
`cooking`
`crest`
`customize_accessory`
`customize_armor`
`customize_weapon`
`document`
`dual`
`dyeItem`
`dyeRaw`
`dyeRecipe`
`earring`
`enchantComponent`
`enchantScroll`
`enchantSeal`
`enchant_agent`
`enchant_material`
`etc`
`extractRecipe`
`fabrication`
`feetLeather`
`feetMail`
`feetRobe`
`fiber`
`fishing`
`gauntlet`
`generalMaterial`
`glaive`
`handLeather`
`handMail`
`handRobe`
`holyThing`
`keyItem`
`lance`
`leather`
`magical`
`medal`
`metal`
`necklace`
`order`
`petAdult`
`petOrb`
`pkitem`
`quest`
`recipe`
`relic`
`ring`
`rod`
`servant`
`service`
`shuriken`
`skillbook`
`staff`
`style_axe`
`style_back`
`style_blaster`
`style_body`
`style_bow`
`style_chain`
`style_circle`
`style_dual`
`style_face`
`style_foot_print`
`style_gauntlet`
`style_glaive`
`style_hair`
`style_lance`
`style_partner`
`style_rod`
`style_shuriken`
`style_staff`
`style_twohand`
`token`
`twohand`
`underwear`
`weaponComponent`
`weaponMaterial`

CombatItemType

Value
`BOOKMARK`
`BUILD_OBJECT_NOTICE`
`CHANGE_COLOR_ITEM`
`CHANGE_GENDER`
`CHANGE_LOOKS`
`CHANGE_LOOKS_PREMIUM`
`CHANGE_LOOKS_SERVANT`
`CHANGE_NAME`
`CHANGE_RACE`
`CITY_WAR_GUILD_TOWER_TELEPORT`
`COLLECTION_CARD`
`CREST`
`CREST_POINT`
`CUSTOM`
`DISPOSAL`
`DOCUMENT`
`DUNGEON_COIN`
`ENCHANTER`
`ENCHANT_COMPONENT_WEAPON`
`ENCHANT_MATERIAL`
`EQUIP_ACCESSORY`
`EQUIP_ARMOR_ARM`
`EQUIP_ARMOR_BODY`
`EQUIP_ARMOR_LEG`
`EQUIP_INHERITANCE`
`EQUIP_STYLE_ACCESSORY`
`EQUIP_STYLE_BACK`
`EQUIP_STYLE_BODY`
`EQUIP_STYLE_EFFECT`
`EQUIP_STYLE_PARTNER`
`EQUIP_STYLE_WEAPON`
`EQUIP_UNDERWEAR`
`EQUIP_WEAPON`
`EnchantSeal`
`EquipmentEnchantScroll`
`FISHING_ROD`
`FloatingCastle_partsstore`
`GACHA`
`GAIN_EP_POINT`
`GET_SERVANT`
`GOLDENBELL`
`GUILD_TOWER`
`IMMEDIATE`
`INC_CHARACTER_EXP`
`INC_INVEN_SLOT`
`INC_POCKET`
`INC_POCKET_SLOT`
`INC_SERVANTINVEN_SLOT`
`INC_SKILL_POLISHING_EXP`
`INC_SKILL_POLISHING_EXP_ITEM`
`INC_STYLE_WAREHOUSE_SLOT`
`INC_WAREHOUSE_SLOT`
`LEVEL_JUMPING_UP`
`LOCKBOX`
`LOCKBOX_KEY`
`LOOT_MOTION_ONLY`
`MEDAL_USEABLE`
`MEGAPHONE`
`MIX_DISPOSAL`
`NO_COMBAT`
`PARTNER_PRESENT`
`PREMIUM_COMPOSE`
`PREMIUM_RENAME`
`QUEST`
`RAWSTONE`
`RECIPE`
`RECOVERY_FATIGUE_POINT`
`RENAME_GUILD`
`RESET_EP`
`RESET_EP_DAILY_LIMIT`
`RESET_SCROLL`
`SERVANT_FEED`
`SHARED_INC_STYLE_WAREHOUSE_PAGE`
`SKILLBOOK`
`SOCIALBOOK`
`SYNTHESIZER`
`TELEPORT_TO_VILLAGE`
`TOKEN`
`UNBINDER`

CombatItemSubType

Value
`Green_custormaize`
`TOKEN`
`accessoryFace`
`accessoryHair`
`alchemy`
`alchemyMaterial`
`armorComponent`
`armorMaterial`
`artisan`
`axe`
`belt`
`blaster`
`bodyLeather`
`bodyMail`
`bodyRobe`
`bow`
`brooch`
`chain`
`charm`
`circle`
`collection_card`
`combat`
`combatRecipe`
`crest`
`custormaize`
`document`
`dual`
`dyeItem`
`dyeRaw`
`dyeRecipe`
`earring`
`enchantScroll`
`enchantSeal`
`enchant_agent`
`enchant_material`
`etc`
`extractRecipe`
`feetLeather`
`feetMail`
`feetRobe`
`fiber`
`gauntlet`
`generalMaterial`
`glaive`
`handLeather`
`handMail`
`handRobe`
`holyThing`
`keyItem`
`lance`
`leather`
`magical`
`medal`
`metal`
`necklace`
`order`
`petAdult`
`petOrb`
`pkitem`
`quest`
`recipe`
`recovery`
`relic`
`ring`
`rod`
`servant`
`service`
`shuriken`
`skillbook`
`staff`
`style_axe`
`style_back`
`style_blaster`
`style_body`
`style_bow`
`style_chain`
`style_circle`
`style_dual`
`style_face`
`style_foot_print`
`style_gauntlet`
`style_glaive`
`style_hair`
`style_lance`
`style_partner`
`style_rod`
`style_shuriken`
`style_staff`
`style_twohand`
`twohand`
`underwear`
`vitality`
`weaponComponent`
`weaponMaterial`

Examples

<Item id="1000"
      name="Basic Sword"
      category="dual"
      icon="Icon_Weapons.Sword_01"
      level="1"
      rank="0"
      rareGrade="0"
      buyPrice="100"
      sellPrice="50"
      combatItemType="EQUIP_WEAPON"
      combatItemSubType="dual"
      boundType="Equip"
      requiredLevel="1"
      tradable="true"
      destroyable="true" />

<Item id="2000"
      name="Health Potion"
      category="combat"
      icon="Icon_Items.Potion_HP"
      level="1"
      rank="0"
      rareGrade="0"
      buyPrice="50"
      sellPrice="10"
      combatItemType="Stat"
      combatItemSubType="None"
      boundType="None"
      maxStack="100"
      tradable="true"
      destroyable="true" />

<Item id="3000"
      name="Iron Ore"
      category="generalMaterial"
      icon="Icon_Materials.Metal_01"
      level="1"
      rank="0"
      rareGrade="0"
      buyPrice="10"
      sellPrice="5"
      combatItemType="ENCHANT_MATERIAL"
      combatItemSubType="generalMaterial"
      boundType="None"
      maxStack="1000"
      tradable="true"
      destroyable="true" />

List-typed properties

Properties like requiredClass, linkPassivityId, and linkPassivityCategoryId accept lists. Use YAML list syntax even for single values:

items:
  create:
    - id: 99000001
      requiredClass: ["ARCHER"]
      linkPassivityCategoryId: ["30"]
      linkPassivityId: ["211907", "317266"]

  update:
    - id: 99000002
      changes:
        requiredClass: ["WARRIOR", "LANCER"]

See Common pitfalls for details on scalar-to-list coercion.

Equipment Item Defaults

Items with an EQUIP_* combat type receive automatic soft defaults for fields left unspecified. These defaults are derived from statistical analysis of production data (≥95% consistency) and are always overridable by setting the field explicitly.

Global Defaults

Attribute	Default
`maxStack`	`1`
`maxDropUnit`	`1`
`itemUseCount`	`1`
`slotLimit`	`0`
`coolTime`	`0`
`coolTimeGroup`	`0`
`sortingNumber`	`0`
`linkCrestId`	`0`
`linkCustomizingId`	`0`
`linkPetAdultId`	`0`
`linkPetOrbId`	`0`
`linkSkillId`	`0`
`dropSound`	`InterfaceSound.Drop_ItemCUE.Drop_ChestBoxCue`
`requiredEquipmentType`	`NO_COMBAT`
`searchable`	`true`
`destroyable`	`true`
`obtainable`	`true`
`relocatable`	`true`
`warehouseStorable`	`true`
`conversion`	`false`
`useOnlyTerritory`	`false`
`requiredGuildMaster`	`false`
`changeLook`	`false`
`extractLook`	`false`
`artisanable`	`false`

Conditional Defaults

The icon, dropSilhouette, equipSound, and requiredClass fields are resolved automatically from combatItemSubType when not specified. Each weapon, armor, accessory, and style subtype maps to an appropriate icon texture, silhouette mesh, sound cue, and class restriction. Weapons resolve to a single class; armor resolves to the appropriate armor weight group (mail, leather, or robe). Unknown subtypes receive no default.

Notes

The id attribute is required and must be unique across all items
The category attribute determines the item’s classification in the inventory
The combatItemType and combatItemSubType work together to define item behavior
The boundType controls when the item becomes bound to the player
Flags enums like requiredClass can specify multiple values
Linked IDs (like linkEquipmentId) reference other game data tables