资源文件总览

所属：参考　·　相关：配置文件 · 内置内容清单

plugins/QinhItems/ 下所有配置 / 资源文件的地图：每个文件管什么、结构要点、去哪章看详解。

这些 YAML 文件顶部都自带中文注释，本页不重复抄原文，只给「哪个文件管什么 + 关键结构 + 跳转」。需要逐行批注的只有 config.yml 原文页。

---

一、根目录文件

文件	管什么	详解
config.yml	主配置（目录 / 写域 / 动作路由 / 宝石桥 / 战斗 / 绑定 / 属性映射）	配置文件 · 原文
item_types.yml	物品类型与能力（见下方完整表）	物品类型
item_tiers.yml	品质 / Tier（权重 / 容量 / 发光）	品质与显示 · 内置清单
enchant_limits.yml	附魔总等级上限（按类型 / 品质）	附魔上限
plugin.yml	插件元数据 / 权限 / 依赖	权限 · 配置文件 §plugin.yml

二、内容目录

目录 / 文件	管什么	详解
items/<type>.yml	物品定义（每文件一类型，~140 件示例）	物品定义 · 示例库
fragments/*.yml	碎片（可复用片段）	碎片与模板
sections/*.yml	段 / 词缀池 / 品质池 + affixes 段	段 · 词缀
sets/*.yml	套装定义	套装 · 内置清单

三、集成目录 integrations/

文件	管什么	详解
gem_socket_types.yml	宝石孔类型（映射 LI / MG 后端）	宝石孔
legendinlay_sockets.yml	Legendinlay 孔目录（lore 须与 LI 逐字一致）	宝石孔
magicgem_sockets.yml	MagicGem 孔目录	同上
legendinlay_guide.yml / magicgem_guide.yml	后端接入说明（文档型，自带注释）	集成实操
action_handlers.yml	动作处理器命名空间说明（文档型）	处理器
bridges.yml	桥开关	集成
resource_models.yml	编辑器模型目录（按分类列模型）	资源包

四、LegendCore 目录 legendcore/

文件	管什么
QinhItemsModule.groovy	LegendCore 兜底桥脚本（自动部署）
README.txt	说明

---

五、item_types.yml 完整类型表

item_types.yml 不只有能力，还定义默认材质、编辑器图标、别名、库分类。完整表（内置 40+ 类型）：

类型	显示名	默认材质	图标	库分类	能力
weapon	武器	iron_sword	IRON_SWORD	combat	skill·attribute·gem_socket·render
armor	护甲	iron_chestplate	IRON_CHESTPLATE	combat	attribute·render
helmet	头盔	iron_helmet	IRON_HELMET	combat	(继承 armor)
chestplate	胸甲	iron_chestplate	IRON_CHESTPLATE	combat	(继承 armor)
leggings	护腿	iron_leggings	IRON_LEGGINGS	combat	(继承 armor)
boots	靴子	iron_boots	IRON_BOOTS	combat	(继承 armor)
shield	盾牌	shield	SHIELD	combat	attribute·render·set
projectile	投射物	arrow	ARROW	combat	projectile·render
bow	弓	bow	BOW	combat	projectile·attribute·render
crossbow	弩	crossbow	CROSSBOW	combat	projectile·attribute·render
trident	三叉戟	trident	TRIDENT	combat	projectile·skill·attribute·render
ring	戒指	gold_ingot	GOLD_INGOT	accessory	skill·attribute·gem_socket·render
necklace	项链	emerald	EMERALD	accessory	skill·attribute·gem_socket·render
bracelet	手镯	bone	BONE	accessory	skill·attribute·gem_socket·render
accessory	饰品	nether_star	NETHER_STAR	accessory	skill·attribute·gem_socket·render
gem	宝石	amethyst_shard	AMETHYST_SHARD	craft	render·attribute
material	材料	iron_ingot	IRON_INGOT	craft	render·set
consumable	消耗品	potion	POTION	utility	consumable·render·set
food	食物	bread	BREAD	utility	consumable·render
scroll	卷轴	book	BOOK	utility	consumable·skill·render
seed	种子	wheat_seeds	WHEAT_SEEDS	craft	consumable·render
bait	鱼饵	bread	BREAD	utility	consumable·render
tool	工具	diamond_pickaxe	DIAMOND_PICKAXE	utility	render·attribute
fishing_rod	钓鱼竿	fishing_rod	FISHING_ROD	utility	render·set
wand	魔杖	blaze_rod	BLAZE_ROD	magic	skill·attribute·gem_socket·render
horse_armor	马铠	diamond_horse_armor	DIAMOND_HORSE_ARMOR	equipment	attribute·render
horse	马匹	saddle	SADDLE	equipment	render·set
skull	头颅	creeper_head	CREEPER_HEAD	decorative	render
currency	货币	gold_ingot	GOLD_INGOT	economy	render
token	代币	netherite_ingot	NETHERITE_INGOT	economy	render·consumable
trophy	奖杯	golden_apple	GOLDEN_APPLE	special	render·consumable
prop	道具	clock	CLOCK	utility	skill·consumable·render
misc	杂项	paper	PAPER	misc	render

类型字段说明

字段	含义
display_name	显示名（编辑器 + 结构化 Lore 的 type 行）
icon	编辑器图标材质
display	是否在类型浏览器显示
default_material	新建该类型物品的默认材质
capabilities	能力标记，见 物品类型
aliases	别名（类型查找用）
parent	父类型（继承 capabilities）
library_category	库面板分类

---

六、宝石孔类型表（gem_socket_types.yml）

内置孔类型与后端映射：

孔类型	显示名	legendinlay	magicgem
绿色	绿色	normal	weapon_slot
黄色	黄色	normal	weapon_slot
无色	无色	normal	weapon_slot
qi_weapon	武器孔	qi_weapon	—
normal	十年魂环	normal	—
armor	护甲孔	—	armor_slot（自带 lore）

字段 display / legendinlay / magicgem / lore 见 宝石孔。

---

下一步

• 配置文件原文：config.yml 逐行
• 内置内容清单：品质 / 段 / 套装
• 物品类型：能力矩阵