QyChemdahView – 清影Chemdah任务视图插件

Minecraft 1.12.2 任务可视化解决方案

📖 插件简介

QyChemdahView 是一款专为 Minecraft 1.12.2 服务器开发的任务视图插件。它深度集成 Chemdah 任务系统和 DragonCore 客户端界面，为玩家提供直观的任务分类管理、实时 HUD 进度追踪、GPS 导航等功能。

作者: QingYing（清影）
QQ: 2976877702

**上面为用户使用的效果图，默认配置不附带UI**

✨ 核心功能

• ★ 任务分类管理 – 支持自定义任务分类（主线、支线、日常等），灵活配置任务归属
• ★ 实时 HUD 显示 – 屏幕右侧显示正在进行的任务进度，支持多任务同时追踪
• ★ 任务置顶功能 – 玩家可以置顶关注的任务到 HUD，优先显示重要任务
• ★ GPS 导航系统 – 支持为每个任务阶段配置独立的 GPS 导航点，一键开启/关闭
• ★ DragonCore 界面 – 精美的客户端 GUI 界面，支持自定义样式
• ★ 双存储模式 – 支持 YAML 文件存储和 MySQL 数据库存储
• ★ 多动作支持 – 控制台命令、玩家命令、消息、标题等多种动作类型
• ★ 物品库支持 – 支持 NeigeItems (NI) 和 MythicMobs (MM) 物品库

📋 前置插件

必需:

• Spigot/Paper 1.12.2
• Chemdah 0.X/1.X（任务系统）
• DragonCore 2.5+（客户端界面）

可选:

• PlaceholderAPI 2.11+（变量支持）
• NeigeItems（NI物品库）
• MythicMobs（MM物品库）

🎮 命令与权限

命令:

权限:

⚙️ 配置文件说明

插件目录结构:

plugins/QyChemdahView/
├── config.yml          # 主配置文件
├── message.yml         # 消息配置
├── Gui/                # DragonCore 界面配置
│   ├── QyChemdahViewGui.yml
│   └── QyChemdahViewHud.yml
└── Quests/             # 任务配置文件夹
    └── *.yml           # 任务配置文件

config.yml 主配置:

# 存储方式配置
storage:
  type: "YAML"                    # YAML 或 MYSQL
  mysql:
    host: "localhost"
    port: 3306
    database: "minecraft"
    username: "root"
    password: "password"
    table-prefix: "qy_chemdah_"
    pool:
      maximum-pool-size: 10
      minimum-idle: 5
      connection-timeout: 10000

# 任务完成状态图标
icons:
  complete: "§a✔"
  uncomplete: "§e○"

# HUD 显示设置
hud-settings:
  enable: true                    # 是否启用 HUD
  number: 3                       # 同时显示的任务数量

# 任务置顶设置
top-quest-settings:
  enable: true
  # max-top-quests: 3             # 可选

# 任务分类配置
quest-class:
  class1:
    name: "主线"
    quests:
      - "主线-新手村"
      - "主线-击杀豺狼"
  class2:
    name: "支线"
    quests:
      - "支线-采集水菜"

# 调试模式
debug: false

📝 任务配置示例

在 Quests/ 文件夹中创建任务配置文件：

# 任务ID必须与Chemdah中的任务ID一致
示例-采集任务:
  # 任务名称（显示在界面上）
  name: "§6§l[主线] §f采集铁矿"

  # task-set: 配置每个 task 的完成图标和 GPS 导航
  task-set:
    "0":                          # task 索引（从0开始）
      complete: "§a✔"             # 完成图标
      uncomplete: "§e○"           # 未完成图标
      gps:                        # GPS 导航配置
        enable: true
        name: "铁矿采集点"
        open-run:                 # 开启导航时执行
          - "tell {player} §a已开启导航！"
        close-run:                # 关闭导航时执行
          - "tell {player} §c已关闭导航！"

  # task-info: 配置任务进度的显示信息
  task-info:
    "0":                          # 阶段索引
      task: "0"                   # 关联的 task 索引
      info:
        hud:                      # HUD 显示内容
          - "§e前往矿洞采集铁矿"
          - "§7进度: §f{goal_0}"
        gui:                      # GUI 显示内容
          - "§e▸ 前往矿洞采集铁矿"
          - "§7进度: §f{goal_0}"
        items:                    # 显示的物品
          - "minecraft:iron_ore"
          - "[ni]NI物品ID,数量"
          - "[mm]MM物品ID,数量"

  # accept-gps: 接取任务时执行的动作
  accept-gps:
    enable: true
    run:
      - "[message]&a&l[任务] &f任务已接取！"
      - "[title]&6&l新任务||&e采集铁矿||10||60||10"
      - "[console]give {player} minecraft:iron_pickaxe 1"

  # cancel: 取消任务时执行的动作
  cancel:
    enable: true
    run:
      - "[message]&c&l[任务] &f任务已取消！"

🔖 占位符说明

🎯 动作命令说明

在 accept-gps.run、cancel.run、gps.open-run、gps.close-run 中支持以下动作类型：

📋 多阶段任务配置示例

示例-击杀任务:
  name: "§6§l[主线] §f击杀怪物"

  task-set:
    "0":
      complete: "§a✔"
      uncomplete: "§e○"
      gps:
        enable: true
        name: "僵尸刷怪点"
        open-run:
          - "tell {player} §a已开启前往僵尸刷怪点的导航！"
        close-run:
          - "tell {player} §c已关闭导航！"
    "1":
      complete: "§a✔"
      uncomplete: "§e○"
      gps:
        enable: true
        name: "骷髅刷怪点"
        open-run:
          - "tell {player} §a已开启前往骷髅刷怪点的导航！"
        close-run:
          - "tell {player} §c已关闭导航！"

  task-info:
    # 阶段 0：第一个 task 未完成时显示
    "0":
      task: "0"
      info:
        hud:
          - "§e{completion_0} 击杀僵尸 §7{goal_0}"
          - "§8{completion_1} 击杀骷髅 §7{goal_1}"
        gui:
          - "§e▸ 第一阶段：击杀僵尸"
          - "§7  {completion_0} 进度: §f{goal_0}"
          - ""
          - "§8▸ 第二阶段：击杀骷髅（未解锁）"
          - "§7  {completion_1} 进度: §f{goal_1}"
        items:
          - "minecraft:rotten_flesh"

    # 阶段 1：第一个 task 完成后显示
    "1":
      task: "1"
      info:
        hud:
          - "§a{completion_0} 击杀僵尸 §7{goal_0}"
          - "§e{completion_1} 击杀骷髅 §7{goal_1}"
        gui:
          - "§a✔ 第一阶段：击杀僵尸（已完成）"
          - "§7  {completion_0} 进度: §f{goal_0}"
          - ""
          - "§e▸ 第二阶段：击杀骷髅"
          - "§7  {completion_1} 进度: §f{goal_1}"
        items:
          - "minecraft:bone"

  accept-gps:
    enable: true
    run:
      - "[message]&a&l[任务] &f任务已接取！"
      - "[title]&6&l新任务||&e击杀怪物||10||60||10"

🎨 颜色代码参考

§0 = 黑色    §1 = 深蓝    §2 = 深绿    §3 = 青色
§4 = 深红    §5 = 紫色    §6 = 金色    §7 = 灰色
§8 = 深灰    §9 = 蓝色    §a = 绿色    §b = 天蓝
§c = 红色    §d = 粉色    §e = 黄色    §f = 白色
§l = 粗体    §m = 删除线  §n = 下划线  §o = 斜体
§r = 重置

⚠️ 注意事项

1. 任务 ID 必须与 Chemdah 配置中的任务 ID 完全一致
2. task 索引从 0 开始，对应 Chemdah 任务中的 task 顺序
3. 只有在 config.yml 的 quest-class 中添加的任务才会被检测和显示
4. 修改配置后使用 /qcv reload 重载配置
5. 切换存储模式（YAML/MySQL）建议重启服务器
6. HUD 刷新间隔在龙核配置文件中设置（建议 1500 毫秒）
7. 大型服务器建议使用 MySQL 存储

📞 技术支持

如有问题，请联系插件作者：

• 作者: QingYing（清影）
• QQ: 2976877702

感谢使用 QyChemdahView！