GQ剧情播放器 (gqplot) 指令使用指南

本文档包含 GQ剧情播放器 插件中所有 /gqplot 自定义指令的详细语法说明、参数解释及常用示例。

---

📌 基础语法

/gqplot <目标> <操作对象> <操作方式/参数...> [其它选项...]

• 权限等级: 游戏管理员 / 命令方块 (game_directors)
• 默认目标: @s（当前执行指令的目标）

---

📖 指令变体列表与示例

1. 设置素材图片路径 (pathname)

为剧情对话框设置头像或角色立绘图片。图片必须存储在资源包 textures/ui/gqimg/ 目录下。

• 语法格式:

  /gqplot <目标> <icon|characterart> pathname <素材名>

• 参数说明:
  • <操作对象>:
    • icon: 头像框图片
    • characterart: 角色立绘图片
  • pathname: 固定操作类型，表示修改路径
  • <素材名>: 图片文件名（不需要加后缀和 textures/ui/gqimg/ 前缀）
• 指令示例:

  # 设置当前玩家的头像为 textures/ui/gqimg/head_npc1.png
  /gqplot @s icon pathname head_npc1
  
  # 设置附近玩家的角色立绘为 textures/ui/gqimg/guard_body.png
  /gqplot @p characterart pathname guard_body

---

2. 控制界面与元素显示/隐藏 (setshow)

控制剧情主界面、头像或立绘的显示状态。

• 语法格式:

  /gqplot <目标> <icon|characterart|plotbox> setshow <是否显示>

• 参数说明:
  • <操作对象>:
    • plotbox: 整个剧情界面面板（设为 false 会立即关闭剧情、恢复系统 HUD 及玩家移动操作）
    • icon: 头像框
    • characterart: 角色立绘
  • setshow: 固定操作类型
  • <是否显示>: true（显示） / false（隐藏）
• 指令示例:

  # 显示整个剧情主面板
  /gqplot @s plotbox setshow true
  
  # 隐藏角色立绘
  /gqplot @s characterart setshow false
  
  # 显示头像框
  /gqplot @s icon setshow true
  
  # 强制关闭剧情界面并恢复玩家控制
  /gqplot @s plotbox setshow false

---

3. 播放剧情文本 (text)

触发逐字打字机文本播放。支持通过 & 符号分割多段剧情连续播放，并可在播放完毕后给玩家赋予指定 Entity Tag。

• 语法格式:

  /gqplot <目标> text <是否可跳过> <结束tag> <剧情内容>

• 参数说明:
  • text: 固定操作类型
  • <是否可跳过>: 布尔值 (true / false)
    • true: 允许玩家在打字播放过程中点击直接完整显示本段文本；每段文本完整显示后，仍需要玩家手动点击继续下一段或关闭。
    • false: 不允许在打字播放过程中点击跳过打字动画；每段文本完整播放完后，玩家手动点击继续下一段或关闭。
  • <结束tag>: 字符串。剧情整组文本播放完毕后，系统将自动使用 /tag 给目标玩家添加此 Tag（可用于命令方块后置检测）。
  • <剧情内容>: 对话内容文本。使用 & 符号分隔可实现多段连续对话。
• 指令示例:

  # 播放单段剧情文本，允许打字中点击跳过显示全文（canskip为true），结束后添加 quest1_finish 标签
  /gqplot @s text true quest1_finish "勇士，欢迎来到长空村！"
  
  # 播放多段对话（用 & 分割），禁止在打字中跳过（canskip为false，打字完后手动点击推进）
  /gqplot @s text false chapter1_end "前方危险！&请拿起这把宝剑。&祝你好运！"
  
  # 播放多段剧情（canskip为true，每次打字中点击均可直接显示全文，播放完后点击推进）
  /gqplot @s text true intro_done "很久很久以前...&这片大陆非常平静。&直到魔王降临..."

---

4. 设置名字与提示文本 (name / tip)

修改剧情界面中显示的说话人姓名和底部提示信息。

• 语法格式:

  /gqplot <目标> <name|tip> <设置内容>

• 参数说明:
  • <操作对象>:
    • name: 说话人/角色名字（如 "村长"、"神秘人"）
    • tip: 界面提示文本（如 "点击屏幕继续"）
  • <设置内容>: 文本字符串
• 指令示例:

  # 设置说话人名字为 "村长"
  /gqplot @s name "村长"
  
  # 设置提示文本为 "点击屏幕继续"
  /gqplot @s tip "点击屏幕继续"

---

💡 常用剧情编排组合示例 (命令方块连招)

在地图或任务触发中，通常按照以下顺序连续执行指令以展现完整剧情：

# 1. 设置说话人名字
/gqplot @p name "守卫长"

# 2. 设置提示语
/gqplot @p tip "点击屏幕推进对话"

# 3. 设置头像与立绘素材路径 (素材需位于 textures/ui/gqimg/ 目录下)
/gqplot @p icon pathname head_guard
/gqplot @p characterart pathname body_guard

# 4. 开启头像与立绘显示
/gqplot @p icon setshow true
/gqplot @p characterart setshow true

# 5. 触发播放 3 段连续剧情对话，完成后给玩家打上 talk_guard_done 标签
/gqplot @p text false talk_guard_done "站住！前方是王城重地！&请出示你的通行证。&没有通行证者不得入内！"