📖 文档说明

本文档提供了item_template表中124个字段的详细解释、用途和示例值。特别详细说明了物品分类(class)及各种物品子分类(subclass)，帮助开发者理解物品系统的完整结构。

数据来源： 本文档基于AzerothCore官方Wiki和官方数据表借鉴.sql编写，确保字段定义的准确性和权威性。

📋 基本字段

🆔 entry - 物品ID

详细说明：物品的唯一标识符，是表的主键。每个物品都有一个唯一的entry ID，游戏中的物品实例都是基于这些模板创建的。 取值范围：1 - 16777215 (mediumint unsigned的范围)

示例值：

  • 2589 - 亚麻布
  • 18563 - 逐风者禁锢之颅
  • 32837 - 战争使者护肩
  • 19019 - 雷霆之怒，逐风者的祝福之剑

注意： 物品ID通常按照以下范围分配：

  • 1-50000: 游戏原始物品
  • 50001-100000: 自定义物品

📦 class - 物品类别

详细说明：物品的主要类别，决定了物品的基本行为和属性。不同类别的物品在游戏中有不同的用途和交互方式。 取值范围：0 - 16
值 类别名称 说明 示例
0 消耗品 使用后消失的物品 药水、食物、卷轴
1 容器 可以存放其他物品的容器 背包、箭袋、弹药袋
2 武器 可以装备的武器 剑、斧、法杖、弓
3 宝石 可以镶嵌在装备上的宝石 红宝石、黄宝石、蓝宝石
4 护甲 可以装备的防护装备 头盔、胸甲、护腕、盾牌
5 材料 施法材料或职业材料 施法材料、职业材料
6 弹药 远程武器使用的弹药 箭、子弹
7 商品 商业技能相关的原材料 布料、矿石、草药
8 通用物品 各种杂项物品 各种杂项
9 配方 商业技能的学习配方 锻造图纸、裁缝图样
10 钱币 游戏货币 铜币、银币、金币
11 箭袋 存放弹药的特殊容器 箭袋、弹药袋
12 任务物品 任务相关的物品 任务道具、任务触发物
13 钥匙 用于开启特定物品或区域 副本钥匙、门钥匙
14 永久物品 永久性物品 坐骑、玩具
15 杂项 各种特殊物品 各种特殊物品
16 雕文 职业雕文 战士雕文、法师雕文

注意： class字段与subclass字段一起使用，共同定义物品的具体类型。每个class都有对应的subclass细分。

🔍 subclass - 物品子类别详细说明

详细说明：物品的子类别，进一步细分物品的类型。子类别的含义取决于物品的主类别(class)。以下是每个class对应的详细subclass说明。 取值范围：根据class不同而不同

🧪 消耗品子类别 (class=0)

值 子类别名称 说明 示例
0 消耗品 通用消耗品 各种消耗品
1 药水 恢复生命或法力的药水 治疗药水、法力药水
2 药剂 提供增益效果的药剂 力量药剂、敏捷药剂
3 卷轴 提供临时增益的卷轴 力量卷轴、智力卷轴
4 食物和饮料 恢复生命和法力的食物 面包、水、肉
5 绷带 急救技能使用的绷带 厚绷带、符文绷带
6 治疗石 术士制作的治疗石 治疗石
7 法术石 术士制作的法术石 法术石
8 烹饪配方 烹饪技能的学习配方 烹饪食谱
9 技能书 学习技能的书籍 技能训练书
10 制皮图样 制皮技能的学习配方 制皮图样
11 裁缝图样 裁缝技能的学习配方 裁缝图样
12 工程学图纸 工程学技能的学习配方 工程学图纸
13 锻造图纸 锻造技能的学习配方 锻造图纸
14 烹饪配方 烹饪技能的学习配方 烹饪食谱
15 急救手册 急救技能的学习配方 急救手册
16 附魔公式 附魔技能的学习配方 附魔公式
17 钓鱼手册 钓鱼技能的学习配方 钓鱼手册
18 珠宝加工设计图 珠宝加工技能的学习配方 珠宝加工设计图
19 书籍 各种书籍 故事书、指南

🎒 容器子类别 (class=1)

值 子类别名称 说明 容量
0 背包 通用背包 各种容量
1 灵魂袋 术士专用灵魂袋 存放灵魂碎片
2 草药袋 草药师专用袋 存放草药
3 附魔材料袋 附魔师专用袋 存放附魔材料
4 工程学材料袋 工程师专用袋 存放工程学材料
5 宝石袋 珠宝加工师专用袋 存放宝石
6 矿石袋 矿工专用袋 存放矿石
7 制皮材料袋 制皮师专用袋 存放皮革
8 铭文袋 铭文师专用袋 存放铭文材料
9 工具箱 存放工具的箱子 存放工具

⚔️ 武器子类别 (class=2)

值 子类别名称 说明 示例
0 单手斧 单手使用的斧头 单手斧
1 双手斧 双手使用的斧头 双手斧
2 弓 远程武器弓 弓
3 枪 远程武器枪 枪
4 单手锤 单手使用的锤子 单手锤
5 双手锤 双手使用的锤子 双手锤
6 长柄武器 长柄武器 长矛、杖
7 单手剑 单手使用的剑 单手剑
8 双手剑 双手使用的剑 双手剑
9 废弃 已废弃的武器类型 -
10 法杖 施法者使用的法杖 法杖
11 废弃 已废弃的武器类型 -
12 废弃 已废弃的武器类型 -
13 拳套 拳套武器 拳套
14 杂项 投掷武器等杂项 投掷武器
15 匕首 匕首武器 匕首
16 投掷武器 投掷武器 飞刀、飞斧
17 长柄武器 长柄武器 长矛
18 弩 远程武器弩 弩
19 魔杖 施法者使用的魔杖 魔杖
20 钓鱼竿 钓鱼使用的竿子 钓鱼竿

💎 宝石子类别 (class=3)

值 子类别名称 颜色 插槽匹配
0 红色 红色 红色插槽
1 蓝色 蓝色 蓝色插槽
2 黄色 黄色 黄色插槽
3 紫色 紫色 红色或蓝色插槽
4 绿色 绿色 蓝色或黄色插槽
5 橙色 橙色 红色或黄色插槽
6 多彩 多彩 多彩插槽
7 简单 简单 任何插槽
8 棱彩 棱彩 任何插槽

🛡️ 护甲子类别 (class=4)

值 子类别名称 说明 适用职业
0 杂项 戒指、饰品等 所有职业
1 布甲 布料护甲 法师、牧师、术士
2 皮甲 皮革护甲 潜行者、德鲁伊
3 锁甲 锁链护甲 猎人、萨满
4 板甲 板金护甲 战士、圣骑士、死亡骑士
5 废弃 已废弃的护甲类型 -
6 盾牌 盾牌防护装备 战士、圣骑士、萨满
7 圣物 职业圣物 各职业专用
8 神像 德鲁伊神像 德鲁伊
9 图腾 萨满图腾 萨满
10 符印 圣骑士符印 圣骑士
11 副手物品 副手非武器物品 施法职业

🔧 材料子类别 (class=5)

值 子类别名称 说明 示例
0 材料 施法材料或职业材料 施法材料、职业材料

🎯 弹药子类别 (class=6)

值 子类别名称 说明 使用武器
0 废弃 已废弃的弹药类型 -
1 废弃 已废弃的弹药类型 -
2 箭 弓使用的箭矢 弓
3 子弹 枪使用的子弹 枪

📦 商品子类别 (class=7)

值 子类别名称 说明 示例
0 商品 通用商品 各种商品
1 零件 工程学零件 工程学零件
2 爆炸物 工程学爆炸物 炸药、炸弹
3 设备 工程学设备 工程学设备
4 珠宝加工 珠宝加工材料 宝石、矿石
5 布料 各种布料 亚麻布、丝绸
6 皮革 各种皮革 轻皮、厚皮
7 金属和矿石 各种金属和矿石 铜矿、铁矿
8 肉类 各种肉类 野兽肉类
9 草药 各种草药 宁神花、银叶草
10 元素材料 元素类材料 元素之水、元素之土
11 其他 其他材料 其他材料
12 附魔 附魔材料 魔法尘埃、精华
13 材料 通用材料 各种材料
14 护甲强化 护甲强化材料 护甲片

🎁 通用物品子类别 (class=8)

值 子类别名称 说明 示例
0 通用物品 各种杂项物品 各种杂项

📜 配方子类别 (class=9)

值 子类别名称 对应技能 示例
0 书籍 通用书籍 故事书、指南
1 制皮 制皮技能 制皮图样
2 裁缝 裁缝技能 裁缝图样
3 工程学 工程学技能 工程学图纸
4 锻造 锻造技能 锻造图纸
5 烹饪 烹饪技能 烹饪食谱
6 炼金术 炼金术技能 炼金术配方
7 急救 急救技能 急救手册
8 附魔 附魔技能 附魔公式
9 钓鱼 钓鱼技能 钓鱼手册
10 珠宝加工 珠宝加工技能 珠宝加工设计图
11 铭文 铭文技能 铭文配方

💰 钱币子类别 (class=10)

值 子类别名称 说明 换算
0 钱币 游戏货币 100铜=1银，100银=1金

🏹 筭袋子类别 (class=11)

值 子类别名称 说明 存放弹药
0 废弃 已废弃的箭袋类型 -
1 废弃 已废弃的箭袋类型 -
2 箭袋 存放箭矢的箭袋 箭
3 弹药袋 存放子弹的弹药袋 子弹

📋 任务物品子类别 (class=12)

值 子类别名称 说明 示例
0 任务物品 任务相关的物品 任务道具、任务触发物

🔑 钥匙子类别 (class=13)

值 子类别名称 说明 用途
0 钥匙 用于开启特定物品或区域 副本钥匙、门钥匙
1 开锁工具 盗贼开锁工具 开锁

⭐ 永久物品子类别 (class=14)

值 子类别名称 说明 示例
0 永久物品 永久性物品 坐骑、玩具

🎭 杂项子类别 (class=15)

值 子类别名称 说明 示例
0 垃圾 无实际用途的物品 垃圾物品
1 材料 各种材料 各种材料
2 宠物 非战斗宠物 小宠物
3 节日物品 节日相关的物品 节日物品
4 其他 其他特殊物品 其他物品
5 坐骑 可骑乘的坐骑 坐骑

✨ 雕文子类别 (class=16)

值 子类别名称 对应职业 示例
1 战士雕文 战士 战士雕文
2 圣骑士雕文 圣骑士 圣骑士雕文
3 猎人雕文 猎人 猎人雕文
4 潜行者雕文 潜行者 潜行者雕文
5 牧师雕文 牧师 牧师雕文
6 死亡骑士雕文 死亡骑士 死亡骑士雕文
7 萨满雕文 萨满祭司 萨满雕文
8 法师雕文 法师 法师雕文
9 术士雕文 术士 术士雕文
11 德鲁伊雕文 德鲁伊 德鲁伊雕文

🔊 SoundOverrideSubclass - 声音覆盖子类别

详细说明：声音覆盖子类别，用于覆盖物品默认的声音效果。如果设置为-1，则使用物品子类别的默认声音。 取值范围：-1 - 各种声音类型

示例值：

  • -1 - 使用默认声音
  • 3 - 使用锁甲声音

📝 name - 物品名称

详细说明：物品的名称，显示在游戏中的物品提示框和物品栏中。 取值范围：最多255个字符

示例值：

  • "亚麻布"
  • "逐风者禁锢之颅"
  • "雷霆之怒，逐风者的祝福之剑"

🎨 displayid - 显示ID

详细说明：物品的显示ID，决定了物品在游戏中的外观。这个ID对应ItemDisplayInfo.dbc文件中的记录。 取值范围：对应ItemDisplayInfo.dbc

示例值：

  • 2177 - 亚麻布的外观
  • 31247 - 逐风者禁锢之颅的外观

⭐ Quality - 品质

详细说明：物品的品质，决定了物品名称的颜色和物品的稀有程度。 取值范围：0 - 7
值 品质名称 颜色 说明
0 垃圾 灰色 无实际用途的物品
1 普通 白色 普通品质物品
2 优秀 绿色 优秀品质物品
3 精良 蓝色 精良品质物品
4 史诗 紫色 史诗品质物品
5 传说 橙色 传说品质物品
6 神器 红色 神器品质（游戏中未使用）
7 继承 金色 继承品质（传家宝）

🛡️ 装备相关字段

🎒 InventoryType - 物品栏类型

详细说明：物品栏类型，定义了物品可以装备在哪个装备栏位置。只有可装备的物品才需要设置此字段。 取值范围：0 - 28
值 类型名称 装备位置 说明
0 INVTYPE_NON_EQUIP 不可装备 不可装备的物品
1 INVTYPE_HEAD 头部 头盔、帽子
2 INVTYPE_NECK 颈部 项链
3 INVTYPE_SHOULDERS 肩部 护肩
4 INVTYPE_BODY 衬衣 衬衣（不显示属性）
5 INVTYPE_CHEST 胸部 胸甲
6 INVTYPE_WAIST 腰部 腰带
7 INVTYPE_LEGS 腿部 护腿
8 INVTYPE_FEET 脚部 靴子
9 INVTYPE_WRISTS 手腕 护腕
10 INVTYPE_HANDS 手套 手套
11 INVTYPE_FINGER 戒指 戒指（可装备2个）
12 INVTYPE_TRINKET 饰品 饰品（可装备2个）
13 INVTYPE_WEAPON 单手武器 单手武器
14 INVTYPE_SHIELD 盾牌 盾牌
15 INVTYPE_RANGED 远程武器 弓、枪、弩
16 INVTYPE_CLOAK 背部 披风
17 INVTYPE_2HWEAPON 双手武器 双手武器
18 INVTYPE_BAG 背包 背包
19 INVTYPE_TABARD 战袍 战袍
20 INVTYPE_ROBE 长袍 长袍（胸部）
21 INVTYPE_WEAPONMAINHAND 主手武器 主手武器
22 INVTYPE_WEAPONOFFHAND 副手武器 副手武器
23 INVTYPE_HOLDABLE 副手物品 副手非武器物品
24 INVTYPE_AMMO 弹药 弹药
25 INVTYPE_THROWN 投掷武器 投掷武器
26 INVTYPE_RANGEDRIGHT 远程武器 魔杖
27 INVTYPE_QUIVER 箭袋 箭袋
28 INVTYPE_RELIC 圣物 图腾、神像、符印

注意： 物品栏类型必须与物品的class和subclass匹配。例如，对于class=4（护甲）、subclass=1（布甲）的物品，InventoryType可以是1（头部）、3（肩部）、5（胸部）等，但不能是13（单手武器）。

⚔️ AllowableClass - 允许职业

详细说明：允许使用此物品的职业，是一个位掩码值。-1表示所有职业都可以使用。 取值范围：-1 或 位掩码组合
位掩码值 职业名称 说明
1 CLASS_WARRIOR 战士
2 CLASS_PALADIN 圣骑士
4 CLASS_HUNTER 猎人
8 CLASS_ROGUE 潜行者
16 CLASS_PRIEST 牧师
32 CLASS_DEATH_KNIGHT 死亡骑士
64 CLASS_SHAMAN 萨满祭司
128 CLASS_MAGE 法师
256 CLASS_WARLOCK 术士
1024 CLASS_DRUID 德鲁伊

常用组合值：

  • -1 - 所有职业
  • 3 (1+2) - 战士和圣骑士
  • 400 (16+128+256) - 牧师、法师和术士（布甲职业）
  • 1101 (1+4+8+1024+64) - 战士、猎人、潜行者、德鲁伊、萨满（可使用皮甲的职业）
  • 1107 (1+2+8+32+1064) - 战士、圣骑士、潜行者、死亡骑士（可使用板甲的职业）
  • 1168 (128+1024+16+256) - 法师、德鲁伊、牧师、术士（施法职业）
  • 77 (1+4+8+64) - 战士、猎人、潜行者、萨满（可使用敏捷武器的职业）

注意： 在设置AllowableClass时，应考虑物品的class、subclass和InventoryType。例如，布甲应该只允许布甲职业使用，板甲应该只允许板甲职业使用。

👤 AllowableRace - 允许种族

详细说明：允许使用此物品的种族，是一个位掩码值。-1表示所有种族都可以使用。 取值范围：-1 或 位掩码组合
位掩码值 种族名称 阵营
1 RACE_HUMAN 联盟
2 RACE_ORC 部落
4 RACE_DWARF 联盟
8 RACE_NIGHTELF 联盟
16 RACE_UNDEAD_PLAYER 部落
32 RACE_TAUREN 部落
64 RACE_GNOME 联盟
128 RACE_TROLL 部落
512 RACE_BLOODELF 部落
1024 RACE_DRAENEI 联盟

常用组合值：

  • -1 - 所有种族
  • 1101 (1+4+8+64+1024) - 人类、矮人、暗夜精灵、侏儒、德莱尼（联盟种族）
  • 690 (2+16+32+128+512) - 兽人、亡灵、牛头人、巨魔、血精灵（部落种族）
  • 5 (1+4) - 人类和矮人
  • 36 (4+32) - 矮人和牛头人（可以成为猎人的种族）
  • 1032 (8+1024) - 暗夜精灵和德莱尼

注意： 在设置AllowableRace时，应考虑物品的背景故事和阵营。例如，部落特有的物品应该只允许部落种族使用，联盟特有的物品应该只允许联盟种族使用。

📊 ItemLevel - 物品等级

详细说明：物品等级，决定了物品的基础属性和强度。物品等级越高，物品越强大。 取值范围：1 - 数百

示例值：

  • 1 - 新手区物品
  • 60 - 经典旧世顶级物品
  • 115 - 燃烧远征顶级物品
  • 213 - 巫妖王之怒顶级物品

🎯 RequiredLevel - 需要等级

详细说明：使用或装备此物品所需的最低角色等级。0表示没有等级要求。 取值范围：0 - 80

示例值：

  • 0 - 无等级要求
  • 10 - 需要10级
  • 60 - 需要60级
  • 80 - 需要80级

💰 价格与数量字段

🛒 BuyCount - 购买数量

详细说明：从商人处购买物品时一次购买的数量。大多数物品为1，但某些物品（如箭矢）可能一次购买多个。 取值范围：1 - 255

示例值：

  • 1 - 一次购买1个
  • 5 - 一次购买5个
  • 20 - 一次购买20个

💵 BuyPrice - 购买价格

详细说明：从商人处购买物品的价格，以铜币为单位。 取值范围：0 - 数百万铜币

示例值：

  • 100 - 1银币
  • 10000 - 1金币
  • 150000 - 15金币

注意： 游戏中的货币换算：100铜币=1银币，100银币=1金币。

💸 SellPrice - 出售价格

详细说明：将物品出售给商人的价格，以铜币为单位。通常是BuyPrice的25%。 取值范围：0 - 数百万铜币

示例值：

  • 25 - 25铜币
  • 2500 - 25银币
  • 37500 - 3金75银

📦 stackable - 可堆叠数量

详细说明：物品可以堆叠的最大数量。1表示不可堆叠，其他值表示可堆叠的最大数量。 取值范围：1 - 数百

示例值：

  • 1 - 不可堆叠（装备等）
  • 5 - 可堆叠5个
  • 20 - 可堆叠20个
  • 200 - 可堆叠200个（如弹药）

🔢 maxcount - 最大持有数量

详细说明：玩家可以持有的此物品的最大数量。0表示无限制。 取值范围：0 - 数百

示例值：

  • 0 - 无限制
  • 1 - 只能持有1个（唯一物品）
  • 5 - 只能持有5个

🔗 相关表格

❓ 常见问题

Q1: 如何确定物品的class和subclass?
首先确定物品的主要用途，选择对应的class。然后根据物品的具体类型，选择对应的subclass。例如，一把单手剑，class=2（武器），subclass=7（单手剑）。
Q2: InventoryType和class/subclass有什么关系?
InventoryType定义了物品的装备位置，必须与class和subclass匹配。例如，class=4（护甲）、subclass=1（布甲）的物品，InventoryType应该是装备位置（头部、胸部等），而不能是武器位置。
Q3: 如何设置AllowableClass?
使用位掩码值组合。例如，要设置一个只允许战士和圣骑士使用的物品，AllowableClass=3（1+2）。要设置所有职业都可以使用，AllowableClass=-1。
Q4: Quality字段如何影响物品?
Quality决定了物品名称的颜色和稀有程度。灰色（0）是垃圾物品，白色（1）是普通物品，绿色（2）是优秀物品，蓝色（3）是精良物品，紫色（4）是史诗物品，橙色（5）是传说物品。