传奇剑侠2.5D引擎任务面板提示文本标签调用与多分支任务第二章配置详解

剑侠2.5D引擎任务提示分为任务主标题、任务描述、目标提示、进度数字、完成提示、失败提示多段文本，第二章任务属于分段式主线任务，需要单独配置任务标识、任务状态标记、可重复标记，文本内容读取由引擎内置任务系统加载，文本格式存在专属标签，标签写错会造成任务面板空白、文字乱码、进度不刷新，修改前备份任务配置文件，防止文本格式错误导致任务模块加载失败。

任务基础标识定义，每一个主线任务分配唯一任务ID，第二章任务使用独立ID，不可与第一章任务ID重复。任务配置文件内第一行填写任务编号、任务名称、任务类型，主线任务标记为1，支线任务标记为2。任务状态依靠人物私有变量进行判断，变量记录任务接受状态、任务完成状态、任务进度，第二章任务必须在第一章任务完成之后才开放领取，脚本增加前置判定，未完成第一章任务无法接取第二章任务。

任务提示文本支持内置标签，标签用来动态读取人物数据，直接嵌入任务描述文字内。<$HUMANNAME>(HUMANNAME>读取角色名称，<)<$LEVEL>读取人物等级，<$M0>(M0>读取人物变量，<)<$KILLCOUNT>读取指定怪物击杀计数，<$ITEMCOUNT>读取背包指定物品数量。标签前后符号不能遗漏，标签名称区分大小写，标签拼写错误会直接原样显示文本，不会替换成动态数值。换行标签使用\r\n，在文本内插入\r\n实现任务面板自动换行，不要直接在文本内回车换行，直接回车会造成配置文件解析异常，面板文字全部挤在同一行。颜色标签写法为<color=255,255,0>文字内容，RGB三组数字控制文字色彩，标签首尾必须成对，只写开始标签不写闭合标签，后续全部文字都会继承该颜色。

第二章任务领取阶段文本配置，任务NPC对话段同步绑定任务面板提示。玩家和NPC对话接取第二章主线，脚本写入标记变量M0=1，代表任务已接取未完成。任务面板提示文本分为标题和正文，标题文字简洁，正文写明任务背景、目标、奖励。示例任务标题，第二章 大漠求援，正文文本，<color=255,255,255>你已经完成第一章试炼，边关传来急报，前往荒漠击杀沙盗(M1>/20，收集沙盗令牌<)。\r\n<color=255,0,0>任务目标：击杀沙盗0/20，获取沙盗令牌0/10\r\n<color=0,255,0>任务奖励：经验、金币、武器材料。文本内进度数字由引擎自动读取击杀变量，无需手动修改文字，击杀怪物后变量更新，面板上的0/20自动刷新。

任务进度实时刷新逻辑，剑侠2.5D引擎任务面板支持自动刷新，击杀怪物、拾取物品触发事件后更新人物变量，面板读取变量数值刷新进度。[@OnKillMon]杀怪事件内增加怪物名称判定，击杀任务目标怪物，任务变量M1累加计数，M1记录沙盗击杀数量，M2记录令牌数量。变量更新后，引擎自动刷新任务面板提示，不需要手动调用刷新指令。部分场景切换地图、打开任务面板才刷新，需要在[@OnOpenTask]打开任务面板事件内增加变量读取，强制刷新一次文本内容，避免进度显示延迟。

任务完成提示文本配置，当M1>=20并且M2>=10，判定任务目标全部达成，触发任务完成分支。完成提示文本单独编写，替换原有任务目标内容，提示文字为<color=0,255,0>任务目标已完成，返回NPC处交付任务领取奖励。玩家回到任务NPC对话，执行奖励发放脚本，发放完成后设置M0=2标记第二章任务已完结，面板切换为任务已完成文本，同时开启第三章任务领取权限。任务交付时同步清除任务进度变量M1、M2，防止重复提交任务。

任务失败提示文本配置，第二章主线可设置失败条件，例如超出限定等级、超时、死亡次数达到阈值，触发失败分支。失败标记M0=3，任务面板加载失败提示文本，<color=255,0,0>任务失败，沙盗已经撤离，可重新接取任务再次挑战。如果任务不可重复接取，删除重新接取文字，写明任务永久失效。重置任务脚本需要清空进度变量M1、M2，重置任务状态标记，文本切回待接取状态。

任务弹窗提示与追踪提示文本，除任务面板之外，引擎支持右侧任务追踪栏短文本，追踪栏文字精简，只保留当前目标。追踪文本示例，第二章主线：击杀沙盗<$M1>/20(M1>/20，收集沙盗令牌<)<$M2>/10。追踪栏文本长度有限，文字过多会被截断，不适合放置大量背景描述。接取任务时弹出任务接受弹窗，弹窗文本独立配置，弹窗支持颜色标签与换行标签，弹窗点击确认后任务正式激活。

多分支任务文本处理，第二章任务可设置多选分支，不同选择跳转不同任务子流程，对应不同提示文本。分支依靠人物变量M3记录选择分支编号，M3=1为分支A，M3=2为分支B。任务面板读取M3数值，加载对应分支的描述文字与目标。分支切换时，直接替换面板全部提示内容，分支之间进度变量相互独立，不会互相覆盖。编写分支文本时，每个分支单独写一套描述、目标、完成提示，不要共用同一套文本。

文本编写限制规则，任务文本不能使用全角符号，逗号、括号、数字全部使用半角字符。单段文本字符长度存在上限，超出上限部分文字不会显示，长篇描述拆分多行，使用\r\n换行。特殊符号如星号、顿号部分版本不支持，会造成面板文字截断。标签嵌套不能多层叠加，一层颜色标签内部不要再嵌套新颜色标签，会出现颜色渲染错乱。

任务文本调试操作，修改任务配置文件之后，在M2重载任务文本配置，不需要重启服务端。接取第二章任务，打开任务面板，核对标题、描述、目标进度颜色是否正常。击杀任务怪物，查看面板进度数字是否实时变化。完成任务交付，确认文本切换为完成提示。触发任务失败条件，校验失败提示正常显示。切换任务分支，确认不同分支加载对应的提示文字。测试关闭重新打开任务面板，验证文本不会丢失、标签不会失效。

常见文本异常排查，标签符号写错，尖括号缺失，面板直接原样显示标签文字。换行标记写成中文回车，文字全部挤在一行。颜色标签没有闭合，后续文字颜色异常。任务变量没有更新，面板进度数字一直不变，需要检查杀怪事件内变量累加脚本是否生效。前置任务标记没有判定，玩家未完成第一章就领取第二章任务，脚本缺少状态判断。文本字符超出上限，后半段文字直接消失。人物变量被其他脚本覆盖，任务进度数值错乱，任务变量尽量使用独立M段变量，不和其他功能共用变量。

扩展文本相关功能，增加任务对话动画文字，NPC对话逐字显示任务剧情。增加任务指引标记，点击任务面板目标文字自动寻路到目标怪物或者NPC坐标。增加任务剧情弹窗，任务关键节点弹出剧情图片搭配文本。增加任务日志，每一步任务节点自动写入任务日志文本，玩家可以打开任务日志查看第二章全部剧情记录。全部文本配置完成，多账号测试接取、进度增长、交付、失败、分支切换场景，确认标签渲染正常，进度同步更新，不会出现面板空白、文字错乱的情况。