喵mc 发表于 2025-9-30 12:07:37

Chemdah任务追踪显示 HUD视图


🎯 ChemdahQuestTracker - Chemdah任务追踪显示

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

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



✨ 插件特色


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




🎨 显示效果展示

📱 云拾UI模式

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

云拾效果:
https://vip.123pan.cn/1817084870/yk6baz03t0m000d7w33ghnj1algw2u3xDIYPAwa1AdY0DcxwDda1.png
https://vip.123pan.cn/1817084870/ymjew503t0n000d7w32ybplqs7vde7adDIYPAwa1AdY0DcxwDda1.png

✨ 云拾模式特点:

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

📊 原版计分板模式

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

原版效果:
https://vip.123pan.cn/1817084870/yk6baz03t0l000d7w33fqxww0tf6wj6bDIYPAwa1AdY0DcxwDda1.pnghttps://vip.123pan.cn/1817084870/ymjew503t0l000d7w32xewcmhke15h32DIYPAwa1AdY0DcxwDda1.png
https://vip.123pan.cn/1817084870/yk6baz03t0n000d7w33hcozk6aafqk3oDIYPAwa1AdY0DcxwDda1.pnghttps://vip.123pan.cn/1817084870/yk6baz03t0m000d7w33gi23f2xutds4fDIYPAwa1AdY0DcxwDda1.png

✨ 原版模式特点:

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



🎮 动作控制系统

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


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


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

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


⚔️ 战斗状态检测

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


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


💡 配置示例:
combat-detection:
# 是否启用战斗状态检测
enabled: true
# 战斗状态持续时间(秒)- 超过此时间没有战斗行为则退出战斗状态
combat-duration: 3
# 进入战斗状态时的ActionBar提示消息
enter-combat-message: "§c⚔ 进入战斗状态,动作控制已暂时禁用"
# 退出战斗状态时的ActionBar提示消息
exit-combat-message: "§a✓ 退出战斗状态,动作控制已恢复"
# 战斗状态提示显示持续时间(tick)
message-duration: 40
# 战斗时隐藏计分板功能
# 是否在战斗时隐藏计分板
hide-scoreboard: true
# 计分板隐藏持续时间(秒)- 进入战斗后隐藏计分板的时长
# 注意:如果此值小于 combat-duration,则在战斗结束前就会恢复显示
hide-duration: 5
# 计分板隐藏状态检测间隔(tick,20 tick = 1秒)
# 用于定期检查是否需要恢复计分板显示
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 文件中。


# ========================================
# 授权设置
# ========================================
auth:
# 您的QQ号(必填)
qq-number: ""
# 授权码(必填 XXXX-XXXX-XXXX-XXXX)
license-code: ""
#----------------以下内容不要修改!----------------
server-url: "http://a.mcstory.cc:41515/"
heartbeat-interval: 300
cache-enabled: true
cache-time: 300



# ========================================
# 核心设置
# ========================================

# 数据更新间隔(tick,20 tick = 1秒)
# 建议值:20-100,过低可能影响性能
update-interval: 20
# 调试模式(启用后会输出更多调试信息)
debug-mode: false



# ========================================
# 云拾UI系统设置
# ========================================

# 是否启用云拾系统(总开关)
# 如果关闭,将不会发送任何云拾数据包
cloudpick-enabled: true
# 云拾UI数据通道名称
# 注意:确保与客户端配置一致
data-channel: "questData"



# ========================================
# Scoreboard任务显示设置
# ========================================

# 是否启用Scoreboard任务显示
scoreboard-enabled: false
# Scoreboard显示配置
scoreboard:
# 标题显示文本
title: "§6§l当前任务"
# 最大显示行数
# 注意:Minecraft客户端最多只能显示15行,超过部分不会显示
max-lines: 15
# 超出限制时的提示文本
more-content-text: "§7更多内容..."
# 是否显示任务介绍内容(默认显示,可通过指令/动作控制)
show-description: true

# 是否隐藏右侧的分数显示
hide-scores: true
# 任务名称前缀
quest-name-prefix: "§e▶ "
# 任务介绍前缀
description-prefix: "§7"
# 展开状态的任务名称前缀
expanded-quest-prefix: "§a▼ "
# 收起状态的任务名称前缀
collapsed-quest-prefix: "§e▶ "
# 选中状态的任务名称前缀
selected-quest-prefix: "§b★ "
# 更新频率(tick,建议不低于20以避免闪烁)
update-interval: 40



# ========================================
# 交互控制设置
# ========================================

# 是否启用动作控制(需要ProtocolLib支持)
# 注意:启用后可通过 /cqt task action <on|off> 命令运行时控制
action-control-enabled: true

# ActionBar显示设置
actionbar:
# 是否在ActionBar显示选中的任务
show-selected-task: true
# 选中任务的显示格式
selected-format: "§e当前选择: §a{task_name}"
# 无选择时的显示文本
show-no-selection-text: true# 是否显示无选择时的提示文本
no-selection-text: "§7使用 /cqt task 或动作选择任务"
# ActionBar显示持续时间(tick)
display-duration: 60



# ========================================
# 战斗状态检测配置
# ========================================
combat-detection:
# 是否启用战斗状态检测
enabled: true
# 战斗状态持续时间(秒)- 超过此时间没有战斗行为则退出战斗状态
combat-duration: 3
# 进入战斗状态时的ActionBar提示消息
enter-combat-message: "§c⚔ 进入战斗状态,动作控制已暂时禁用"
# 退出战斗状态时的ActionBar提示消息
exit-combat-message: "§a✓ 退出战斗状态,动作控制已恢复"
# 战斗状态提示显示持续时间(tick)
message-duration: 40

# 战斗时隐藏计分板功能
# 是否在战斗时隐藏计分板
hide-scoreboard: true
# 计分板隐藏持续时间(秒)- 进入战斗后隐藏计分板的时长
# 注意:如果此值小于 combat-duration,则在战斗结束前就会恢复显示
hide-duration: 5
# 计分板隐藏状态检测间隔(tick,20 tick = 1秒)
# 用于定期检查是否需要恢复计分板显示
check-interval: 20



# ========================================
# 动作控制配置 - 新版本配置系统
# ========================================
actions:
# 支持的按键说明:
# 支持:
#   - F (单独F键)
#   - Q (单独Q键)
#   - SHIFT+F (Shift + F键)
#   - SHIFT+LEFT_CLICK (Shift + 左键点击)
#   - SHIFT+RIGHT_CLICK (Shift + 右键点击)
#   - SHIFT+SCROLL (Shift + 滚轮)
#   - SNEAK_DOUBLE (双击蹲下)
# - 权限后缀: op (OP权限), player (玩家权限), console (控制台权限)

# 任务选择切换 (滚轮选择任务)
cut:
    key: "SHIFT+SCROLL"# 按键组合

# 切换模式 (一键展开/收起)
# 注意: 启用此模式时,spread_click 和 conceal_click 的 enable 应设为 false 以避免冲突
checked:
    enable: false      # 是否启用切换模式
    key: "F"            # 切换按键

# 展开任务
spread_click:
    enable: true         # 是否启用展开功能
    key: "SHIFT+LEFT_CLICK"# 展开按键

# 收起任务
conceal_click:
    enable: true         # 是否启用收起功能 (切换模式启用时自动禁用)
    key: "SHIFT+RIGHT_CLICK" # 收起按键

# 收起所有任务
collapseall:
    enable: true         # 是否启用收起所有功能
    key: "Q"            # 收起所有按键(通过丢弃物品事件检测)

# 命令执行 (可用于开关动作控制等)
# 重要:command 功能不受动作控制开关影响,确保可以重新打开动作控制
command:
    enable: true         # 是否启用命令功能
    key: "SHIFT+F"       # 命令触发按键 ✨ 现在支持 SHIFT+F!
    command: "cqt task action {off to on} op"# 执行的命令
    # 命令模板变量:
    # {player} - 玩家名称
    # {off to on} - 自动切换开关状态
    # 权限后缀: op, player, console


💡 配置提示:

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



📝 命令列表


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




🎯 适用场景

🏰 RPG服务器

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


🌍 生存服务器

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




🔄 更新日志

v1.0.0 (2025-09-30)

新增功能:

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


优化:

[*]✅ 优化数据更新机制




📞 购买联系方式

如有任何问题或建议,欢迎联系:

[*]💬 QQ:2776901795
[*]售价 58




🙏 感谢使用 ChemdahQuestTracker!
页: [1]
查看完整版本: Chemdah任务追踪显示 HUD视图