item_db.txt 7.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294
  1. //===== rAthena Documentation ================================
  2. //= Item Database Structure
  3. //===== By: ==================================================
  4. //= rAthena Dev Team
  5. //===== Last Updated: ========================================
  6. //= 20220402
  7. //===== Description: =========================================
  8. //= Explanation of the item_db.yml file and structure.
  9. //============================================================
  10. ---------------------------------------
  11. Id: Item ID.
  12. ---------------------------------------
  13. AegisName: Server name to reference the item in scripts and lookups, should use no spaces.
  14. ---------------------------------------
  15. Name: Name in English for displaying as output for atcommands and script commands.
  16. ---------------------------------------
  17. Type: Item's type.
  18. Healing - Healing item.
  19. Usable - Usable item.
  20. Etc - Etc item.
  21. Armor - Armor/Garment/Boots/Headgear/Accessory item.
  22. Weapon - Weapon item.
  23. Card - Card item.
  24. PetEgg - Pet egg item.
  25. PetArmor - Pet equipment item.
  26. Ammo - Ammo (Arrows/Bullets/etc) item.
  27. DelayConsume - Usable with delayed consumption (intended for 'itemskill').
  28. Items using the 'itemskill' script command are consumed after selecting a target. Any other command will NOT consume the item.
  29. ShadowGear - Shadow Equipment item.
  30. Cash - Another delayed consume that requires user confirmation before using the item.
  31. ---------------------------------------
  32. SubType: Indicates the weapon-class of the item.
  33. For weapons, the types are:
  34. Fist
  35. Dagger
  36. 1hSword
  37. 2hSword
  38. 1hSpear
  39. 2hSpear
  40. 1hAxe
  41. 2hAxe
  42. Mace
  43. Staff
  44. Bow
  45. Knuckle
  46. Musical
  47. Whip
  48. Book
  49. Katar
  50. Revolver
  51. Rifle
  52. Gatling
  53. Shotgun
  54. Grenade
  55. Huuma
  56. 2hStaff
  57. For ammo, the types are:
  58. Arrow
  59. Dagger
  60. Bullet
  61. Shell
  62. Grenade
  63. Shuriken
  64. Kunai
  65. CannonBall
  66. ThrowWeapon
  67. For cards, the types are:
  68. Normal (default)
  69. Enchant
  70. ---------------------------------------
  71. Buy: Default buying price. When not specified, becomes double the sell price.
  72. ---------------------------------------
  73. Sell: Default selling price. When not specified, becomes half the buy price.
  74. ---------------------------------------
  75. Weight: Item's weight. Each 10 is 1 weight.
  76. ---------------------------------------
  77. Attack: Weapon's attack.
  78. ---------------------------------------
  79. MagicAttack: Weapon's magic attack. (Renewal only)
  80. Unlike matk bonus from equipment, MagicAttack is taken into account in weapon variance calculation on Renewal.
  81. ---------------------------------------
  82. Defense: Armor's defense.
  83. ---------------------------------------
  84. Range: Weapon's attack range.
  85. ---------------------------------------
  86. Slots: Amount of slots the item possesses.
  87. ---------------------------------------
  88. Jobs: Equippable jobs.
  89. All - Applies to all jobs listed below.
  90. Acolyte
  91. Alchemist
  92. Archer
  93. Assassin
  94. BardDancer - Applies to Bard and Dancer.
  95. Blacksmith
  96. Crusader
  97. Gunslinger
  98. Hunter
  99. KagerouOboro - Applies to Kagerou and Oboro.
  100. Knight
  101. Mage
  102. Merchant
  103. Monk
  104. Ninja
  105. Novice
  106. Priest
  107. Rebellion
  108. Rogue
  109. Sage
  110. SoulLinker
  111. StarGladiator
  112. Summoner
  113. SuperNovice
  114. Swordman
  115. Taekwon
  116. Thief
  117. Wizard
  118. ---------------------------------------
  119. Classes: Equippable upper-types.
  120. All - Applies to all classes.
  121. Normal - Normal classes (no Baby/Transcendent/Third classes).
  122. Upper - Transcedent classes (no Transcedent-Third classes).
  123. Baby - Baby classes (no Third-Baby classes).
  124. Third - Third classes (no Transcedent-Third or Third-Baby classes).
  125. Third_Upper - Transcedent-Third classes.
  126. Third_Baby - Third-Baby classes.
  127. Fourth - Fourth classes.
  128. All_Upper - All Transcedent classes
  129. All_Baby - All baby classes
  130. All_Third - Applies to all Third classes.
  131. ---------------------------------------
  132. Gender: Gender restriction.
  133. Female
  134. Male
  135. Both
  136. ---------------------------------------
  137. Locations: Equipment's placement.
  138. Head_Top - Upper Headgear
  139. Head_Mid - Middle Headgear
  140. Head_Low - Lower Headgear
  141. Armor - Armor
  142. Right_Hand - Weapon
  143. Left_Hand - Shield
  144. Garment - Garment/Robe
  145. Shoes - Shoes
  146. Right_Accessory - Accessory Right
  147. Left_Accessory - Accessory Left
  148. Costume_Head_Top - Costume Top Headgear
  149. Costume_Head_Mid - Costume Mid Headgear
  150. Costume_Head_Low - Costume Low Headgear
  151. Costume_Garment - Costume Garment/Robe
  152. Ammo - Ammo
  153. Shadow_Armor - Shadow Armor
  154. Shadow_Weapon - Shadow Weapon
  155. Shadow_Shield - Shadow Shield
  156. Shadow_Shoes - Shadow Shoes
  157. Shadow_Right_Accessory - Shadow Accessory Right (Earring)
  158. Shadow_Left_Accessory - Shadow Accessory Left (Pendant)
  159. Both_Hand - Right_Hand + Left_Hand
  160. Both_Accessory - Right_Accessory + Left_Accessory
  161. ---------------------------------------
  162. WeaponLevel: Weapon level. Used for refinement.
  163. ---------------------------------------
  164. EquipLevelMin: Base level required to be able to equip.
  165. ---------------------------------------
  166. EquipLevelMax: Only able to equip if base level is lower than this.
  167. ---------------------------------------
  168. Refineable: Defines if the item can be refined.
  169. ---------------------------------------
  170. Gradable: Defines if the item can be graded.
  171. ---------------------------------------
  172. View: For normal items, defines a replacement view-sprite for the item.
  173. ---------------------------------------
  174. AliasName: Use the AegisName of another item which will be sent to the client instead of this item.
  175. This makes items visually appear as another without having to change the client data.
  176. ---------------------------------------
  177. Flags: Different types of flags for an item.
  178. BuyingStore - If the item is available to Buying Stores.
  179. DeadBranch - If the item is a Dead Branch type.
  180. Container - If the item is part of a Container.
  181. UniqueId - If the item is a unique stack.
  182. BindOnEquip - If the item is bound to the character upon equipping.
  183. DropAnnounce - If the item has a special announcement to self on drop.
  184. NoConsume - If the item is consumed on use.
  185. DropEffect - If the item has a special effect on the ground when dropped by a monster.
  186. ---------------------------------------
  187. Delay: Item use delay.
  188. Duration - Duration of delay in seconds.
  189. Status - Status Change used to keep track of the delay.
  190. ---------------------------------------
  191. Stack: Item stack amount.
  192. Amount - Maximum amount that can be stacked.
  193. Inventory - If the stack is applied to player's inventory.
  194. Cart - If the stack is applied to the player's cart.
  195. Storage - If the stack is applied to the player's storage.
  196. GuildStorage - If the stack is applied to the player's guild storage.
  197. ---------------------------------------
  198. NoUse: Conditions when the item is unusable.
  199. Override - Group level to override these conditions.
  200. Sitting - If the item can not be used while sitting.
  201. ---------------------------------------
  202. Trade: Trade restrictions.
  203. Override - Group level to override these conditions.
  204. NoDrop - If the item can not be dropped.
  205. NoTrade - If the item can not be traded.
  206. TradePartner - If the item can not be traded to the player's partner.
  207. NoSell - If the item can not be sold.
  208. NoCart - If the item can not be put in a cart.
  209. NoStorage - If the item can not be put in a storage.
  210. NoGuildStorage - If the item can not be put in a guild storage.
  211. NoMail - If the item can not be put in a mail.
  212. NoAuction - If the item can not be put in an auction.
  213. ---------------------------------------
  214. Script: Script to execute when the item is used/equipped.
  215. ---------------------------------------
  216. EquipScript: Script to execute when the item is equipped.
  217. Warning, not all item bonuses will work here as expected.
  218. ---------------------------------------
  219. UnEquipScript: Script to execute when the item is unequipped or when a rental item expires.
  220. Warning, not all item bonuses will work here as expected.