GM后台货币、物品日志
1.引擎添加日志
查看-列表信息-游戏功能列表-日志过滤
点击全部增加


2.导出物品列表
路径：\Mir200\Envir\DB\cfg_item.xls


键值对功能
SetStrValue命令，修改字符型变量主键值对应值 ([23.11.01.10]引擎)
注意：此命令是方便拆分数据,$996开头的变量下线后不会保存！！！
参数说明

脚本命令: SetStrValue	是否可省略	值范围	说明
参数一	否	文本	字符串变量名 支持S A s$无限字符变量 Human(Var个人字符变量) Global(Var全局字符变量) Guild(Var行会字符变量)
参数二	否	文本	键名 为*表示批量运算
参数三	否	文本	操作符（+,-,*,/,\,%,=） 参数五为0时只有+ = 除法向下取整 / 除法向上取整 \
参数四	否	数值或文本	键值 参数五决定 参数二为*时格式为 A=1|B=2 分隔符与参数一使用的相同
参数五	是	数值	类型 0:字符 1:数值 默认1
参数六	是	文本	分隔符 默认“|”
字符型键值对，清除变量示例

SetStrValue S$键值对2 键名1 = NULL 0 |
SENDMSG 7 <$STR(S$键值对2)>
参数二为*时，使用示例

mov S0 键名1=NULL|键名2=NULL
SetStrValue S$键值对2 * = S0 1 |
SENDMSG 7 <$STR(S$键值对2)>|
字符串数据结构
键名1=键值1|键名2=键值2

示例1：键值为数值型
[@SetStrValue]
#IF
True
#ACT
mov S$键值对1 键名1=7|键名2=3|键名3=14|键名4=2
SetStrValue S$键值对1 键名4 - 1 1 |
SENDMSG 7 <$STR(S$键值对1)>
SENDMSG 7 <$996(S$键值对1).键名1>|<$996(S$键值对1).键名2>|<$996(S$键值对1).键名3>|<$996(S$键值对1).键名4>
示例2：键值为字符型
[@SetStrValue]
#IF
True
#ACT
SetStrValue S$键值对2 键名1 = 键值为1 0 |
SetStrValue S$键值对2 键名2 = 键值为2 0 |
SetStrValue S$键值对2 键名3 = 键值为3 0 |
SetStrValue S$键值对2 键名4 = 键值为4 0 |
SENDMSG 7 <$STR(S$键值对2)>
SENDMSG 7 <$996(S$键值对2).键名1>|<$996(S$键值对2).键名2>|<$996(S$键值对2).键名3>|<$996(S$键值对2).键名4>
示例3：
[@SetStrValue]
#IF
TRUE
#ACT
Mov S0 等级=1*经验=100*攻击=1000
Mov S1 等级=10*经验=10*攻击=10
SetStrValue S0 * \ S1 1 *
SendMsg 5 <$Str(S0)>---<$996(S0).经验>---<$996(S0).等级>
Break
输出结果为：等级=1*经验=10*攻击=100---10---1

CalcVar HUMAN 武器镶嵌 = 屠龙刀=10|倚天剑=100
SetStrValue HUMAN|武器镶嵌 屠龙刀 + 50 1 |
SetStrValue HUMAN|武器镶嵌 倚天剑 - 50 1 |
SendMsg 5 HUMAN-----<$HUMAN(武器镶嵌)>----<$996(HUMAN|武器镶嵌).屠龙刀>-<$996(HUMAN|武器镶嵌).倚天剑>

CalcVar GLOBAL 男战士 = 等级=1|经验=100
SetStrValue GLOBAL|男战士 经验 + 50 1 |
SetStrValue GLOBAL|男战士 等级 + 150 1 |
SendMsg 5 GLOBAL----<$GLOBAL(男战士)>----<$996(GLOBAL|男战士).经验>

CalcVar GUILD 穿云箭 = 攻击=1|防御=100
SetStrValue GUILD|穿云箭 攻击 + 50 1 |
SetStrValue GUILD|穿云箭 防御 - 50 1 |
SetStrValue GUILD|穿云箭 等级 + 150 1 |
SendMsg 5 GUILD----<$GUILD(穿云箭)>----<$996(GUILD|穿云箭).攻击>-<$996(GUILD|穿云箭).防御>-<$996(GUILD|穿云箭).等级>

MOV A$无限变量名 屠龙刀=10|倚天剑=100|裁决=150
SetStrValue A$无限变量名 倚天剑 - 34 1 |
SetStrValue A$无限变量名 屠龙刀 + 34 1 |
SENDMSG  5 <$str(A$无限变量名)>-<$996(A$无限变量名).屠龙刀>

SENDMSG 5 --完整键值对-<$996(A$无限变量名).0=str>--键-<$996(A$无限变量名).0=key>--值-<$996(A$无限变量名).0=value>----获取序号-<$996(A$无限变量名).倚天剑=getindex>
;0=str  1=key  2=value  倚天剑=getindex
;0 1 2:指定的序号  从0开始,只能是数字
;=str  =key  =value  =getindex: 固定内容   倚天剑是获取序号时指定的键名
文本设置为NULL 可清空删除

SetStrValue S$键值对2 键名1 = 键值为1 0 |
SetStrValue S$键值对2 键名2 = 键值为2 0 |
SENDMSG 7 <$STR(S$键值对2)>

SetStrValue S$键值对2 键名1 = NULL 0 |
SENDMSG 7 <$STR(S$键值对2)>

mov S0 键名1=NULL|键名2=NULL
SetStrValue S$键值对2 * = S0 1 |
SENDMSG 7 <$STR(S$键值对2)>|
SortStrValue命令，键值对排序 ([23.11.01.10]引擎)
脚本命令: SortStrValue	是否可省略	值范围	说明
参数一	否	文本	字符串变量名 支持S A s$无限字符变量 Human(Var个人字符变量) Global(Var全局字符变量) Guild(Var行会字符变量)
参数二	否	数值	比较位置 从0开始
参数三	否	数值	排序方式 0=从大到小 1=从小到大
参数四	是	文本	一级分隔符 默认“|”
参数五	是	文本	二级分隔符 默认=
说明：排序只支持数值,文本默认转换为0   数值为0时不保留

一级分隔符为：|
二级分隔符为：=

示例1：
[@SetStrValue]
#IF
TRUE
#ACT
Mov S0 张三=gg=10|李四=hgh=5|王五=llj=12
SortStrValue S0 2 0 | =
Break

以|为分隔符将字符串分为 张三=gg=10  李四=hgh=5  王五=llj=12  三组
每组中以=为分隔符取第3个数值作为比较值  按照从大到小进行排序，排序后S0的值为：王五=llj=12|张三=gg=10|李四=hgh=5

CalcVar GUILD 穿云箭 = 攻击=1|防御=100
SortStrValue GUILD|穿云箭 1 0 | =
SendMsg 5 GUILD-<$GUILD(穿云箭)>
新增 CalcVar参数6，设置键值对分割符，同时格式化键值对 ([24.11.01.01]引擎)
#act
calcvar HUMAN 寄言 = 等级=1|经验=100 1 |
SendMsg 5 HUMAN****<$996(HUMAN|寄言).经验>|<$996(HUMAN|寄言).等级>|<$996(HUMAN|寄言).攻击>-----<$996(HUMAN|寄言).AllKeys>----<$996(HUMAN|寄言).KeyCount>
新增 MOV参数3，设置键值对分割符，同时格式化键值对 ([24.11.01.01]引擎)
#act
MOV A$功勋回收 风云腰带=3|圣战项链=10|生成标识=1 |
SendMsg 5 -<$996(A$功勋回收).风云腰带>-<$996[A$功勋回收].圣战项链>-<$996[A$功勋回收].生成标识>---<$996(A$功勋回收).AllKeys>----<$996(A$功勋回收).KeyCount>



镖车系统说明

增加镖车系统

MP：为镖车提示位置间隔时间，单位：秒
DC：为镖车攻击真实伤害，百分比掉血！非人物攻击镖车的伤害
MC：等级控制。小于MC等级的玩家攻击镖车会触发反弹功能！
SC：反弹比例。设置50则表示玩家攻击镖车的伤害50%会减少自己的HP！
镖车受到伤害最多掉1%血量，少于1%则掉实际血量！
例如：
镖车血量为10000点，如果受到烈火伤害为500，则最多掉1%为100点。10000-100=9900
如果受到普攻伤害为50 ，则直接减少实际血量，10000-50=9950

数据库配置
新增怪物RACE类型：215 为镖车专用AI！

经验镖车;215;19;482;1000;1;0;5;1;1000;30;40;45;5;0;0;0;10;12;1000;1;800;2000;0;0;0;
自己将无法攻击以及挡住自己的镖车！

脚本参数
新增镖车路线功能设置！扩展 MOBPLACE 命令，增加参数4
参数4：增加刷出怪物血量！

[@biaoche2] 
SETPARAM 0 467,228 //设置镖车行走坐标1
SETPARAM 1 376,322 //设置镖车行走坐标2
SETPARAM 2 436,390 //设置镖车行走坐标3
SETPARAM 3 441,505 //设置镖车行走坐标4
SETPARAM 4 430,526 //设置镖车行走坐标5
SETPARAM 5 378,580 //设置镖车行走坐标6
MISSION SELF 378 580 //设置镖车终点坐标
PARAM1 479 //设置镖车出生坐标X
PARAM2 218 //设置镖车出生坐标y
PARAM3 1 //设置镖车数量
PARAM4 0 //设置镖车出生地图
PARAM5 6 //设置镖车行走坐标数量 
MOBPLACE 经验镖车 996经验镖车 小白 1000
SENDMSG 5 本次刷出镖车增加了1000点HP值！
镖车坐标间隔触发
新增镖车坐标间隔触发机器人脚本！

[@_镖车定时触发]
#ACT
$PARAM(0) //镖车原名字
$PARAM(1) //押镖人的名字
$PARAM(2) //地图名字
$PARAM(3) //地图X
$PARAM(4) //地图Y
$PARAM(5) //镖车血量百分比 
$PARAM(6) //镖车真实血量
镖车到达终点触发
新增镖车到达终点触发机器人脚本！

[@_镖车到达终点]
#ACT
$PARAM(0) //镖车原名字
$PARAM(1) //押镖人的名字
$PARAM(2) //地图名字
$PARAM(3) //镖车血量百分比 
$PARAM(4) //镖车真实血量
镖车掉血触发
增加镖车掉血触发机器人RobotManage.txt脚本 [@_镖车掉血触发]！
//怪物DB设置AC为触发条件，AC为10则表示每减少10%触发一次！

[@_镖车掉血触发]
#ACT
$PARAM(0) //镖车原名字
$PARAM(1) //押镖人的名字
$PARAM(2) //地图名字
$PARAM(3) //地图X
$PARAM(4) //地图Y
$PARAM(5) //镖车血量百分比 
$PARAM(6) //镖车真实血量
镖车死亡触发
增加镖车死亡触发机器人RobotManage.txt脚本 [@_镖车死亡触发]！

;Mir200\Envir\Robot_def\RobotManage.txt
[@_镖车死亡触发]
#IF
True
#ACT
SENDMSG 16 <$PARAM(0)>|镖车原名字
SENDMSG 16 <$PARAM(1)>|押镖人的名字
SENDMSG 16 <$PARAM(2)>|地图名字
SENDMSG 16 <$PARAM(3)>|地图X
SENDMSG 16 <$PARAM(4)>|地图Y
SENDMSG 16 <$PARAM(6)>|镖车真实血量


怪物爆率系统
爆率系统说明
    1. 支持爆率文件  #CALL方式
    以下是采用#call设置怪物爆率
    刀犬.txt
    #CALL [\爆率系统\基础爆率.txt] @武器
    以上是怪物爆率文件中刀犬设置
    D:\996Server\Mir200\Envir\QuestDiary\爆率系统\基础爆率.txt
    [@武器]
    {
        1/1    匕首 1 H $STR(S$爆出者信息) = 无 $USERNAME
    }
    2. 扩展爆率文件格式，用于调整是否作用于翻倍爆率命令！
    1/200 *神秘灵匣 //前面加 * 表示不计算爆率翻倍
    1/200 *神秘灵匣|黄金灵匣 //格式二 表示这组物品都不计算翻倍
    3. 多物品爆率&权重爆率格式1/5 圣战戒指|法神戒指|天尊戒指 　;//多物品爆率老格式 
    1/5 圣战戒指,50|法神戒指,40|天尊戒指,30 ;//权重爆率格式 
    说明有1/5的概率掉落一个后面设置的物品。
    权重爆率，物品后设置数值越高，爆出的概率越大，权重最大支持21亿。
    爆率格式，兼容老的，同时也支持权重格式，自由选择使用。
    使用权重设置后，某些怪物爆率，可以设置的更加细致。
    例：1/5 金币 1000 
    1/10 圣战戒指,50|法神戒指,40|天尊戒指,3
    1/15 天魔战甲|圣战战甲|法神披风|法神羽衣|天尊道袍
    4. 扩展怪物爆率文本格式！
    1)、新的爆率格式(兼容老的爆率格式，不写就是老的爆率模式)
    1/x 装备名称 数量 对象类型(H/G) 检测变量 检测符(<、>、=, \ , /, ! ) 检测数值 扣除数值(正数为加，负数为减) 
    \ 大于等于
    / 小于等于
    ! 不等于
    例如：
    1/1 血煞头盔 1 H $LEVEL > 50 //等级大于50级，则会掉落此装备
    1/1 血煞项链 1 H $STR(S88) = 爆物达人 //S88变量为爆物达人，则会掉落此装备
    1/1 血煞项链 1 H $STR(M88) > 100 10 //M88变量大于100时，爆出物品后，M88变量+10
    1/1 血煞项链 1 H $STR(D88) > 100 -20 //D88变量大于100时，爆出物品后，D88变量-20
    1/1 血煞项链 1 H $STR(P88) > 100 -30 //P88变量大于100时，爆出物品后，P88变量-30
    说明：支持所有的个人变量检测，目前支持整数型扣除变量如下：
    $HUMAN(X)
    $GUILD(X)
    $CLAN(X)
    $TABLE(X).Y
    $CUSTOMVALUE(X)
    N$
    G$
    注意：全局变量只支持以下变量，整数型变量支持扣除。
    $GLOBAL(X)
    $STR(G)
    $STR(I)
    为全局变量检测时，H为杀死怪物对象必须是玩家，G为不检测杀死对象
    1/1 血煞靴子 1 H $STR(G99) > 100 -1 //只能是玩家杀死怪物后，检测G99大于100 爆出物品后，G99变量-1
    1/1 血煞靴子 1 G $STR(G99) > 100 -1 //无论是玩家或大刀卫士，或是玩家释放火墙、火雨技能下线后，杀死的怪物满足条件均会爆出
    同时也支持多个物品设置：
    1/1 血煞靴子|血煞手镯|血煞戒指 1 H $STR(G99) > 100 -1 //只能是玩家杀死怪物后，检测G99大于100 爆出物品后，G99变量-1
    1/1 血煞靴子|血煞手镯|血煞戒指 1 G $STR(G99) > 100 -1 //无论是玩家或大刀卫士，或是玩家释放火墙、火雨技能下线后，杀死的怪物满足条件均会爆出
    2)、字符型变量只支持=号检测，全局变量目前只支持以上3个类型！
扩展怪物爆率脚本
 1/1    匕首 1 @触发脚本

 返回变量
 $996(MonDropItem).X   坐标X
 $996(MonDropItem).Y   坐标Y
 $996(MonDropItem).MAP   地图名字
 $996(MonDropItem).ITEMNAME   爆出的物品名字
 $996(MonDropItem).COUNT   数量
 $996(MonDropItem).dropname  怪物名字

 该脚本下如果执行 Stop的话 将不会爆出该物品

 [@触发脚本]
 #ACT
 Stop
 SENDMSG 5 <$996(MonDropItem).x>-<$996(MonDropItem).y>-<$996(MonDropItem).map>-<$996(MonDropItem).itemname>-<$996(MonDropItem).count>-<$996(MonDropItem).dropname>



马匹捕捉和骑乘
骑马系统 － 马鞭抓马
只要装备了马鞭，打野马时将有1/10的概率抓马成功，要求野马的名称和可骑的马名称一样。
抓马成功后，将触发QF中的[@抓马成功]脚本
注意：战士职业抓马如果有问题时，把内挂中战斗里的技能全部取消掉,然后小退一下再进行抓马。
手机端黄金宝马默认客户端没有modelinfo.json和monster.json的配置,需要使用的可以自己去增加一个
骑马系统 － DB设置
怪物DB：

枣红马1;52;11;151;12;254;0;5;1;1000;0;0;0;0;0;0;0;0;4;1400;3;0;3000;0;;0;
乌骓1;52;11;153;12;254;0;5;1;1000;0;0;0;0;0;0;0;0;4;1400;1;0;3000;0;;0;
雪龙1;52;11;152;12;254;0;5;1;1000;0;0;0;0;0;0;0;0;4;1400;1;0;3000;0;;0;
枣红马;52;11;161;12;254;0;5;1;1000;0;0;0;0;0;0;0;0;4;1400;3;0;3000;0;;0;
乌骓;52;11;163;12;254;0;5;1;1000;0;0;0;0;0;0;0;0;4;1400;1;0;3000;0;;0;
雪龙;52;11;162;12;254;0;5;1;1000;0;0;0;0;0;0;0;0;4;1400;1;0;3000;0;;0;
高头大马;52;11;164;15;254;0;5;1;2000;0;0;0;0;0;0;0;12;4;1400;1;0;3000;0;;0;
迎亲宝马;52;11;164;15;254;0;5;1;2000;0;0;0;0;0;0;0;12;4;1400;1;0;3000;0;;0;
黄金宝马;52;11;165;15;254;0;5;1;2000;0;0;0;0;0;0;0;12;4;1400;1;0;3000;0;;0;
幽影铁骑;52;11;475;12;254;0;5;5000;100000;0;0;0;0;0;0;0;0;4;1400;3;0;3000;0;;0;;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0
赤炎追风;52;11;476;12;254;0;5;5000;100000;0;0;0;0;0;0;0;0;4;1400;3;0;3000;0;;0;;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0
踏雪银驹;52;11;477;12;254;0;5;5000;100000;0;0;0;0;0;0;0;0;4;1400;3;0;3000;0;;0;;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0
物品DB：

131;马牌;33;0;0;0;0;0;258;20000;0;0;0;0;0;0;0;0;0;0;0;0;0;20;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;8000;5;0;0  
132;马牌(空);32;0;0;0;0;0;259;0;0;0;0;0;0;0;0;0;0;0;0;0;0;20;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;8000;5;0;0
马牌(空)绑定一匹马
A B C

命令参数

参数	含义
A	物品序列号
B	马的名字
C	马的类型.分别表示5种
1:枣红马
2:雪龙
3:乌骓
4:高头大马
5:黄金宝马
命令说明

本命令用于马牌(空)绑定一匹马。

例：

[@马牌]
#ACT
Give 马牌 1
SETHORSENAME $PARAM(10) 黄金宝马 5
相关变量
<$HORSETYPE> 表示当前人物释放出来的马，或者刚抓到的马的类型;
<$HORSENAME>表示当前人物释放出来的马，或者刚抓到的马的名字;

例

[@抓马成功]
#ACT
SENDMSG 7 ---<$HORSETYPE>----马的类型
SENDMSG 7 ---<$HORSENAME>---马的名字
不戴马牌，一键骑马命令：AutoRideHorse 参数一 参数二
说明：若骑马失败在.\Mir200\996Log\script_*.txt中查看日志

    脚本命令: AutoRideHorse    是否可省略    值范围    说明
    参数一：马的类型 1-9
    参数二：AniCount 55表示高级马 (默认0,可省略)

    说明：读取 cfg_horse.xls 表格配置，根据id来上马。

    示例1：
    [@骑马]
    #IF
    TRUE
    #ACT
    AutoRideHorse 1
    BREAK

引导功能系统说明
打开或者关闭指定窗体
脚本命令: OpenUi	是否可省略	值范围	说明
窗口ID	否	数值	每个窗口都有对应的ID，有详细说明见下表
状态	否	数值	1：表示打开2：表示关闭
任务ID	非任务窗口时可省略	数值	窗口ID=1时 表示任务栏 本位置填写任务ID ，任务之外的窗口 无需填写此参数
例子：
[@打开界面] 
#IF
#ACT
OpenUi 101 1
SendMsg 6 打开了装备栏面板


[@任务状态打开界面] 
#IF
#ACT
OpenUi 1 1
SendMsg 6 打开了任务栏面板


[@关闭界面] 
#IF
#ACT
OpenUi 1 2
SendMsg 6 关闭了任务栏面板
窗口ID说明
窗口ID	说明
1	特殊: 任务栏任务界面,比如: 拥有一个任务ID为10的任务,则是OpenUi 1 1 10,关闭则是OpenUi 1 2 10
2011	包裹一
2012	包裹二
2013	包裹三
2031	灵兽包裹一
2032	灵兽包裹二
1905	摆摊
1202	行会 （未加入行会不会打开）
1299	行会申请界面
520	排行榜
401	邮件
如果后台关闭了邮件功能,在使用OPENUI 401 脚本将不会打开邮件界面 并且触发 QF标签 @OPEN401
1604	设置
1601	系统
1603	战斗
1602	拾取
1605	怪物
1606	cocospc 保护
1101	小地图
402	好友
801	组队
101	装备栏
103	装备属性栏
104	技能栏
1401	技能配置栏
1402	骑战技能
88	右侧功能区旋转收缩按钮
881	顶部自定义按钮的收缩按钮
750	商城
1901	拍卖行
108	灵兽界面
111	盒子礼包
61	交易行
65	客服系统
998	仓库
151	元神包裹
152	元神技能
153	元神装备
调出手机QQ或者微信
脚本命令 SendForQQWX 参数一 参数二
功能: 手游专用命令 调出手机QQ或者微信

脚本命令: SendForQQWX	是否可省略	值范围	说明
类型	否	数值	1= 拉起QQ 2=QQ好友 3=QQ群 4=微信
值	否	数值	QQ号 或者 QQ群KEY
[@拉QQ]
#IF
#ACT
SENDFORQQWX 1

[@QQ好友]
#IF
#ACT
SENDFORQQWX 2 QQ好友的QQ号

[@QQ群]
#IF
#ACT
SENDFORQQWX 3 QQ群号 QQ群key

[@微信]
#IF
#ACT
SENDFORQQWX 4

QQ群号和 KEY获取地址：https://qun.qq.com/join.html
让角色自动寻路到一个坐标点
GoPlace 参数1 参数2 参数3 参数4
脚本命令: GoPlace	是否可省略	值范围	说明
坐标X	否	数值	目标地址X
坐标Y	否	数值	目标地址Y
自动战斗	是	数值	到达目地是否自动战斗1=是
是否使用飞行靴	是	数值	1=使用飞行靴 点击触发QFunction-0.txt [@FastMove]
自动走到指定坐标的NPC面前并打开NPC
GoNpc 参数1 参数2 参数3
自动走到指定坐标的NPC面前并打开NPC 只能相同地图, 坐标请填写NPC坐标
脚本命令: GoNpc	是否可省略	值范围	说明
坐标X	否	数值	目标地址X
坐标Y	否	数值	目标地址Y
是否使用飞行靴	是	数值	1=使用飞行靴 点击触发QFunction-0.txt [@FastMove]
增加检测脚本命令 CanArrive
CanArrive 参数1 参数2
用于检测指定坐标是否为地图阻挡点 只能支持当前地图
脚本命令: CanArrive	是否可省略	值范围	说明
参数一	否	数值	地图坐标X
参数二	否	数值	地图坐标Y
引导动画命令
脚本命令: Navigation	是否可省略	值范围	说明
界面ID	否	数值	界面ID
按钮ID	否	文本	按钮ID(每个界面自己定义的ID)
提示文字	否	文本	引导文字提示#ID标识#文字位置ID标识和文字位置可省略 id说明:点击本引导消息后 将会触发QF功能脚本下标签 [@Navigation] 返回参数：$996(Navigation).1 表示id 位置说明:1-8分别代表 从左至右 从上往下依次排列的区域
遮罩层	是	数值	隐藏(0),显示(1) 显示遮罩层 默认不显示
倒计时	是	数值	倒计时，时间结束自动点击 默认为0不倒计时
提示文字扩展说明:

参数三扩展增加#id#位置(1-8)
id说明:点击本引导消息后 将会触发QF功能脚本下标签 [@Navigation]
返回参数：
$996(Navigation).1 //界面ID
$996(Navigation).2 //组件ID
$996(Navigation).3 //参数三中的ID
位置说明:1-8分别代表 从左至右 从上往下依次排列的区域
示例:
#ACT
Navigation 100 0 请打开包裹#996#1
Break
点击包裹指引后会触发QFunction-0.txt [@Navigation] $996(Navigation).1 返回id：996 自行安排用途
界面ID说明

界面ID	说明	按钮ID	说明
100	背包		
101	攻击模式按钮		
200	切换按钮		
201	右侧功能区展开后的定义按钮	按钮ID	
202	右侧功能区自定义按钮	按钮ID	
150	战斗设置		
151	拾取设置		
152	设置界面		
153	排行榜按钮		
154	小地图按钮		
155	切换走跑模式的按钮		
156	角色按钮		
158	宠物按钮		
1	会先选中设置按钮，然后选中怪物页签		
19	顶部自定义按钮	按钮ID	
1500	快捷栏	快捷栏物品makeindex	框选快捷栏指定物品
301	背包物品	背包物品makeindex	框选包裹指定物品
160	任务	任务ID	框选指定ID的任务区域
161	cocospc任务	任务ID	框选指定ID的任务区域
80	npc界面	组件ID	组件id 不可重复
302	骑马操作快捷图标	0或者1	骑马按钮引导
303	背包自定义组件	组件id	
304	小地图界面自定义组件	组件id	
305	技能栏自定义组件	组件id	
306	技能配置自定义组件	组件id	
307	装备栏自定义组件	组件id	
308	他人装备栏自定义组件	组件id	　
1011~1019	101~109 SendUI自定义组件	组件id	　
1202	元神头像区域	1=元神包裹
2=元神技能	　


装备弹窗功能
物品弹窗功能(快捷佩戴某个装备或者使用某个道具)
FastUse 参数一 参数二 参数三 参数四 参数五 参数六
功能: 弹出一个窗体 显示物品信息 带一个按钮 可用于 立即装备之类的功能

触发: 点击确定触发 QFunction-0 下 [@FastUse] 点击关闭触发 [@FastUseClose]

脚本命令: FastUse	是否可省略	值范围	说明
编号	否	数值	触发编号
物品信息	否	数值或文本	物品MakeIndex 或者 物品名字
标题	否	文本	弹窗标题
按钮名字	否	文本	按钮名字
描述文字	否	文本	描述文字
倒计时	是	数值	倒计时后自动触发标签 不填或者填0 只能手动确定
返回变量
$996(FASTUSE).1 物品MakeIndex 有名字时此参数为0
$996(FASTUSE).2 编号
$996(FASTUSE).3 物品数据库名字 有MakeIndex时此参数为空
[@test]
#ACT
Fastuse 1 裁决 弹窗标题 按钮名字 描述文字 15

QF:
[@Fastuse]
#ACT
SENDMSG 6 你点击的佩戴
BREAK

[@Fastuseclose]
#ACT
SENDMSG 7 <$996(FASTUSE).1>\<$996(FASTUSE).2>\<$996(FASTUSE).3>
客户端内置判断
如果启用客户端自动判断弹窗,需要配置 cfg_global.json文件内140001,即可开启客户端自动配置

   "140000": {
        "name": "装备对比和自动使用",
        "desc": "值为1,则客户端自动处理,脚本自动穿戴不会响应,为0则启用脚本自动穿戴----此功能开启,装备对比箭头会根据配置的cfg_goods.json来展示",
        "id": 140000,
        "value": 1
    },
"140001": {
        "name": "自动穿戴弹窗内容配置",
        "desc": "根据格式通配自动使用弹窗内容,只有在140000值为1的时候才能生效",
        "id": 140001,
        "value": "提示#立即穿戴#0"
启用后,会根据cfg_goods.json文件配置的内容,客户端自动判断是否弹窗提示穿戴,格式:

{
  "格式示例": ["参数一:职业0、1、2、99", "参数二:评级"],
  "桃木剑": [99, 99],
  "屠龙刀": [0, 1],
  "雷裂刀": [0, 5]
}


夺宝(标记)功能说明
夺宝功能详解
SetArrow A B C D E
参数	释义
A	执行的总时间
B	@执行的总标签
C	物品名字
D	间隔执行的时间
E	@间隔执行的标签
命令说明
A时间内C物品没有掉落则执行B标签,并且每间隔D时间执行一次E标签

补充说明
CLEARARROW X
清除指定物品的检测记录，x是物品名字，如果不指定，则为清除所有检测记录

例
;=========夺宝奇兵===============
[@dropitem120]
#ACT
CLEARARROW 宝盒
SENDMSG 15 宝盒掉落在%m(%x,%y)地图，只要捡起来并守护宝盒20分钟不掉落，就能获得夺宝大奖哦！
break

[@pickupitem120]
#IF
CHECKITEM 宝盒 1
CHECKMAPNAME NLDB
#ACT
MOV D2 20
SENDMSG 0 (*)宝盒已经在%m(%x，%y)被%s检起
SENDMSG 9 『夺宝骑兵』:『%S』携带宝盒出现在%m(%x，%y)，宝盒藏有高级玩家梦寐以求的道具和技能，只有抢到宝盒的人才有机会获得！
SENDMSG 7 (*)从现在开始:保持宝盒在你身上20分钟，宝盒就会自动打开！到时你将获得各种宝物！
SENDMSG 7 (*)携带宝盒的时候，不能使用各种移动卷轴，不能离开本地图！离开本地图活动结束！努力吧！力争20分钟！
SetArrow 20 @DKBHOK 宝盒 1 @BHJGHH
break

[@BHJGHH]
#IF
CHECKITEM 宝盒 1
#ACT
DEC D2 1
SENDMSG 0 (*)%s携带宝盒出现在%m(%x，%y)，宝盒藏有高级玩家梦寐以求的道具和技能，只有抢到宝盒并保持20分钟不掉的人才有机会获得。
SENDMSG 7 加油啊！再坚持[<$STR(D2)>]分钟，宝盒中的宝物便可属于你了... 
break

[@DKBHOK]
#ACT
CLEARARROW 宝盒
#CALL [\游戏活动\夺宝奖励.txt] @获得宝盒奖励
break


向手机端发送图形验证码
参数说明：
SendVerify	说明
参数一	操作倒计时,单位秒
参数二	允许错误次数（0为不限制）
 ;QF相关触发标签如下：
  ;验证通过触发
  [@VerifyOn]
  #IF
  True
  #ACT
  SendMsg 7 验证通过,祝您游戏愉快!
  Break

  ;超时触发
  [@VerifyNot]
  #IF
  True
  #ACT
  SendMsg 5 超时未操作
  BREAK

  ;验证错误
  [@VerifyError]
  #IF
  True
  #ACT
  SendMsg 7 验证错误,连续错误设定的次数将被踢下线
  Break


寻路地图自定义显示图标
AddMapTips
AddMapTips A#B C D E F G H
寻路地图界面指定坐标添加图标
参数说明：

AddMapTips	说明
参数A	地图号
参数B	TIPS唯一ID,自定义的数字标识
参数C	x
参数D	y
参数E	图标素材编号（位于interface中）,手游res/picpackage/3
参数F	设置调取的tips的内容模板编号
参数G	对象类型：0=自己 1=组队 2=行会 3=当前地图玩家 4=范围内所有玩家
参数H	范围。参数G=4时 需要设置，否则可忽略
PS:
映射方式一：
[<0>new 新中州]，此映射方式增加的新地图依旧会使用原地图的小地图配置，所以要让新地图正常显示小地图需要配置原地图
这种方式添加MapTips，地图号需填原地图号
映射方式二：
[0|new 新中州]，此映射方式增加的新地图将会是独立的地图，可以独立配置小地图
这种方式添加MapTips，可以填映射后的地图号
客户端MapTips配置
手游端调取的tips,配置文件:cfg_maptips.json

PC端调取的tips,配置文件:MapTipsCfg.xml

点击图标触发服务端QF标签 [@MapTips]
[@MapTips]
#ACT
SENDMSG 7 <$996(MapTips).M>|地图号
SENDMSG 7 <$996(MapTips).ID>|Tips唯一ID
SENDMSG 7 <$996(MapTips).x>|x
SENDMSG 7 <$996(MapTips).y>|y
SENDMSG 7 <$996(MapTips).pic>|图标编号
SENDMSG 7 <$996(MapTips).sign>|标识
DelMapTips A#B C D
删除寻路地图界面的指定图标
参数说明：

AddMapTips	说明
参数A	地图号
参数B	TIPS唯一ID,自定义的数字标识
参数C	对象类型：0=自己 1=组队 2=行会 3=当前地图玩家 4=范围内所有玩家
参数D	范围。参数D=4时 需要设置，否则可忽略
AddMapTipsEX
AddMapTipsEx A B C D E F G
寻路地图界面指定坐标添加NPC组件
参数说明：

AddMapTipsEx	说明
参数A	地图号
参数B	坐标X
参数C	坐标Y
参数D	NPC组件
参数E	唯一ID
参数F	对像类型：0=自己 1=组队 2=行会 3=当前地图玩家 4=范围内所有玩家
参数G	范围。参数F=4时 需要设置，否则可忽略
DelMapTipsEx A B C D E F G
删除寻路地图界面指定id的maptips组件
参数说明：

DelMapTipsEx	说明
参数A	地图号
参数B	唯一ID
参数C	对像类型：0=自己 1=组队 2=行会 3=当前地图玩家 4=范围内所有玩家
参数D	范围。参数C=4时 需要设置，否则可忽略
例：

[@加maptipsEX]
#IF
True
#ACT
AddMapTipsEx L006 25 25 <Button|ax=0.5|ay=0.5|nimg=public/button/btn_close_01.png|color=255|size=18|text=<[测试用的NPC]>|link=@发送消息> 33 0
[@删maptipsEX]
#IF
True
#ACT
DelMapTipsEX L006 33 0

;QFunction.txt
;组件link的标签名需加到FunLableList.txt中
[@发送消息]
#IF
True
#ACT
INC N$发送消息次数 1
SENDMSG 5 QF发送消息|<$STR(N$发送消息次数)>



新cooldown和delay说明
Cooldown为单技能CD，技能的Delay为公共CD（与原来一致），技能图标倒计时会综合Delay和Cooldown进行计算显示
公共CD(Delay)：使用技能后在这个技能的Delay时间内，不可以使用任何技能(包括当前技能)，也不能进行其他动作(移动、平砍)，即使施法动画播放完毕。
单技能CD（Cooldown）：使用技能后在这个技能的Cooldown时间内不允许再次使用这个技能（其他技能不限制）
由于每个技能都会带有一个Delay和Cooldown，所以在使用任何一个技能后都会产生一个公共的CD和单技能CD
每个技能都会在公共CD和单技能CD之间取一个最大值作为最终的CD时间
例如：
狂龙紫电：Delay=1200 Cooldown=0
移形换影：Delay=1800 Cooldown=60000
使用狂龙紫电后狂龙紫电的最终CD是1200，移形换影也会有一个1200的最终CD
使用移形换影后狂龙紫电的最终CD是1800，移形换影的最终CD是60000（Cooldown > Delay）
注意：不可以将所有的技能Delay设置成0，会出现技能连发的情况，一般设置1000左右。

例如：小火球、雷电术、狂龙紫电的Delay都是0，不管Cooldown是多少都可以将三个技能同时使用，因为它们之间没有公共CD
注意：也尽量不要让技能Cooldown小于delay，否则持续攻击时，可能没有空隙释放其他技能

例如：野蛮冲撞的delay=8000，cooldown=0，这样野蛮冲撞完之后，会原地罚站，直到8秒CD结束。


自定义事件上报功能
自定义事件上报功能
新版本追加引擎内置上报事件,后台有开关控制
解锁技能
技能升级
NPC点击
手持装备
进入地图
创建行会
加入行会
退出行会
沙城战申请
战斗死亡
使用祝福油 stdmode=3 shap=4的固定物品
击杀Boss MonGen.txt里地图带*的为所在地图对应的Boss,参数6和参数9必须是1
商店购买 打开默认商城购买物品(openui 750 1),配置文件 Mir200\Envir\WolShop.txt
客户端版本号：
1.6版本选 1000606-009 及更高版本
1.7版本选 1000704-005 及更高版本, 1000705-015及更高版本包含boxid处理
母包版本号: 传世_Android_1.6版_250123_通用版
引擎版本号：NR24.11.01.01.018Pro NR24.11.01.01.019 NR24.11.01.01.019KF NR24.11.01.01.020 及以后的版本, 匹配最新的后台开关, 支持diymsgevtign过滤事件; 如果是2026年02月03日之前更新的以上引擎版本,需再更新一次引擎

有需求，在以下页面申请或联系商务开通


自定义行为上报
SENDDIYMSG
参数		类型
参数一	str	json
例子:当前需求内容是上报创建行会
img

游戏中代码上报行创建行会

    [@CheckBuildGuild]
    #act
    SENDDIYMSG {"event_name":"guild_create","map":{"servid":"<$SERVERID>","server_name":"<$SERVERNAME>","role_id":"<$USERID>","role_name":"<$USERNAME>","role_level":"<$LEVEL>","job_id":"<$JOB>","job_name":"1","guild_id":"2","guild_name":"行会名称"}}
    SENDMSG 6 上报事件创建行会
上面的代码可能看起来不清晰,把内容格式化后查看
以下是格式化后的上报内容

{
    "event_name": "guild_create",
    "map": {
        "servid": "<$SERVERID>",
        "server_name": "<$SERVERNAME>",
        "role_id": "<$USERID>",
        "role_name": "<$USERNAME>",
        "role_level": "<$LEVEL>",
        "job_id": "<$JOB>",
        "job_name": "1",
        "guild_id": "2",
        "guild_name": "行会名称"
    }
}
需要注意下,这里的格式xxxx为代理填写,其他两个"event_name"和"map"是固定的,上报什么内容有GM自由控制,但格式必须正确
{
    "event_name": "xxxx",
    "map": {
        "xxxx"
    }
}
引擎版本号：NR24.11.01.01.018Pro NR24.11.01.01.019 NR24.11.01.01.019KF NR24.11.01.01.020 及以后的版本

手机端版本:1000605-019(1.6.536)

PC端版本:1.6.5.8

注意:上报数据为JSON格式,如果是游戏中的常量,一定要加引号,具体看上方例子




器魂系统
命令参数
UpgradeUserItem 物品唯一ID 属性位 操作符(+,-,=) 数值
属性位：
203 = 器魂等级(0-255)
204 = 器魂经验(0-65535)
205 = 器魂类型(0-255)
器魂只是Tips显示，具体属性请自行实现
手游配置文件：
配置文件：data_config\cfg_forsoul.json

自定素材：dev\res\picpackage\3\01682.png dev\res\picpackage\3\01683.png 自定义素材放到这里

默认素材：mod_fgcq\stab\res\public\bg_jindutiaod_01 mod_fgcq\stab\res\public\bg_hp_01 没有自定义素材，默认读这两个素材。

{
  "LevelUpExp" :
  {
      "器魂类型": [1级器魂升级所需经验, 2级器魂升级所需经验, 3级器魂升级所需经验, 4级器魂升级所需经验],
      "2": [400,1000,3000, 5000]
  },
  "Equip" :
  {
      "装备名字": {"1":"1级器魂属性说明", "2":"2级器魂属性说明", "3":"3级器魂属性说明"},
      "裁决": {"1":"魔防上限增加：3点", "2":"生命上限增加：100点", "3":"韧性和耐力增加：4点", "4":"韧性和耐力增加：47777点"}
  }
}
示例：

{
  "LevelUpExp" :
  {
      "1": [50, 100, 150, 200],
      "2": [400,1000,3000, 5000]
  },
  "Equip" :
  {
      "圣战戒指": {"1":"攻击上限增加：1点", "2":"生命上限增加：10点", "3":"狂战属性增加：3点"},
      "裁决": {"1":"魔防上限增加：3点", "2":"生命上限增加：100点", "3":"韧性和耐力增加：4点", "4":"韧性和耐力增加：47777点"}
  }
}
PC端配置文件：996Woool\xml\ForsoulCfg.xml
对应进度条素材：interface 01682、01683

<?xml version="1.0" encoding="gb2312" standalone="yes"?>
<SoulLevelUpExp Ver="1">
  <!-- <LevelUpExp>

      <level value="器魂类型" exp1="1级器魂升级所需经验" exp2="2级器魂升级所需经验" exp3="3级器魂升级所需经验" exp4="4级器魂升级所需经验" exp5="5级器魂升级所需经验"/>

      <level value="21" exp1="60000" exp2="100000" exp3="150000" exp4="200000"/>

  </LevelUpExp>
  <Equip>

      <goods name="装备名字" level1="1级器魂属性说明" level2="2级器魂属性说明" level3="3级器魂属性说明" level4="4级器魂属性说明" level5="5级器魂属性说明"/>

      <goods name="圣战戒指" level1="攻击上限增加：10点" level2="生命上限增加：100点" level3="防御属性增加：30点" level4="幸运属性增加：3点" level5="狂暴属性增加：3点"/>

  </Equip> -->
  <LevelUpExp>
      <level value="1" exp1="50" exp2="100" exp3="150" exp4="200" />
      <level value="2" exp1="50" exp2="100" exp3="150" exp4="200" />
      <level value="3" exp1="50" exp2="100" exp3="150" exp4="200" />
      <level value="4" exp1="50" exp2="100" exp3="150" exp4="200" />
      <level value="5" exp1="50" exp2="100" exp3="150" exp4="200" />
      <level value="6" exp1="50" exp2="100" exp3="150" exp4="200" />
      <level value="7" exp1="400" exp2="1000" exp3="3000" exp4="50000" />
  </LevelUpExp>
  <Equip>
      <goods name="圣战戒指" level1="攻击上限增加：1点" level2="生命上限增加：10点" level3="狂战属性增加：3点" />
      <goods name="圣战手镯" level1="攻击上限增加：1点" level2="生命上限增加：10点" level3="狂战属性增加：3点" />
      <goods name="圣战头盔" level1="魔防上限增加：4点" level2="生命上限增加：15点" level3="韧性和耐力增加：4点" />
      <goods name="圣战项链" level1="攻击上限增加：2点" level2="魔法躲避增加：5%" level3="狂战属性增加：3点" />
      <goods name="圣战靴子" level1="魔防上限增加：3点" level2="生命上限增加：10点" level3="韧性和耐力增加：4点" />
      <goods name="圣战腰带" level1="魔防上限增加：3点" level2="生命上限增加：10点" level3="韧性和耐力增加：4点" />
      <goods name="裁决" level1="魔防上限增加：3点" level2="生命上限增加：10点" level3="韧性和耐力增加：4点" />
  </Equip>
</SoulLevelUpExp>


游戏充值接入
游戏充值接入
PullPay A B C D E

脚本命令: PullPay	是否可省略	值范围	说明
金额	否	数值	自己填
充值方式	否	数值	1.支付宝 2.花呗 3.微信 ,填写1即可
货币ID	否	数值	货币ID (这里的货币ID必须后台已经配置好的ID)
宽度	是	数值	客户端拉起充值窗体时的宽度(PC专用，手游可忽略)
高度	是	数值	客户端拉起充值窗体时的高度(PC专用，手游可忽略)
示例脚本:
;拉起一个元宝充值,充值金额:10元
[@Main]
#IF
True
#ACT
Pullpay 10 1 2 400 400
Break
　
;弹出充值界面，玩家支付成功后自动到账并触发QFunction-0.txt [@ReCharge]
;大额订单功能支持 触发QFunction-0.txt [@BigCharge]    (仅支持正式区)
;扶持订单收到后 触发 QFunction-0.txt [@FcCharge] 在线直达，离线上线后直接获取    (仅支持正式区)


设置临时地图光圈
设置临时地图光圈脚本命令 SetMapLightZone A B C D E F
脚本说明
脚本命令: SetMapLightZone	是否可省略	值范围	说明
地图号	否	数值	地图号
坐标X	否	数值	坐标X
坐标Y	否	数值	坐标Y
半径范围	否	数值	10000以下为方形区域，10000以上为圆形区域
持续时间	否	数值	单位:秒 0=永久 -1=消失
光圈类型	否	数值	自己测试
当前半径范围只支持方形区域

脚本示例
[@临时地图光圈脚本命令]
#IF
True
#ACT
SetMapLightZone 0 100 100 50 100  1
Break


服务端常量说明
20210818
[Engine]
增加常量功能
Envir 新建目录 Defines
Defines\ 可任意新建文本文件 如 1.txt
文本格式如下
说明
#DEFINE    MAINMSG    这地方是做药品买卖的，你需要点什么？\当然，如果你要的是可卡因或其他之类\精神药品的话，我们可不卖。\

说明
#DEFINE 常量名  常量内容
NPC调用方式

脚本示例
(@buy )
%100
+0
+42
#INCLUDE 1.txt
[@main]
#IF
True
#SAY
MAINMSG\ \
 <BUYITEMMSG/@buy>\
 <SELLITEMMSG/@sell>\ \


注意 调用此常量时 前面必须要有 

#IF
TRUE
#SAY

或者

#IF
TRUE
#Act

邮件系统
给当前角色发送自定义邮件
发送邮件必须先使用MailGive 配置邮件需要发送的物品，最多支持6个，每个物品需要单独用MailGive配置，

之后再使用SendMail命令来统一发送设置的邮件物品

注意:每个邮件附带物品总数量不能超过包裹格子，否则无法取出，叠加物品会按照实际个数计算

获取自定义邮件ID:<$LASTMAILOPTYPEID>

MailGive A B C

参数	释义
A	设置邮件发送的道具
B	设置邮件发送道具的数量
C	设置邮件内道具是否绑定（1为绑定，0代表不绑定，为0可省略）
SendMail A B C

参数说明：

参数	释义
A	自定义邮件ID (0-20000)不要使用9997或9999,已被系统占用
B	邮件标题
C	邮件内文字内容
例:

[@发送邮件福利]
 #IF
 TRUE
 #ACT
 MailGIve 裁决 1 1
 MailGive 骨玉 2
 MailGIve 龙纹 2 1
 SENDMAIL 1 系统奖励 恭喜您获得本次新手奖励，请点提取
 break
邮件在QFunction-0.txt的相关触发,阅读邮件触发qf[@ReadMail] ，提取邮件触发qf[@GetMailItem]
;阅读触发
[@ReadMail] 
#IF
EQUAL <$LASTMAILOPTYPEID> 1
#ACT
SENDMSG 0 你阅读了ID:<$LASTMAILOPTYPEID>的邮件

;提取触发
[@GetMailItem] 
#IF
EQUAL <$LASTMAILOPTYPEID> 1
#ACT
SENDMSG 0 你提取了ID:<$LASTMAILOPTYPEID>的邮件
给离线玩家发送邮件
脚本命令: SendLXMail	是否可省略	值范围	说明
A	否	数值	自定义邮件ID (0-20000) 不要使用9997或9999,已被系统占用
B	否	文本	邮件标题
C	否	文本	邮件内文字内容
D	否	文本	离线玩家角色名
E	否	文本	邮件物品内容
[@离线玩家发送邮件示例]
#IF
TRUE
#ACT
SENDLXMAIL 1 系统奖励 恭喜您获得本次新手奖励,请点提取 又见一帘幽梦 349,1,1|353,2,0|352,2,1
;又见一帘幽梦 表示离线玩家的角色名
;349,1,1|353,2,0|352,2,1  按照 A物品ID,A物品数量,是否绑定|B物品ID,B物品数量,是否绑定|C物品ID,C物品数量,是否绑定 固定格式拼接邮件内容,不可省略,一次最多支持6种物品
break



权重取值功能
RandomStr
可用于随机发放道具奖励

权重列表：裁决,10|骨玉,30|龙纹,50    以|为分隔 取到第一组的几率=10/90 第二组几率=30/90 第三组几率=50/90
权重列表支持变量  
返回变量名  指定变量名 文本型  返回第一串字符 例 裁决,10 返回  裁决  
示例:
#IF
True
#ACT
RandomStr 裁决,10|骨玉,30|龙纹,50 S1
Give $STR(S1) 1
SendMsg 5 你获得了<$STR(S1)>


时长功能
新增以下返回变量
$PaymentPoint //返回玩家剩余点卡时间

新增命令 PaymentPoint 参数1 参数2
用于调整玩家点卡时间

参数1：操作符(+、-、=)
参数2：数值

[@示范脚本]
#ACT
PaymentPoint + 108000
SENDMSG 5 游戏时间增加30小时
玩家点卡时间到期后触发QF脚本中 [@点卡到期]
更新支持时长版计费功能，可在引擎面板勾选开启时长模式；
选项 — 参数设置 — 点卡模式
扣点间隔：表示引擎每次间隔多少秒扣除玩家游戏点
扣点点数：表示引擎每次扣除玩家多少游戏点
精力参数：表示扣除玩家多少游戏点增加1点精力值
试玩等级设置
试玩模式是否使用仓库
试玩等级不计费 低于试玩等级登陆时 触发 QF @点卡试玩

增加地图参数 PAYMENTPOINTRATE(X) 代表点卡扣除的倍数 默认为 1 填0的时候地图不扣点卡

游戏配置顶戴花翎

自定义顶戴花翎(头顶封号)

增加人物顶戴花翎效果
ADDFH 参数1 参数2 参数3 参数4 参数5 参数6

脚本命令: AddFh	是否可省略	值范围	说明
参数一	否	数值	顶戴花翎(头顶封号) 所处的位置
参数二	否	数值	图包编号　( 例:Texture1.wpf内的INTERFACE项 则此处参数填写为3 )
参数三	否	数值	素材编号　( 选择的素材在参数2图包编号内的位置 )
参数四	否	数值	当前素材显示的X坐标
参数五	否	数值	当前素材显示的Y坐标
参数六	是	文本	HUM，NPC，MON，BaoBao
不填参数六默认当前角色
HUM，不写参数7 就是当前玩家
NPC，不写参数7就是当前NPC
MON，不写参数7就是刚刷的全部怪物
BAOBAO，不写参数7就是当前玩家的全部宝宝
参数七	是	数值	目标的ID
删除人物顶戴花翎效果
DELFH 参数一 参数二

脚本命令: DELFH	是否可省略	值范围	说明
参数一	否	数值	顶戴花翎(头顶封号) 所处的位置
参数二	是	文本	HUM，NPC，MON，BaoBao
不填参数六默认当前角色
HUM，不写参数7 就是当前玩家
NPC，不写参数7就是当前NPC
MON，不写参数7就是刚刷的全部怪物
BAOBAO，不写参数7就是当前玩家的全部宝宝
参数三	是	数值	目标的ID
脚本示范：

[@开启顶戴花翎]
#ACT
ADDFH 0 3 39504 -110 -50
BREAK
顶戴花翎追加参数
ADDFH 位置[0-2] 图包编号 素材编号 偏移X 偏移Y 个人或NPC(HUM,NPC)

范例
个人封号

ADDFH 0 3 13800 23 -15 或 ADDFH 0 3 13800 23 -15 HUM
NPC封号

ADDFH 0 3 13800 23 -15 NPC

此命令只能支持点击NPC后显示

NPC封号配置文件用于NPC初始化列表使用

文件路径: Envir\FengHaoCfg.txt
该文件配置NPC出生头顶封号功能

格式如下：

[FengHaoNum]
Num= 配置总数
[编号] 此编号从1开始 可以通过MerChant.txt进行调用
packid= 图包号
ImgIndex= 素材号
x= 偏移X
y= 偏移Y
open= 是否开启
例：

[FengHaoNum]
Num=2

[1]
packid=3
ImgIndex=13807
x=23
y=-15
open=1

[2]
packid=3
ImgIndex=13800
x=23
y=-15
open=1
扩展NPC初始化列表MerChant.txt 支持封号初始化定义 新增三个封号标识该标识读取FengHaoCfg.ini对应配置项 不需要填0或者为空

;文件名 地图名 坐标X 坐标Y NPC显示名称 NPC标识 形象代码 是否沙城NPC NPC是否可移动 NPC移动间隔时间 封号1 封号2 封号3
封号NPC  dengdai 39 36  老兵\【攻沙时间20-21点】$250\测试颜色$249\测试颜色2$248 0  32  0  0  0  2   0   0
封号NPC2 dengdai 37 36 新区接待员            0 32 0 0   0  1   0   0
视频教程传送门:顶戴花翎


GM自定义日志
AddLog 参数一 参数二 …..
用于添加GM自定义日志可在网站后台 - GM日志查询

参数说明：
脚本命令: AddLog	是否可省略	值范围	说明
参数一	否	数值	自定义数值 可做为日志后台分类使用方便查询
参数二	否	文本	日志内容自定义
参数三	是	数值	日志内容自定义
参数四	是	数值	日志内容自定义
参数五	是	数值	日志内容自定义
参数六	是	数值	日志内容自定义
参数七	是	数值	日志内容自定义
参数八	是	数值	日志内容自定义
参数九	是	数值	日志内容自定义
参数十	是	数值	日志内容自定义


复制内容到玩家剪切板
PC客户端玩家保存文字到剪切板里 玩家可以通过粘贴到其他位置

可以用于类似序列号获取 或者其他方面使用 支持变量

手机端在WIN32上无效，需要在APP才有效

[@MAIN]
#ACT
MOV S1 测试文字复制内容
#SAY
<点我复制内容/@@copyright&{$STR(S1)}>


游戏打开网址功能
游戏打开网址说明:
PC客户端:
<打开网页测试/@@url http://www.996m2.com>
手游客户端:
使用脚本命令执行打开:

脚本命令: OpenWeb	是否可省略	值范围	说明
参数一	否	字符	网页地址(前面必需要加 http://)

[@example]
#ACT
OpenWeb http://www.996m2.com
BREAK


临时NPC的添加命令
增加临时NPC
Mobnpc A B C D E

命令参数

参数	含义
A	Npc的名字
B	读取Market_def里脚本文件，支持同读，且支持2级目录
C	外形
D(x,y)	D = 地图号
x = x坐标
y = y坐标
E	有效时间，单位为秒，时间到后Npc消失
命令说明

临时生成一个NPC，并且加载脚本，指定时间后消失
此命令用作有镜像地图标识 CANMIRROR 参数的地图 地图号使用SELF
同一个坐标点刷出NPC后,不可再次刷出
使用示例

[@MobNpc]
#ACT
MobNpc 黄金宝箱 黄金宝箱 47 0(460,215) 120 ;//此格式NPC脚本文件需要地图号;
MobNpc 黄金宝箱 同读<黄金宝箱> 47 0(460,215) 120  ;//此格式NPC脚本文件不需要地图号;
MobNpc 黄金宝箱 同读<特殊功能\黄金宝箱> 47  0(460,215) 120 ;//此格式NPC脚本文件不需要地图号;
删除临时NPC
DelNpc M X Y

命令参数

参数	含义
M	地图号
X	坐标X
Y	坐标Y
命令说明

临时删除指定位置的NPC
使用示例

[@delNpc]
#IF
True
#ACT
DelNpc $M 460 215
SENDMSG 7 临时NPC已经删除
视频教程传送门:创造临时NPC


长短时间格式互相转换
长短时间格式互相转换
变量	说明
$LONGTODATETIME(时间戳)	可以将一个时间戳($LONGTIME)返回成时间格式
$DATETIMETOLONG(时间格式)	可以将一个指定的时间格式返回为时间戳
$DATETIME	返回日期格式更改为 2022-01-14 00:00:00
可以直接让 $DATETIMETOLONG(时间格式) 调用
$LONGDATE	返回一个当前时间的时间戳


脚本嵌入For循环功能
脚本嵌入For循环功能
增加脚本For 参数一 参数二 参数三 支持脚本内条件循环 为防止无限死循环 目前上限 10000次 超过10000次自动停止

增加脚本EndFor脚本内条件循环结束位置

For循环里面不要使用goto跳转出去判断

脚本命令: FOR	是否可省略	值范围	说明
参数一	是	数值	变量/值
参数二	是	符号	操作符说明 >大于 <小于 =等于 !不等于 \大于等
参数三	是	数值	变量/值 当条件当达到后停止循环
注意：1、循环内不能增加条件检测 2、不能套二次循环 3、不能在循环内用GOTO

[@MAIN]
<111/@111> <222/@222> <$STR(N1)>
; ******************************************尽可能不要用这种写法，递归调用容易产生栈溢出
[@111]
#IF
SMALL M1 2000
#ACT
Inc M1 1
SendMsg 6 > $STR(M1)>
GOTO @111
BREAK
;这种脚本GOTO多时有可能产生这样的问题。换成新的写法，用 FOR / ENDFOR
; ★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★★推荐这种写法
[@222]
#IF
#ACT
;为方便测试每次执行脚本前将变量设置为1
MOV M1 1
;开始计时
STARTTIMER 1
;循环开始，FOR 变量/值 比较符号(> < =) 变量/值；循环写在 #ACT中 条件达到时自动停止循环往后执行
FOR M1 > 1000
Inc M1 1
EndFor
;循环结束 EndFor
STOPTIMER 1 P10
;结束计时,耗时保存到P10里
SENDMSG 5 循环结束了<$STR(M1)>-耗时-<$STR(P10)>


任务系统配置说明

任务系统

任务系统配置
任务列表Envir\Task.txt
说明文件内容为各任务的定义文件名，每个任务名字占一行
前面为读取Envir\Task\任务文件(文件名以Task.txt中定义的任务名,必须一致)
任务文件配置，存放所有任务定义，
配置如下：Envir\Task\寻找失落的鬼王刀.txt
[setup]
;主任务标题  显示在客户端树型框主题标上
MainTitle=初入江湖
;主任务ID值
MainID=1
;是否为主线任务 0=主线 1=支线 客户端会自动在该任务标题前增加上(主) (支)  文字进行区分
IsMain=0
;本任务内几个步骤
stepcount = 17
;任务标题
title=新手的训练
;任务ID值
ID = 1
;任务描述
stepDESC1 = <color=graygolden 任务目的：> <color=green  去购物商场处他会给你丰厚奖励！>\<color=graygolden 任务介绍: > <color=green  不需要任何物品只要你去了就会给你东西哟！>\\<color=graygolden 任务奖励：> <@@!PIC2 10,951>经验：14000 <@@!PIC2 10,229>金币：5000\\<去购物商场/@@goto 7 购物商场 53,31>  <color=red 这个是自动跑任务坐标>
;主界面小任务框里的标题
stepstitle1 =  <去购物商场/@@goto 7 购物商场 53,31>  <color=red 这个是自动跑任务坐标>
;任务管理界面内的图片ID值
stepPic1  =26100
任务相关命令
变量名	参数	作用
AddTask A	A=TaskID	增加一个任务
DelTask A	A= TaskID	取消一个任务
取消任务后触发QFunction-0.txt中的[@CancelTask]
UpdateTask A B	A=TaskID
B=Step	更新任务步骤
EndTask A	A=TaskID	完成一个任务
HasTask A B C	A=TaskID
B=TaskID(可省略)	检查当前人物是否开始执行指定的任务
B有参数则代表检测是否拥有参数A到参数B之间的任务
参数3:返回拥有的那个任务ID
[@示范]
#IF
HasTask 1 10 P5
#ACT
SendMsg 5 你已经有Task(1-10)任务在身!所拥有的任务ID:<$STR(P5)>
Break
上表参数关键词说明

参数	解释
TaskID	任务文件中定义的ID值
Step	任务的当前步骤
任务相关变量
变量	参数	说明
$TASK(n)	n=TaskID	返回指定任务的进度步骤
$TASKSTEPCOUNT(n)	n=TaskID	返回指定任务总步骤数
$TASKVAL(n).I0 - $TASKVAL(n).I9	n=TaskID	指定ID的任务专属的10个整数变量
$TASKVAL(n).S0 - $TASKVAL(n).S9	n=TaskID	指定ID的任务专属的10个字符变量
脚本调整任务专属变量：

SetTaskValue A B C D

参数说明：

A //任务ID
B //变量名称(I0~I9，S0~S9)
C //操作符号，支持(+、-、=)
D //具体操作的数值
例：
#ACT
SetTaskValue 34 I0 = 100
SetTaskValue 34 S0 = 任务信息
SENDMSG 7 当前任务变量测试：<$TASKVAL(34).I0>，<$TASKVAL(34).S0>
任务特殊标签
以下标签写在任务配置的描述或者标题里,点击指定标签会执行对应的事件
(特殊说明,这里的标签格式是固定的,和脚本命令gonpc、goplace是两回事,不要混为一谈)

标签格式	标签说明	标签示例
<label/@@goto A B C,D>	在地图寻路到某个NPC并打开这个NPC
label=显示标签文字
A=地图号
B=NPC
C=NPC的X坐标
D=NPC的Y坐标	寻找<老兵/@@goto 0 老兵 471,222>
<label/@@goplace A B,C>	在地图寻路到某个坐标点
label=显示标签文字
A=地图号
B=前往的X坐标
C=前往的Y坐标	前往坐标<239,239/@@goto 1 239,239>
注意:地图号必须大写!

手游点击任务触发
手游点击任务区域内容非标签部分会触发功能脚本Qfunction.txt里的[@任务触发]

变量返回任务ID:$996(TASK).1

任务事件配置补充
传送门:任务事件配置说明

自定义任务框模式
MainTitle = 测试任务
MainID=52
IsMain=0
stepcount = 4
title = 用来测试的任务-52
ID = 52

stepstitle1 = <RText|children=1|x=5|y=0|width=211|bg=1|color=108|size=18|text=<用来测试的任务-52/@第一个标签>\去找<落霞村屠夫/@@goto 1 铁匠 228,262><color=blue 帮><color=149 他><color=253 磨><color=graygolden 刀>>
stepstitle2 = <RText|children=1|x=5|y=0|width=211|bg=1|color=108|size=18|text=<用来测试的任务-52/@第一个标签>\去找<落霞村铁匠/@@goto 1 铁匠 227,216>磨刀>
stepstitle3 = <RText|children=1|x=5|y=0|width=211|bg=1|color=108|size=18|text=<用来测试的任务-52/@第一个标签>\把磨好的刀子还给<落霞村屠夫/@@goto 1 屠夫 228,262>>
stepstitle4 = <RText|children=1|x=5|y=0|width=211|bg=1|color=108|size=18|text=<用来测试的任务-52/@第一个标签>\去<村子西门口/@@goplace 1 235,269>杀鹿\挖1个鹿肉\把肉送给<落霞村屠夫/@@goto 1 屠夫 228,262>>

stepDESC1 = <RText|id=1|x=0|y=0|color=108|size=18|text=任务目的：><RText|id=2|x=0|y=20|size=16|text=去找<落霞村屠夫/@@goto 1 屠夫 228,262>帮他磨刀><RText|id=3|x=0|y=40|color=108|size=18|text=任务奖励：><RText|id=4|x=0|y=60|size=16|text=磨损的刀子\经验：1000\绑定金币：15000\><RText|id=5|x=0|y=120|color=108|size=18|text=任务介绍：><RText|id=6|x=0|y=140|size=16|text=村里的屠夫最近愁眉苦脸，似乎需要帮助，你去看看吧。他就在村子中央的肉铺<（228：262）/@@goto 1 屠夫 228,262>，那个胖子就是他了。>
stepDESC2 = <RText|id=1|x=0|y=0|width=320|size=18|text=<color=graygolden 任务目的：>\去找<落霞村铁匠/@@goto 1 铁匠 227,216>磨刀\<color=graygolden 任务奖励：>\锋利的刀子\<color=graygolden 任务介绍：>\近来生意兴隆，每天客户盈门，我都忙得没时间去铁匠铺打磨杀鹿刀了。能否麻烦你帮我去找铁匠打磨一下刀子呢？我会酬谢你的。他就在村子西门附近的铁匠铺<（227：216）/@@goto 1 铁匠 227,216>。>
stepDESC3 = <RText|id=1|x=0|y=0|width=320|size=18|text=<color=graygolden 任务目的：>\把磨好的刀子还给<落霞村屠夫/@@goto 1 屠夫 228,262>\<color=graygolden 任务奖励：>\经验：2000\绑定金币：15000\<color=graygolden 任务介绍：>\刀子已经帮你磨好了，看你初来乍到，就照顾你，不收钱了。快把磨好的刀子送还给<屠夫/@@goto 1 屠夫 228,262>吧，他等得着急呢！>
stepDESC4 = <RText|id=1|x=0|y=0|width=320|size=18|text=<color=graygolden 任务目的：>\去<村子西门口/@@goplace 1 230,340>杀鹿挖1个鹿肉送给<落霞村屠夫/@@goto 1 屠夫 228,262>\<color=graygolden 任务奖励：>\幻彩戒指×2\经验：3000\<color=graygolden 任务介绍：>\谢谢你，年轻人，作为报酬就送你些零钱吧。落霞村里一年一度的庆祝节日到了，鹿肉有些供不应求，能不能帮忙找些品质高的鹿肉来，村子周围有很多鹿跑来跑去的。<color=green 你杀死鹿><color=green 之后，将鼠标放在鹿的尸体上面，按住ALT+鼠标左键，就可以获得鹿肉了>。提示：需要任意品质的鹿肉1块。>
stepPic1 = 301
stepPic2 = 302
stepPic3 = 303
stepPic4 = 304


通区功能
通区变量功能
仅支持全局变量 UpdateTongVar 参数一(全局变量 G A I 无限全局变量)

区服一
[@Main]
<变量通区测试/@变量通区>
[@变量通区]
#IF
True
#ACT
MOV A$无限变量名 无限全局变量同步
UPDATETONGVAR A$无限变量名
Break
其他区服
[@输出变量]
#if
true
#act
SENDMSG  5 <$str(A$无限变量名)>
文本通区功能
代理后台配置,单版本可以文本通区,不可以2个不一样的版本通区

该功能为  设定好的 同一个游戏下的 多个区服进行文本实时同步作用
//;通区创建和删除文本
TongFile  参数1 参数2          
参数1：(0创建文件  1删除文件) 
参数2：文件名称       如：aaa.txt
//;通区同步文本
UpDateTongFile 参数1 参数2  
参数1：文件名称 如：aaa.txt                    
参数2：同步的文件名 (如：bbb.txt) 到参数1文本           ;参数2留空默认同步参数1文件名
//;更改文件内容
ChangeTongFile 参数1 参数2 参数3 参数4
参数1：文件名字(最大16中文)
参数2：内容(最大64中文字符)
参数3：指定操作行
参数4：0 =文件尾追加内容(快) ; 1 =插入内容到指定行 ; 2=替换内容到指定行; 3=删除指定行内容; 4=清空整个文件内容
//;例子
[@新建文件]
#IF
#ACT
TongFile 0 ..\QuestDiary\996m2.txt
Break
[@删除文件]
#IF
#ACT
TongFile 1 ..\QuestDiary\996m2.txt
Break
[@同步目标文件]
#IF
#ACT
UpDateTongFile ..\QuestDiary\996m2.txt ..\QuestDiary\bbb.txt
Break
[@同步当前文件]
#IF
#ACT
UpDateTongFile ..\QuestDiary\996m2.txt
Break
[@InPutString22]
#IF
#ACT
ChangeTongFile ..\QuestDiary\996m2.txt <$STR(S22)> 1 0
Break


循环调用标签
LoopGoto
脚本命令: LoopGoto	是否可省略	值范围	说明
参数一	否	文本	循环执行的标签名
参数二	否	文本	循环次数(1<= Num < 10000)
注: 支持多层循环及退出单层循环(BREAK、STOP)

脚本示例
[@LoopGoto]
#IF
TRUE
#ACT
MOV P2 0
MOV P3 0
LoopGoto @AAAA  20
SENDMSG 7 dsjkhfsjdkh

[@AAAA]
#IF
TRUE
#ACT
SENDMSG 5 AAAAA_<$STR(P2)>
INC P2 1
MOV P3 0
LoopGoto @BBBB  20

[@AAAA_END]
#IF
TRUE
#ACT
SENDMSG 7 AAAAA_<$STR(P2)>-IS_End

[@BBBB]
#if
small P3 6
#ACT
SENDMSG 5 BBBB_<$STR(P3)>
INC P3 1
#elseact
stop

[@BBBB_END]
#IF
TRUE
#ACT
SENDMSG 7 BBBBB<$STR(P3)>-IS_End



添加Buff图标显示
AddBuffIcon 参数一 参数二 参数三 参数四
仅是图标显示实际Buff效果请自行脚本实现

AddBuffIcon	是否可省略	数值类型	说明
参数一	否	整数	Buff分组编号
参数二	否	整数	Buff编号(同分组同编号的Buff会覆盖)
参数三	否	整数	buff时长(单位:秒)
参数四	是	文本	触发标签名(倒计时结束后触发QFunction-0.txt指定的标签)
DelBuffIcon 参数一 参数二
删除指定Buff图标

DelBuffIcon	是否可省略	数值类型	说明
参数一	否	整数	Buff分组编号
参数二	否	整数	Buff编号



服务端机器人功能配置
系统机器人功能
系统机器人，可以定时做一些功能和活动,让服务器自动执行
相关文件和目录:
mir200\Envir\Robot.txt　　　　 //机器人配置
mir200\Envir\Robot_def\AutoRunRobot.txt　　　　//机器人时间配置文件
mir200\Envir\Robot_def\RobotManage.txt　　　　 //机器人执行脚本文件
Robot.txt
格式
机器人名称　脚本名称
系统控制　AutoRunRobot
AutoRunRobot.txt
格式：
#AutoRun NPC SEC 10 @测试　　　;//按秒运行
#AutoRun NPC MIN 10 @测试 　　　;//按分运行
#AutoRun NPC HOUR 10 @测试 　　　;//按小时运行
#AutoRun NPC DAY 5 @测试 　　　;//按天运行
#AutoRun NPC RUNONWEEK 5:15:55 @测试　　　;//每周星期五15点55分运行
#AutoRun NPC RUNONDAY 20:30 @测试　　　;//每天20点30分运行
RobotManage.txt
格式：
[@测试]  
#ACT
SENDMSG 0  传奇世界，无限精彩。欢迎进入无限可能的传世之旅！
机器人脚本触发 [@攻城战结束] 增加返回变量
$996(CastStop).Name                 城堡名字
$996(CastStop).CastleName           城堡所属行会名字
$996(CastStop).GuardGuild           守城行会
$996(CastStop).AttackGuild          攻城行会


脚本传递方式写法拓展
传递脚本使用方法
注意： 牵扯到货币、装备的脚本，建议不要使用此写法！

如果要使用则一定要有严格的逻辑来判断传递的参数*

直接传递：

<测试/@测试&1&2&3&4&5&6&7&8&9>
变量传递：
{测试/@测试&<$STR(S1)>&<$STR(S2)>&<$STR(S3)>&<$STR(S4)>&<$Str(S5)>&<$Str(S6)>&<$Str(S7)>&<$Str(S8)>&<$Str(S9)>}
解释 可使用变量$SCRIPTPARAM(X)返回上面的参数
其中： X= 前面标签后的变量参数(1 - 9)
goto DelayCall DelayGoto Hcall 后面的跳转标签同样支持本类写法
注意：<$SCRIPTPARAM(1)>为公共变量，不要在所传递的标签之外使用这些变量

比如：以下示例，[@开始记录]标签下可以使用<$SCRIPTPARAM(1)>，但是[@chooseposok]标签下不可以使用

例:
 请选择您要记录的回城点：\\
<落霞岛/@开始记录&1&249&246>\
<王城/@开始记录&0&471&218>\
<土城/@开始记录&2&225&450>\
<禁地/@开始记录&4&350&164>\
<西域奇境/@开始记录&5&464&112>\
<死水沼泽/@开始记录&7&55&41>

[@开始记录]
#ACT
mov S$地图号 <$SCRIPTPARAM(1)>
mov S$坐标X <$SCRIPTPARAM(2)>
mov S$坐标Y <$SCRIPTPARAM(3)>
CHOOSEPOS <$STR(S$地图号)>  <$STR(S$坐标X)> <$STR(S$坐标Y)> @chooseposok
#SAY
请放上你的回城石。\\\
<关 闭/@exit>
[@chooseposok]
你的回城石记录成功。\\
回城点为 <$STR(S$地图号)>：<$STR(S$坐标X)> <$STR(S$坐标Y)>
<好 的/@exit>
传递脚本使用方法扩展
 <传递脚本/@传递&材料1=绿色项链&材料2=圣战项链>

  [@传递]
  #IF
  True
  #ACT
  SendMsg 5 <$Str(S$材料1)>-<$Str(S$材料2)>
  Break

  <$Str(S$材料1)>的值为：绿色项链
  <$Str(S$材料2)>的值为：圣战项链
视频教程传送门:传递脚本的使用方法
[toc]

元神系统
服务端：[24.07.30.02 003]引擎↓(2025-08-29)
PC端：1.8.0.6↓(2025-11-27)
元神相关命令
1. 创建元神命令
CreatePneuma	是否可省略	值范围	说明
参数一	否	文本	元神名字
参数二	否	文本	元神职业
( 0:战士 1:法师 2:道士 )
参数三	否	文本	元神性别
( 0:男 1:女 )
#IF
TRUE
#ACT
CreatePneuma 我是元神 0 1
SENDMSG 7 创建元神
Break
2. 释放、收回元神命令
ReleasePneuma 无参数

#IF
HasPneuma
#ACT
ReleasePneuma
SENDMSG 7 释放元神
Break
#ELSEACT
SENDMSG 7 你没有元神
Break
3. 删除元神命令
DelPneuma 无参数

#IF
PneumaReleased
#ACT
SendMsg 5 请收起你的元神.再删除他吧
Break

#IF
HasPneuma
#ACT
DelPneuma
SendMsg 7 已经成功删除了您的元神
Break
4. 检测人物是否拥有元神
HasPneuma 无参数

5. 检测人物是否释放元神
PneumaReleased 无参数

6. 检测对象是否为元神
IsPneuma 无参数

7. 单独给元神加经验
GetExp 参数一：经验值
此命令增加的经验不会分给本体，本体执行不会分给元神，其他方式获得经验都会按照2:1的比例分配

元神相关变量
变量及格式	参数	解释	说明
<$PNEUMANAME>			元神名字
<$PNEUMAJOB>			元神职业
<$PNEUMASEX>			元神性别
<$PNEUMALEVEL>			元神等级
元神也是一个角色，元神的个人变量可以通过 $humaninfo 获取

元神本身可以执行大多数脚本命令
例

#IF
TRUE
#ACT
$PNEUMANAME.SENDMSG 7 这是元神发的消息
Break
元神相关文件
1. PC端 更新说明
PC端元神相关配置文件.zip

文件	说明
\996Woool\xml\setup_ys.xml	元神战斗设置
\996Woool\ui\ui.xml	各类UI读取文件配置
\996Woool\ui\YsAvatarWnd.xml	元神F10界面
\996Woool\Information\default\ysprotect.xml	元神保护设置
\996Woool\ui\YsMiniWnd.xml	元神头像
\996Woool\ui\YsPackageWnd.xml	元神包裹界面
\996Woool\ui\YsSkillWnd.xml	元神技能界面
\996Woool\txt\merhelp.txt	元神帮助界面
setup_ys.xml：
<?xml version="1.0" encoding="gb2312" standalone="yes"?>
<YsSkillsList name="ys_skill">
  <Ys_Skill>
      <Skill id="编号" magicid="技能ID" name="技能名称" autotype="技能类型" mutex="互斥编号" default="1=默认勾选" />
  </Ys_Skill>
  <Ys_Settings>
      <Settings id="10001" name="单体技能" skill="1" default="1=默认勾选 0=不勾" default1="默认技能ID" />
      <Settings id="10002" name="群怪技能" skill="2" default="1=默认勾选 0=不勾" default1="默认技能ID" />
      <Settings id="10003" name="自动治疗" skill="3" default="1=默认勾选 0=不勾" default1="默认技能ID" />
      <Settings id="10004" name="自动召唤" skill="4" default="1=默认勾选 0=不勾" default1="默认技能ID" />
  </Ys_Settings>
</YsSkillsList>
2. 手机端 待更新
文件	说明
\data_config\cfg_setup_ys.json	元神战斗设置
cfg_setup_ys.json ：
{
"编号": {
  "id": 编号,
  "name": "技能名称",
  "autotype": "技能分类",
  "group": 显示组别,
  "order": 显示顺序,
  "mutual": "互斥编号",
  "magicid": 技能ID,
  "default": 1=默认勾选  0=不勾,
  "default1": 默认技能ID(单体、群体、治疗、召唤才可设置)
}
}
3. 服务端 更新说明
文件	说明
\Mir200\Envir\Data\cfg_neumamagic.xls	元神战斗设置
cfg_neumamagic.xls
表格内技能顺序为元神自动战斗使用技能的优先级，平砍的优先级时最低的


断线重连
服务端Mir200\!setup.txt中

[Setup]
ReConnect=1
0或不配置表示不启用断线重连，1表示开启断线重连
手机端 global 增加配置,设置断线重连最长等待时间

    "100263": {
        "name": "断线重连",
        "desc": "第一个参数:与后端失去链接多少ms后,断开网络;后面两个参数不要动",
        "id": 100263,
        "value": "10000#200#10"
    }


定时器功能
开启定时器
SETONTIMER A B C

参数	说明
A	定时器索引(0-24)
B	定时间隔（单位为秒)
C	循环次数(可为空，当不为空时，循环指定次数后退出)
说明:

定时器脚本位于QManage.txt里,定时器对应的为[@OnTimer0] [@OnTimer1] [@OnTimer2] … [@OnTimer24]
停止计时器
格式:SETOFFTIMER 定时器索引(0-24)

说明:

停止指定的定时器
;设置定时器
[@Test]
#IF
#ACT
SetOnTimer 0 20 3

;QManage.txt:
[@OnTimer0]
#ACT
SendMsg 5 你目前位于%m的(%x：%y)

;停止定时器
[@Test]
#IF
#ACT
SetOffTimer 0
视频教程传送门:定时器功能


灵兽系统说明
自动捡物品，捡金币说明
0级丛林豹：不会捡钱和物品。
1级丛林豹：只会捡钱。
2级以上：会捡钱和物品。捡到的物品自动放入包裹。
物品属性调整
命令参数	属性位置
UPGRADEUSERITEM A B C D
A=灵兽石序列号
B=属性位置
C=操作符号 + - =
D=数值	4：灵兽等级
6：灵兽经验
8：灵兽的颜色
9：灵兽转生等级
71：灵兽上次喂食时间的时间戳
Envir\Data\cfg_mount.xls 灵兽配置文件，需要配置灵兽等级、颜色所对应的怪物名，否则无法召唤灵兽
一转以上灵兽可骑乘，二转以上灵兽可骑战
灵兽颜色0 不可骑乘
灵兽石的Anicount要在6以内，否则无法骑乘
灵兽属性调整
命令参数	属性位置
SETPETATTRIBUTE A B C D
A=灵兽石序列号
B=属性位置
C=操作符号 + - =
D=数值	0：积累经验
1：幻化次数
2：资质
3：生命
4：魔法值
5：中毒躲避
6：魔御下限
7：魔御上限
8：魔法命中
9：躲避
10：防御下限
11：防御上限
12：魔法躲避
13：中毒命中
17：灵兽经验
19：魔法攻击下限
20：魔法攻击上限
21：道术攻击下限
22：道术攻击上限
23：攻击下限
24：攻击上限
25：命中 最高：7
26：幸运 最高：3
27：骑战速度 最高：1
28：麻痹几率
29：暴击几率
30：抗性
31：减免对方物理防御
32：减免对方魔法防御
33：减免对方物理命中
34：减免对方魔法命中
35：灵兽等级
灵兽变量-<$PET.A>
<$PET.A>只能获取跟随状态下的灵兽的相应属性
灵兽属性	参数A取值
类型	KIND
颜色	TYPE
等级	LEVEL
当前经验	EXP
升级所需经验	MAXEXP
饥饿程度	STATE
最近喂养时间	EATTIME
转生次数	RELIVE
灵兽名称（灵兽改名才显示）	NAME
对应灵兽石ID	MAKEINDEX
生命	HP
魔法值	MP
中毒躲避	ANTIPOISON
魔御下限	MAC1
魔御上限	MAC2
魔法命中	MAGICNICETY
躲避	EVADET
防御下限	AC1
防御上限	AC2
魔法躲避	ANTIMAGIC
中毒命中	POISONNICETY
PILEEXP	积累经验
魔法攻击下限	MC1
魔法攻击上限	MC2
道术攻击下限	SC1
道术攻击上限	SC2
攻击下限	DC1
攻击上限	DC2
命中	NICETY
幸运	LUCK
骑战速度	SPEED
物理命中	HITPOINT
幸运	LUCK
麻痹几率	PARALY
暴击几率	THUMP
抗性	AGAINST
减免对方物理防御	REDUCEAC
减免对方魔法防御	REDUCEMAC
减免对方物理命中	REDUCEHITPOINT
减免对方魔法命中	REDUCEANTIMAGIC
使用灵兽项圈捕捉灵兽
MapInfo.txt配置示例
[0        中州] CANUSESUPERITEM[灵兽项圈/灵符/镇魔符]

灵兽项圈物品DB示例
1372;灵兽项圈;3;206;1;0;0;0;1220;1;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;0;;5000;5;131072;0;0;0;0;;0;0;0;0;0;0;0;0;0;0;0

灵兽DB示例
丛林豹;52;18;511;99;255;0;;200;500;0;30;20;0;0;0;0;0;17;200;1;0;2000;0;0;;2;0;0;

引擎-选项-物品设置-灵符类
A 代表  怪物血量    B 代表 怪物等级  C 代表 (目标灵兽当前血量 / A)，C 最小为 2
如果 ( random(20) > (目标灵兽等级 + B) ) 并且 (random(C) = 0 ) 表示捕捉成功 触发QF标签

[@捕捉灵兽]
#IF
True
#ACT
SENDMSG 5 成功捕捉<$PARAM(2)>级<$PARAM(0)>,外观ID=<$PARAM(1)>,消耗物品唯一ID=<$PARAM(3)>



NPC开头参数配置
NPC开头参数
参数名	含义
@s_repair	特殊修理
@buy	购买东西
@sell	出售东西
@repair	普通修理
@makedrug	制作毒药
@storage	保管物品
@getback	取回物品
@upgradenow	升级武器
@getbackupgnow	取回武器
@upgradedressnow	升级衣服
@getbackupgdressnow	取回衣服
@callboard	江湖公告类型
@doshop	拥有该属性的NPC，可以在玩家摆摊状态下点击 （通常情况下，摆摊时不能点击NPC）
@fastbuy	快捷交易
@FastStorge	快捷存取
@bindbuy	绑定金币买卖标签
@notsellbind	当前NPC禁止销售已绑定物品
@Effigy	天人雕像对话界面
@SysComment	旗座对话框
MerChant.txt 第6个参数(NPC名称后面那个) 设置1..6	显示宗族界面
%100	表示该NPC出售的物品价格，%100是原始物价,%150是1.5倍价格
+19 +20 +21	是项链店，所有项链可以在这里维修和交易
+22 +23	是戒指店，所有戒指可以在这里维修和交易
+24 +26	是手镯店，所有手镯可以在这里维修和交易
+3 +25 +30	是杂货店，所有杂货可以在这里维修和交易
+4 +8	是书 店，所有图书可以在这里交易
+0 +42	是药 店，所有药剂可以在这里交易
+10 +11 +58 +81	是衣服店，所有衣服、腰带和靴子可以在这里维修和交易
+15	是头盔店，所有头盔可以在这里维修和交易
+5 +6 +43	是兵器店，所有兵器可以在这里维修和交易
+1 +40	是肉 店，所有肉可以在这里交易
NPC其它参数
参数名	含义
[goods]	npc库存物品不能写在 [@mian]前面
[goods]
;名字　数量　刷新时间
粗布衣(男) 　　40 　　10
[InGotGoods]	普通NPC使用元宝购买物品
[InGotGoods]
A B C
A = 物品在StdItems.DB中的Idx+1
B = 物品名
C = 元宝价格
例：
[InGotGoods]
769　　灵符　　1
[BindGoods]	使用绑定金币购买物品
[bindgoods]
;名字　　 数量　　刷新时间
示例：
[bindgoods]
疗伤神水　10 　　10
使用示例

(@fastbuy @buy @sell @repair @s_repair)
%100
+10
+11
+15
+58
+81

[@main]
欢迎光临，有什么事情需要我帮忙吗？\\
<快捷交易/@fastbuy>     <绑定金币购买/@bindbuy>\
<购入衣服/@buy>\
<出售衣服/@sell>\
<修复衣服/@repair>\
<特殊修理/@s_repair>\
<打听/@_FZ_ask>和心魔有关的最新消息\
<关闭选单/@exit>

[@bindbuy]请挑选要购买的物品。\\
<商品清单/@bindbuy>\
<返  回/@main>

[@fastbuy]
请挑选要购买的物品。\
\
<商品清单/@buy>\
<返 回/@main>

[@buy]
要购买什么吗？\
\
<商品清单/@buy>\
<返 回/@main>

[@sell]
请放上去要卖的衣服，我给估价。\
头盔、帽子、靴子和腰带也收购，\
最好在这儿一起卖吧。\
\
<返 回/@main>

[@repair]
可以修复衣服，头盔，帽子。另外，还可以修复靴子和\
腰带！

[@s_repair]
要特殊修理吗？\
价格会比普通修理贵的。\
\
<返 回/@main>

[@_FZ_ask]
　　  快修补好你的衣服，拿好你的武器，加入寻找心魔的队\
伍吧。最近我看到一些目光呆滞的人在中州大陆上游荡，你\
去看看吧。\
\
　　  <返 回/@main>

[goods]
;商品名称        ;数量    ;刷新时间
粗布衣(男)    40    10
灵魂战甲(男)    40    10
魔袍(男)       40    10

[bindgoods]
治疗神水　10 　　10
镜像NPC功能和同读NPC功能
格式

公主\天界小贩 RTG11 52 100 天界小贩 0 1 0
公主\天碑 RTG11 49 97 天碑 0 160 15
公主\天关之门  RTG11 37 108 天关之门 0 158 0
公主\天关之门 RTG11 33 104 天关之门 0 158  0
公主\天关之门 RTG11 31 99 天关之门 0 158 0
公主\天关之门 RTG11 25 104 天关之门 0 158 0
公主\天关之门 RTG11 27 94 天关之门 0 159 0
公主\天界小贩 <RTG11>RTG12 52 100 天界小贩 0 1 0
公主\天碑 <RTG11>RTG12 49 97 天碑 0 160 15
公主\天关之门 <RTG11>RTG12 37 108 天关之门 0 158 0
公主\天关之门 <RTG11>RTG12 33 104 天关之门 0 158 0
公主\天关之门 <RTG11>RTG12 31 99 天关之门 0 158 0
公主\天关之门 <RTG11>RTG12 25 104 天关之门 0 158 0
公主\天关之门 <RTG11>RTG12 27 94 天关之门 0 159 0


同读<秘境\秘境守卫> TJMJ10 60 62  秘境守卫 0 48 0
同读<秘境\秘境守卫> TJMJ20 60 62 秘境守卫 0 48 0
同读<秘境\秘境守卫> TJMJ30 60 62 秘境守卫 0 48 0
同读<秘境\秘境守卫> TJMJ40 60 62 秘境守卫 0 48 0
同读<秘境\秘境守卫> TJMJ50 60 62 秘境守卫 0 48 0
同读<秘境\秘境守卫> TJMJ60 60 62 秘境守卫 0 48 0
同读<秘境\秘境守卫> TJMJ70 60 62 秘境守卫 0 48 0
同读<秘境\秘境守卫> TJMJ80 60 62 秘境守卫 0 48 0
同读<秘境\秘境守卫> TJMJ90 60 62 秘境守卫 0 48 0


控制玩家攻击模式
控制玩家攻击模式
GmExeCute AttackMode A
参数解释:
A参数代码	解释
0	善&恶攻击模式
1	全体攻击模式
2	和平攻击模式
3	编组攻击模式
4	行会攻击模式
5	师徒攻击模式
6	夫妻攻击模式
补充
变量<$ATTACKMODE>返回以上攻击模式的值
例:
[@main]
#ACT
GMEXECUTE AttackMode 1
SENDMSG 5  你现在是全体攻击模式
视频教程传送门:控制玩家攻击模式


包裹、仓库、摊位相关
Bigbag
本体包裹

BagSize A

命令参数

参数	含义
A	格子数
命令说明

本体包裹界面点击扩充包裹后将触发QM登陆脚本 [@扩展包裹]
修改背包需要扩展的背包格鼠标移上去的提示 自定义

Ini\GlobalStrings.ini
BagWnd_Tip_BuyMsg= “ 本次支付1元宝,您将可以开启4个包裹空格，并获得永久使用权。是否确认开启？”
此条请加在BagWnd_Tip_Lable2后面 位置是固定的请勿随意放在其他位置
使用示例

[@扩展包裹]
#IF
!checkgold 100000
#ACT
SENDMSG 5 你的剩余金币不足，不能扩充包裹
break
#IF
CHECKGAMEGOLD > 4
#ACT
take 金币 100000
GAMEGOLD - 5
BAGSIZE 66
SENDMSG 5 恭喜你的包裹扩充成功！
#ELSEACT
SENDMSG 5 你的剩余元宝不足，不能扩充包裹
break
扩展仓库
StorageSize A B
参数	解释
A	+ - =
B	数字
补充说明

点击扩展仓库按钮将触发QM登陆脚本 [@扩展仓库];
仓库最大支持120格，初始默认为39格;
变量<$STORAGESIZE>，返回仓库大小;
例

[@扩展仓库] 
#ACT
GameGold - 10 
StorageSize + 20 
SENDMSG 5  你的仓库已经扩充了20格
扩展BAGSIZE 参数一 参数二
参数	说明
参数一	背包格子数量
参数二	摆摊格子数量
摆摊格子扩展后不能减少 参数一为0时为默认的原始背包格数不会进行修改 参数二可省略 不影响原始命令
新增双击摆摊格子后点确定后的触发 QM [@扩展摆摊]
新增摆摊双击未开启格式提示框自定义文字内容
修改摆摊需要扩展的背包格鼠标移上去的提示 自定义

Ini\GlobalStrings.ini
BoothWnd_Tip_ExBag="双击可以打开摆摊的格子哟亲"
BoothWnd_Tip_BuyMsg="   本次支付100元宝,您将可以开启4个摆摊空格，并获得永久使用权。是否确认开启？"

BoothWnd_Tip_Diy="神石"
BoothWnd_Tip_DiyName="使用神石交易"
BoothWnd_Tip_DiySale="你决定以%s神石的价格出售“%s”物品吗？"
BoothWnd_Tip_DiyBuy="你将以%s神石的价格购买“%s”物品，"
此条请加在UiWnd_Tip_Zbzz3后面 位置是固定的请勿随意放在其他位置
背包需要扩展的背包格鼠标移上去的提示 自定义

Ini\GlobalStrings.ini BagWnd_Tip_ExBag = "请联系GM进行扩展"
BagWnd_Tip_Lable1 = "自定义积分描述"  
BagWnd_Tip_Lable2 = "自定义积分2描述"
视频教程传送门:扩展包裹


怪物墓碑系统
服务端 ([24.11.01.01]引擎以上)
配置文件:\Mir200\Envir\MonGen.txt

地图	坐标x	坐标y	怪物名字	范围	数量	间隔时间(分钟)	集中刷新0-100	死了才刷	重命名	怪物等级	封号1	封号2	封号3	刷新触发标签	是否走动	墓碑类型	墓碑素材	小地图图标	tips标识	墓碑文字显示	小地图文字显示	墓碑刷新方式
大地图墓碑
怪物死后，出现怪物墓碑及刷怪倒计时
墓碑类型：1=调用图片
墓碑素材：素材编号，墓碑类型为1时，手游素材路径`\res\picpackage\1`,PC素材路径：`\996Woool\data\dev\texture99\wolext`
墓碑文字显示:0=显示名字和倒计时，1=不显示，2=只显示名字，3=只显示倒计时
墓碑刷新方式
  0：怪死在哪，碑放在哪，碑放在哪，怪刷在哪
  1：碑放在设置的坐标，刷怪还是按照普通刷怪，在范围内刷
  2：提前算出下次的刷怪点，在那放墓碑，也在那刷怪
不可用清理怪物的命令清理，否则墓碑消失
小地图墓碑
一直存在的提示，类似于maptips功能，可显示tips。
小地图图标：手游素材路径`\res\picpackage\3`，PC素材路径：`\996Woool\data\dev\texture99\interface`。
tisp标识：点击图标显示的tips
小地图文字显示:0=显示名字和倒计时，1=不显示，2=只显示名字，3=只显示倒计时
手游端调取的tips,配置文件:cfg_maptips.json

PC端调取的tips,配置文件:MapTipsCfg.xml

例：

;地图    坐标X    坐标Y    怪物名称    刷怪范围    怪物数量    间隔(分钟)    集中座标刷新机率    死了才刷    新名字    宠物等级    头顶封号1    头顶封号2    头顶封号3    刷怪触发标签(触发机器人)    是否走动    墓碑类型    墓碑素材    小地图图标    tips标识    墓碑文字显示    小地图文字显示    墓碑刷新方式
*L006    12    27    测试怪甲    10    1    5    0    1    坟头一    0    1    2    3    @刷出怪来    0    1    301    301    0    0    0    1
手游端 (手游1000703-012以上)
墓碑类型为1时
素材路径：\res\picpackage\1
相关配置
配置文件:data_config\cfg_global.json
"130015": {
  "desc": "墓碑模型方向，当墓碑类型为2或者3时起效",
  "id": 130015,
  "value": 0
},
"130016": {
  "desc": "墓碑文字标题，#name当前怪物名字，可以不要",
  "id": 130016,
  "value": "#name 复活倒计时"
},
"130017": {
  "desc": "墓碑文字倒计时，#time倒计时",
  "id": 130017,
  "value": "#time"
},
"130018": {
  "desc": "大地图墓碑文字标题，锚点x#锚点y#x#y#颜色 0-255编号代表的颜色参考文档，颜色不填使用怪物名字颜色",
  "id": 130018,
  "value": "0.5#0.5#0#80"
},
"130019": {
  "desc": "大地图墓碑文字倒计时，锚点x#锚点y#x#y#颜色 0-255编号代表的颜色参考文档，颜色不填使用怪物名字颜色",
  "id": 130019,
  "value": "0.5#0.5#0#-40"
},
"130020": {
  "desc": "小地图墓碑文字标题，锚点x#锚点y#x#y#颜色 0-255编号代表的颜色参考文档，颜色不填使用怪物名字颜色",
  "id": 130020,
  "value": "0.5#0.5#0#20#249"
},
"130021": {
  "desc": "小地图墓碑文字倒计时，锚点x#锚点y#x#y#颜色 0-255编号代表的颜色参考文档，颜色不填使用怪物名字颜色",
  "id": 130021,
  "value": "0.5#0.5#0#-20#249"
}
PC端 (1.6.8.6以上)
墓碑类型为1时
素材路径：\996Woool\data\dev\texture99\wolext，wolext图包号为1。
相关配置
配置文件:\996Woool\ini\launcher.ini
;------墓碑模型方向
TombDir=0
;------墓碑文字标题
TombTitle="#name 复活倒计时"
;------墓碑文字倒计时
TombTime="#time"
;-----大地图墓碑文字标题，锚点x#锚点y#x#y#颜色 0-255编号代表的颜色参考文档，颜色不填使用怪物名字颜色
TombTextColor="0.5#0.5#0#-80#243"
;-----大地图墓碑文字倒计时，锚点x#锚点y#x#y#颜色 0-255编号代表的颜色参考文档，颜色不填使用怪物名字颜色
TombTimeColor="0.5#0.5#0#40"
;-----小地图墓碑文字标题，锚点x#锚点y#x#y#颜色 0-255编号代表的颜色参考文档，颜色不填使用怪物名字颜色
MiniTombTextColor="0.5#0.5#0#-40"
;-----小地图墓碑文字倒计时，锚点x#锚点y#x#y#颜色 0-255编号代表的颜色参考文档，颜色不填使用怪物名字颜色",
MiniTombTimeColor="0.5#0.5#0#5#249"

手游微信公众号接入说明
手游微信公众号接入说明
此命令只能在开服务器上使用，测试环境无法生效。
BindWeChat发送微信验证操作

命令格式：BindWeChat 参数一
参数一：
1=绑定微信
2=解绑微信
3=获取一个验证
执行该脚本后触发QFunction-0.txt中的
[@BindWeChat]
#IF
True
#ACT
SendMsg 5 微信验证码：<$WECHATKEY>，请在公众号内回复该验证码。（本验证码的类型是：<$REWECHATTYPE>）
Break
;变量 $WECHATKEY 是返回的验证码，玩家在公众号内回复该验证码即可完成验证。
玩家在公众号内正确回复验证码后将触发QFunction-0.txt中的
[@BindReWeChat]
#IF
True
#ACT
SendMsg 5 验证码：<$REWECHATKEY>
SendMsg 5 微信名：<$REWECHATNAME>
SendMsg 5 微信ID：<$REWECHATID>
Break
ClearWeChat 清空微信验证码所有对应变量
脚本示例
下面脚本中使用的个人标记变量[8]来记录该角色是否绑定过微信，正常流程是玩家先绑定微信后才能使用 解绑(类型2)和获取验证码(类型3)的操作。

    <绑定微信/@绑定微信>\
    <解绑微信/@解绑微信>\
    <获取验证码/@获取验证码>

    [@绑定微信]
    #IF
    Check [8] 0
    #ACT
    BindWeChat 1
    Break
    #ELSEACT
    MessageBox 该角色已经绑定过微信，无需重复绑定！
    Break

    [@解绑微信]
    #IF
    Check [8] 1
    #ACT
    BindWeChat 2
    Break
    #ELSEACT
    MessageBox 你还没有绑定过微信，无需解绑！
    Break

    [@获取验证码]
    #IF
    Check [8] 1
    #ACT
    BindWeChat 3
    Break
    #ELSEACT
    MessageBox 请先绑定微信！
    Break
    ;QFunction-0.txt
    ;获取验证码成功触发
    [@BindWeChat]
    #IF
    #ACT
    SendMsg 5 微信验证码：<$WECHATKEY>，请在公众号内回复该验证码。（本验证码的类型是：<$REWECHATTYPE>）
    Break

    ;验证成功触发
    [@BindReWeChat]
    #IF
    true
    #ACT
    SendMsg 5 验证成功,验证码:<$WECHATKEY>请在公众号内回复该验证码,本验证码的类型是:<$REWECHATTYPE>

    #IF
    Equal <$REWECHATTYPE> 1
    Large <$WXMAXNUM> 0
    Equal <$WXNOWNUM> <$WXMAXNUM>
    #ACT
    MessageBox 绑定人数超限！
    Break

    #IF
    Equal <$REWECHATTYPE> 1
    Large <$WXMAXNUM> 0
    Large <$WXNOWNUM> <$WXMAXNUM>
    #ACT
    MessageBox 绑定人数超限！
    Break

    #IF
    Equal <$REWECHATTYPE> 1
    #ACT
    Set [8] 1
    MessageBox 绑定成功！
    Break

    #IF
    Equal <$REWECHATTYPE> 2
    #ACT
    Set [8] 0
    MessageBox 解绑成功！
    Break

    #IF
    Equal <$REWECHATTYPE> 3
    #ACT
    SendMsg 5 验证成功！
    Break
后台微信公众号配置
配置须知：WX公众平台链接(订阅号,服务号都可用)：https://mp.weixin.qq.com/
配置步骤：


点击后台公众号关联—添加公众号
添加公众号时需要5个参数
参数一:Appid（微信公众平台—基本设置内获取）
参数二:AppSecret（微信公众平台—基本设置内获取）
参数三:Token值,自由设置(必须为英文或数字，长度为3-32字符)
参数四:解密秘钥,自由设置(消息加密密钥由43位字符组成，可随机修改，字符范围为A-Z，a-z，0-9)
参数五:绑定数量,自由设置(0-99都可以)（暂不生效）
后台公众号关联处—查看绑定游戏处添加游戏（1个公众号可以绑定多个游戏）
五个参数填写完毕后保存，后台自动获得白名单IP和服务器地址，复制填写到微信公众平台—基本配置处（Token和秘钥必须和公众号后台一致否则会提交失败）
填写完毕后请检查 5个参数和IP白名单 与后台是否一致！！！


多功能角色跳转
扩展脚本命令GOTO 新增加参数 模式(1,2,3,4) 多功能GOTO 除了原始标签 使用其他模式的触发时是触发到QM下的指定标签
脚本说明
脚本命令: GOTO	是否可省略	值范围	说明
标签	否	文本	需要跳转的标签 @标签
模式	是	文本	模式(1,2,3,4)　　　　　　　　　　　　
0或者不填=原始功能
1=小组成员触发
2=同行会人员触发
3=当前地图玩家触发
4=以玩家自身中心的范围玩家触发
范围	是	数值	当模式 = 4的时候使用的范围
脚本示例
[@GOTO]
#IF
True
#ACT
GOTO @小组触发  1
Break

QManage.txt

[@小组触发]
#IF
TRUE
#ACT
SENDMSG 5 小组成员都触发了
break;
视频教程传送门:goto用法


复活/重生触发
复活/重生触发
游戏重生/复活将会触发QM脚本标签 [@重生触发]

新增变量 $RELIVETIME 显示剩余重生时间间隔

新增命令
脚本命令: SetReLiveTime	是否可省略	值范围	说明
参数一	否	数值	正数为增加时间，负数为减少时间！


盒子接入礼包说明
手游盒子接入礼包说明
关于盒子礼包重要说明
检查文件“ !Setup.txt”，地址是否正确
Gift_DomainName=http://yyht-api.996box.com
Gift_Key=7PZJImoeAE5Dnjb6pCYu8Ja5Buhb2urL
Gift_PathDocument0=/api/GameApi/getGiftList
Gift_PathDocument1=/api/GameApi/csSendGift

注意：严格匹配大小写
后台配置礼包数据，礼包数据是由引擎向后台请求礼包数据，得到的数据放到引擎内，并提供相应的变量供脚本使用。

[Main_Engine] 新增脚本命令 REGETGIFTLIST 重新加载盒子礼包 无参数。 放到[@GlobalVar]里执行。此命令不能频繁执行，否则会引擎卡死，纯PC用的，没有纯PC的别加！！！

[Main_Engine] 新增脚本命令 POSTGIFTTYPE 参数一 参数二 领取礼包

脚本命令: POSTGIFTTYPE	是否可省略	值范围	说明
参数一	否	数值	类型
参数二	否	数值	礼包码字符(参数1等于3时才生效)
[Main_Engine] 礼包配套变量 配套触发
;<$ARRGIFTITEMIDX[A,B]>  获取礼包IDX
;<$ARRGIFTITEMNAME[A,B]> 获取礼包名称
;<$ARRGIFTITECOUNT[A,B]> 获取礼包数量

A=礼包类型 (1=登录礼包 3=礼包码)   
B=礼包内配置的物品0~99

QF触发：

[@GiftStatusOk]
#if
#act
SendMsg 6 成功了

[@GiftStatusFail]
#If
#Act
SendMsg 6 失败了


NPC脚本命令:
<重载礼包/@重载礼包> <领取礼包/@领取礼包> <领取状态/@领取状态> <获取礼包物品/@获取礼包物品>

[@领取状态]
#IF
#ACT
获取领取礼包的状态: 0=从未请求过领取 1=请求发起等待中 2=领取成功 3=领取失败 4=发生错误收到的返回为空 5=收到信息为空 6=已领取过该礼包 7=对不起礼包码填写错误 8=无法使用该礼包码 9=未从盒子登录，无法领取该礼包 10=账号不存在 11=对不起，小号无法领取游戏礼包
SendMsg 6 <$USERGIFTSTATUS>

[@获取礼包物品]
#IF
#ACT
sendmsg6类型1第一个礼包IDX=;<$ARRGIFTITEMIDX[1,0]>,礼包名称=;<$ARRGIFTITEMNAME[1,0]>,礼包数量=;<$ARRGIFTITECOUNT[1,0]>
sendmsg6类型1第二个礼包IDX=;<$ARRGIFTITEMIDX[1,1]>,礼包名称=;<$ARRGIFTITEMNAME[1,1]>,礼包数量=;<$ARRGIFTITECOUNT[1,1]>
sendmsg6类型1第三个礼包IDX=;<$ARRGIFTITEMIDX[1,2]>,礼包名称=;<$ARRGIFTITEMNAME[1,2]>,礼包数量=;<$ARRGIFTITECOUNT[1,2]>

sendmsg6类型3第一个个礼包IDX=;<$ARRGIFTITEMIDX[3,0]>,礼包名称=;<$ARRGIFTITEMNAME[3,0]>,礼包数量=;<$ARRGIFTITECOUNT[3,0]>
sendmsg6类型3第二个个礼包IDX=;<$ARRGIFTITEMIDX[3,1]>,礼包名称=;<$ARRGIFTITEMNAME[3,1]>,礼包数量=;<$ARRGIFTITECOUNT[3,1]>
sendmsg6类型3第三个个礼包IDX=;<$ARRGIFTITEMIDX[3,2]>,礼包名称=;<$ARRGIFTITEMNAME[3,2]>,礼包数量=;<$ARRGIFTITECOUNT[3,2]>

[@重载礼包]
#IF
#ACT
;REGETGIFTLIST 重新加载礼包:无参数
REGETGIFTLIST

[@领取礼包]
#IF
#ACT
;POSTGIFTTYPE 获取礼包: 参数1=类型整型 参数2=礼包码字符(参数1等于3时才生效)
POSTGIFTTYPE 3 礼包码
获取领取礼包的状态 $USERGIFTSTATUS

变量: $USERGIFTSTATUS	说明
0	从未请求过领取
1	请求发起等待中
2	领取成功
3	领取失败
4	发生错误收到的返回为空
5	收到信息为空
6	已领取过该礼包
7	对不起礼包码填写错误
8	无法使用该礼包码
9	未从盒子登录，无法领取该礼包
10	账号不存在
11	对不起，小号无法领取游戏礼包
论坛教程传送门
增加盒子称号常量说明 (这个功能仅能在正式服上测试 有部份功能 需要用盒子登录)

常量名字	类型	说明
<$BOXTILE>	数值	返回当前称号ID
<$BOXTILEOPEN>	数值	盒子称号是否开启 0=未开启 1=已开启
<$BOXLOGIN>	数值	盒子登录状态 0=非盒子登陆 1=盒子登录
<$$BOXTILEADV(1-5).类型>	多类型	具体说明看下面描述
<$BOXTILEADV(0).ABIL> =属性类型
<$BOXTILEADV(0).VALUE> =属性值
<$BOXTILEADV(0).TYPE> = 是否百份比 0=数值 1=百分比
<$BOXTILEADV(0).DESC> = 盒子称号描述


结婚脚本实例
结婚脚本
[@main]
你想做什么？\
<求婚/@求婚>\
<取消求婚/@wantcancel>\
<离婚/@unmarry>\
<打听消息/@ask>\
<回城/@backcity>\ 
<离开/@exit>\ 
<COLOR=GREEN  龙凤阁结婚更为气派！>\

[@求婚] 
结婚是一生中的大事，这样的大事在龙凤阁这样的地方举\ 
办，才算相得益彰啊。来，让我月老为你们的天作之合做\ 
个见证。你知道吗？传说，如果谁能够找到一种叫“龙凤\ 
婚嫁饰品”的好东西，那么他不但会有一场天下无双的梦\
幻婚礼，而且他们的婚姻会得到上天的眷顾，美满幸福。\
<我们就在这结婚/@我们就在这结婚>\
<返回/@main>

[@我们就在这结婚]
求婚者必须是男性且装备求婚戒指，如果你的求婚失\
败，你的求婚戒指会保留下来求婚成功后，你的求婚\
戒指就会将被收走。\
每次求婚收取1000金币手续费，你准备好求婚了吗？\
<准备好了/@准备好了>\
<没有，我下次再来/@exit>\
<返回/@main>\

[@准备好了]
#IF
Checkmarry
#act 
break
#say
你都结过婚了，还来注册结婚，想犯重婚罪呀！！！ \ \
<返回/@main>

#IF
checkposemarry
#say
对方已经结过婚了，是不是想犯重婚罪呀！！！\ \
<返回/@main>
#act
break

#IF
Gender man
#elsesay
只有男的向女的求婚，还没见过大姑娘向小伙子求婚的。\  \
<返回/@main>
#elseact
break

#if
checkposegender  男
#say
你变态呀！！！想搞同性恋！！！ \ \
<返回/@main>
#act
break

#if
checkposedir 2
#elsesay
你们二个面对面站好呀，不要乱动。\ \
<返回/@main>
#elseact
break 

#IF
checklevel 40
#Elsesay
结婚要求你的等级必须40级或以上，小伙子努力练好级再来找我。\ \
<返回/@main>
#elseact
break

#IF
checkposelevel  > 40
#Elsesay
结婚要求双方都已经满40级\  \
<返回/@main>
#Elseact
break

#IF
Checkitem 求婚戒指  1
#Elsesay
你没求婚戒指，弄到求婚戒指再来找我吧！！！\ \
<返回/@main>
#Elseact
Break

#IF
#Act
take 求婚戒指 1
marry

[@StartMarry]
#IF
Checkmarry
#Say
你都结过婚了，还来注册结婚，想犯重婚罪呀！！！ \ \
<返回/@main>
#act
break

#IF
Gender man
#Act
break
#say
婚礼现在正式开始。\ \
你愿意娶对方为妻，并照顾她一生一世吗？\ \
<我愿意/@RequestMarry>

#IF
Gender
#Act
break
#say
婚礼现在正式开始。\\
请耐心等待你心爱的人向你求婚\\

[@RequestMarry]
#IF
checkmarry
#ACT
Break
#say
你都结过婚了，还来注册结婚，想犯重婚罪呀！！！ \ \
<返回/@main>
#IF
#ACT
marry requestmarry

[@WateMarry]
你已向对方求婚，请耐心等待对方的答复。

[@RevMarry]
#IF
checkmarry
#act
break
#say
你都结过婚了，还来注册结婚，想犯重婚罪呀！！！ \ \
<返回/@main>

#IF
#Say
对方向你求婚，你是否答应嫁给他？ \ \
<我愿意/@ResposeMarry> \
<我不愿意/@ResposeMarryFail>
#elsesay
你声望不足5点以上。\
<离开/@exit>

[@ResposeMarry]
#IF
checkmarry
#ACT
Break
#say
你都结过婚了，还来注册结婚，想犯重婚罪呀！！！ \ \
<返回/@main>

#IF
#Act
marry responsemarry ok 

[@ResposeMarryFail]
#If
checkmarry
#Act
break
#say
你都结过婚了，还来注册结婚，想犯重婚罪呀！！！ \ \
<返回/@main>
#IF
#ACT
marry responsemarry fail

[@EndMarry]
你们二个已经成为了一对合法夫妻了。\ \
<关闭/@exit>

[@EndMarryFail]
结婚失败！\ \
<关闭/@exit>

[@MarryDirErr]
对方没站好位置

[@MarryCheckDir]
请站好位置\\

[@HumanTypeErr]
你变态呀，竟然选择一个非人类作为结婚对象。

[@MarrySexErr]
你变态呀，竟然同性恋。

[@unmarry]
#IF
Checkmarry
#ACT
Unmarry
#elsesay
你都没结婚离什么婚？？\ \
<返回/@main>

[@UnMarryCheckDir]
要离婚是吧？离婚是二个人的事，必须二个人对面对站好位置，\
如果人来不了你只能选择强行离婚姻了。\\
<我要强行离婚/@fUnMarry>\
<返回/@main>

[@UnMarryTypeErr]
你对面站了个什么东西，怎么不太象人来的。\\
<返回/@main>

[@StartUnMarry]
#IF
Gender man
#ACT
BREAK
#SAY
是否确定真的要与你共事多年的妻子离婚吗？\ \
<确定/@RequestUnMarry>

#IF
Gender
#Say
你的老公现在向我请求离婚，是不是愿意协议离婚？ \ \
<确定/@RequestUnMarry>
#ACT
Break

[@RequestUnMarry]
#IF
Checkmarry
#ACT
Unmarry requestunmarry

[@ResposeUnMarry]
#IF
Checkmarry
#ACT
Unmarry responseunmarry

[@WateUnMarry]
你已向对方发出离婚请求，请耐心等待对方的答复。

[@RevUnMarry]
对方向你离婚请求，你是否答应离婚？ \ \
<我愿意/@RequestUnMarry>
<返回/@main>

[@ExeMarryFail]
你都没结过婚，跑来做什么？ \ \
<返回/@main>

[@fUnMarry]
#IF
Checkitem 金条 1
Checkmarry
#ACT
Take 金条 1
unmarry requestunmarry force
#elsesay
要收一根金条的手续费，你没有金条，\
我不能让你离婚。\
<确定/@exit>

[@UnMarryEnd]
呵呵，你已经脱离苦海了！！！ \ \
<退出/@exit>

[@backcity]
#IF
#ACT
MApmove 0 476 226
Break

[@ask]
前几天我不小心丢了一枚戒指\
你能帮我找回来吗？\\
<确定/@exit>


脚本命令物品放取框操作说明
物品放取框
ShowSpotDlg　A　B　C
命令参数
参数	含义
A	6：根据所提供的物品触发相关脚本；
B	提示文字信息；
C	触发标签，当参数Type为6时需要设置该参数；
放入的物品优先会执行和物品同名的标签
当放入的物品没有找到对应的标签，则触发该自定义标签；
命令说明
本命令用于显示一个物品放取框；
返回参数：

<$PARAM(0)>返回物品名字；
<$PARAM(1)>返回物品的ID；
特别提醒
注意：

不要在后面调用的脚本中使用MessageBox命令提示信息，而要用#SAY命令提示信息，否则第二次放物品时不会触发对应的脚本；
例
[@例]
#SAY
请把物品放入托盘。 
#ACT
ShowSpotDlg 6 请提供物品 @其他物品
Break

[@裁决]  
#SAY
你提供的物品是\\
<$PARAM(0)> 物品名字\
<$PARAM(1)>物品序列号\ 

[@倚天剑] 
#SAY
你提供的物品是\\
<$PARAM(0)> 物品名字\
<$PARAM(1)>物品序列号\

[@其他物品] 
#SAY 
你提供的物品是\\
<$PARAM(0)> 物品名字\
<$PARAM(1)>物品序列号\
视频教程传送门:物品放取框操作说明


心魔相关命令、触发
心魔登陆触发
路径:\Envir\MapQuest_def\QManage.txt

[@Evil_Login]
#if
true
#act
wingtype 33 33
SENDMSG 14 【心魔】<$USERNAME>在地图<$M>坐标<$X>:<$Y>出现了!
;下面的这些参数在1.8引擎[25.09.23.01]及之后版本才有
;SENDMSG 14 <$996(Evil_Login).fullname>|怪物的完整名字
;SENDMSG 14 <$996(Evil_Login).name>|怪物的去除数字的名字
;SENDMSG 14 <$996(Evil_Login).Userid>|怪物的USERID
;SENDMSG 14 <$996(Evil_Login).RACE>|怪物的RACE
;SENDMSG 14 <$996(Evil_Login).RACEIMG>|怪物的RACEIMG
;SENDMSG 14 <$996(Evil_Login).Job>|职业
;SENDMSG 14 <$996(Evil_Login).Gender>|性别
;SENDMSG 14 <$996(Evil_Login).Ambit>|境界类型
;SENDMSG 14 <$996(Evil_Login).DBName>|数据库名字
break
心魔死亡触发
路径:Envir\Funtion_def\QFunction-0.txt

[@Evil_死亡触发]
#if
TRUE
#act
SendMagicID 4614 0 0
查看心魔装备触发
路径:Envir\Funtion_def\QFunction-0.txt

[@查询心魔装备]
脚本命令：DisposeMonGhost
用于移除指定坐标的尸体(即收取心魔)，支持单坐标多怪物触发
脚本命令:DisposeMonGhost	是否可省略	值范围	说明
坐标X	否	文本	目标坐标X
坐标Y	否	文本	目标坐标Y
触发特效ID	否	文本	触发特效ShowHumEff特效编号
例:

#act
DisposeMonGhost <$X> <$Y> 61
DisposeMonGhost 命令收取心魔触发
DisposeMonGhost在移除怪物之前触发[@DisposeMonGhost_Begin]
如果当前怪物不是你想要移除的对像执行脚本 RETURN 0 则不会进行移除操作
如果当前多个怪物,你检测到对应的怪物信息后要停止后续的检测可以使用stop停止循环
[@DisposeMonGhost_Begin]
#if
TRUE
#act
SENDMSG 7 <$996(DisposeMonGhost).Count>|坐标下有多少个怪物尸体
;SENDMSG 7 <$996(DisposeMonGhost).fullname>|移除的怪物的完整名字
;SENDMSG 7 <$996(DisposeMonGhost).name>|移除怪物的去除数字的名字
;SENDMSG 7 <$996(DisposeMonGhost).Userid>|移除怪物的USERID
;SENDMSG 7 <$996(DisposeMonGhost).RACE>|移除怪物的RACE
;SENDMSG 7 <$996(DisposeMonGhost).RACEIMG>|移除怪物的RACEIMG
;下面的这些参数在1.8引擎[25.09.23.01]及之后版本才有
;SENDMSG 7 <$996(DisposeMonGhost).Job>|职业
;SENDMSG 7 <$996(DisposeMonGhost).Gender>|性别
;SENDMSG 7 <$996(DisposeMonGhost).Ambit>|境界类型
;SENDMSG 7 <$996(DisposeMonGhost).DBName>|数据库名字
#if
EQUAL <$996(DisposeMonGhost).RACE> 254
EQUAL <$996(DisposeMonGhost).RACEIMG> 253
#act
SENDMSG 5 <$996(DisposeMonGhost).Count>-<$996(DisposeMonGhost).fullname>-<$996(DisposeMonGhost).name>-<$996(DisposeMonGhost).Userid>-<$996(DisposeMonGhost).RACE>-<$996(DisposeMonGhost).RACEIMG>
;Stop
break
#elseact
Return 0
成功执行的会触发[@DisposeMonGhost_end]
[@DisposeMonGhost_end]
#If
true
#act
sendmsg 6 (*)玉净瓶魔力四射，俘获心魔成功
移除失败的触发[@DisposeMonGhost_Fail]
[@DisposeMonGhost_Fail]
#If
true
#act
sendmsg 5 <$996(DisposeMonGhost).Result>|1=地面上没有尸体
脚本命令：GetEvilObj
删除心魔尸体上的特效ID
脚本命令:GetEvilObj	是否可省略	值范围	说明
参数一	否	数值	心魔唯一ID


手游端 轮盘施法功能
开启轮盘施法
配置文件：\dev\data_config\cfg_setupnew.json
"30": {
  "id": 30,
  "content": "轮盘施法",
  "group_text": "轮盘施法",
  "default": 0, -- 1=默认勾选
  "default1": 50, -- 默认轮盘百分比大小
  "visible": 1 -- 是否显示，1=显示
}
设置技能轮盘施法类型
配置文件：\dev\data_config\cfg_skills.json 的wheelType字段
"wheelType"：轮盘施法类型
  0：该技能不能呼出轮盘
  1：普通选点技能，适用于选的点上面有怪，无怪的点，鼠标移上去显示红色
  2：火墙火雨，除了建筑物等，其他点均能显示绿色，可以释放技能
  3：位移类技能，移形换影、化身蝙蝠、遁地
  4：带方向的技能，例如野蛮，冰龙破
例：
[
{
  "id": 73,
  "name": "流星火雨",
  "wheelType": 2
},
{
  "id": 10,
  "name": "疾光电影",
  "wheelType": 4
},
{
  "id": 22,
  "name": "火墙",
  "wheelType": 2
},
{
  "id": 27,
  "name": "野蛮冲撞",
  "wheelType": 4
},
{
  "id": 35,
  "name": "化身蝙蝠",
  "wheelType": 3
},
{
  "id": 62,
  "name": "突斩",
  "wheelType": 4
},
{
  "id": 75,
  "name": "遁地",
  "wheelType": 3
},
{
  "id": 77,
  "name": "移形换影",
  "wheelType": 3
}
]

手游端 设置界面自定义
手游保护界面添加配置(目前只能在保护界面添加)
配置文件：data_config\cfg_setupnew.json

格式：
{
"20001": { -- id 需要在20001以上
  "id": 20001,
  "content": "显示文字",
  "group": 2, -- 目前只支持2
  "group2": 5, -- 目前只支持5
  "group_text": "保护设置",
  "default": 1, -- 默认是否勾选
  "desc": "<font colorStyleID='1135'>勾选后自动使用并购买回血</font>",
  "index": 14, -- 排列顺序
  "default1": 10, --滑动条默认值
  "heightPrecent": 100, -- 滑动条上限
  "lowprecent": 1 -- 滑动条下限
}
}
例
{
"20001": {
  "id": 20001,
  "content": "生命值低于<font color='#ffFFFFFF'>%s%%</font>，持续使用<font color='#ff7200'>回血</font>",
  "group": 2,
  "group2": 5,
  "group_text": "保护设置",
  "default": 1,
  "desc": "<font colorStyleID='1135'>勾选后自动使用并购买回血</font>",
  "index": 14,
  "default1": 10,
  "heightPrecent": 100,
  "lowprecent": 1
}
}
游戏里勾选、滑动自定义保护配置，触发QF标签[@ClientSetting]
[@ClientSetting]
#IF
TRUE
#ACT
sendmsg 15 <$996(ClientSetting).id>|配置id
sendmsg 15 <$996(ClientSetting).SValue>|是否勾选
sendmsg 15 <$996(ClientSetting).PValue>|滑动条值
BREAK
脚本命令，调整自定义设置界面配置
命令及格式	参数	参数解释	说明
ClientSetting A B C	A=控件ID
B=是否勾选
C=滑动条值		调整自定义设置界面配置
例:

#act
ClientSetting 20001 1 50


Buff系统
重载自定义Buff数据，只能重载新增的Buff编号，之前存在的Buff的删除和更改不能重载。
服务端 Buff 配置文件
Buff表路径：\Mir200\Envir\Data\cfg_buff.xls
属性表路径：\Mir200\Envir\Data\cfg_att_score.xls

更新说明中下载最新的引擎，data示例中有文件模板
手游端 Buff 配置文件
路径：\dev\data_config\cfg_diybuff.json

详细配置：http://cshelp.996m2.com/web/#/17/941
PC端 Buff 配置文件
路径：\996Woool\xml\diybuff.xml

详细配置：http://cshelp.996m2.com/web/#/17/870
脚本命令添加 Buff
AddBuff	是否可省略	数值类型	说明
参数一	否	整数	BuffID
参数二	是	整数	Buff 时间(0 或不填则使用 cfg_buff.xls 配置)
参数三	是	整数	叠加层数
参数四	是	整数	目标 ID
参数五	是	文本	添加属性
格式: 属性,值|属性,值
不填则使用 cfg_buff.xls 配置
脚本命令删除 Buff
DelBuff	是否可省略	数值类型	说明
参数一	否	整数	BuffID
参数二	是	整数	目标ID
检测是否有某编号的 Buff
HasBuff	是否可省略	数值类型	说明
参数一	否	整数	BuffID
参数二	是	整数	目标ID
获取身上所有 BuffID
GetAllBuffID	是否可省略	数值类型	说明
参数一	否	变量	BuffID 存入到此变量中，分隔符#
参数二	否	变量	Buff 数量，存入到此变量中
Buff 变量
变量及格式	参数	解释	说明
<$BuffInfo(BuffID).IconGroup>			返回 Buff 图标分组
<$BuffInfo(BuffID).IconID>			返回图标分组下编号
<$BuffInfo(BuffID).TimeType>			返回 Buff 时间类型
<$BuffInfo(BuffID).Time>			返回 Buff 时间
<$BuffInfo(BuffID).Param>			返回 Buff 添加的 所有属性
<$BuffInfo(BuffID).CurOverlap>			返回 Buff 当前叠加次数
<$BuffInfo(BuffID).Overlap>			返回 Buff 叠加上限
<$BuffInfo(BuffID).paramEx>			返回 addbuff 参数五 添加的属性
cfg_att_score.xls 属性表 变量
变量及格式	参数	解释	说明
<$NEWABIL(X)>	x=属性序号		返回属性增加值
更新汇总
24.11.01.01.016 新增 183 - 189属性位调用自定义buff。
.\Mir200\Envir\ItemSuitAttribute.txt 增加参数四，0=调用套装数据库，1=调用buff表
183 - 189属性位调用的buff，时间为永久

ItemSuitAttribute里配置的buffid，不能再用addbuff添加

;此文件用于  当装备属性位200=1时    183 - 194支持对应套装属性表
;属性的位置  属性的值    调用编号    0=调用套装数据库，1=调用buff表
183 1   10001   1   ;// 183 = 1 时 ，读取套装数据库内的1号属性
184 3   10004   1   ;// 184 = 3 时 ，读取套装数据库内的2号属性
24.11.01.01.018 新增 血量控制、蓝量控制


24.11.01.01.018 新增 减少属性
数值负数为减属性


24.11.01.01.019 新增 addbuff 参数五新格式，65,32|66,32
24.11.01.01.019 新增 变量 <$BuffInfo(BuffID).paramEx>，返回脚本命令 addbuff 参数五 添加的属性
24.11.01.01.019 新增 addbuff 参数四，设置目标 ID，给怪物、角色加 buff。
怪物不支持部分属性（具体请参考 cfg_att_score.xls 属性表）
24.11.01.01.019 新增 hasbuff 新增参数二，目标 ID，检查是否存在 buff
24.11.01.01.019 新增 delbuff 新增参数二，目标 ID，删除指定 buff
24.11.01.01.019 新增 禁止 使用指定道具
格式：道具1名字#道具2名字#道具3名字



24.11.01.01.019 新增 禁止 使用 指定技能
格式：技能ID#技能ID#技能ID



24.11.01.01.019 新增 Dis_Action 字段


24.11.01.01.020 新增 cfg_att_score.xls 属性表 属性映射





染色功能
[+] 新增 衣服外观染色功能，customize_modelinfo 中增加 colormode参数
例:10013中添加了colormode参数，13 link了 10013，调用13号衣服的时候，会显示10013的染色

[
{
  "die_interval": 0.12,
  "sex": 1,
  "dir": 8,
  "horsedie_interval": 0.12,
  "sitdown_interval": 0.3,
  "horsestuck_interval": 0.12,
  "mining_interval": 0.09,
  "walk_interval": 0.04,
  "idle_interval": 0.35,
  "magic_interval": 0.085,
  "stand_pos_y": 1,
  "stand_pos_x": 0,
  "horsewalk_interval": 0.1,
  "stuck_interval": 0.08,
  "index": 11,
  "id": 10013,
  "hud_top": 20,
  "run_interval": 0.04,
  "horsestand_interval": 0.35,
  "attack_interval": 0.1,
  "type": 1,
  "horserun_interval": 0.08,
  "blendmode": 0,
  "colormode": 1
},
{
  "showstand_interval": 10,
  "id": 13,
  "stand_pos_y": 1,
  "horsestand_interval": 0.35,
  "hud_top": 20,
  "die_interval": 0.12,
  "stand_pos_x": 0,
  "horsestuck_interval": 0.12,
  "horsewalk_interval": 0.1,
  "blendmode": 0,
  "attack_interval": 0.1,
  "sex": 1,
  "horserun_interval": 0.08,
  "walk_interval": 0.04,
  "magic_interval": 0.085,
  "idle_interval": 0.35,
  "index": 4695,
  "born_interval": 0.1,
  "dir": 8,
  "type": 1,
  "horsedie_interval": 0.12,
  "run_interval": 0.04,
  "stuck_interval": 0.08,
  "link": 10013
}
]
[+] 新增 衣服内观染色功能，cfg_avatar 中增加 colormode参数
例:

{
"Cloth": {
  "131": {
    "backsfx": { "icon": 742, "x": -31, "y": 45, "blend": 0 },
    "avatar": { "icon": 335, "x": 25, "y": 8, "blend": 0, "colormode": 1 }
  },
  "132": {
    "backsfx": { "icon": 743, "x": -31, "y": 45, "blend": 0 },
    "avatar": { "icon": 350, "x": 43, "y": 4, "blend": 0, "colormode": 1 }
  }
}
}



怪物大血条功能
1. 素材
素材路径：\res\private\main\main_monster_ui

头像素材补充：怪物大血条.zip

boss一套为默认素材，客户端中已有。elite一套为补充素材，需要自己放到dev里



2. 配置怪物头像模板
配置文件：data_config\cfg_monster_target.json data_config\cfg_monster_target-win32.json

例：

{
"bigboss_1": {
  "Node_boss": { "isChange": 1, "offsetX": 0, "offsetY": 0, "positionType": 2, "name": "整个目标界面的根节点" },
  "Image_frame": { "isChange": 1, "offsetX": 0, "offsetY": 0, "res": "boss_bg.png", "name": "底图" },
  "Image_icon": { "isChange": 1, "offsetX": 0, "offsetY": 0, "res": "monster/1.png", "name": "怪物头像" },
  "Text_lv": { "isChange": 1, "offsetX": 0, "offsetY": 0, "fontSize": 16, "name": "怪物等级" },
  "Text_name": { "isChange": 1, "offsetX": 0, "offsetY": 0, "fontSize": 16, "name": "怪物名字" },
  "LoadingBar_hp_bg": { "isChange": 1, "offsetX": 0, "offsetY": 0, "name": "下一管血条坐标" },
  "LoadingBar_hp": { "isChange": 1, "offsetX": 0, "offsetY": 0, "res": "boss_hp.png", "name": "血条" },
  "Effect": { "isChange": 1, "offsetX": 0, "offsetY": 0, "name": "特效" },
  "Text_hp": { "isChange": 1, "offsetX": 0, "offsetY": 0, "fontSize": 16, "name": "怪物血条百分比文字" },
  "Text_count": { "isChange": 1, "offsetX": 0, "offsetY": 0, "fontSize": 16, "name": "怪物血条数量文字" },
  "ListView_buff": { "isChange": 1, "offsetX": 0, "offsetY": 0, "name": "怪物buff显示" },
  "Button_close": { "isChange": 1, "offsetX": 0, "offsetY": 0, "res": "close1.png", "name": "取消按钮" }
},
"bigboss_2": {
  "Node_boss": { "isChange": 1, "offsetX": 0, "offsetY": 0, "positionType": 2, "name": "整个目标界面的根节点" },
  "Image_frame": { "isChange": 1, "offsetX": 0, "offsetY": 0, "res": "elite_bg.png", "name": "底图" },
  "Image_icon": { "isChange": 1, "offsetX": 0, "offsetY": 0, "res": "monster/1.png", "name": "怪物头像" },
  "Text_lv": { "isChange": 1, "offsetX": 0, "offsetY": 0, "fontSize": 16, "name": "怪物等级" },
  "Text_name": { "isChange": 1, "offsetX": 0, "offsetY": 0, "fontSize": 16, "name": "怪物名字" },
  "LoadingBar_hp_bg": { "isChange": 1, "offsetX": 0, "offsetY": 0, "name": "下一管血条坐标" },
  "LoadingBar_hp": { "isChange": 1, "offsetX": 0, "offsetY": 0, "res": "elite_hp.png", "name": "血条" },
  "Effect": { "isChange": 1, "offsetX": 0, "offsetY": 0, "name": "特效" },
  "Text_count": { "isChange": 1, "offsetX": 0, "offsetY": 0, "fontSize": 16, "name": "怪物血条数量文字" },
  "ListView_buff": { "isChange": 1, "offsetX": 0, "offsetY": 0, "name": "怪物buff显示" },
  "Button_close": { "isChange": 1, "offsetX": 0, "offsetY": 0, "res": "close2.png", "name": "取消按钮" }
}
}
参数详解：

positionType：初始坐标点，1~9，类似与sendui的9个点
isChange：是否生效，不填为不生效
3. 调用怪物头像模板
配置文件：data_config\cfg_monster_hp.json

格式：

{
"通天教主": {  -- 怪物名
  "targettype": "bigboss_1",  --调用的模板
  "monster_icon": "monster/5.png",  --调用的模板
  "loop_count": 10,  --血条素材循环数
  "hp_count": 1822,  --血条数
  "hp_effect": 701  --血条特效
}
}
参数详解：

"loop_count": 10,  --例如：模板中配置血条素材为boss_hp.png，loop_count=10，则血条在 boss_hp、boss_hp_1~boss_hp_9这十张素材中循环显示
"hp_count": 1822,  --刷出来的怪物显示的血条数量
"hp_effect": 701  --loop_count=10，则特效在701~710中循环显示
例：

{
"通天教主": {
  "targettype": "bigboss_1",
  "monster_icon": "monster/5.png",
  "loop_count": 10,
  "hp_count": 1822,
  "hp_effect": 701
},
"练功师": {
  "targettype": "bigboss_2",
  "monster_icon": "monster/1.png",
  "loop_count": 10,
  "hp_count": 1377,
  "hp_effect": 701
}
}


文件操作

Excel表格读取功能
Excel表格读取功能
增加读取表格(Excel)功能 ReadExcel 参数一 参数二
功能说明: 读取Excel 文件里的内容
脚本命令: ReadExcel	是否可省略	值范围	说明
参数一	否	数值	Excel文件路径
参数二	否	数值	从哪一行开始读
取出行数据之后,返回变量 $996(Excel).X 表示该行数据中的列,列从0开始计数
例子:


[@读取表格第1行第1列]
#IF
#ACT
ReadExcel ..\QuestDiary\996.xls 1
SENDMSG 0 -<$996(Excel).0>

[@读取表格第1行第2列]
#IF
#ACT
ReadExcel ..\QuestDiary\996m2.xls 1
SENDMSG 0 -<$996(Excel).1>

ReadRandomStr（文本读取、排序）
命令解释：
ReadRandomStr命令，读取文本中的行，支持文本参数自动排序。

参数	说明	是否可省略
参数A	文件名称	否
参数B	变量名称，将从列表中读取字符到该变量中	否
参数C	指定行数，如果不写，则为随机读取一行。如果指定行不存在，则返回空	是
参数D-F	支持从C ~ D 行之间随机读取一段文本

当参数E和参数F有值，启用排名系统后。
参数C 取排行的名次，从0开始
注意：行数是从0开始的
参数D （值：-1、0）
-1：从小到大排列
0：从大到小排列
参数E 需要排名的整数型位置，从0开始
参数F 参数间隔符	是
示例

随机读取一行并保存到S0变量中
ReadRandomStr ..\QuestDiary\xxx.txt S0
读取指定行的内容并保存到变量S1中(读取第1行)
ReadRandomStr ..\QuestDiary\xxx.txt S1 0
读取指定范围内的随机一行并保存到S2中(1-11行随机读取一行)
ReadRandomStr ..\QuestDiary\xxx.txt S2 0 10
启用自动排序后再读取指定行(文本中的内容以|为分隔,取第2段的内容由大到小进行排序并读取排序后的第1行)
ReadRandomStr ..\QuestDiary\xxx.txt S3 0 0 1 |

S3：读取的行保存到S3变量
第一个0：读取的行数
第二个0：由大到小进行排序
1：根据第2个数据进行排序
|：每行的内容以|为分隔符

QuestDiary\xxx.txt 中的文本内容参考：
张三|100
李四|120
王五|88
赵六|89

上面脚本读取后的内容应该为：张三|100
积分排名.txt内容：
admin|442|<领奖/@Ljiang>
老赵|8642|<领奖/@Ljiang>
老吴|7929|<领奖/@Ljiang>
老孙|1389|<领奖/@Ljiang>
老张|175|<领奖/@Ljiang>

[@积分排名]
#ACT
READRANDOMSTR ..\积分排名.txt S10 0 0 1 | ;//由大到小，取第1名
READRANDOMSTR ..\积分排名.txt S11 1 0 1 | ;//由大到小，取第2名
READRANDOMSTR ..\积分排名.txt S12 2 0 1 | ;//由大到小，取第3名
READRANDOMSTR ..\积分排名.txt S13 3 0 1 | ;//由大到小，取第4名
READRANDOMSTR ..\积分排名.txt S14 4 0 1 | ;//由大到小，取第5名
SPLIT $STR(S10) | S20
SPLIT  $STR(S11) | S30
SPLIT $STR(S12) | S40
SPLIT $STR(S13) | S50
SPLIT  $STR(S14) | S60
#SAY
<  color=green 名次> <color=green 姓名> <color=green 积分> <color=green  奖励>\
第1名： <$STR(S20)> <$STR(S21)>  <$STR(S22)> <$STR(S23)>\
第2名：  <$STR(S30)> <$STR(S31)> <$STR(S32)> <$STR(S33)>\
第3名： <$STR(S40)> <$STR(S41)> <$STR(S42)>  <$STR(S43)>\
第4名： <$STR(S50)>  <$STR(S51)> <$STR(S52)> <$STR(S53)>\
第5名： <$STR(S60)> <$STR(S61)> <$STR(S62)>  <$STR(S63)>\
<刷新/@积分排名>

[@Ljiang]
#IF
EQUAL S20 $USERNAME
#ACT
SENDMSG 5 第1名奖励
Break
#IF
EQUAL S30 $USERNAME
#ACT
SENDMSG 5 第2名奖励
Break
#IF
EQUAL S40 $USERNAME
#ACT
SENDMSG 5 第3名奖励
Break
#IF
EQUAL S50 $USERNAME
#ACT
SENDMSG 5 第4名奖励
Break
#IF
EQUAL S60 $USERNAME
#ACT
SENDMSG 5 第5名奖励
Break
#ELSEACT
MESSAGEBOX 你不在排行傍中。。。

以上只是简单的演示命令的用法，实际功能还请自己根据需求自行编写！


创建文件
CreateFile 文本路径
在指定位置建立一个文本文件. 注意：文件保存在\Envir目录中

示例:
[@main]
#IF
#ACT
CreateFile ..\QuestDiary\NewFile.txt
#SAY
在Envir\QuestDiary目录中建立了一个NewFile.txt文件.

读写配置项与高速读写配置项说明
读写配置项
增加脚本命令 写配置项格式 WriteConfigFileItem 参数一 参数二 参数三 参数四
本命令用于写入 ini文件或者txt文件配置项

脚本命令: WriteConfigFileItem	是否可省略	值范围	说明
参数一	否	文本	路径
参数二	否	文本	配置项区
参数三	否	文本	配置项节
参数四	否	文本	酏置项值
[@写配置]
#IF
#ACT
WriteConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 配置内容 996M2
SENDMSG 6 写入QuestDiary\KEY.txt <$USERNAME> 配置内容 996M2
增加脚本命令 读配置项格式 ReadConfigFileItem 参数一 参数二 参数三 参数四
命令用于读取指定配置项区的某一配置项节点的值
脚本命令: ReadConfigFileItem	是否可省略	值范围	说明
参数一	否	文本	路径
参数二	否	文本	配置项区
参数三	否	文本	配置项节
参数四	否	文本	返回变量, 如果此项没有值 这个是默认值
[@读配置]
#if
#act
ReadConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 配置内容 S1
SENDMSG 6 你读取的配置内容为:S1=<$STR(S1)>
增加脚本命令 删除配置项区 DelConfigFileSection 参数一 参数二
删除对应配置项区包括其自身的所有节点
脚本命令: DelConfigFileSection	是否可省略	值范围	说明
参数一	否	文本	路径
参数二	否	文本	配置项区
[@删区]
#if
#act
DelConfigFileSection ..\QuestDiary\KEY.txt <$USERNAME>
SENDMSG 6 删区QuestDiary\KEY.txt <$USERNAME>
增加脚本命令 删除配置项区 DelConfigFileItem 参数一 参数二
删除某一个配置项区内的某一个节点
脚本命令: DelConfigFileItem	是否可省略	值范围	说明
参数一	否	文本	路径
参数二	否	文本	配置项区
参数三	否	文本	配置项节
[@删节]
#if
#act
DelConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 配置内容
SENDMSG 6 删节QuestDiary\KEY.txt <$USERNAME> 配置内容
示范脚本在本说明文末
高速读写配置项
高效率读写会缓存到内存,只有引擎关闭才会保存
使用本类方式读写配置项不能通过手动操作目标文本来修改文件内容
增加脚本命令 高效率写配置项格式 WriteCacheConfigFileItem 参数一 参数二 参数三 参数四
功能和用法跟上面非高速读写命令的使用方式一致,但是一旦使用高速读写类命令,必须全部用高速读写类命令
两类命令不能混用
脚本命令: WriteCacheConfigFileItem	是否可省略	值范围	说明
参数一	否	文本	路径
参数二	否	文本	配置项区
参数三	否	文本	配置项节
参数四	否	文本	酏置项值
[@写配置到缓存]
#IF
#ACT
WriteCacheConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 配置内容 996M2
SENDMSG 6 写入QuestDiary\KEY.txt <$USERNAME> 配置内容 996M2
[服务端] 增加脚本命令 高速读配置项格式 ReadCacheConfigFileItem 参数一 参数二 参数三 参数四
功能和用法跟上面非高速读写命令的使用方式一致,但是一旦使用高速读写类命令,必须全部用高速读写类命令
两类命令不能混用
脚本命令: ReadCacheConfigFileItem	是否可省略	值范围	说明
参数一	否	文本	路径
参数二	否	文本	配置项区
参数三	否	文本	配置项节
参数四	否	文本	配置项值 如果此项没有值 这个是默认值
参数五	是	数值	在ini文件为空时返回的值 默认0 返回空 1 返回参数4填写的变量名
[@读配置到缓存]
#if
#act
ReadCacheConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 配置内容 S1
SENDMSG 6 你读取的配置内容为:S1=<$STR(S1)>
[服务端] 增加脚本命令 高速删除配置项区 DelCacheConfigFileSection 参数一 参数二
功能和用法跟上面非高速读写命令的使用方式一致,但是一旦使用高速读写类命令,必须全部用高速读写类命令
两类命令不能混用
脚本命令: DelCacheConfigFileSection	是否可省略	值范围	说明
参数一	否	文本	路径
参数二	否	文本	配置项区
[@删区到缓存]
#if
#act
DelCacheConfigFileSection ..\QuestDiary\KEY.txt <$USERNAME>
SENDMSG 6 删区QuestDiary\KEY.txt <$USERNAME>
[服务端] 增加脚本命令 高速删除配置项区 DelCacheConfigFileItem 参数一 参数二
功能和用法跟上面非高速读写命令的使用方式一致,但是一旦使用高速读写类命令,必须全部用高速读写类命令
两类命令不能混用
脚本命令: DelCacheConfigFileItem	是否可省略	值范围	说明
参数一	否	文本	路径
参数二	否	文本	配置项区
参数三	否	文本	配置项节
[@删节到缓存]
#if
#act
DelCacheConfigFileItem ..\QuestDiary\KEY.txt <$USERNAME> 配置内容
SENDMSG 6 删节QuestDiary\KEY.txt <$USERNAME> 配置内容
示例脚本:
[@bilibili]
#SAY
<写入/@写入>\
<读取/@读取>\
<删除配置节点/@删除配置节点>\
<删除配置项目/@删除配置项目>\
<高速写入/@高速写入>\
<高速读取/@高速读取>\
<高速删除配置节点/@高速删除配置节点>\
<高速删除配置项目/@高速删除配置项目>\


[@写入]
#ACT
WriteConfigFileItem ..\快速读写.txt <$USERNAME> 账号 <$ACCOUNT>
WriteConfigFileItem ..\快速读写.txt <$USERNAME>123 账号 <$ACCOUNT>123
WriteConfigFileItem ..\快速读写.txt <$USERNAME>456 账号 <$ACCOUNT>456
SENDMSG 7 执行完毕-1

[@读取]
#ACT
ReadConfigFileItem ..\快速读写.txt <$USERNAME>456 账号 S1
SENDMSG 7 取值-<$STR(S1)>-

[@删除配置节点]
#ACT
DelConfigFileItem ..\快速读写.txt <$USERNAME>123 账号
SENDMSG 7 执行完毕-2

[@删除配置项目]
#ACT
DelConfigFileSection ..\快速读写.txt <$USERNAME>456
SENDMSG 7 执行完毕-3


[@高速写入]
#ACT
WriteCacheConfigFileItem ..\快速读写2.txt <$USERNAME> 账号 <$ACCOUNT>
WriteCacheConfigFileItem ..\快速读写2.txt <$USERNAME>123 账号 <$ACCOUNT>123
WriteCacheConfigFileItem ..\快速读写2.txt <$USERNAME>456 账号 <$ACCOUNT>456
SENDMSG 7 执行完毕-1-高速

[@高速读取]
#ACT
ReadCacheConfigFileItem ..\快速读写2.txt <$USERNAME>123 账号 S$读取值
SENDMSG 7 高速取值-<$STR(S$读取值)>-

[@高速删除配置节点]
#ACT
DelCacheConfigFileItem ..\快速读写2.txt <$USERNAME>123 账号
SENDMSG 7 执行完毕-2-高速

[@高速删除配置项目]
#ACT
DelCacheConfigFileSection ..\快速读写2.txt <$USERNAME>456
SENDMSG 7 执行完毕-3-高速


文本操作命令
增加脚本命令
INSERTVARLIST　A　B　C　D
参数	含义
A	指定行数，如果为1则表示在第一行的后面插入一行;
B	数据内容
C	文件路径
D	=0,表示可以写入重复数据
命令解释
将数据插入指定文本的指定行
增加检测命令
Pos　A　B　C
参数	含义
A	字符支持变量
B	字符支持变量
C	变量(可忽略)
补充说明
检测A字符中是否包含B内容;
不带参数C时,检测A字符中是否包含B内容;
带参数C时,从第几个字符开始检测
例
#IF
POS ABCDEFG  D
#SAY
存在！
增加检测命令
PosInlist　A　B　C　D　E
参数	含义
A	字符支持变量
B	文件路径
C	变量(可忽略)
D	返回行数(可忽略)
E	(0、1) 0为原始方式(可忽略); 1为相反检测;
作用
检测某文本中是否包含另外一段字符
检测B文本中是否包含A内容，如果存在则返回内容至C变量
D参数返回内容所在文本行数(数值型变量)
例
#IF
PosInList 测试  ..\QuestDiary\名单.txt S10 M10
#ACT
SENDMSG 5 我的行数是<$STR(M10)>
获取某段文本中以某文本为分割的第一段文本和剩余内容
GETVALIDSTR　A　B　C　D
参数	含义
A	文本
B	字符
C	变量
D	变量
例
;将A文本中，以B字符(只支持一个英文半角字符)为分割，获取第一段内容存入C变量，剩下内容存入D变量

#ACT
GETVALIDSTR 哈哈|呵呵|幻化|探讨 | S1  S2
GETVALIDSTR $STR(S2) | S1 S2
GETVALIDSTR $STR(S2) | S1 S2
检测A字符是否与B字符相同
CompareText　A　B　C
参数	含义
A	字符
B	字符
C	0/1
补充说明
C=0 表示区分大小写，默认区分大小写，可忽略;
例
#IF
CompareText  abcdefg ABCDEFG
#ELSESAY
不相同!!

#IF
CompareText abcdefg ABCDEFG 1
#SAY
相同!!
FillText A B
作用
将字符变量A以空格填满至B长度
补充说明
A 必须为文本类变量 S、 A
B 填满长度
将A变量填满至B长度，原变量中的内容不变
例
[@Test]
#ACT
MOV S1 22
FillText S1 14
inc S1 |
则 S1 为 22 |
Trim A
作用
将字符变量A中的空格去除，A必须为字符类变量;
例
#ACT
MOV S1 哈哈
INC S1 
INC S1 
INC S1 
INC S1 
INC S1 呵呵
Trim S1
\#SAY
<$STR(S1)>
显示为 哈哈呵呵
FormatStr A B C
命令说明
#32代表空格
A: 变量名称，将格式化后的字符写入相应的文本变量
B: 文本格式，应该由字符和格式化文本组成 类似：我的名字是%s
C: 变量内容，B参数中有几个格式化参数，这里就应该有几个变量内容，使用|隔开.
注意：格式化参数最多支持10个%s
例
#ACT
FormatStr S1  你的名字是%s，你的元宝还剩余%s个 <$USERNAME>|<$GAMEGOLD>
SENDMSG 7 <$STR(S1)>
分割文本字符串变量命令
SPLIT A B C D
参数	含义
A	需要分割使用的文本(支持变量)
B	以此为分割条件的文本(支持变量)
C	用于范围分割文本数组的起始变量(仅支持文本型)
D	数字型变量，返回分割总数,可不填
例如:
#ACT
MOV S0 瓦塔西瓦|传世|996 
SPLIT $STR(S0) | S60 
;以上脚本执行后，S60~S62，将依次保存分割后的文本。 
MOV S$000 瓦塔西瓦|传世|996 
SPLIT $STR(S$000) | S$接受 
以上脚本执行后，S$接受_0 ~ S$接受_2，将依次保存分割后的文本。
CopyText用于截取某一段文本中指定长度的字符串
参数说明：
A //待处理字符串
B //待拷贝字符初始位置
C //拷贝字符位数
D //保存的字符串
例如：
#IF
RANDOM 1
#ACT
COPYTEXT 123 2 2 S1
SENDMSG 7 <$STR(S1)>取出来的是:23
COPYTEXT 123哈塞给5465 4 2 S1
SENDMSG 7 <$STR(S1)>取出来的是:哈
COPYTEXT 123 2 1 S1
SENDMSG 7 <$STR(S1)>取出来的是:2
CheckTxt A，用于检测目标文件是否存在;
例：
#IF
CHECKTXT  .\QuestDiary\游戏数据\白金帐号.txt
#ACT
SENDMSG 6 该文件存在！！！
FileCopy A B，用于复制一个文件到指定目录;
参数说明：
A //被复制的文件名
B //复制到的文件名，如果目标文件存在，则直接覆盖
例：
#ACT
FileCopy  ..\QuestDiary\游戏数据\白金帐号.txt ..\QuestDiary\白金帐号.txt
Break
注:如果拷贝的文件夹在QuestDiary文件夹下则是2个”.”,其他目录下是1个”.”

$TXTLINE(A)获取指定文件的行数,A=文件路径
参数说明

SENDMSG 5 指定文本当前有“$TXTLINE(..\QuestDiary\玩家排名.txt);行；
获取指定文本拥有多少行数，文本不存在则返回-1，支持嵌套写法 ；

例:

#IF
random 1
#ACT
MOV S1 ..\QuestDiary\玩家排名.txt
SENDMSG 5 指定文本当前有“{$TXTLINE(<$STR(S1)>)};”行
break
将变量S中的 A 替换成 B
ReplaceText S A B C
脚本命令: Replacetext	是否可省略	值范围	说明
参数一	否	文本	要替换的字符型变量名
参数二	否	文本	要替换的文本
参数三	否	文本	替换的内容
参数四	是	数值	替换模式不写默认为0
模式:0-5
参数四说明:

0 = 默认模式 把参数二替换成参数三 所有相同的全部替换不分区大小写
1 = 只替换第一个相同字符 不区分大小写
2 = 只替换第一个相同字符 区分大小写
3 = 替换全部 但是区分大小写
4 = 删除第一个相同字符 不区分大小写 参数三可随便写任何东西不会进行识别
5 = 删除第一个相同字符 区分大小写 参数三可随便写任何东西不会进行识别

视频教程传送门:文本操作命令1　　　　　　　　　　文本操作命令2　　　　　　　　　　文本操作命令3

文件高速读写
格式:LoadFileToMemory 文本路径
仅支持txt ini 格式的文件比如 ..\QuestDiary\游戏数据\角色数据.txt 其他格式请勿使用~

 该命令作用是，把脚本用到的数据文件加载到内存里，脚本命令读取时直接从内存中读取，极大提高文本读写效率，常用在需要频繁读取和存储量比较大的文本。
  引擎每隔一段时间，保存一次该文件到硬盘。
  注意：
  不能手动修改该文件,只能通过脚本命令读写
  支持的脚步命令如下：
  AddNameList
  DelNameList
  CheckNameList
  ClearNameList

  AddVarList
  DelVarList
  InsertVarList
  PosInList
  ReadRandomStr

  CheckAccountList
  CheckUserDate
  CheckAccountIPList
  CheckIPList
  CheckNameIPList


列表文本操作命令
检测玩家名是否在指定文件的的指定位置内
CheckNameListPosition A B C
命令参数
参数	含义
A	玩家列表文件名
B	判断符(<、>、=)
C	位置
命令说明
本命令用于检测玩家名是否在指定文件的的指定位置内
使用示例
[@CheckNameListPosition]
#IF
CheckNameListPosition NameList.txt < 10
#ACT
SendMsg 5 [提示]:您的玩家名在NameList.txt的前10位
Break
检测玩家名是否在指定列表
CheckNameList A
命令参数
参数	含义
A	玩家列表文件名或文件路径
命令说明
本命令用于检测玩家名是否在指定列表
使用示例
[@CheckNameList]
#IF
CheckNameList NameList.txt
#ACT
Break
加入列表玩家名
AddNameList A B
命令参数
参数	含义
A	玩家列表文件或文件路径
B	=1,表示可以写入重复内容
命令说明
本命令用于在一个玩家名列表文件内加入当前玩家的名称
使用示例
[@AddNameList]
#IF
True
#ACT
AddNameList NameList.txt
Break
删除列表玩家名
DelNameList A B
命令参数
参数	含义
A	玩家列表文件或文件路径
B	=1，表示删除列表中所有与执行条件相同的文本
命令说明
本命令用于在一个玩家名列表文件内删除当前玩家的名称
使用示例
[@DelNameList]
#IF
True
#ACT
DelNameList NameList.txt
Break
清空列表玩家名
ClearNameList A
命令参数
参数	含义
A	玩家列表文件或文件路径
命令说明
本命令用于清空一个玩家名列表
使用示例
[@ClearNameList]
#IF
True
#ACT
ClearNameList ..\NameList.txt
Break
检查指定字符是否在指定文本中存在
CheckVarList A B
命令参数
参数	含义
A	字符或变量
B	列表文件名或文件路径
命令说明
检查指定字符是否在指定文本中存在
使用示例
[@CheckVarList]
#IF
CheckVarList GM01 传世主宰者名单.txt
#SAY
玩家GM01是传世主宰者。
将指定字符加入到文本中
ADDVARLIST A B C
命令参数
参数	含义
A	字符或变量
B	列表文件名或文件路径
命令说明
将指定字符加入到文本中
使用示例
[@ADDVARLIST]
#IF
True
#ACT
ADDVARLIST GM01 传世主宰者.txt
#SAY
玩家GM01获得了传世主宰者的资格。
将指定字符从文本中删除
DELVARLIST A B C
命令参数
参数	含义
A	字符或变量
B	列表文件名或文件路径
C	=1 ，表示删除列表中所有与执行条件相同的文本
命令说明
将指定字符从文本中删除
使用示例
[@DELVARLIST]
#IF
True
#ACT
DELVARLIST GM01 传世主宰者.txt
#SAY
玩家GM01失去了传世主宰者的资格。


csv文件读取
 加载csv表格：NewReadcsv 路径

  读取表内指定行列的内容(0行0列开始)：NewDQcsv 路径 行数 列数 存到变量

  获取当前表格最大行数、和获取表格最大列数：GetHLcsv 路径 0,1(0=行数 1= 列数) 存入变量名

  取字符串在csv表格中的行号
  格式：GetGJCSV 参数1 参数2 参数3 参数4 参数5 参数6
  参数1=路径
  参数2=字符串
  参数3=开始行号~结束行号(表内容太多,整张表取会慢,所以建议设定号开始行号和结束行号)
  参数4=在表第几列查找
  参数5=0或1(0=从上往下 1=从下往上)
  参数6=存入变量名

  下面为全部例子：
  ;加载csv表格内容：
  [@加载表格]
  #IF
  True
  #ACT
  NewReadcsv ..\QuestDiary\test.csv
  SENDMSG 6 加载成功

  ;读取表内指定行列的内容：
  [@读取表第几行第几列内容]
  #IF
  True
  #ACT
  NewDQcsv ..\QuestDiary\test.csv 2 2 S0
  SENDMSG 6 表里面的第二行第二列是：<$STR(S0)>

  ;获取当前表格最大行数、和获取表格最大列数：
  [@取最大行号]
  #IF
  True
  #ACT
  GetHLcsv ..\QuestDiary\test.csv 0 N0
  SENDMSG 6 最大行数：<$STR(N0)>
  GetHLcsv ..\QuestDiary\test.csv 1 N1
  SENDMSG 6 最大列数：<$STR(N1)>

  NEWREADCSV ..\Data\cfg_guanzhi.csv 表格名字前面增加cfg读取时会已常量形式存放在内存中(如果不经常更改的情况下建议放在QM的[@GrobalVar]启动触发执行)

  我们通过以下去读相关内存中的表格常量值
  1.<$cfg_guanzhi(1_1)> 读取行列（行列可套用任意变量） 行列默认从0开始
  2.<$GetTypeBRow(cfg_guanzhi,4,GUANJIAN)> 起始行,检测关键字所在的行数 (取第4列的,关键字"GUANJIAN"所在的初始行 ) 行列默认从0开始
  3.<$GetTypeERow(cfg_guanzhi,5,GUANJIAN)> 结束行 (取第5列的,关键字"GUANJIAN"所在的最后一行 ) 行列默认从0开始
  4.<$Getcsv(cfg_文件名,Row)> 获取最大行数 建议启动获取，保存为变量 (行数默认从1开始)
  5.<$GetCsv(cfg_文件名,Col)> 获取最大列数 按照第1行计算 同上 (默认从1开始)
  (*)最大行数或表格行数不正确时，请使用TXT打开查看下方是否有存在多出来的空行”,”，一般存在这种情况都是未删干净导致的，所以通常做完表格一定要及时用TXT打开确认是否存在多余的空行！


行会相关功能


脚本创建行会
脚本创建行会
AutoAddGuild A B
参数说明：
A=行会名
B=会长名称（省略时,只会建立空行会）

检测坐标范围内相同行会人数
检测当前坐标范围内相同行会的人数
CHECKGUILDRANGENUM A B C
A = 范围大小
B = 检测符 = > < ?
C = 人数
脚本命令: CHECKGUILDRANGENUM	是否可省略	值范围	说明
范围大小	否	数值	范围大小
检测符	否	字符	= > < ?
人数	否	数值	指定范围的人数

添加行会成员
ChangeGuildMember 参数一 参数二 参数三
参数说明：
ChangeGuildMember	说明	类型	是否可以省略
参数一	行会名	文本	否
参数二	玩家名	文本	否
参数三	加入后职位(1=会长 5=成员 默认=5)	数字	是
支持直接添加无行会会员到行会
支持直接添加成行会会长
支持多会长添加
此命令无需玩家输入 @加入门派


行会指数操作命令
行会建筑、繁荣、人气、安定指数 － 变量
变量	含义
<$GUILDBUILDPOINT>	行会建筑指数
<$GUILDFLOURISHPOINT>	行会繁荣指数
<$GUILDAURAEPOINT>	行会人气指数
<$GUILDSTABILITYPOINT>	行会安定指数
命令说明
行会建筑、繁荣、人气、安定指数的显示变量

使用示例
[@ShowGuildPoint]
#IF
True
#SAY
建筑指数：<$GUILDBUILDPOINT>\
繁荣指数：<$GUILDFLOURISHPOINT>\
人气指数：<$GUILDAURAEPOINT>\
安定指数：<$GUILDSTABILITYPOINT>
检测行会建筑、繁荣、人气、安定指数
CheckGuildBuildPoint Type Count

CheckGuildAuraePoint Type Count

CheckGuildStabilityPoint Type Count

CheckGuildFlourishPoint Type Count

命令参数
参数	含义
Type	操作符号.可选>、<、=
Count	操作指数的数量
命令说明
本命令用于检测行会建筑、繁荣、人气、安定指数

使用示例
[@CheckGuildPoint]
#IF
CheckGuildBuildPoint = 100
CheckGuildAuraePoint = 100
CheckGuildStabilityPoint = 100
CheckGuildFlourishPoint = 100
#ACT
Break
调整行会建筑、繁荣、人气、安定指数
GuildBuildPoint Type Count

GuildAuraePoint Type Count

GuildStabilityPoint Type Count

GuildFlourishPoint Type Count

命令参数
参数	含义
Type	操作符号.可选+、-、=
Count	操作指数的数量
命令说明
本命令用于调整行会建筑、繁荣、人气、安定指数

使用示例
[@GuildPoint]
#IF
True
#ACT
GuildBuildPoint = 100
GuildAuraePoint = 100
GuildStabilityPoint = 100
GuildFlourishPoint = 100
Break


行会列表相关命令
检测行会名是否在指定列表
CheckGuildList GuildFileName
命令参数
参数	含义
GuildFileName	行会列表文件名
命令说明
本命令用于检测行会名是否在指定列表

使用示例
[@CheckGuildList]
#IF
CheckGuildList GuildNameList.txt
#ACT
Break
加入列表行会名
AddGuildList GuildFileName
命令参数
参数	含义
GuildFileName	行会列表文件名
命令说明
本命令用于在一个行会列表文件内加入当前玩家所在的行会名
使用示例
[@AddGuildList]
#IF
HaveGuild
#ACT
AddGuildList GuildNameList.txt
Break
删除列表行会名
DelGuildList GuildFileName
命令参数
参数	含义
GuildFileName	行会列表文件名
命令说明
本命令用于在一个行会列表文件内删除当前玩家所在的行会名
使用示例
[@DelGuildList]
#IF
HaveGuild
#ACT
DelGuildList GuildNameList.txt
Break
视频教程传送门:行会相关


行会等级命令
脚本命令行会等级
GuildLEVEL X Y Z
用于客户端显示当前行会等级 客户端实时显示
变量返回 $GUILD.GUILDLEVEL
命令参数:

参数	含义
X	行会名称(支持变量)
Y	操作符，可以是+、-、=
Z	数值
示例

[@ChangeGuildLeve]
#IF　
True
#ACT
GuildLevel 行会名称 = 5
视频教程传送门:升级行会


行会相关触发
行会相关触发整理
点击创建行会按钮触发Qf @BuildGuild 标签

;QFunction-0.txt

    //;创建行会前触发
    [@CheckBuildGuild]
    #IF
    #ACT
    SENDMSG 7 禁止<$USERNAME>创建行会
    Stop

    //;加入行会前触发例子
    [@GuildAddMember]
    #IF
    LARGE N$P30 0
    #ACT
    SENDMSG 7 [<$STR(N$P30)>]秒后你才可以加入行会
    Stop

    //;加入行会触发
    [@GuildAddMemberAfter]

    ;//掌门踢出行会成员前触发
    [@GuildChiefDelMember]
    #IF
    #act
    stop
    sendmsg 7 禁止踢出行会

    //;编辑行会公告前触发

    [@UpdateGuildNotice]

    //;退出行会前触发
    [@GuildDelMemberBefore]

    //;解散行会前
    [@GuildCloseBefore]

    //;解散行会
    [@GuildClose]

    [@InivitGuild]
    #IF
    #act
    Stop
    sendmsg 6 邀请入会前触发


;Qmanage.txt

    //;退出行会触发
    [@GuildDelMember]
    #IF
    #ACT
    SENDMSG 7 <$USERNAME>退出<$PARAM(0)>行会原称号<$PARAM(1)>


行会变量说明
行会变量说明
变量及格式	参数	解释	说明
<$OWNERGUILD>			沙城所属的行会
<$GUILDNAME>		行会名字	行会名称
<$GUILDGOLD>			显示个人行会银两
<$GUILDBUILDPOINT>			行会建筑指数
<$GUILDAURAEPOINT>			行会人气指数
<$GUILDSTABILITYPOINT>			行会安定指数
<$GUILDFLOURISHPOINT>			行会繁荣指数
<$GUILD.A>	A=参数类型	取值: 返回人物相应的行会参数
　NAME 行会名字
　GUILDEXP 行会经验
　MAXMEMBER 最大人员数
　MEMBERCOUNT 当前人员数
　MEMBERCOUNT 当前人员数
行会通灵塔五大资源变量，如下：
　ORE 矿石
　GEM 宝石
　WOOD 木材
　BAR 金条
　ROCK 灵石
行会通灵塔每日维护所需五大资源变量：
　OREMAX 矿石
　GEMMAX 宝石
　WOODMAX 木材
　BARMAX 金条
　ROCKMAX 灵石	返回人物相应的行会参数
<$GUILDINFO(A).B>	A=行会名字
B=参数类型
行会名字不存在返回????	B取值: 返回人物相应的行会参数
　CHIEF 行会会长名字
　NAME 行会名字
　GUILDEXP 行会经验
　MAXMEMBER 最大人员数
　MEMBERCOUNT 当前人员数
　MEMBERCOUNT 当前人员数
行会通灵塔五大资源变量，如下：
　ORE 矿石
　GEM 宝石
　WOOD 木材
　BAR 金条
　ROCK 灵石
行会通灵塔每日维护所需五大资源变量：
　OREMAX 矿石
　GEMMAX 宝石
　WOODMAX 木材
　BARMAX 金条
　ROCKMAX 灵石	返回人物相应的行会参数
<$ALLGUILDLIST(A).B>	A = 编号 从 0 开始　不能大于等于行会总数
B = 属性值 与GUILDINFO 相同	B取值: 返回人物相应的行会参数
CHIEF 行会会长名字
NAME 行会名字
GUILDEXP 行会经验
MAXMEMBER 最大人员数
MEMBERCOUNT 当前人员数
MEMBERCOUNT 当前人员数
行会通灵塔五大资源变量，如下：
　ORE 矿石
　GEM 宝石
　WOOD 木材
　BAR 金条
　ROCK 灵石
行会通灵塔每日维护所需五大资源变量：
　OREMAX 矿石
　GEMMAX 宝石
　WOODMAX 木材
　BARMAX 金条
　ROCKMAX 灵石	返回对应编号的行会参数
<$ALLGUILDNUM>			返回当前游戏行会总数
<$GUILD(A)>	A=变量名	比如：<$GUILD(HHYB)>	显示行会自定义变量值


组队相关功能


组队范围检测开启命令
组队范围检测开启命令
OpenGroupGap 参数1(1=开启 0=关闭 ) 参数二(需要检测的范围大小)
脚本命令: OpenGroupGap	是否可省略	值范围	说明
开关	否	数值	0=关闭 1= 开启
范围	否	数值	需要检测的范围大小
例如
OpenGroupGap 1 11

当开启此功能时会触发 QM下 [@组队范围开启]  
当关闭此功能时会触发 QM下 [@组队范围关闭]  

此功能开启时当队员走入到队长的11格范围之内会触发 QM下 [@队员进入]
离开11格范围之外会触发 QM下 [@队员离开]


队伍检测
检测是否是队长
ISGROUPOWNER
无命令参数
命令作用
检测当前人物是否是组队的队长。

使用示例
[@ISGROUPOWNER] 
#IF
ISGROUPOWNER
#SAY
你是队长
检测队伍人数
CHECKGROUPCOUNT 　A　B
命令参数
参数	含义
A	操作符号.可选>、<、=
B	检测的数量
命令作用
检测当前玩家队伍中的队员人数。

使用示例
[@CHECKGROUPCOUNT]
#IF
CHECKGROUPCOUNT > 1
#SAY
你所在的队伍人数大于1人。


编组传送
编组传送——队员执行
GROUPMOVE　A 　B
命令参数
参数	含义
A	地图号
B	为1则取消@天地合一检测
命令作用
将所有队员传送到指定地图

补充说明
所有本组队员均可以使用该命令;
使用此命令必须配合Map或MapMove命令使用,否则无效!

使用示例
[@GROUPMOVE]
#IF
CHECKGROUPCOUNT > 1
#ACT
MAP AS004
GROUPMOVE AS004 1
#ELSESAY
你没有组队,不能使用本功能
编组传送——队长执行
RECALLGROUPMEMBERS　 A 　B
命令参数
参数	含义
A	地图号
B	为1则取消@天地合一检测
命令作用
将所有队员传送到指定地图

补充说明
只有当前人物为队长时才可以使用该命令;
使用此命令必须配合Map或MapMove命令使用,否则无效!

使用示例
[@RECALLGROUPMEMBERS]
#IF
ISGROUPOWNER
#ACT
MAP AS004
RECALLGROUPMEMBERS AS004 1
#ELSESAY
你不是队长,不能使用本功能


队伍相关变量
显示队员名字
$GROUPMEMBER(X)
命令参数
参数	含义
X	显示队伍中第X个队员的名字 X=0..队员数-1 例：想显示第1个队员名字的话，X等于0
命令作用
将当前玩家所在队伍中的队员的名字显示在脚本中。

显示队长名字
$GROUPMASTER
无命令参数
命令作用
将当前玩家所在队伍中的队长名字显示在脚本中。

显示队员人数
$GROUPCOUNT
无命令参数
命令作用
将当前玩家所在队伍中的队员人数显示在脚本中。