秦淮系列文档

简体中文

English

简体中文

English

外观

示例库 · 杂项 / 特殊篇 ​

所属：服主指南 → 物品示例库 · 杂项篇　·　相关：物品类型 · 动作系统

本页收录 QinhItems 自带的杂项 / 特殊类示例物品，逐件给出完整 YAML 与逐项说明。每个示例文件名即物品的 type，每个顶层键即一件物品 ID。改完任何 YAML 后须执行 /qi reload 才生效（动作只在 reload / 重启时加载）。

🖼️ [图片占位] 杂项物品在背包中的整体陈列（货币、代币、奖杯、头颅、道具、坐骑各一排）　·　建议 assets/misc-overview.png

货币 currency.yml ​

经济货币类。底物多为原版贵金属材质，可堆叠；交互型货币以 触发器 left_click 配合 consume 扣自身完成兑换。

demo_gold_coin ​

最基础的货币物品：只有外观，可堆叠到 64。

yaml
demo_gold_coin:
  type: currency
  material: gold_ingot
  display_name: "<yellow>金币</yellow>"
  item_name: "金币"
  lore:
    - ""
    - "<gray>通用的流通货币</gray>"
  options:
    max_stack_size: 64
  • 纯外观货币，无 actions；max_stack_size: 64 使其作为通用流通货币可大量堆叠。

demo_jade_note ​

高额纯外观货币，底物为绿宝石。

yaml
demo_jade_note:
  type: currency
  material: emerald
  display_name: "<green>翡翠钞票</green>"
  item_name: "翡翠钞票"
  lore:
    - ""
    - "<gray>价值不菲的高额货币</gray>"
  options:
    max_stack_size: 64
  • 与 demo_gold_coin 结构一致，仅换底物与命名，用于表示更高面额。

demo_exchange_token ​

可兑换货币：左键扣 1 张并通过指令给玩家充值游戏币。

yaml
demo_exchange_token:
  type: currency
  material: gold_nugget
  display_name: "<gold>兑换金券</gold>"
  item_name: "兑换金券"
  tier: UNCOMMON
  lore:
    - ""
    - "<gray>左键兑换为 100 游戏币</gray>"
    - "<dark_gray>每次消耗 1 张 · 冷却 3 秒</dark_gray>"
  options:
    max_stack_size: 64
    glow: true
  actions:
    triggers:
      left_click:
        trigger:
          atom: left_click
        cooldown: 3s
        consume:
          - "self:1"
        refs:
          - handler: qi:command
            payload: "money give {player} 100"
          - handler: qi:action_bar
            payload: "<gold>已兑换 100 游戏币</gold>"
          - handler: qi:sound
            payload: "minecraft:entity.experience_orb.pickup;1;1.2"
  • 触发器 触发器 left_click + cooldown: 3s + consume: self:1：每次扣 1 张并 3 秒冷却。处理器 处理器 链依次为 qi:command（向经济插件充值，{player} 替换为玩家名）、qi:action_bar 提示、qi:sound 反馈。

代币 token.yml ​

兑换券类。一律以 触发器 left_click 触发使用，配 consume: self:1 扣券；兑换结果可以是指令奖励，也可以是 qi:give_item 直接发放物品。

demo_event_token ​

活动收集 / 凭证用纯外观代币。

yaml
demo_event_token:
  type: token
  material: netherite_ingot
  display_name: "<dark_purple>活动代币</dark_purple>"
  item_name: "活动代币"
  lore:
    - ""
    - "<gray>限时活动专属代币</gray>"
  options:
    max_stack_size: 64
  • 无动作，仅作收集 / 凭证标记。

demo_arena_token ​

竞技场兑换凭证，纯外观。

yaml
demo_arena_token:
  type: token
  material: iron_nugget
  display_name: "<gray>竞技代币</gray>"
  item_name: "竞技代币"
  lore:
    - ""
    - "<gray>竞技场兑换专用代币</gray>"
  options:
    max_stack_size: 64
  • 无动作，定位为竞技场专用兑换货币。

demo_kit_voucher ​

新手礼包兑换券：左键扣 1 张并执行 kit 指令。

yaml
demo_kit_voucher:
  type: token
  material: paper
  display_name: "<gold>新手礼包兑换券</gold>"
  item_name: "新手礼包兑换券"
  tier: UNCOMMON
  lore:
    - ""
    - "<gray>左键使用，领取新手礼包</gray>"
    - "<dark_gray>使用后消耗 1 张</dark_gray>"
  options:
    max_stack_size: 16
  actions:
    triggers:
      left_click:
        trigger:
          atom: left_click
        cooldown: 3s
        consume:
          - "self:1"
        refs:
          - handler: qi:command
            payload: "kit starter"
          - handler: qi:sound
            payload: "minecraft:entity.player.levelup;1;1.2"
          - handler: qi:action_bar
            payload: "<gold>已领取新手礼包！</gold>"
  • 触发器 left_click + consume: self:1；处理器 qi:command 调用礼包指令，再以音效与 action_bar 反馈。

demo_legend_voucher ​

传说兑换券：左键扣 1 张并通过 qi:give_item 直接发放一件传说武器。

yaml
demo_legend_voucher:
  type: token
  material: nether_star
  display_name: "<light_purple>传说兑换券</light_purple>"
  item_name: "传说兑换券"
  tier: LEGENDARY
  lore:
    - ""
    - "<gray>左键使用，兑换一件传说武器</gray>"
    - "<dark_gray>使用后消耗 1 张</dark_gray>"
  options:
    glow: true
    max_stack_size: 1
  actions:
    triggers:
      left_click:
        trigger:
          atom: left_click
        cooldown: 3s
        consume:
          - "self:1"
        refs:
          - handler: qi:give_item
            payload: "demo_void_reaver"
          - handler: qi:title
            payload: "<light_purple>✦ 兑换成功 ✦</light_purple>||<gray>传说武器已入背包</gray>||5||40||10"
          - handler: qi:sound
            payload: "minecraft:ui.toast.challenge_complete;1;1"
  • 处理器 处理器 qi:give_item 的 payload 是另一件 QI 物品 ID（demo_void_reaver，装备篇中的武器），扣券后直接入背包；再以 qi:title 全屏标题与音效强化兑换仪式感。

奖杯 trophy.yml ​

纪念 / 战利品类。多数为纯外观陈列品（material + display_name + glow）；如需可交互纪念品，可挂 触发器 left_click。

demo_champion_cup ​

冠军奖杯，发光纯外观纪念品。

yaml
demo_champion_cup:
  type: trophy
  material: golden_apple
  display_name: "<gold>冠军奖杯</gold>"
  item_name: "冠军奖杯"
  tier: EPIC
  lore:
    - ""
    - "<gray>胜利者的荣耀象征</gray>"
    - "<dark_gray>陈列于荣誉殿堂</dark_gray>"
  options:
    glow: true
    max_stack_size: 1
  • 无动作；glow: true + max_stack_size: 1 为典型奖杯陈列设置。

demo_victory_emblem ​

胜利徽章，可堆叠的发光纪念徽章。

yaml
demo_victory_emblem:
  type: trophy
  material: gold_block
  display_name: "<yellow>胜利徽章</yellow>"
  item_name: "胜利徽章"
  lore:
    - ""
    - "<gray>纪念辉煌战绩的徽章</gray>"
  options:
    glow: true
    max_stack_size: 16
  • 与奖杯不同，徽章 max_stack_size: 16 允许堆叠收集。

demo_dragon_skull ​

可炫耀的战利品：左键举起，触发全屏标题、龙吼音效与公屏播报。

yaml
demo_dragon_skull:
  type: trophy
  material: dragon_head
  display_name: "<dark_purple>巨龙头骨</dark_purple>"
  item_name: "巨龙头骨"
  tier: LEGENDARY
  lore:
    - ""
    - "<gray>讨伐末影龙的不朽证明</gray>"
    - "<dark_gray>左键举起，向世界宣告你的功绩</dark_gray>"
  options:
    glow: true
    max_stack_size: 1
  actions:
    triggers:
      left_click:
        trigger:
          atom: left_click
        cooldown: 5s
        refs:
          - handler: qi:title
            payload: "<dark_purple>屠龙者</dark_purple>||<gray>举起了巨龙头骨</gray>||10||40||10"
          - handler: qi:sound
            payload: "minecraft:entity.ender_dragon.growl;1;1"
          - handler: qi:console_command
            payload: "broadcast <gold>{player}</gold> <gray>正在炫耀他的</gray> <dark_purple>巨龙头骨</dark_purple>!"
  • 无 consume（炫耀不损耗）；处理器 qi:console_command 以控制台权限执行 broadcast 向全服播报，{player} 替换为持有者名。

头颅 skull.yml ​

装饰头颅类。多为纯外观；玩家头通过 options.skull_owner 指定皮肤主人。可挂 left_click / shift_left_click 等 触发器。

🖼️ [图片占位] 玩家头 skull_owner 渲染效果（Notch / Herobrine 皮肤头）　·　建议 assets/skull-owner.png

demo_creeper_trophy ​

苦力怕头颅，纯外观战利品。

yaml
demo_creeper_trophy:
  type: skull
  material: creeper_head
  display_name: "<green>苦力怕头颅</green>"
  item_name: "苦力怕头颅"
  lore:
    - ""
    - "<gray>击败苦力怕的战利品</gray>"
  options:
    max_stack_size: 16
  • 用原版怪物头材质 creeper_head，无需 skull_owner；也被 demo_summon_skull 作为 qi:give_item 的发放目标。

demo_skeleton_trophy ​

骷髅头颅，纯外观战利品。

yaml
demo_skeleton_trophy:
  type: skull
  material: skeleton_skull
  display_name: "<white>骷髅头颅</white>"
  item_name: "骷髅头颅"
  lore:
    - ""
    - "<gray>击败骷髅的战利品</gray>"
  options:
    max_stack_size: 16
  • 同样用原版怪物头材质，无动作。

demo_hero_head ​

英雄玩家头：用 skull_owner 套用指定玩家皮肤，左键炫耀一句。

yaml
demo_hero_head:
  type: skull
  material: player_head
  display_name: "<gold>传说英雄之首</gold>"
  item_name: "传说英雄之首"
  tier: LEGENDARY
  lore:
    - ""
    - "<gray>取自一位传奇玩家的头颅</gray>"
    - "<dark_gray>左键挥动以炫耀</dark_gray>"
  options:
    skull_owner: "Notch"
    glow: true
  actions:
    triggers:
      left_click:
        trigger:
          atom: left_click
        cooldown: 3s
        refs:
          - handler: qi:action_bar
            payload: "<gold>你高举着传说英雄之首！</gold>"
          - handler: qi:sound
            payload: "minecraft:entity.player.levelup;1;1"
  • skull_owner 机制：当 material 为 player_head 时，options.skull_owner: "Notch" 会让头颅渲染为该玩家的皮肤头像（按正版用户名拉取材质）。其余为常规 left_click 炫耀动作，无消耗。

demo_summon_skull ​

召唤头颅：潜行 + 左键献祭自身，换取一枚苦力怕战利品。

yaml
demo_summon_skull:
  type: skull
  material: player_head
  display_name: "<light_purple>诅咒之颅</light_purple>"
  item_name: "诅咒之颅"
  tier: EPIC
  lore:
    - ""
    - "<gray>潜行 + 左键，献祭头颅</gray>"
    - "<gray>以换取一枚苦力怕战利品</gray>"
  options:
    skull_owner: "Herobrine"
  actions:
    triggers:
      shift_left_click:
        trigger:
          atom: shift_left_click
        cooldown: 5s
        consume:
          - "self:1"
        refs:
          - handler: qi:title
            payload: "<dark_purple>献祭完成</dark_purple>||<gray>诅咒之颅化为战利品</gray>||10||40||10"
          - handler: qi:sound
            payload: "minecraft:entity.wither.spawn;0.6;1.4"
          - handler: qi:give_item
            payload: "demo_creeper_trophy"
  • skull_owner 机制：player_head 渲染为 Herobrine 皮肤头。触发器 触发器 shift_left_click（潜行 + 左键）+ consume: self:1 实现"献祭"；处理器 qi:give_item 发放上文的 demo_creeper_trophy，形成头颅互换链。

道具 prop.yml ​

通用道具类。靠 触发器 left_click 当"使用"手势触发 qi:title / qi:sound / qi:command 等效果。

demo_pocket_watch ​

最简道具：怀表，纯外观。

yaml
demo_pocket_watch:
  type: prop
  material: clock
  display_name: "<gold>怀表</gold>"
  item_name: "怀表"
  lore:
    - ""
    - "<gray>记录时光流转的怀表</gray>"
  options:
    max_stack_size: 1
  • 无动作，纯外观收藏品。

demo_seeker_compass ​

寻迹罗盘，纯外观。

yaml
demo_seeker_compass:
  type: prop
  material: compass
  display_name: "<aqua>寻迹罗盘</aqua>"
  item_name: "寻迹罗盘"
  lore:
    - ""
    - "<gray>指引方向的神奇罗盘</gray>"
  options:
    max_stack_size: 1
  • 无动作，定位为方向指引道具的外观件。

demo_recall_stone ​

回归之石：左键施放回城，2 分钟冷却且一次性消耗。

yaml
demo_recall_stone:
  type: prop
  material: recovery_compass
  display_name: "<light_purple>回归之石</light_purple>"
  item_name: "回归之石"
  tier: RARE
  lore:
    - ""
    - "<gray>左键挥动，返回安全之地</gray>"
    - "<dark_gray>一次性 · 冷却 2 分钟</dark_gray>"
  options:
    glow: true
    max_stack_size: 1
  actions:
    triggers:
      left_click:
        trigger:
          atom: left_click
        cooldown: 2m
        consume:
          - "self:1"
        refs:
          - handler: qi:title
            payload: "<light_purple>✦ 回归 ✦</light_purple>||<gray>空间正在折叠</gray>||5||40||10"
          - handler: qi:sound
            payload: "minecraft:entity.enderman.teleport;1;1"
          - handler: qi:command
            payload: "spawn"
  • cooldown: 2m（分钟级冷却）+ consume: self:1（一次性）；处理器 qi:command 以玩家身份执行 spawn 回到出生点。

demo_far_spyglass ​

远眺单筒镜：左键播报视野效果，3 秒冷却，不消耗。

yaml
demo_far_spyglass:
  type: prop
  material: spyglass
  display_name: "<yellow>远眺单筒镜</yellow>"
  item_name: "远眺单筒镜"
  tier: UNCOMMON
  lore:
    - ""
    - "<gray>左键挥动，眺望远方</gray>"
    - "<dark_gray>冷却 3 秒</dark_gray>"
  options:
    max_stack_size: 1
  actions:
    triggers:
      left_click:
        trigger:
          atom: left_click
        cooldown: 3s
        refs:
          - handler: qi:action_bar
            payload: "<yellow>你举镜远眺，视野豁然开朗</yellow>"
          - handler: qi:sound
            payload: "minecraft:item.spyglass.use;1;1"
  • 无 consume 的可重复使用道具，仅 action_bar + 音效反馈。

坐骑 horse.yml ​

坐骑相关类。外观件为鞍具 / 缰绳；召唤型用刷怪蛋底物 + 触发器 触发 qi:console_command 的 summon 指令生成坐骑实体。

🖼️ [图片占位] 召唤蛋触发 summon 生成已驯服坐骑的瞬间　·　建议 assets/horse-summon.png

demo_war_saddle ​

战马鞍，纯外观。

yaml
demo_war_saddle:
  type: horse
  material: saddle
  display_name: "<gold>战马鞍</gold>"
  item_name: "战马鞍"
  lore:
    - ""
    - "<gray>驾驭战马的鞍具</gray>"
  options:
    max_stack_size: 1
  • 无动作，鞍具外观件。

demo_swift_lead ​

疾行缰绳，可堆叠纯外观。

yaml
demo_swift_lead:
  type: horse
  material: lead
  display_name: "<green>疾行缰绳</green>"
  item_name: "疾行缰绳"
  lore:
    - ""
    - "<gray>牵引坐骑的缰绳</gray>"
  options:
    max_stack_size: 16
  • 无动作，缰绳外观件，可堆叠 16。

demo_summon_steed_egg ​

骏马召唤蛋：左键召唤一匹已驯服的马，消耗自身并 5 秒冷却。

yaml
demo_summon_steed_egg:
  type: horse
  material: horse_spawn_egg
  display_name: "<aqua>骏马召唤蛋</aqua>"
  item_name: "骏马召唤蛋"
  tier: RARE
  lore:
    - ""
    - "<gray>左键吹响号角，唤来你的坐骑</gray>"
    - "<dark_gray>一次性 · 冷却 5 秒</dark_gray>"
  options:
    glow: true
  actions:
    triggers:
      left_click:
        trigger:
          atom: left_click
        cooldown: 5s
        consume:
          - "self:1"
        refs:
          - handler: qi:console_command
            payload: "summon minecraft:horse ~ ~ ~ {Tame:1b}"
          - handler: qi:sound
            payload: "minecraft:entity.horse.angry;1;1"
          - handler: qi:action_bar
            payload: "<aqua>骏马应召而来！</aqua>"
  • 召唤机制：QI 本身不内置生物生成，而是靠 处理器 qi:console_command 执行原版 summon minecraft:horse ~ ~ ~ {Tame:1b}——~ ~ ~ 为玩家所在坐标，NBT {Tame:1b} 让马生成即已驯服。consume: self:1 使召唤蛋一次性。

demo_celestial_mount_egg ​

天界神驹之蛋：潜行 + 左键吟唱召唤，需 30 级、获得即绑定。

yaml
demo_celestial_mount_egg:
  type: horse
  material: horse_spawn_egg
  display_name: "<light_purple>天界神驹之蛋</light_purple>"
  item_name: "天界神驹之蛋"
  tier: LEGENDARY
  lore:
    - ""
    - "<gray>潜行 + 左键，吟唱召唤天界神驹</gray>"
    - "<dark_gray>需要 30 级 · 获得即绑定 · 冷却 10 秒</dark_gray>"
  options:
    glow: true
    bind_on_acquire: true
    restrictions:
      - "level:30"
  actions:
    triggers:
      shift_left_click:
        trigger:
          atom: shift_left_click
        cooldown: 10s
        refs:
          - handler: qi:title
            payload: "<light_purple>✦ 天界降临 ✦</light_purple>||<gray>神驹踏云而至</gray>||5||40||10"
          - handler: qi:sound
            payload: "minecraft:entity.ender_dragon.flap;1;1.2"
          - handler: qi:console_command
            payload: "summon minecraft:skeleton_horse ~ ~ ~ {Tame:1b}"
  • 召唤机制：处理器 qi:console_command 召唤 minecraft:skeleton_horse（骷髅马，同样 {Tame:1b} 驯服）。options.bind_on_acquire: true 获得即绑定，restrictions: level:30 限制 30 级以下不可使用；触发器 触发器 为 shift_left_click（潜行 + 左键）。此例不带 consume，可重复召唤（受 10 秒冷却约束）。

下一步 ​