Chemdah任务追踪显示 HUD视图

喵***

🎯 ChemdahQuestTracker - Chemdah任务追踪显示

版本：1.0.0 | 适用版本：Minecraft 1.16.X - 1.21.1 (Paper/Spigot/Bukkit)
(描述的版本可能存在不支持但会进行一对一兼容修复)

一款专为Chemdah任务系统设计的任务追踪显示插件
支持云拾UI和原版计分板双模式，让任务管理更加便捷！[/center]

---

✨ 插件特色

• 🎨 双模式显示 - 支持云拾UI和原版计分板两种显示方式，满足不同需求
• 🎮 动作控制 - 丰富的快捷键操作（Shift+滚轮、Shift+左键等），方便任务管理
• ⚔️ 战斗状态检测 - 战斗时自动关闭动作控制，避免意外操作
• 🔄 实时数据同步 - 自动追踪任务进度变化，无需手动刷新
• ⚙️ 高度可配置 - 所有按键、显示样式都可以自定义
  

---

🎨 显示效果展示

📱 云拾UI模式

插件自带一个基础云拾任务HUD视图，可随意修改配置
支持任务展开/收起、多任务切换、实时进度更新

云拾效果：

✨ 云拾模式特点：

• 美观的图形界面，支持自定义样式
• 支持任务展开/收起，节省屏幕空间
• 支持多任务切换显示，一目了然
  

📊 原版计分板模式

支持纯原版使用（计分板），纯原版有动作控制（方便切换任务介绍）
无需客户端MOD，所有玩家都能使用

原版效果：

✨ 原版模式特点：

• 无需客户端MOD，兼容性强
• 支持完整的动作控制功能
• 自动适配屏幕大小
  

---

🎮 动作控制系统

插件提供了丰富的快捷键操作，让任务管理更加便捷：

操作	默认按键	功能说明
任务切换	Shift + 滚轮	滚动切换当前显示的任务
展开任务	Shift + 左键	展开当前任务的详细信息
收起任务	Shift + 右键	收起当前任务的详细信息
收起所有	Q键	一键收起所有任务
切换模式	F键	一键展开/收起（可选功能）
执行命令	Shift + F	执行自定义命令（如开关动作控制）

💡 提示：所有按键都可以在配置文件中自定义！

支持的按键组合：F、Q、SHIFT+F、SHIFT+LEFT_CLICK、SHIFT+RIGHT_CLICK、SHIFT+SCROLL、SNEAK_DOUBLE

---

⚔️ 战斗状态检测

插件会检测玩家的战斗状态，在战斗时自动隐藏任务界面，避免遮挡视线：

• ✅ 玩家攻击实体时自动隐藏
• ✅ 玩家受到伤害时自动隐藏
• ✅ 玩家使用武器时自动隐藏
• ✅ 战斗结束后自动恢复显示（默认5秒）
• ✅ 隐藏时长可在配置文件中自定义
  

💡 配置示例：

1. combat-detection:
   
2.   # 是否启用战斗状态检测
   
3.   enabled: true
   
4.   # 战斗状态持续时间（秒）- 超过此时间没有战斗行为则退出战斗状态
   
5.   combat-duration: 3
   
6.   # 进入战斗状态时的ActionBar提示消息
   
7.   enter-combat-message: "§c⚔ 进入战斗状态，动作控制已暂时禁用"
   
8.   # 退出战斗状态时的ActionBar提示消息
   
9.   exit-combat-message: "§a✓ 退出战斗状态，动作控制已恢复"
   
10.   # 战斗状态提示显示持续时间（tick）
    
11.   message-duration: 40
    
12.   # 战斗时隐藏计分板功能
    
13.   # 是否在战斗时隐藏计分板
    
14.   hide-scoreboard: true
    
15.   # 计分板隐藏持续时间（秒）- 进入战斗后隐藏计分板的时长
    
16.   # 注意：如果此值小于 combat-duration，则在战斗结束前就会恢复显示
    
17.   hide-duration: 5
    
18.   # 计分板隐藏状态检测间隔（tick，20 tick = 1秒）
    
19.   # 用于定期检查是否需要恢复计分板显示
    
20.   check-interval: 20

复制代码

---

📋 依赖插件

必需依赖：
(以下只是已知的，如果不支持和我联系进行兼容)

• ✅ Chemdah (1.1.17 - 1.1.19+) - 任务系统核心插件
• ✅ auth-sdk (1.0.0+) - 授权验证SDK
  

可选依赖：

• 💡 PlaceholderAPI (2.11.6+) - 变量支持（推荐安装）
• 💡 CloudPick (1.2.0+) - 云拾UI（云拾模式必需）
  

---

🔧 安装步骤

• 下载插件
  
  
  
    
  • 下载 ChemdahQuestTracker-1.0-SNAPSHOT.jar (插件本体)
  • 下载 Chemdah-1.1.19.jar (任务本体)
  • 下载 CloudPick-Bukkit-1.2.0-Release.jar（云拾本体）
  • 下载 auth-sdk-1.0.0-obfuscated.jar (验证本体)
    
• 放入插件目录
  
  
  
    
  • 将所有插件放入服务器的 plugins 目录
    
• 配置授权
  
  
  
    
  • 编辑 plugins/ChemdahQuestTracker/config.yml
  • 填写你的QQ号和授权码
    
• 重启服务器
  
  
  
    
  • 重启服务器，插件将自动加载
    
  
  

---

⚙️ 配置说明

插件提供了丰富的配置选项，所有配置都在 plugins/ChemdahQuestTracker/config.yml 文件中。

[spoiler=🔐 授权设置]

1. # ========================================
   
2. # 授权设置
   
3. # ========================================
   
4. auth:
   
5.   # 您的QQ号（必填）
   
6.   qq-number: ""
   
7.   # 授权码（必填 XXXX-XXXX-XXXX-XXXX）
   
8.   license-code: ""
   
9.   #----------------以下内容不要修改！----------------
   
10.   server-url: "http://a.mcstory.cc:41515/"
    
11.   heartbeat-interval: 300
    
12.   cache-enabled: true
    
13.   cache-time: 300

复制代码

[/spoiler]

[spoiler=⚙️ 核心设置]

1. # ========================================
   
2. # 核心设置
   
3. # ========================================
   
4. 
   
5. # 数据更新间隔（tick，20 tick = 1秒）
   
6. # 建议值：20-100，过低可能影响性能
   
7. update-interval: 20
   
8. # 调试模式（启用后会输出更多调试信息）
   
9. debug-mode: false

复制代码

[/spoiler]

[spoiler=☁️ 云拾UI系统设置]

1. # ========================================
   
2. # 云拾UI系统设置
   
3. # ========================================
   
4. 
   
5. # 是否启用云拾系统（总开关）
   
6. # 如果关闭，将不会发送任何云拾数据包
   
7. cloudpick-enabled: true
   
8. # 云拾UI数据通道名称
   
9. # 注意：确保与客户端配置一致
   
10. data-channel: "questData"

复制代码

[/spoiler]

[spoiler=📊 计分板显示设置]

1. # ========================================
   
2. # Scoreboard任务显示设置
   
3. # ========================================
   
4. 
   
5. # 是否启用Scoreboard任务显示
   
6. scoreboard-enabled: false
   
7. # Scoreboard显示配置
   
8. scoreboard:
   
9.   # 标题显示文本
   
10.   title: "§6§l当前任务"
    
11.   # 最大显示行数
    
12.   # 注意：Minecraft客户端最多只能显示15行，超过部分不会显示
    
13.   max-lines: 15
    
14.   # 超出限制时的提示文本
    
15.   more-content-text: "§7更多内容..."
    
16.   # 是否显示任务介绍内容（默认显示，可通过指令/动作控制）
    
17.   show-description: true
    
18. 
    
19.   # 是否隐藏右侧的分数显示
    
20.   hide-scores: true
    
21.   # 任务名称前缀
    
22.   quest-name-prefix: "§e▶ "
    
23.   # 任务介绍前缀
    
24.   description-prefix: "§7  "
    
25.   # 展开状态的任务名称前缀
    
26.   expanded-quest-prefix: "§a▼ "
    
27.   # 收起状态的任务名称前缀
    
28.   collapsed-quest-prefix: "§e▶ "
    
29.   # 选中状态的任务名称前缀
    
30.   selected-quest-prefix: "§b★ "
    
31.   # 更新频率（tick，建议不低于20以避免闪烁）
    
32.   update-interval: 40

复制代码

[/spoiler]

[spoiler=🎮 动作控制设置]

1. # ========================================
   
2. # 交互控制设置
   
3. # ========================================
   
4. 
   
5. # 是否启用动作控制（需要ProtocolLib支持）
   
6. # 注意：启用后可通过 /cqt task action <on|off> 命令运行时控制
   
7. action-control-enabled: true
   
8. 
   
9. # ActionBar显示设置
   
10. actionbar:
    
11.   # 是否在ActionBar显示选中的任务
    
12.   show-selected-task: true
    
13.   # 选中任务的显示格式
    
14.   selected-format: "§e当前选择: §a{task_name}"
    
15.   # 无选择时的显示文本
    
16.   show-no-selection-text: true  # 是否显示无选择时的提示文本
    
17.   no-selection-text: "§7使用 /cqt task 或动作选择任务"
    
18.   # ActionBar显示持续时间（tick）
    
19.   display-duration: 60

复制代码

[/spoiler]

[spoiler=⚔️ 战斗状态检测配置]

1. # ========================================
   
2. # 战斗状态检测配置
   
3. # ========================================
   
4. combat-detection:
   
5.   # 是否启用战斗状态检测
   
6.   enabled: true
   
7.   # 战斗状态持续时间（秒）- 超过此时间没有战斗行为则退出战斗状态
   
8.   combat-duration: 3
   
9.   # 进入战斗状态时的ActionBar提示消息
   
10.   enter-combat-message: "§c⚔ 进入战斗状态，动作控制已暂时禁用"
    
11.   # 退出战斗状态时的ActionBar提示消息
    
12.   exit-combat-message: "§a✓ 退出战斗状态，动作控制已恢复"
    
13.   # 战斗状态提示显示持续时间（tick）
    
14.   message-duration: 40
    
15. 
    
16.   # 战斗时隐藏计分板功能
    
17.   # 是否在战斗时隐藏计分板
    
18.   hide-scoreboard: true
    
19.   # 计分板隐藏持续时间（秒）- 进入战斗后隐藏计分板的时长
    
20.   # 注意：如果此值小于 combat-duration，则在战斗结束前就会恢复显示
    
21.   hide-duration: 5
    
22.   # 计分板隐藏状态检测间隔（tick，20 tick = 1秒）
    
23.   # 用于定期检查是否需要恢复计分板显示
    
24.   check-interval: 20

复制代码

[/spoiler]

[spoiler=🎯 动作按键配置]

1. # ========================================
   
2. # 动作控制配置 - 新版本配置系统
   
3. # ========================================
   
4. actions:
   
5.   # 支持的按键说明：
   
6.   # 支持：
   
7.   #   - F (单独F键)
   
8.   #   - Q (单独Q键)
   
9.   #   - SHIFT+F (Shift + F键)
   
10.   #   - SHIFT+LEFT_CLICK (Shift + 左键点击)
    
11.   #   - SHIFT+RIGHT_CLICK (Shift + 右键点击)
    
12.   #   - SHIFT+SCROLL (Shift + 滚轮)
    
13.   #   - SNEAK_DOUBLE (双击蹲下)
    
14.   # - 权限后缀: op (OP权限), player (玩家权限), console (控制台权限)
    
15. 
    
16.   # 任务选择切换 (滚轮选择任务)
    
17.   cut:
    
18.     key: "SHIFT+SCROLL"  # 按键组合
    
19. 
    
20.   # 切换模式 (一键展开/收起)
    
21.   # 注意: 启用此模式时，spread_click 和 conceal_click 的 enable 应设为 false 以避免冲突
    
22.   checked:
    
23.     enable: false        # 是否启用切换模式
    
24.     key: "F"            # 切换按键
    
25. 
    
26.   # 展开任务
    
27.   spread_click:
    
28.     enable: true         # 是否启用展开功能
    
29.     key: "SHIFT+LEFT_CLICK"  # 展开按键
    
30. 
    
31.   # 收起任务
    
32.   conceal_click:
    
33.     enable: true         # 是否启用收起功能 (切换模式启用时自动禁用)
    
34.     key: "SHIFT+RIGHT_CLICK" # 收起按键
    
35. 
    
36.   # 收起所有任务
    
37.   collapseall:
    
38.     enable: true         # 是否启用收起所有功能
    
39.     key: "Q"            # 收起所有按键（通过丢弃物品事件检测）
    
40. 
    
41.   # 命令执行 (可用于开关动作控制等)
    
42.   # 重要：command 功能不受动作控制开关影响，确保可以重新打开动作控制
    
43.   command:
    
44.     enable: true         # 是否启用命令功能
    
45.     key: "SHIFT+F"       # 命令触发按键 ✨ 现在支持 SHIFT+F！
    
46.     command: "cqt task action {off to on} op"  # 执行的命令
    
47.     # 命令模板变量:
    
48.     # {player} - 玩家名称
    
49.     # {off to on} - 自动切换开关状态
    
50.     # 权限后缀: op, player, console

复制代码

[/spoiler]

💡 配置提示：

• 修改配置后使用 /cqt reload 重新加载
• 云拾模式和计分板模式可以同时启用，插件会自动处理
• 所有按键都可以自定义，避免与其他插件冲突
• 战斗检测功能可以单独开关，不影响其他功能
  

---

📝 命令列表

命令	权限	说明
/cqt reload	chemdahtracker.admin	重新加载配置文件
/cqt debug [on|off]	chemdahtracker.admin	开关调试模式
/cqt task	chemdahtracker.task | default	收起全部任务
/cqt task [N]	chemdahtracker.tack.* | default	展开/收起任务
/cqt task action [on|off|status]	chemdahtracker.status | default	动作控制状态
/cqt task select [N]	chemdahtracker.select | default	选择指定任务
/cqt task expand [N|all]	chemdahtracker.expand | default	展开指定/全部任务
/cqt task collpse [N|all]	chemdahtracker.collpae | default	收起指定/全部任务
/cqt task list	chemdahtracker.list | default	显示全部的任务
/cqt task help	chemdahtracker.help | default	显示帮助
/cqt combat	chemdahtracker.combat | default	查看战斗状态
/cqt help	chemdahtracker.help | default	显示帮助信息

---

🎯 适用场景

🏰 RPG服务器

• 玩家可以清晰地看到任务进度
• 支持多任务同时追踪
• 战斗时自动隐藏，不影响PVP体验
  

🌍 生存服务器

• 使用原版计分板模式，无需客户端MOD
• 简洁的任务显示，不占用过多屏幕空间
• 方便的快捷键操作，提升游戏体验
  

---

🔄 更新日志

v1.0.0 (2025-09-30)

新增功能：

• ✅ 支持云拾UI和原版计分板双模式
• ✅ 完整的动作控制系统
• ✅ 战斗状态检测功能
  

优化：

• ✅ 优化数据更新机制
  

---

📞 购买联系方式

如有任何问题或建议，欢迎联系：

• 💬 QQ：2776901795
• 售价 58
  

---

[center]🙏 感谢使用 ChemdahQuestTracker！[/center]