item_db.txt 7.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293
  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. ---------------------------------------
  81. Defense: Armor's defense.
  82. ---------------------------------------
  83. Range: Weapon's attack range.
  84. ---------------------------------------
  85. Slots: Amount of slots the item possesses.
  86. ---------------------------------------
  87. Jobs: Equippable jobs.
  88. All - Applies to all jobs listed below.
  89. Acolyte
  90. Alchemist
  91. Archer
  92. Assassin
  93. BardDancer - Applies to Bard and Dancer.
  94. Blacksmith
  95. Crusader
  96. Gunslinger
  97. Hunter
  98. KagerouOboro - Applies to Kagerou and Oboro.
  99. Knight
  100. Mage
  101. Merchant
  102. Monk
  103. Ninja
  104. Novice
  105. Priest
  106. Rebellion
  107. Rogue
  108. Sage
  109. SoulLinker
  110. StarGladiator
  111. Summoner
  112. SuperNovice
  113. Swordman
  114. Taekwon
  115. Thief
  116. Wizard
  117. ---------------------------------------
  118. Classes: Equippable upper-types.
  119. All - Applies to all classes.
  120. Normal - Normal classes (no Baby/Transcendent/Third classes).
  121. Upper - Transcedent classes (no Transcedent-Third classes).
  122. Baby - Baby classes (no Third-Baby classes).
  123. Third - Third classes (no Transcedent-Third or Third-Baby classes).
  124. Third_Upper - Transcedent-Third classes.
  125. Third_Baby - Third-Baby classes.
  126. Fourth - Fourth classes.
  127. All_Upper - All Transcedent classes
  128. All_Baby - All baby classes
  129. All_Third - Applies to all Third classes.
  130. ---------------------------------------
  131. Gender: Gender restriction.
  132. Female
  133. Male
  134. Both
  135. ---------------------------------------
  136. Locations: Equipment's placement.
  137. Head_Top - Upper Headgear
  138. Head_Mid - Middle Headgear
  139. Head_Low - Lower Headgear
  140. Armor - Armor
  141. Right_Hand - Weapon
  142. Left_Hand - Shield
  143. Garment - Garment/Robe
  144. Shoes - Shoes
  145. Right_Accessory - Accessory Right
  146. Left_Accessory - Accessory Left
  147. Costume_Head_Top - Costume Top Headgear
  148. Costume_Head_Mid - Costume Mid Headgear
  149. Costume_Head_Low - Costume Low Headgear
  150. Costume_Garment - Costume Garment/Robe
  151. Ammo - Ammo
  152. Shadow_Armor - Shadow Armor
  153. Shadow_Weapon - Shadow Weapon
  154. Shadow_Shield - Shadow Shield
  155. Shadow_Shoes - Shadow Shoes
  156. Shadow_Right_Accessory - Shadow Accessory Right (Earring)
  157. Shadow_Left_Accessory - Shadow Accessory Left (Pendant)
  158. Both_Hand - Right_Hand + Left_Hand
  159. Both_Accessory - Right_Accessory + Left_Accessory
  160. ---------------------------------------
  161. WeaponLevel: Weapon level. Used for refinement.
  162. ---------------------------------------
  163. EquipLevelMin: Base level required to be able to equip.
  164. ---------------------------------------
  165. EquipLevelMax: Only able to equip if base level is lower than this.
  166. ---------------------------------------
  167. Refineable: Defines if the item can be refined.
  168. ---------------------------------------
  169. Gradable: Defines if the item can be graded.
  170. ---------------------------------------
  171. View: For normal items, defines a replacement view-sprite for the item.
  172. ---------------------------------------
  173. AliasName: Use the AegisName of another item which will be sent to the client instead of this item.
  174. This makes items visually appear as another without having to change the client data.
  175. ---------------------------------------
  176. Flags: Different types of flags for an item.
  177. BuyingStore - If the item is available to Buying Stores.
  178. DeadBranch - If the item is a Dead Branch type.
  179. Container - If the item is part of a Container.
  180. UniqueId - If the item is a unique stack.
  181. BindOnEquip - If the item is bound to the character upon equipping.
  182. DropAnnounce - If the item has a special announcement to self on drop.
  183. NoConsume - If the item is consumed on use.
  184. DropEffect - If the item has a special effect on the ground when dropped by a monster.
  185. ---------------------------------------
  186. Delay: Item use delay.
  187. Duration - Duration of delay in seconds.
  188. Status - Status Change used to keep track of the delay.
  189. ---------------------------------------
  190. Stack: Item stack amount.
  191. Amount - Maximum amount that can be stacked.
  192. Inventory - If the stack is applied to player's inventory.
  193. Cart - If the stack is applied to the player's cart.
  194. Storage - If the stack is applied to the player's storage.
  195. GuildStorage - If the stack is applied to the player's guild storage.
  196. ---------------------------------------
  197. NoUse: Conditions when the item is unusable.
  198. Override - Group level to override these conditions.
  199. Sitting - If the item can not be used while sitting.
  200. ---------------------------------------
  201. Trade: Trade restrictions.
  202. Override - Group level to override these conditions.
  203. NoDrop - If the item can not be dropped.
  204. NoTrade - If the item can not be traded.
  205. TradePartner - If the item can not be traded to the player's partner.
  206. NoSell - If the item can not be sold.
  207. NoCart - If the item can not be put in a cart.
  208. NoStorage - If the item can not be put in a storage.
  209. NoGuildStorage - If the item can not be put in a guild storage.
  210. NoMail - If the item can not be put in a mail.
  211. NoAuction - If the item can not be put in an auction.
  212. ---------------------------------------
  213. Script: Script to execute when the item is used/equipped.
  214. ---------------------------------------
  215. EquipScript: Script to execute when the item is equipped.
  216. Warning, not all item bonuses will work here as expected.
  217. ---------------------------------------
  218. UnEquipScript: Script to execute when the item is unequipped or when a rental item expires.
  219. Warning, not all item bonuses will work here as expected.