传奇3K引擎龙卫心法自创武功完整脚本实现与命令详解

龙卫心法自创武功系统在3K引擎中的脚本实现分为五个模块：入门试炼、心法领悟、自创命名、强化技能、师门系统。核心命令是CHECKSKILLLEVEL和ReadSkillNG，前者检测心法等级，后者触发领悟流程，配合QFunction-0.txt中的多个触发段完成整个闭环。

## 入门试炼与心法领悟

等级达到50级的玩家可在酒馆龙卫信使处参加试炼。试炼共三轮，一轮为安全地图，二三轮为普通地图，死亡会掉落装备，每个试炼地图允许免费复活3次。

试炼完成后进入心法领悟阶段。核心脚本如下：

```plaintext
[@main]
#IF
CHECKLEVELEX > 49
CHECKQUEST 龙卫试炼完成
#SAY
你已完成龙卫手记的试炼，可以参悟龙卫手记了。\
<参悟龙卫手记/@领悟心法>\

#ELSESAY
你还没有完成龙卫试炼，无法参悟心法。\

[@领悟心法]
#IF
CHECKSKILLLEVEL 龙卫心法 = 0
#ACT
ReadSkillNG 龙卫心法
SENDMSG 0 玩家[%s]成功领悟龙卫心法，踏入龙卫境界！
#ELSESAY
你已经领悟过龙卫心法了。\
```

ReadSkillNG命令触发心法领悟流程，引擎内部将龙卫心法技能的等级从0提升到1，同时激活龙卫境界状态。CHECKSKILLLEVEL检测心法当前等级，参数格式为`CHECKSKILLLEVEL 技能名 操作符 等级值`。

学习心法后，攻魔道属性上限变为原来的1.5倍，并获得神圣属性加成，心法等级越高加成越多。施展自创心法技能进入龙卫境界需要内力值多于20000点，且在龙卫境界下每秒消耗内力。

## 自创心法命名

学会心法后，玩家需要为自己的自创心法命名。这个名字会显示在心法界面的神技页签下，玩家可以给该技能设置快捷键。

3K引擎通过输入框命令接收玩家输入的名称，存储到变量中：

```plaintext
[@命名心法]
#IF
CHECKSKILLLEVEL 龙卫心法 > 0
CHECKVAR HUMAN 心法名称 = 0
#SAY
请为你的自创心法命名：\
<输入名称/@@InPutString50>\\

[@CallInPutString50]
#IF
CHECKVAR HUMAN 心法名称 = 0
#ACT
MOV HUMAN 心法名称 <$STR(S50)>
SAVEVAR HUMAN 心法名称 ..\QuestDiary\心法数据\心法名称.txt
SENDMSG 6 你的自创心法已命名为：<$STR(S50)>
```

3K引擎中`@@InPutString50`直接跳转到`[@CallInPutString50]`标签，输入内容存储在字符串变量S50中。MOV HUMAN命令将S50的值赋给自定义变量“心法名称”，SAVEVAR HUMAN持久化保存到文件。

心法名称存入变量后，可以通过脚本命令显示在技能快捷栏或人物状态界面。部分版本需要在客户端UI中配置心法名称显示位置，将变量值嵌入到对应的界面元素中。

## 强化技能脚本

心法等级达到要求后，强化技能不需要额外学习，只需重复使用对应技能即可自动领悟到相应重数。

脚本中通过CHECKSKILLLEVEL检测心法等级，控制强化技能的解锁：

```plaintext
[@强化技能]
#IF
CHECKSKILLLEVEL 龙卫心法 > 4
#SAY
你的心法等级已可强化刺杀剑术到一重。\
持续使用刺杀剑术即可领悟强化效果。\

#IF
CHECKSKILLLEVEL 龙卫心法 > 9
#SAY
你的心法等级已可强化攻杀剑术到二重。\

#IF
CHECKSKILLLEVEL 龙卫心法 > 14
#SAY
你的心法等级已可强化烈火剑法到一重。\
```

各职业可强化的技能范围不同。战士对应攻杀剑术、圆月弯刀、刺杀剑术、烈火剑法、逐日剑法；法师对应雷电术、疾光电影、火墙、灭天火、流星火雨、冰咆哮；道士对应施毒术、灵魂火符、召唤骷髅、召唤圣兽、噬血术、神圣战甲术、幽灵盾。

实际强化逻辑由引擎内部处理，NPC脚本只负责显示当前可强化的技能列表和等级要求。强化重数随技能使用次数自动累积，不需要在脚本中编写计数逻辑。

## QFunction-0.txt触发段配置

龙卫心法系统依赖QFunction-0.txt中的多个触发段处理技能升级、心法类型更换等事件。

心法升级触发：

```plaintext
[@HeartLevelUp]
#IF
CHECKSKILLLEVEL 龙卫心法 > 0
#ACT
SENDMSG 6 你的龙卫心法升级了！当前等级：<$SKILLLEVEL(龙卫心法)>
```

更换心法类型触发，用于多心法版本中玩家切换修炼路线的场景：

```plaintext
[@ChangeHeartType]
#IF
#ACT
SendMsg 5 你更换了心法类型:<$STR(N0)>
SAVEVAR HUMAN 心法类型 <$STR(N0)> ..\QuestDiary\心法数据\心法类型.txt
```

更换心法类型时，引擎将新类型保存到N0变量中，脚本通过SendMsg通知玩家并持久化存储。

## 师门系统与传承心法

玩家学会心法后可以创建师门传授心法，未满999级且无宗派的玩家可通过拜入师门学习师父传承的心法。

创建师门的核心脚本：

```plaintext
[@创建师门]
#IF
CHECKSKILLLEVEL 龙卫心法 > 9
CHECKVAR HUMAN 师门名称 = 0
#SAY
你的心法等级已达10级，可以创建师门。\
<输入师门名称/@@InPutString51>\\

[@CallInPutString51]
#IF
CHECKVAR HUMAN 师门名称 = 0
#ACT
MOV HUMAN 师门名称 <$STR(S51)>
SAVEVAR HUMAN 师门名称 ..\QuestDiary\心法数据\师门名称.txt
MOV G600 <$USERNAME>
SENDMSG 0 玩家[%s]创建了师门【<$STR(S51)>】，广收门徒传承心法！
```

师门人气值通过除魔任务积累，每完成一次除魔任务获得1点师门人气，完成一轮（5次）额外获得10点。人气值用于兑换师门称号。

```plaintext
[@师门称号]
#IF
CHECKVAR HUMAN 师门人气 > 99
#SAY
你的师门人气已达<$HUMAN(师门人气)>点，可以兑换师门称号。\
<兑换称号/@兑换称号>\

[@兑换称号]
#IF
CHECKVAR HUMAN 师门人气 > 99
#ACT
DEC HUMAN 师门人气 100
SAVEVAR HUMAN 师门人气 ..\QuestDiary\心法数据\师门人气.txt
GIVE 师门称号凭证 1
SENDMSG 6 你消耗100点师门人气兑换了师门称号凭证。
```

## 心法经验与龙卫境界控制

心法经验的吸收依赖火龙果。玩家累积的心法经验借助火龙果的法力吸收进入丹田，达到一定数量后心法等级提升。火龙果的经验转换比例在M2控制台的选项→功能设置→技能魔法→龙卫心法中可以调整，10000点经验可以转换为1点心法经验。

龙卫境界的进入和退出通过内力值控制。施展自创心法技能时内力值必须多于20000点，境界状态下每秒消耗内力，内力归零自动退出，再次点击自创心法技能快捷键也会退出境界。

脚本中可以通过CHECKNGLEVEL检测内力等级，结合条件判断控制龙卫境界相关功能的开放：

```plaintext
[@龙卫境界检测]
#IF
CHECKNGLEVEL > 1
CHECKSKILLLEVEL 龙卫心法 > 0
#SAY
你已满足龙卫境界的进入条件。\
内力值需多于20000点方可施展自创心法技能。\
```

## 数据库与M2配置要点

心法技能需要在Magic.DB中注册记录。技能DB中龙卫心法的MagID字段值参考格式为：`299;龙卫心法;0;0;1000;25;25`，具体字段值需根据版本调整。

火龙守护兽和恶魔蝙蝠必须在M2中设置为禁止清理怪物，否则试炼地图中的任务怪会被自动清理命令清除。

心法等级上限需要在M2的功能设置中设定。固定心法等级上限后，技能DB中的属性值按固定公式计算，修改上限后所有等级的属性都会重新计算，需要同步调整技能DB中的数值。

心法等级高的玩家对心法等级低或无心法的玩家造成5%额外伤害，这个压制效果由引擎自动处理，不需要在脚本中编写判断逻辑。

## 常见问题排查

心法无法领悟，首先检查ReadSkillNG命令中技能名称是否与Magic.DB中的完全一致。其次确认玩家等级是否达到要求，以及试炼任务是否已完成。试炼完成标记通常用CHECKQUEST检测，任务标记需要在任务系统中正确设置。

自创心法命名后快捷栏没有显示，检查客户端UI配置中是否将心法名称变量嵌入到技能快捷栏元素中。部分版本需要额外配置客户端补丁才能显示自定义名称。

强化技能不生效，确认心法等级是否达到对应技能的最低要求。强化技能由引擎自动处理，不需要脚本干预，但如果心法等级不够，引擎不会触发强化效果。在M2控制台中检查技能魔法设置中的龙卫心法相关参数是否正确配置。

师门人气值不增加，检查除魔任务的触发脚本中是否包含了人气值增加的CALCVAR HUMAN命令。人气值的增加逻辑写在除魔任务的QFunction触发段中，与龙卫心法NPC脚本是分开的两个模块。