“通用剧情事件指令说明”的版本间的差异

2020年1月27日 (一) 12:52的版本

特别注意：脚本编辑时注意所有特殊符号必须为半角！！！同时在剧情和所有配置表里也要避免使用带有特殊符号的字符串，以防止和脚本配合使用时发生脚本注入错误！

1 剧情事件
2 脚本命令列表
3 全局存档相关的操作指令
4 内置指令列表
5 脚本预设字段及含义
6 剧情事件中的结果脚本指令格式
7 条件表达式组格式
8 游戏数据中运算值表达式系统说明
9 剧情事件中可用的嵌入式查询指令
10 全局存档查询指令字段
11 内置自定义变量字段
12 对话框及一些通用UI中支持的字体颜色指定代码
13 人物角色位置指令格式
14 游戏内全局位置指令格式
15 特定战斗中的单位限制指令格式
16 大地图单位控制指令表
17 物品列表信息格式
18 天气效果信息格式
19 镜头滤镜效果信息格式
20 人物表中具有特殊含义的TAG
21 地点表中具有特殊含义的TAG
22 物品表中具有特殊含义的TAG
23 物品道具词条信息格式
24 物品掉落信息格式
25 地图假人设置及控制方法说明
26 地图宝箱设置说明
27 地图野怪设置说明
28 特效对象事件脚本指令格式

剧情事件

剧情事件是游戏过程中用来实现剧情脚本的基本元素。游戏中所有的剧情事件都是由触发器或者执行器调用并丢入指令队列中，然后在游戏中由世界事件管理器(GameWorldManager)在游戏世界时间运行时顺序执行的。一个完整的剧情事件主要由以下部分组成：

剧情事件ID：用以唯一标识该剧情事件；
命令内容：包含该剧情事件触发后执行的命令条目；
结果：根据命令条目最后一条的返回结果，进行条件判定并跳转；

脚本命令列表

游戏事件中执行的脚本指令一般由：指令类型*参数1#参数2#..#参数N 这样的格式组成，多行指令由换行符进行分隔。

目前支持的脚本命令条如下：


指令	说明
（空）	角色对话框用途：以角色立绘+文字打印的方式显示一段对话文本格式：角色ID(@立绘显示位置)#对话段落1#对话段落2#对话段落3#...#对话段落N 备注：当对话框某段文字需要绑定语音时，在该段文字之前加上<voice:语音ID>就可以在显示该段文字时播放对应声音文件，当点击跳过时自动关闭当前语音每段对话文字可以以“\|”分隔写出多组随机对话段落，调用时会在其中随机选出一段进行返回。当对话内容以“inner:...”开头时，为用特殊信息替换内容；以下为内置的特殊信息ID及含义： inner:set_player_job 给对象为玩家的角色设置工作指令时说的话 inner:set_player_lord 任命玩家为城主时说的话 inner:self_introduce 角色的自我介绍 inner:cur_doing 当前角色正在进行的工作内容 inner:cur_team_intent 当前队伍的目的立绘显示位置：可以是L或者R，默认为L，立绘显示在对话框左侧，R则显示在右侧
EVENT	跳转事件用途：跳转并执行指定的剧情事件ID 格式：EVENT*剧情事件ID#跳转至目标事件的子命令行index值（从0开始）
SUB_EVENT	跳转子事件用途：跳转并执行指定的子事件，并可通过 SUB_EVENT_RETURN 指令跳转回来格式：SUB_EVENT*剧情事件ID
SUB_EVENT_RETURN	返回子事件用途：从当前子事件中返回上一次跳转来的事件位置格式：SUB_EVENT_RETURN*
SELECT	角色对话选择框用途：在角色对话框的基础上，当打印完对话内容后，弹出一个选项框让用户选择并返回结果（对应剧情事件中的结果命令中的[%result_code%]）格式：SELECT角色ID#对话内容#1:选项一条件组一;2:选项二条件组二;...;N:选项N条件组N （只有当条件组满足或者为空时才会显示，否则隐藏该选项）备注：当选项Key值以"+"开头时表示该选项选中后对话框不会关闭；
SELECT_TALK	插件式对话选择框用途：可通过触发器表来扩展选项内容的选择框格式：SELECT角色ID#对话内容#[ADDON_SELECT];[固定选项(例如：0:取消)]#筛选标签(以"\|"分隔，默认为any) 备注：前2个参数和SELECT相同，第4个参数为触发器type（不填写默认为any），不过会从触发器中选择触发类型为SELECT且满足条件的选项添加到选项中，显示的文字为触发器中的绑定选项，触发事件为触发事件ID对应的事件。注意：使用时需要在结果中添加一行[%result_code%][>]99:EVENTPOJO_EVENT 在触发器表中触发事件ID支持增加前缀“SUB_EVENT.”来标记该事件为一个子事件。
CMD_SELECT	系统选择框用途：弹出一个只有确定按钮的文字框格式：CMD_SELECT*选择提示信息#选项组（同SELECT命令）
CONFIRM	文字确认框用途：弹出一个只有确定按钮的文字框格式：CONFIRM*确认文字内容
TOAST	屏幕短消息提示用途：在屏幕中弹出一段文字，隔一小段时间自动消失格式：TOAST*弹出信息内容
BB	角色头像提示对话框用途：在屏幕指定UI区域弹出一个有角色头像的对话框，不会打扰当前的操作且不需要进行操作，对话结束后自动消失格式：BB*角色ID#对话内容#等待额外延时(以秒为单位，按照文字长度自动停留时间再加上此项)
GAME_MSG	游戏内消息通知用途：在UI中的消息框中显示一段文字消息，并且可以再消息记录中查阅格式：GAME_MSG*消息内容#消息类型(0:普通 1:警告 2:系统)
INPUT	文字输入框用途：弹出一个文字输入框，并将输入结果保存在可查询变量中([%input_str%]) 格式：INPUT*提示文字#Len限制字数#默认文字
DELAY	延时等待用途：延时等待一小段时间（以真实时间秒数为单位，期间不能进行任何操作）格式：DELAY*等待时间（秒）
SCREEN	全屏字幕用途：全屏显示一个屏幕字幕（默认背景为黑色，可设置背景透明度）格式：SCREEN*字幕显示文字#字幕配全屏图资源名称(空为不配图)#背景透明度(可选，默认为1)
BLACK_SCREEN	屏幕黑幕用途：给屏幕UI层覆盖一层黑色的幕布，仅可在其上显示全屏字幕等UI对象格式：BLACK_SCREEN*是否开启(0：关闭 1：开启)
SHAKE_SCREEN	屏幕晃动用途：执行一个屏幕晃动效果格式：SHAKE_SCREEN时间(秒)#烈度 (如：SHAKE_SCREEN0.3#3)
SET_WEATHER	设置当前游戏天气用途：设置并覆盖当前的游戏天气效果格式：SET_WEATHER*天气效果命令备注：天气效果命令格式：天气效果ID1,强度\|天气效果ID2,强度\|...\|天气效果ID N,强度如：雪,60\|雾,20 强度值范围0~100，当为0时表示关闭该效果天气效果ID见6.9章
BATTLE	执行战斗用途：执行一个定义在特定战斗表或者当前遭遇战的战斗格式：BATTLE*战斗ID （当不指定战斗ID或为"ENCOUNTER"则开启当前遭遇战）
BATTLE_WITH	与指定单位目标进行战斗用途：与指定的单位目标开始一场自定义战斗格式：BATTLE_WITH*对方角色信息（可选）#对方兵牌信息（可选）#战场地图信息（可选）#战场地点信息（可选）#战场天气（可选）#bgm(可选）
BATTLE_WITH_TAGROLE	与目标角色进行战斗用途：立即与当前的目标角色开始一场特定战斗格式：BATTLE_WITH_TAGROLE*战斗ID（战斗ID只是用来触发剧情事件）
CHANGE_BGM	更改当前游戏的背景音乐用途：根据剧情需要更改当前游戏播放的背景音乐格式：CHANGE_BGM*参数1#参数2 参数1：目标BGM的AudioID(如果需要定义中文名，需要加前缀@，并在音效表中定义中文名对应的音效文件，类型必须是BGM，为空时表示切换回当前地图默认的BGM，当该ID为保留字段”MUTE”时，表示当前不播放BGM) 参数2：有效期类型（0：切换场景时无效 1：始终有效，哪怕保存游戏再进来，除非再次调用CHANGE_BGM指令指定一个空的AudioID）
PLAY_SOUND	播放游戏音效用途：播放一段游戏音效格式：PLAY_SOUND*音效ID#延迟播放时间（默认0秒）
PLAY_ROLE_VOICE	播放角色语音用途：播放定义在角色tags中"Voice"项中的语音音频文件格式：PLAY_ROLE_VOICE*角色ID，该处关联角色tags中“Voice”一栏设定。
DUNGEON	【暂不可用】
NUMSEL	数值输入框用途：弹出一个文字输入框，并将输入结果保存在可查询变量中([%result_code%]) 格式：NUMSEL*输入框显示文字#最小值#最大值#默认值#单价#单价计算显示信息（当单价为0时不显示单价信息，否则需要按照"每个单位{0}银两，共需{1}银两"这样的格式进行指定）
CHANGE_MONEY	更改主角所持的金钱数量用途：按照变更值改变主角所持金钱数，可为负数代表减少格式：CHANGE_MONEY*金钱变更数量
ROLE_CHANGE_MONEY	更改指定英雄所持的金钱数量用途：按照变更值改变指定角色所持金钱数，可为负数代表减少格式：ROLE_CHANGE_MONEY*英雄ID#金钱变更数量
GETITEMS	主角获得道具或资源用途：主角直接获得指定的道具列表（注意：游戏中的金钱、经验等资源都可以通过此方法来获得，只要传入正确的映射ID即可）格式：GETITEMS道具列表信息（如GETITEMS商会茶叶,3\|面包,1）
AI_CAMP_GETITEMS	全势力获得道具或资源用途：同GETITEMS指令，但是生效的主体从主角改为所有调用当前指令的势力实体格式：AI_CAMP_GETITEMS*道具列表信息
TRANSFER_ITEMS	转换道具用途：按照比例将现有道具表中的指定道具转换为新的道具格式：TRANSFER_ITEMS原道具ID#新道具ID#原数额#新数额#转化次数例如：TRANSFER_ITEMS小麦#小麦粉#1#1#10，表示将小麦1:1转化为小麦粉，转化10次。如果任何一次转化过程中原道具数量不足，则停止转换。
GET_RND_ITEM	随机抽取一组道具用途：在几组道具之中随机选中并获取一组道具格式：GET_RND_ITEM对象道具列表（如GET_RND_ITEMS茶叶,3\|面包,1\|牛奶,2 表示从此3种道具总随机取一种）
REMOVE_ITEMS	移除指定道具或资源用途：根据指定的道具数量从主角道具表中移除指定数量的道具格式：REMOVE_ITEMS*道具列表
REMOVE_PRESENT	移除符合要求的指定礼物道具用途：根据指定的礼物标签移除道具列表中一个礼物道具格式：REMOVE_PRESENT*礼物筛选描述信息，礼物描述字符串格式参加任务列表中Tag栏中“Like”这个tag的格式
ITEMS_SELECTOR	打开道具选择对话框用途：弹出一个道具选择对话框，并将选择结果保存在可查询变量中([%last_seled_items%],[%last_seled_item_id%]等) 格式：ITEMS_SELECTOR*选择框标题#数量限制(小于0为不限制)#筛选条件表达式
LOOT	打开道具选择对话框用途：弹出一个道具选择对话框，并将选择结果保存在可查询变量中([%last_seled_items%],[%last_seled_item_id%]等) 格式：LOOT*Loot列表 (信息格式见 )
TEAM_GAINEXP	主角队伍获取经验值用途：根据均分原则对主角队伍增加一次经验值格式：TEAM_GAINEXP*获得的经验值（每张卡牌均有等量经验）
TEST_ADD_ROLE_EXP	指定英雄获取经验用途：对一个指定的角色增加经验值格式：TEST_ADD_ROLE_EXP*英雄ID#经验
CHANGE_ROLE_LV	更改角色的等级用途：更改一个指定的角色的等级格式：CHANGE_ROLE_LV*英雄ID#指定等级
PLAYER_GUARDS_LEVELUP	地点所有守军英雄升级用途：直接把一个地点下所有的守军等级提升一级格式：PLAYER_GUARDS_LEVELUP*地点ID
PLAYER_TEAM_LEVELUP	主角队伍中所有的英雄升级用途：直接升级主角队伍里所有的英雄格式：PLAYER_TEAM_LEVELUP*
SETTRIGG	设置触发器开关用途：直接开启或关闭一个触发器格式：SETTRIGG*触发器ID#状态值(0为开启，1为关闭)
TRIGGER	执行触发器用途：直接执行一个指定的触发器格式：TRIGGER*触发器ID
SET_ES	手动设置剧情事件状态用途：手动设置一个剧情事件的执行状态(正常的事件执行逻辑执行后会以当前事件的ResultCode标记事件状态结果) 格式：SET_ES剧情事件ID状态值(-1未执行过其他为该事件ResultCode)
SETINTVAR	设置自定义整形变量用途：设置一个整形的自定义变量（会被存档所记录），其中一部分变量字段可对游戏中的一些逻辑参数进行关联（已在程序内部定义并关联的整形自定义变量见《自定义变量参数表》），并可通过内置查询参数进行查询([%int_val:ID%]) 格式：SETINTVAR*变量ID#当前int值
CHANGEINTVAR	改变自定义整形变量用途：通过改变值来根据当前自定义变量的值进行更改格式：CHANGEINTVAR*变量ID#改变值（正负数皆可）#【可选：forceZero】，填写forceZero后，扣负只会扣到零，不会为负数。
SET_TEMP_ID	设置临时ID变量用途：设置一个临时的ID，不会被存档保存，通过特殊方式进行访问格式：SET_TEMP_ID*ID
SETSTRVAR	设置自定义字符串变量用途：设置一个字符串变量（会被存档记录），可通过内置查询参数进行查询([%str_val%]) 格式：SETSTRVAR*变量ID#string值
SETGAMETIMETAG	标记自定义关键时间点用途：标记并按ID记录当前的游戏时间点，之后可以通过[%tag_gametime_elapse%]读取该时间点ID的已流逝时间。【注意：该指令仅用于在一系列story中进行临时变量传递，该tag不会在存档中被保存，请勿用于需要持久化数据的场景】格式：SETGAMETIMETAG*时间点ID
SETGAMETIME	标记自定义游戏时间点用途：标记并按ID记录当前的游戏时间点（会被存档记录），可通过查询参数查询此时间相关的信息（见[%gametime_elapse%]、[%gametime_elapse_by_day%]等查询说明）格式：SETGAMETIME*时间点ID
SET_CUSTOM_CD	设置一个自定义冷却时间用途：设置一个自定义的冷却时间计时器，可通过[%is_custom_cd:ID%]是否为1来判断此CD当前是否可用格式：SET_CUSTOM_CD*自定义ID#CD时间(≤0为关闭此CD，＞0时设置指定时间，单位：天)
GET_QUEST	领取一个任务用途：领取指定的任务格式：GET_QUEST*任务ID
ADD_QS	增加任务子项计数器用途：手动增加一个任务子项的计数器格式：ADD_QS*任务ID#子项index(0开始)#增加数量
SETQUESTIEM	设置任务子项的值用途：设置指定任务子项的值格式：SETQUESTIEM*任务ID#子项index#设置的值
DONE_QUEST	完成一个任务用途：标记并完成指定的任务格式：DONE_QUEST*任务ID#是否给奖励(1是)
SHOW_IMG	显示一个立绘图片框用途：标记并完成指定的任务格式：SHOW_IMG图片资源名称预设特效0*停留时间(秒)
CLOSE_IMG	关闭当前的立绘图片框用途：关闭当前的立绘图片框格式：CLOSE_IMG*预设特效0
JOIN_ROLE	强制指定角色加入队伍用途：强制一个指定角色加入队伍，如果当前队伍已满，会显示处置界面格式：JOIN_ROLE*人物ID
QUIT_ROLE	强制指定角色离队用途：强制一个指定的角色离开主角队伍格式：QUIT_ROLE*人物ID
SET_PLACE	更改地点的状态用途：设置一个地点的当前状态格式：SET_PLACE*地点ID#状态值（0正常 1被摧毁 -1隐藏）
SET_ROLEPOS	设置角色位置用途：强制设置一个角色的位置（人物位置信息格式见人物位置信息说明）格式：SET_ROLEPOS*人物ID#位置信息
LEAVE_PLACE	【暂不可用】
TELEPORT	主角传送至指定位置用途：将主角队伍传送至指定世界位置格式：TELEPORT*世界位置信息
TELEPORT_TO_PLACE	主角传送至指定地点用途：将主角队伍传送至指定地点的位置格式：TELEPORT_TO_PLACE*地点ID
TELEPORT_TO_ROLE	主角传送至指定目标角色附近用途：将主角队伍传送至指定角色所在的位置（只有目标角色位于队伍或者地点中时方可生效）格式：TELEPORT_TO_ROLE*人物ID
MAP_CMD	沙盒地图单位控制专用指令集用途：用于在沙盒地图上控制各种单位进行指定命令格式：MAP_CMD*指令内容移动至指定坐标：MOVETO#对象ID#目标坐标x,y#等待回调(1:否 0:是) 追逐指定目标：CHASE#对象ID#目标ID#等待回调(1:否 0:是) 主角进入指定地点：ENTER_PLACE#目标地点ID#进入方式(0普通 1潜入)#是否屏蔽enter_place事件(0否 1是) 显示一个战斗标记：SHOW_BATTLE_MARK#目标坐标x,y 隐藏当前战斗标记：HIDE_BATTLE_MARK#1
RESTORE	回复主角队伍卡牌耐久用途：用于回复主角队伍所有卡牌的耐久度格式：RESTORE*参数（<=0：回复队伍所有耐久 >0：仅指定点数的耐久）
TIME_ELAPSE	快速时间推进用途：使用该指令可快速的推进游戏时间，期间会显示一个时间进度条格式：TIME_ELAPSE*游戏时间#时间倍率#框体信息#允许取消(0[默认] 是 1否)#显示进度条（0[默认]否 1是）#操作显示图标(Assets\BuildSource\Icons下的图标文件名)#UI是否跟随主角单位(0否 1是)
WAIT_EXEC	等待并执行一个脚本事件用途：显示一个计时器，并等待指定的游戏时间，当时间到达时，会执行指定的脚本事件格式：WAIT_EXEC*游戏时间#时间倍率#框体信息#允许取消(0[默认] 是 1否)#时间到达时执行的事件ID#操作显示图标(Assets\BuildSource\Icons下的图标文件名)#是否跟随主角单位(0否 1是)
OPENSEIGE	打开围城处置界面用途：显示一个围城处置界面，根据预设来操作增援部队（需配合适当的指令触发环境，如：进城触发器）格式：OPENSEIGE*界面模式 0：攻城 1：守城
OCCUPY	执行攻城占领用途：直接根据当前环境执行攻城占领判定（需配合适当的指令触发环境，如：进城触发器）格式：OCCUPY*0
JOIN_WARBAND	加入战团用途：加入一个已经创建的战团（战团ID一般通过[$tagwb:id$]来取得当前遭遇到的战团信息）格式：JOIN_WARBAND*战团ID
CHANGE_CAMP	改变角色阵营用途：直接改变一个目标角色的阵营格式：CHANGE_CAMP*阵营ID#目标角色ID#招募者ID(如果指定此字段为主角则直接进入主角队伍)
CREATE_OWN_CAMP	创建主角自己的阵营势力用途：创建并激活主角自己的势力。主角自己的势力势力拥有一个默认且固定的势力ID：自建势力，此势力游戏一开始就存在，只是出于非激活状态，调用此指令后主角自建势力将激活并处于可用状态，同时主角及其下属角色都将改变至此势力中格式：CREATE_OWN_CAMP*自建阵营势力名称
SET_CAMP_ACTIVE	改变阵营活跃状态用途：改变势力的活跃状态。当势力处于非活跃状态时，不会进行各种决策或者势力行为格式：SET_CAMP_ACTIVE*阵营ID#状态值（0不活跃 1活跃）
SET_CAMP_RL	改变阵营关系用途：改变阵营势力之间的外交关系状态或友好值格式：SET_CAMP_RL*阵营A#阵营B#关系状态(-1:不改变状态 0:中立 1: 敌对 2:友善)#友好度改变值#友好值目标值（如果存在该字段）
CHG_CAMP_REP	改变主角对阵营的声望值（贡献值）用途：改变主角与阵营的声望值（贡献值）格式：CHG_CAMP_REP*目标阵营ID#更改数值#目标值（当不为空时生效），阵营ID为空时表示当前所属阵营
CHG_PLACE_REP	改变主角对地点的声望值（友好值）用途：改变主角对地点的声望值（友好值）格式：CHG_PLACE_REP*地点ID#更改数值#目标值（当不为空时生效）
FAME	修改主角全局声望值用途：修改主角当前的全局声望值格式：FAME*改变值
CHANGE_FAME	修改指定角色的全局声望值用途：修改一个指定角色当前的全局声望值格式：CHANGE_FAME*目标人物ID#更改数值
CHG_PERSON_FV	改变主角与游戏角色的好感度用途：修改主角与指定游戏角色的友善度格式：CHG_PERSON_FV*目标人物ID#更改数值#目标值（当不为空时生效）
SET_ROLE_ACTIVE	改变角色活跃状态用途：改变一个非主角角色的活跃状态。当角色处于非活跃状态时，不会自动刷新在在野酒馆里，也不会进行迁移等AI操作格式：SET_ROLE_ACTIVE*人物ID#状态值（-1不活跃 0活跃）
CHG_PROSP_BY_CAMP	改变势力下所有据点的繁荣度用途：按照百分比改变一个势力下所有据点的繁荣度格式：CHG_PROSP_BY_CAMP*势力ID#百分比（>-100）
CHG_PLACE_PROSPERITY	改变地点的繁荣度用途：按照固定数值改变一个地点的繁荣度格式：CHG_PLACE_PROSPERITY*地点ID#更改数值#目标值（当不为空时生效不能超过当地最大值）
CHG_PLACE_PROSPERITY_BY_PCT	按百分比改变地点的繁荣度用途：按照百分比改变一个地点的繁荣度格式：CHG_PLACE_PROSPERITY_BY_PCT*地点ID#更改数值百分比（>-100）
CHG_PLACE_DEF	改变地点的防御度用途：按照固定数值改变一个地点的防御度格式：CHG_PLACE_DEF*地点ID#更改数值#目标值（当不为空时生效不能超过当地最大值）
CHG_PLACE_DEF_BY_PCT	按百分比改变地点的防御度用途：按照百分比改变一个地点的防御度格式：CHG_PLACE_DEF_BY_PCT*地点ID#更改百分比
CHG_PLACE_SECURITY	改变地点的治安值用途：按照固定数值改变一个地点的治安值格式：CHG_PLACE_SECURITY*地点ID#更改数值#目标值（0-100）
PLACE_CUSTOM_INT	指定地点的自定义字段值用途：指定地点的指定自定义整形字段值格式：PLACE_CUSTOM_INT*地点ID#标记ID#整型标记值
CHG_PLACE_CUSTOM_INT	改变地点的自定义字段值用途：改变地点的指定自定义整形字段值格式：CHG_PLACE_CUSTOM_INT*地点ID#字段KEY#更改数值#目标值
PLACE_ADD_BUILDING	增加地点的自定义设施用途：给一个地点增加一个自定义设施格式：PLACE_ADD_BUILDING*地点ID#设施ID（目标地点已存在该设施则无效）
PLACE_REMOVE_BUILDING	移除地点的指定自定义设施用途：移除地点的指定自定义设施格式：PLACE_REMOVE_BUILDING*地点ID#设施ID
CREATE_CARAVAN	创建商队用途：指定一个地点创建出一个指定的商队格式：CREATE_CARAVAN*出发城市ID#到达城市ID#玩家保护（1为玩家保护，0不是）#
CREATE_TEAM	创建队伍用途：创建一个队伍并使其根据指定指令进行行动格式：CREATE_TEAM*地图位置#所属阵营#人物列表(所有人物会强制离开当前队伍或地点)#卡牌单位列表（卡牌ID#等级,数目\|卡牌ID2#等级2,数目2\|.......）#指令方式(见说明)#指令参数目前指令方式支持以下几种： 0：自定义指令：当自定义指令时参数为队伍指令内容(格式如：指令类型1,参数1;指令类型2,参数2;...;指令类型N,参数N （指令格式见队伍预置指令说明） 1：预制指令入侵城市：参数为目标城市的ID,入侵方式（默认0） 2：预制指令入侵势力：参数为目标势力的ID,目标优先方式(0距离优先 1城防值优先),入侵方式（默认0）
DISMISS_TEAM	解散队伍用途：解散一个指定的队伍格式：DISMISS_TEAM*地图单位识别ID
TEAM_ORDER	更改队伍指令用途：更改队伍当前执行的指令列表格式：TEAM_ORDER*地图单位识别ID#新的队伍指令内容（指令格式见队伍预置指令说明）
INVASION_PLACE	指定攻打地点用途：指定一个地点开始攻打另外一个地点。发兵地点与目标地点必须分属两个敌对势力且发兵城内有可战斗人员格式：INVASION_PLACE*发兵地点ID#目标地点ID#攻打方式（默认0）
INVASION_CAMP	指定攻打目标势力用途：发动一个势力马上开始进攻另外一个势力。注意：这两个势力必须是敌对或中立状态的两个势力，当发起方因为兵力不足等原因时可能无法发起进攻格式：IVASION_CAMP*进攻方势力ID#目标势力ID#选取目标方式(0距离优先 1城防优先)#入侵方式(0占领地点 1掠夺)#发动据点数量(0：全部发动 >0：发动距离最近的有限个据点)#入侵强度(0：保留有限实力 1：不顾一切(发动所有资源))
OPENSTORE	打开交易界面用途：打开与指定商人的交易界面格式：OPENSTORE*商人ID（如为空则表示根据地点及当前NPC自动查询）
RESET_STORE	刷新商人所持商品表用途：根据配置刷新商人所持的商品表格式：RESET_STORE*商人ID
ADD_LOCAL_PRODUCT	增加地图特产用途：向指定地图位置投放特产，投放后附近的商人中会刷新特产格式：ADD_LOCAL_PRODUCT*特产ID#地图ID#中心坐标X#中心坐标Y
TRADE_PERMISSION	设置通商许可用途：设置一个地点的通商许可格式：TRADE_PERMISSION地点ID是否可以通商（0代表不能通商，1代表可以通商）
TROOPS_ALLOC	驻军界面用途：打开一个地点的驻军界面格式：TROOPS_ALLOC*地点ID（如为空则表示当前地点）
GETSKILL	学习技能用途：给一个角色增加技能格式：GETSKILL*人物ID#技能列表(单个技能格式为：“技能ID,等级(可选)”，多个技能以”\|”分隔)
REMOVESKILL	遗忘技能用途：移除指定角色的技能格式：REMOVESKILL*人物ID#技能列表(多个技能以”\|”分隔)
RESET_SP	重置技能点数用途：重置角色技能点数格式：RESET_SP*人物ID
ADD_UNUSEDSP	改变可用技能点数用途：变更角色可用的技能点数格式：ADD_UNUSEDSP*人物ID#点数（为负值时减少）
SET_SKILLPAGE	点亮或移除主角技能页用途：点亮或者移除角色可用的技能页格式：SET_SKILLPAGE*技能页ID表（以”,”分割）#1点亮0移除#目标角色ID（可选，默认为主角）
SHOW_TEAMINFO	显示当前队伍信息用途：显示当前遭遇的队伍信息格式：SHOW_TEAMINFO*1
SET_FLAG	设置完成标记用途：设置一个完成标记，一般用于重大剧情转折标记格式：SET_FLAG*标记名称#标记值
UPDATE_MARKS	更新地图上的标记用途：更新地图上的标记格式：UPDATE_MARKS*1
SET_DUMMY	设置假人或野怪状态用途：设置地图假人或野怪的状态。当控制野怪时ID为野怪ID 格式：SET_DUMMY*假人ID#状态（0：显示 -1：隐藏）
SET_CAMERA	设置沙盒地图的镜头跟随模式用途：用来控制沙盒地图上镜头的跟随模式。格式：SET_CAMERA*跟随模式#参数目前支持的镜头跟随模式及参数含义： 0：跟随主角，无参数（默认） 1：跟随指定目标，参数为指定地图目标标识ID 2：指定地图位置，参数为地图坐标(地图ID:x,y)#镜头移动速度
SET_PLACE_CAMP	设置地点归属阵营用途：改变一个地点所归属的阵营势力。格式：SET_PLACE_CAMP*目标地点ID#目标阵营ID#是否以攻城侵略方式占据（1为是，0为否）
SET_MAP_CAMP	设置一个地图所有的地点归属阵营用途：改变一个地图板块下所有据点的阵营势力格式：SET_MAP_CAMP*目标地图ID#from阵营ID#to阵营ID#是否为攻城侵略（1为是，0为否）
TRY_RECRUIT_FREE_ROLE	尝试进行一次在野英雄招募判定用途：尝试进行一次在野英雄招募判定成功返回1、内部错误返回0、队伍已满返回2 格式：TRY_RECRUIT_FREE_ROLE*角色ID
CHK_RECRUIT_CAPTIVE	【暂未开放】
RELEASE_CAP	【暂未开放】
SEND_ENVOY	派出外交信使用途：派出一个执行特定外交任务的信使格式：SEND_ENVOY*势力ID（为空时表示玩家势力）#外交行为(1：赎回 2：友善 3：宣战 4：同盟 5：破裂 6：停战)#目标ID(当赎回时为目标人物ID，其他为目标势力ID)#附带参数(一般为条件金钱数)#是否即刻到达的信使（1表示不需要等待时间，0表示需要等待时间）
DIP_DECIDE	执行外交事件判定用途：对当前外交事件进行结果决定。只能用在特定的外交事件触发器环境中格式：DIP_DECIDE*结果代码（1同意 0拒绝）
EXPEL_ROLE	驱逐角色用途：将一个角色驱逐出阵营势力格式：EXPEL_ROLE*势力ID#人物ID
TRY_REWARD_ROLE	尝试奖赏属下用途：尝试奖赏一个属下格式：TRY_REWARD_ROLE*人物ID（为空时表示当前对象）
ADD_GLOBAL_BUFF	增加队伍全局BUFF 用途：为当前队伍增加一个全局BUFF 格式：ADD_GLOBAL_BUFF*buffID#持续时间(游戏天数)#层数（默认为1）#最高层数限制（默认为-1，无限制）
RM_GLOBAL_BUFF	移除队伍全局BUFF 用途：为当前队伍移除一个全局BUFF 格式：RM_GLOBAL_BUFF*buffID
RM_GLOBAL_BUFF_BYCLASS	按类型移除队伍全局BUFF 用途：按照类型为当前队伍移除一个全局BUFF 格式：RM_GLOBAL_BUFF_BYCLASS*全局BUFF类型
RM_ALL_GLOBAL_BUFF	移除队伍所有的全局BUFF 用途：为当前队伍移除所有全局BUFF 格式：RM_ALL_GLOBAL_BUFF*1
PLAYER_FAILED	游戏失败用途：玩家游戏失败时进行的通用处理格式：PLAYER_FAILED*1
LOSE_INVENTORY	玩家通用财物损失操作用途：对玩家进行一次财物损失操作（只损失货物和金钱）格式：LOSE_INVENTORY*比例（比例为整数，代表百分比）
SET_TAGROLE	变更当前脚本中的对象人物用途：为当前脚本的环境变量设置默认的操作对象角色格式：SET_TAGROLE*人物ID
SURRENDER	势力投降用途：指定一个势力向另外一个势力投降（所有领地被受降方占领，所有人员根据忠诚度随机选择是否归顺）格式：SURRENDER*投降方势力ID#受降方势力ID
GEN_RND_PLACE	选定随机地点以供查询用途：生成一个随机地点，并可以用[%last_rnd_place_XX%]系列指令查询格式：GEN_RND_PLACE*所属势力ID（如果所属势力为空，则为玩家势力中的一个地点）
GEN_RND_ROLE	选定随机人物以供查询用途：在指定范围内选定一个随机人物角色，并可用[%last_rnd_role_XX%]系列指令查询格式：GEN_RND_ROLE*所属势力ID（如果所属势力为空，则为玩家势力中的一个地点）
HERO_UPGRADE	英雄强化用途：为指定的人物角色永久增加某项角色属性格式：HERO_UPGRADE*英雄ID#属性ID#增加值#增加上限（必须指定，可以为-1，即没有上限）
HERO_SET_STATU	设置角色属性字段用途：为指定的人物角色设置某一项属性字段值格式：HERO_SET_STATU*角色ID#属性ID#新值（角色ID为空表示主角）
ADD_CAMP_BUFF	增加阵营BUFF 用途：为指定的阵营势力增加一个阵营BUFF 格式：ADD_CAMP_BUFF*阵营ID#buffID#持续时间(游戏天数，当该值小于等于0时表示永久生效除非强制移除该BUFF)
RM_CAMP_BUFF	移除阵营BUFF 用途：为指定的阵营势力移除一个阵营BUFF 格式：RM_CAMP_BUFF*阵营ID#buffID
RM_CAMP_BUFF_BYCLASS	按照类型移除阵营BUFF 用途：按照BUFF类型为指定的阵营势力移除一个阵营BUFF 格式：RM_CAMP_BUFF_BYCLASS*阵营ID#阵营BUFF类型
RM_ALL_GLOBAL_BUFF	移除所有的阵营BUFF 用途：为指定的阵营势力移除所有的阵营BUFF 格式：RM_ALL_GLOBAL_BUFF*阵营ID
ADD_CAMP_EXTRA_STATU	增加阵营属性字段值用途：增加阵营势力的某一项动态属性字段格式：ADD_CAMP_EXTRA_STATU*阵营ID#动态属性字段表（见阵营表EXCEL势力初始属性格式）
RESET_CAMP_EXTRA_STATU	重置阵营属性字段值用途：重置阵营势力的所有动态属性字段值格式：RESET_CAMP_EXTRA_STATU*阵营ID
WEAPON_DURABILITY_DOWN	武器装备耐久度下降用途：降低当前装备的武器装备的耐久度，当耐久度为0时自动损毁。如果武器本身耐久为-1（没有耐久度概念），则该语句什么也不会发生格式：WEAPON_DURABILITY_DOWN*数值
ITEM_DURABILITY_DOWN	特定道具耐久度下降用途：降低背包中一把符合tag、等级条件（>=要求等级）的道具耐久度【数值】点，如果符合条件的道具耐久不足，将摧毁这件道具格式：ITEM_DURABILITY_DOWN*装备tag筛选#装备等级筛选#数值
SET_SYNTH_STATE	设置合成配方的状态用途：设置指定合成配方状态格式：SET_SYNTH_STATE*配方ID#新状态(0：未习得 1：已习得)
OPEN_SYNTH_DLG	开启道具合成界面用途：开启道具合成界面UI 格式：OPEN_SYNTH_DLG*是否锁定(0:不锁定主分类 1:锁定显示分类)#默认显示的分类页(可为空默认，以“,”分隔多页，默认显示第一页；当锁定主分类时该字段可显示隐藏的分类)#关闭合成面板后执行的story key（可不填）
OPEN_CARD_SYNTH_DLG	开启卡牌合成界面用途：开启卡牌合成界面UI 格式：OPEN_CARD_SYNTH_DLG*1
PLAY_EFT	播放特效用途：在当前地图上播放一个特效格式：PLAY_EFT*特效路径(相对Asset目录，例如:Assets\BuildSource\battle_effects\SkillEffects\psLightingHit1.prefab)#地图坐标#初始旋转角度（可为3方向旋转向量或者一个Y轴的旋转角度）#缩放比例（可指定XYZ3轴上的比例向量或者整体的缩放比例）#持续时间(秒，超过此时间后自动移除)#播放延迟时间(默认为0秒)
PLAY_MU_EFT	播放大地图单位跟随特效用途：在指定地图单位身上播放一个跟随该单位的特效格式：PLAY_MU_EFT*特效路径(相对Asset目录，例如:Assets\BuildSource\battle_effects\HitEffects\psHealEft1.prefab)#地图单位ID#对象范围(0：仅英雄 1：全体)#初始旋转角度（可为3方向旋转向量或者一个Y轴的旋转角度）#缩放比例（可指定XYZ3轴上的比例向量或者整体的缩放比例）#持续时间(秒，超过此时间后自动移除)
OPEN_MAPAREA_SELECTOR	开启地图区域选择界面用途：在当前沙盒地图上开启一个区域选择UI界面，在此界面上可为当前操作的对象在预先定义好的地图区域中选取一个地图位置并返回。result_code返回1标识位置设置成功，为0标识失败。位置信息记录在[$last_selpos$]中。格式：OPEN_MAPAREA_SELECTOR*区域标识ID#显示的模型#排他模式（0：不排他、1：排除自定义宝箱）#提示信息
OPEN_FREEAREA_SELECTOR	开启自由地图位置选择界面用途：效果同上，只不过不再限制可供选择的地图区域。格式：OPEN_FREEAREA_SELECTOR*宽（整数）#高（整数）##显示的模型#排他模式（0：不排他、1：排除自定义宝箱）#提示信息。
PLACE_SELECTOR	开启地点选择界面用途：开启一个建议的地点选择界面。选中的结果存在[$tagplace$]里，编号存在[%result_code%]里，如果[%result_code%]为9999则代表玩家取消选择。格式：PLACE_SELECTOR*提示内容#选择条件(传入[%tagplace%]作为判断参数)
SET_LORD	设置城主用途：为指定地点设置一个城主。格式：SET_LORD*角色ID#地点ID
ADD_CUSTOM_CHEST	增加自定义宝箱用途：根据设置信息在大地图上增加一个自定义宝箱。（宝箱的概念可扩展为所有大地图上有价值的可交互目标。如：材料、遗迹、征兵点等等）格式：ADD_CUSTOM_CHEST*宝箱ID#对应的宝箱表中ID#位置信息#初始状态（>0表示可以开的次数，-1表示已经开过了）#默认方向（0-360）
SET_CHEST	设置宝箱状态用途：设置一个地图上可控宝箱的状态格式：SET_CHEST*地图ID#宝箱ID#状态。状态>0表示可开启次数，状态<=0表示已开启
SET_CURCHEST	设置当前宝箱状态用途：设置当前脚本中的对象宝箱的状态格式：SET_CURCHEST*状态（同 SET_CHEST）
CLOSE_SYSTEM_UI	关闭系统UI 用途：关闭当前打开的系统UI 格式：CLOSE_SYSTEM_UI*
ROLES_SELECTOR	关闭系统UI 用途：关闭当前打开的系统UI 格式：ROLES_SELECTOR选择框标题#选择数量限制（小于0为不限制）#选择范围(0：全局非模板人物 1：主角队伍中 2：指定人物表范围)#筛选条件表达式#参数(当选择范围为指定人物表时该参数为人物列表信息) 示例： ROLES_SELECTOR选择目标阵营中的人物#1#0#[$tagrole:campid$][=][$player:campid$]&[$tagrole:campid$][<>][$null$]# ROLES_SELECTOR*几个目标对象中选择一个#1#2##人物1\|人物2\|人物3\|人物4 选取后存在[%last_seled_roles%]里。如果只有一个结果，则同时存在[%tagrole%]里
ASK_ABOUT_SOMEBODY_SELECTOR	打听人物选择器用途：被打听人现在暂没参与逻辑运算，弹出人物选项框，结果存在[%arg_str_val1%]里，选择结果[%result_code%]为9999的时候是玩家取消格式：ASK_ABOUT_SOMEBODY_SELECTOR#被打听人ID
CARD_SELECTOR	卡牌选择器用途：弹出当前卡牌列表界面供选择格式：CARD_SELECTOR*选择框标题#选择数量限制（小于0为不限制）#选择范围(0：主角队伍中的卡牌 1：指定单位表范围)#参数(当选择范围为指定单位表时该参数为单位列表信息)#筛选条件表达式(可选)
ASSEMBLE_ARMY	集结部队用途：集结阵营势力下的部队跟随集结者格式：ASSEMBLE_ARMY#集结者ID#集结角色ID列表（可为空，“\|”分割，可以使用ROLES_SELECTOR的结果[%last_seled_roles%]。如果为空，则是默认选定阵营下所有的角色。）
RELEASE_ALL_ASSEMBLE_ARMY	解散所有集结部队用途：解散所有当前已进行集结中的部队格式：RELEASE_ALL_ASSEMBLE_ARMY#首领角色ID
SET_ROLE_IN_PROJECT	角色开始执行项目用途：使一个角色开始执行指定项目格式：SET_ROLE_IN_PROJECT*角色ID#项目ID
SET_ROLE_FINISH_PROJECT	角色结束当前执行的项目用途：强制指定的角色结束当前进行的项目格式：SET_ROLE_FINISH_PROJECT*角色ID1,角色ID2,...
ROLE_PROJECT_ADMIN	打开个人项目界面用途：打开角色个人项目执行界面格式：ROLE_PROJECT_ADMIN*项目ID#绑定地点(可选，默认当前地点)
GROUP_PROJECT_ADMIN	打开团体项目界面用途：打开团体项目执行界面格式：GROUP_PROJECT_ADMIN*项目标签#界面标题#项目绑定类型#项目绑定对象参数(可选，默认为当前对象) 目前支持的项目绑定类型有 place：地点建筑建设对象参数为地点ID，如不指定为当前地点 world：自定义地点建设对象参数格式为：自选区域控制ID;所属地点(当所属地点为空时表示建设一个非附属地点)
SET_REVIVE_POS	设置复活集结地点用途：设置新的复活集结地点格式：SET_REVIVE_POS*大地图位置(地图ID:x,y)
SET_SILENCE_MODE	设置静默模式用途：开启或关闭消息静默模式格式：SET_SILENCE_MODE*静默模式（0：不开启 1：不显示TOAST，仅显示消息，获得物品TOAST信息在消息中显示 2：不显示TOAST及消息）
START_RAID_PLACE	【已废除】
ADD_CUSTOM_PLACE	增加自定义地点用途：在大地图上的指定位置增加一个自定义地点格式：ADD_CUSTOM_PLACE*自定义地点ID(全局唯一)#附属于地点(可为空，为空表示非附属地点)#地点信息模板ID#位置信息#默认所属势力
SET_PLACE_NAME	修改地点名称用途：修改一个指定地点的显示名称格式：SET_PLACE_NAME*地点ID#自定义名称
OPEN_PLACE_BUILD_UI	开启地点建筑建设界面用途：开启地点建筑建设界面格式：OPEN_PLACE_BUILD_UI*地点ID#建设成功后执行的剧本（可选）#建设取消后执行的剧本（可选
ADD_CARD	获得新卡牌用途：加入一张预制的卡牌格式：ADD_CARD*卡牌ID#是否免费招募（1免费，0付费招募，默认为0）
ADD_CARD_PIECE	获得指定耐久的卡牌用途：加入一张预制的卡牌，最大耐久为指定的残值格式：ADD_CARD_PIECE*卡牌ID#最大耐久#是否免费招募（1免费，0付费招募，默认为0）
SET_OBS_AREA	设置阻挡区状态用途：设置地图阻挡区域的状态格式：SET_OBS_AREA*控制ID#状态（0：启用 -1：禁用）
EXPLORE_AREA	点亮地图区域用途：点亮当前地图某一块区域（去除区域战争迷雾）格式：EXPLORE_AREA*坐标x,坐标y#点亮半径
EXPLORE_MAP	点亮整个地图用途：点亮整个地图（去除整张地图的战争迷雾）格式：EXPLORE_MAP*地图ID
ADD_INTVAL_WATCHER	增加自定义变量监视字段用途：增加自定义变量监视字段，在屏幕指定UI区块显示当前监视的变量字段值格式：ADD_INTVAL_WATCHER*变量监视信息格式（格式如：字段Key1,显示名称1,枚举值1a=枚举名称1a\|枚举值1b=枚举名称1b\|...\|枚举值1N=枚举名称1N,是否战斗中可见([可选，默认0] 0否1是);...;监视字段信息N）
REMOVE_INTVAL_WATCHER	移除自定义变量监视字段用途：移除指定的自定义变量监视字段格式：REMOVE_INTVAL_WATCHER*字段Key值
CLEAR_ALL_INTVAL_WATCHERS	清除所有变量监视字段用途：清除所有变量监视字段格式：CLEAR_ALL_INTVAL_WATCHERS*
SET_TIMER	设置事件定时器用途：设置一个游戏计时器事件，当时间到达后将执行指定的事件格式：SET_TIMER*计时器ID（当ID重复时将覆盖重复的目标计时器信息）#时间参数(小于0时表示关闭该计时器，其他当类型为指定时间型时该参数为指定的游戏事件(单位天), 当倒计时型时该参数为倒计时的天数)#计时器类型(0：指定时间触发型 1：倒计时型)#时间到达时执行的事件ID#是否强制更新（1表示强制更新，0表示非强制更新：即不会更改已有的计时器的数据。不填为1）
REMOVE_TIMER	移除事件定时器用途：移除一个游戏计时器事件格式：REMOVE_TIMER*计时器ID
CHANGE_TIMER_TIME	更改事件定时器用途：增加/缩减一个游戏计时器的时间格式：CHANGE_TIMER_TIME*计时器ID#时间（以天为单位，可正可负，可以为小数）
ADD_TIMER_WATCHER	增加自定义事件定时器监视字段用途：增加自定义计时器监视字段，同自定义变量监视器UI 格式：ADD_TIMER_WATCHER*计时器监视信息格式（格式如：计时器ID1,显示时间格式1,缩放参数1([可选，默认1]对时间参数(天)进行缩放的系数),是否战斗中可见([可选，默认0] 0否1是)\|...\|计时器ID N,显示时间格式N,缩放参数N
REMOVE_TIMER_WATCHER	移除自定义事件定时器监视字段用途：移除一个自定义计时器监视字段格式：REMOVE_TIMER_WATCHER*字段Key值
CLEAR_ALL_TIMER_WATCHERS	清除自定义事件定时器监视字段用途：清除所有自定义计时器监视字段格式：CLEAR_ALL_TIMER_WATCHERS*
PLAYER_RECRUIT_CARD_IN_PLACE	打开玩家招募城镇内卡牌的面板用途：打开玩家招募城镇内卡牌的面板格式：PLAYER_RECRUIT_CARD_IN_PLACE*城镇ID#完成招募后执行的事件ID（可选）#取消招募后执行的事件ID（可选）
STORY_CARD_START STORY_CARD_LINE STORY_CARD_END	打开剧情卡片界面用途：打开剧情卡片界面。必须要有STORY_CARD_START和STORY_CARD_END，不然会报错。STORY_CARD_LINE为剧情段落，需要加在中间，可以加无数行格式： STORY_CARD_START卡片文件名 STORY_CARD_LINE剧情段落1 STORY_CARD_LINE剧情段落2 STORY_CARD_LINE剧情段落3 ... STORY_CARD_END*
AUTOSAVE	执行自动存档用途：立即执行自动存档格式：AUTOSAVE*1
OPEN_SAVE_DLG	打开存档界面用途：打开存档界面格式：OPEN_SAVE_DLG*1
OPEN_SAVE_DLG	打开读取界面用途：打开读取界面格式：OPEN_LOAD_DLG*1
EXCHANGE_CARD	打开卡牌交换界面用途：打开卡牌交换界面格式：EXCHANGE_CARD*对象类型(0：地点 1：队伍)#对象ID([可选，默认为当前地点] 当对象为地点时为地点ID，队伍时为队伍ID)
LEVEL_FINISH	关卡完成用途：用于剧本模式描述一关结束格式：LEVEL_FINISH*
SET_CAMERA_FILTER	设置镜头滤镜用途：设置镜头滤镜效果格式：SET_CAMERA_FILTER滤镜参数（为空为关闭所有滤镜，参数代码见6.10节）测试代码：SET_CAMERA_FILTER黑白,0\|老旧,100\|暗角,100
TLACTION	播放Timel带有图片和选项的剧情选项界面格式：SELECTION_VIEW剧情图片文件名#剧情内容（支持“\n”表示换行）#选择项（参考SELECT）
DIALOG_BUBBLE	地图单位气泡对话框用途：在大地图上的单位头上弹出气泡对话框格式：DIALOG_BUBBLE*地图角色ID#对话内容#显示时长
TEXT_EXPLORE_START TEXT_EXPLORE_OVER TEXT_EXPLORE_FORCE_OVER_AND_CD	文字探索相关用途：特定的文字探索模式格式： TEXT_EXPLORE_START文字探索地图ID。开启一场文字冒险 TEXT_EXPLORE_OVER。结束当前副本 TEXT_EXPLORE_FORCE_OVER_AND_CD*。强制结束当前副本并进入CD
SHOW_CG	显示CG图片用途：用来展示一个CG图片界面（注意开了之后需要手动用HIDE_CG关闭CG，不然会影响玩家操作）格式：SHOW_CG图片名称（不带后缀，可为空，空就只会显示黑色背景，对应目录为Assets\BuildSource\Backgrounds\，文件格式统一要求为png）
HIDE_CG	关闭CG图片用途：关闭CG图片界面格式：HIDE_CG*
GENERATE_RANDOM_CARD	随机选取一个卡牌用途：随机抽取一张卡牌，并存放在当前环境变量的ta旁白格式：VOICE_OVER#内容
CREATE_STORYARMY	创建剧情队伍用途：创建一个用于剧情的队伍格式：CREATE_STORYARMY*tagkey#地图位置#所属阵营#人物列表(所有人物会强制离开当前队伍或地点)#卡牌单位列表（卡牌ID#等级,数目\|卡牌ID2#等级2,数目2\|.......）#运动信息（例如：WANDER,2500）
REMOVE_STORYARMY	移除剧情队伍用途：移除一个剧情队伍格式：REMOVE_STORYARMY*tagkey
BAZZAR_BUY_ITEM	集市商人买入操作用途：进行集市商人买入操作格式：BAZZAR_BUY_ITEM*集市ID#商人ID#交换用物品的集市ID（可选）#交换用物品的商人ID（可选）
BAZZAR_SELL_ITEM	集市商人卖出操作用途：进行集市商人卖出操作格式：BAZZAR_SELL_ITEM*集市ID#商人ID
SHOWROLE	对话显示角色立绘用途：对话时显示角色立绘格式：SHOWROLE角色1ID@角色1立绘显示位置(#角色2ID@角色2立绘显示位置)（可选）立绘显示位置：可以是L或者R，默认为L，立绘显示在对话框左侧，R则显示在右侧
HIDEROLE	对话隐藏角色立绘用途：对话时隐藏角色立绘格式：HIDEROLE角色1立绘显示位置(#角色2立绘显示位置)（可选）立绘显示位置：可以是L或者R，L为隐藏左侧立绘，R为隐藏右侧立绘
SELECT_QUEST_ASK	任务询问用途：在普通的SELECT基础上添加满足条件的任务询问格式：SELECT_QUEST_ASK*
SELECT_TEAMROLE	队伍角色选择用途：选择队伍里的人物角色格式：SELECT_TEAMROLE*
ROLE_PLAYER_ACTIVE	激活角色信息状态用途：设置角色在“情报”界面中可见，传入角色ID（此方法一般用于剧情中，如酒吧女郎）格式：ROLE_PLAYER_ACTIVE*角色ID
ROLE_ORDER	内置角色指令用途：为一个角色下达一些内置指令并立即执行格式：ROLE_ORDER*角色ID[为空表示当前目标角色]#指令代码:指令参数表当前指令代码支持以下内容： RETURN_JOBCITY：角色返回所属地点，无参数，当其为队长时直接变更队伍指令，不是队长时离开当前队伍并返回，在其他地点时则创建队伍并返回 GOTO_PLACE：角色前往目标地点，参数为目标地点ID JOIN_PLAYER_TEAM：角色直接加入主角队伍，无参数 FOLLOW_ME：角色集结并跟随主角队伍，无参数 EXPEL_FROM_CAMP：从阵营中驱逐该角色，无参数

全局存档相关的操作指令

全局存档是用来记录一些所有存档共享的数据记录的存档。记录在全局存档中的数据更改后可以在所有不同的存档中进行访问。


指令	说明
SET_GLOBAL_INTVAR	设置全局存档自定义整形变量用途：设置一个全局存档中的自定义整形变量。记录在全局存档中的自定义整形变量可以通过查询指令[%global_int:ID%]来进行查询访问。格式：SET_GLOBAL_INTVAR*变量ID#当前int值
CHANGE_GLOBAL_INTVAR	修改全局存档自定义整形变量用途：修改一个全局存档中的自定义整形变量。格式：CHANGE_GLOBAL_INTVAR*变量ID#改变值（正负数皆可）#锁定最小值(可选，不填为不限制)#锁定最大值(可选，不填为不限制)
SET_GLOBAL_STRVAR	设置全局存档自定义字符串变量用途：设置自定义字符串变量。记录在全局存档中的自定义字符串变量可以通过查询指令[$global_str:ID$]来进行查询访问。格式：SET_GLOBAL_STRVAR*变量ID#string值
PUSH_GLOBAL_ROLES	存入角色状态至全局存档用途：将指定的角色表存入全局角色状态表中格式：PUSH_GLOBAL_ROLES*自定义全局存储Key#角色ID（该角色只能为非模板角色）
PULL_GLOBAL_ROLES	从全局存档取回角色状态用途：将指定的角色表的状态从全局角色状态表读入到当前游戏模式中格式：PULL_GLOBAL_ROLES*自定义全局存储Key（该Key值对应的角色必须为当前游戏模式人物模板表中存在的角色）
LOCK_CMD_QUEUE	锁定当前指令队列用途：锁定当前的指令队列，当锁定后切换游戏存档或者重置游戏模式时不会清空执行的指令队列格式：LOCK_CMD_QUEUE*是否锁定(0否1是)
SWITCH_GAME_MODE	切换游戏模式用途：切换并载入到目标游戏模式格式：SWITCH_GAME_MODE*目标游戏模式的ID

内置指令列表

内置指令是指一些专门用于程序内部实现某些特定功能的指令。一般专门供一些特定脚本使用。


指令	说明
ENCOUNTER	遭遇野怪UI 用途：打开遭遇野怪信息面板格式：ENCOUNTER*1
CHEST_INFO_DLG	宝箱守卫信息UI 用途：打开宝箱守卫信息面板格式：CHEST_INFO_DLG*宝箱ID
CHEST_COST_DLG	宝箱开启代价信息UI 用途：打开宝箱开启代价信息面板格式：CHEST_COST_DLG*宝箱ID
CHEST_CALLBACK	宝箱开启逻辑回调用途：开启宝箱逻辑回调命令格式：CHEST_CALLBACK*回调代码(1：击败守卫 2：完成开启)#目标宝箱ID
EXEC_RECRUIT_CAPS	执行招募队伍中的俘虏判定用途：执行招募队伍中的俘虏判定格式：EXEC_RECRUIT_CAPS*

脚本预设字段及含义

在脚本编辑中有时会使用一些特定的指令来替代具体的对象，比如CUR_ROLE可以用来替代当前遭遇对象的人物ID，这样就可以实现一些通用脚本编辑的应用场景。

目前支持的预设字段有：

CUR_ROLE：当前遭遇人物模板的ID，专门用与对话框及选择框
CUR_BATTLE：当前遭遇的大地图刷新单位对应的战斗ID

剧情事件中的结果脚本指令格式

剧情事件中结果脚本指令的格式为(以换行符分割):

条件表达式组1:执行命令1
条件表达式组2:执行命令2
...
条件表达式组N:执行命令N

执行方式为：先判定条件表达式组1，如果成立则执行命令1，否则接着判定条件表达式组2……直到有任意一组成立，或者所有条件均不成立

条件表达式组格式

条件表达式组由多个形如" [%CONDITION%][=]1"这样的条件表达式组成，以符号"|"(或) 或符号”&”(与)进行连接，”&”(与)的优先级大于"|"(或)的优先级，当条件表达式左右值均为整数字符时，将返回其数值大小的比较结果，否则只能执行字符串比较且仅支持[=]和[<>]两种判定。

例如:

[%result_code%][=]1|[%player_money%][>=]100 表示当结果为1或玩家身上有100金钱时执行 
而[%player:level%][>=]3&[%player_money%][>]100 表示玩家等级大于等于3并且身上的金钱大于100时执行

以下为条件表达式中支持的比较符号

[=]：等于
[>]：大于
[>=]：大于等于
[<]：小于
[<=]：小于等于
[<>]：不等于

游戏数据中运算值表达式系统说明

在游戏中很多地方可以以“[&expression&]”的格式嵌入一些数值公式进去（如BUFF列表的状态值等）

数值公式中支持一些基本数学运算，目前支持的运算符号如下：

+：加法运算
-：减法运算
*：乘法运算
/：除法运算
%：模运算（取余）
^：幂运算
( )：改变运算优先级

此外，当数值公式以 @func(expression1,expression2...) 的格式出现时，则调用相关的内置函数返回计算结果。目前支持的内置函数如下（注意：当前此等内置函数只能用于最外层的计算）

@min(a,b)：返回a与b中较小的一个值
@max(a,b)：返回a与b中较大的一个值

比如某段数据中[&1+2*3&]将会被替换为7，[&@max(1+2*3, 8)&]将会被替换为8，[&@min(1+2*3, 8)&]将会被替换为7……

剧情事件中可用的嵌入式查询指令

目前游戏中很多地方都支持插入嵌入式查询指令，通过这些查询指令，可以很方便的在一些文本或者条件表达式中插入我们想要的数值或者字符串类型的查询结果。所有嵌入式查询指令都是以[%QUERY:arg1:arg2...%]或者[$QUERY:arg1:arg2...$]这样的格式（两者等效）插入到目标位置的。

注意：目前暂不支持查询中再次嵌入查询指令！

目前支持的查询指令列表如下：


查询指令	说明
[%result_code%]	返回当前事件中最后一个有返回结果的命令结果值（比如在剧情事件脚本中代表返回的选择框选项、输入的数值、战斗的结果等）以下为result_code在不同类型命令下返回的含义当选择框返回时表示其选项ID 当战斗结束返回时 0：战斗胜利 1：战斗失败当整数输入框时为表示输入的数字
[%rnd_num%]	返回一个0-100的整数
[%last_rnd%]	返回上次产生的随机数
[%player_money%]	玩家身上的金钱数
[%player_wood%]	玩家拥有的木材数
[%player_iron%]	玩家拥有的铁矿石数
[%player_jade%]	玩家拥有的玉石数
[%player_food%]	玩家当前的饱食度
[%game_time%]	当前游戏中的天数
[%is_gametime_night%]	判断当前是否是晚上，如果是，返回1，否则为0
[%is_gametime_daytime%]	判断当前是否是白天，如果是，返回1，否则为0
[%mod_day:MOD%]	当前游戏的天数对MOD取余的值
[%generate_rob_money%]	生成当前等级遭抢劫时索取的金额
[%rob_money%]	获取上次生成的抢劫索取金额
[%get_ts:ID%]	返回一个触发器当前的状态值 0正常 1关闭
[%get_es:ID%]	返回一个剧情事件当前的状态 -1：未执行其他：返回Result Code
[%get_es_first_time:ID%]	返回一个剧情事件的首次完成时间
[%get_es_time_score:ID:minTime:maxTime:maxScore%]	返回一个剧情事件的首次完成时间得分，minTime是设定的最短完成时间（在此时间前完成均为满分），maxTime是设定的最长完成时间（之后完成均为零分），maxScore为最高得分。
[%int_val:ID%]	返回编号为ID的自定义int值
[%int_val_for_calc:ID%]	返回编号为ID的自定义int值用于计算，必定存在计算值，如果ID不存在则值为0
[%str_val:ID%]	返回编号为ID的自定义string值
[%team_num%]	当前队伍当前数量
[%team_max%]	当前队伍最大数量
[%unit_name:兵种key%]	返回某种兵的名称
[%item_number:物品key%]	返回背包中某种物品的数目
[%item_with_tag:tag%]	返回背包中具有某种tag的物品数目
[%item_with_tag_and_level:tag:level%]	返回背包中具有某种tag、且物品等级>=level的物品数目
[%item_qualify_as_present:present_desc%]	返回背包中满足某种礼物描述字符串要求的道具数目。礼物描述字符串的格式参见人物列表excel中的Tag一列中的“Like”这个Tag的格式写法。
[%item_name:物品ID%]	返回物品的显示名称
[%admin_level%]	返回玩家在当地的管理权限 0：无 1：任职 2：城主 3：阵营领袖
[%gametime_elapse:ID%]	返回距上次设置的自定义游戏时间点ID过去的游戏时间(整数天数，算法是：（当前时间-ID时间)后取整。
[%gametime_elapse_by_day:ID%]	返回距上次设置的自定义游戏时间点ID过去的游戏时间(整数天数，算法是：（当前所在的天-ID所在的天)。一般用于一天内只能触发一次的事件。
[%tag_gametime_elapse%]	返回预先设置的动态tag的gametime_elapse，如果没有预先设置的动态tag，或者没有该ID，则返回-1。算法是：（当前时间-ID时间)后取整
[%tag_gametime_elapse_by_day%]	返回预先设置的动态tag的gametime_elapse，如果没有预先设置的动态tag，或者没有该ID，则返回-1。算法是：（当前所在的天-ID所在的天)，通常用于一天内只能触发一次的事件判断。
[%is_custom_cd:ID%]	返回编号为ID的自定义CD时间是否已就绪(1：是 0：否)
[%has_gametime_elapse_tag:ID%]	查询上述的自定义游戏时间点ID是否存在（存在1，不存在0）
[%realtime_elapse:ID%]	返回距上次设置的自定义现实时间点ID过去的现实时间(秒)
[%qs:ID%]	返回指定任务ID的状态值0：未领取 1：进行中 2：已完成 3：已终结
[%qs:ID:index%]	返回指定任务ID的子项值，index为从0开始的子项序号
[%get_flag:ID%]	返回一个完成标记的当前值，没有值则返回-1
[%camp_rep:ID%]	返回主角对目标阵营ID的声望值
[%is_wanted_by_tagcamp%]	返回主角是否被目标阵营通缉，0否，1是
[%is_player_triggered_encounter%]	一个遭遇对话是否是由玩家主动点击的，0否，1是。（如果玩家是被其他人追上的情况下触发对话，则此值为0）
[%place_rep:ID%]	返回主角对目标地点的声望值
[%arg_int_val1%] [%arg_int_val2%] [%arg_int_val3%]	当前事件数值参数1、2、3
[%g_buffs%]	返回当前队伍全局BUFF的个数
[%last_battle_res%]	上一次战斗的战斗结果 0：胜利 1：失败 2：撤退
[%last_dungeon_res%]	上一次地城的结果 0：退出 1：通过 2：失败
[%g_buff:ID%]	查询当前队伍是否存在目标ID的全局BUFF，存在返回1
[%g_buff_c:CLASS%]	查询当前队伍当前类型为CLASS的全局BUFF的个数
[%g_stat:STAT_FILED%]	返回当前队伍状态中字段为STAT_FILED的当前值
[%has_KeyValues:ID%]	直接对存储中的KV进行查询，存在相应KV为1，不存在为0
[%get_KeyValues:ID%]	直接对存储中的KV进行查询，存在相应KV返回相应值，不存在为空
[%rnd_place_id:CAMP_ID%]:	返回一个由一个势力控制的随机地点id，如果没有camp_id则返回主角势力控制的随机地点id
[%last_rnd_place_id%]	返回上一个生成的随机地点id
[%last_rnd_place_name%]	返回上一个生成的随机地点的名称
[%last_rnd_place_map_name%]	返回上一个生成的随机地点的所在地图名称
[%last_rnd_place_products%]	返回当前地点的每周期产出列表，符合GETITEMS的物品格式
[%last_rnd_place_products_name%]	返回当前地点的每周期产出描述
[%last_rnd_place_has_products%]	当前地点每周期是否有产出，1为有产出，0无
[%last_seled_items%]	返回上一次物品选择框命令(ITEMS_SELECTOR)选择的物品列表
[%last_seled_roles%]	返回上一次人物选择框命令(ROLES_SELECTOR)选择的人物列表
[%weather:ID%]	查询当前地图中指定ID的天气效果的当前值
[%monster_news:X:Y%]	查询当前地图中坐标为（X，Y）附近的野怪信息，X/Y不填则为主角当前队伍所在位置信息
[%attack_intend_code%]	查询当前相遇的地图单位对玩家的攻击意图，详情见MuUnitBase.IntendToAttack
[%place_randmom_pos%]	查询一个地点所在位置附近的随机位置，输出特定的字符串如：沙盒红石城:123,123
[%tag_role_with_role_relation%]	输入参数和tagrole或place的关系
[%tag_role_with_city_relation%]	tagrole和输入的role的关系

[$player:INFO$] [$tagrole:INFO:ID$]	查询指定角色 (主角 player / 指定角色 tagrole) 的指定信息字段。当tagrole时，ID字段不存在时则返回当前交互对象的查询结果 INFO可为如下内容： id:角色ID name:角色名称 level:角色等级 job_type:身份类型 0：百姓 1：阵营成员 2：城主 3：阵营领袖 campid:所属阵营ID campname:所属阵营名称 campleaderid:所属阵营首领的ID campleadername：所属阵营首领的名称 campleader:所属阵营首领的称呼 fame_val:个人名望值 maxhp:最大生命 maxmp:最大气力 job_cityid:任职地点ID job_cityname:任职地点名称 state:当前状态：0：正常 1：被俘 -1：死亡 is_recruitable:是否可招募人物 0：不可 1：可招募 is_leave_team_enable:是否可以离队 0 不可以 1可以 recruit_val:当前可招募标记 0：不可 1：可招募 inteam:是否在玩家队伍中 0：不在 1：在 camp_rl:目标阵营与主角阵营之间的关系 0中立 1交战 2盟友 3己方 camp_fv_val:目标阵营与主角阵营之间的友好度具体值 fv:与玩家的友好度 player_relation_score:与玩家的综合好感评估 weapon_tag=(自定义tag字段)：查询装备武器上的指定tag，如果没有武器或者指定tag不存在，都会返回[$null$] skill_level=(技能ID）：查询人物目标技能的当前等级 skill_maxlevel=(技能ID）：查询人物目标技能的最大等级 skill_exp=(技能ID）：查询人物目标技能的当前经验 skill_upexp=(技能ID）：查询人物目标技能当前等级升级到下一级所需经验 statu=(自定义ID）：查询人物属性表里的相应ID的值。如果没有则返回[$null$] statu_int=(自定义ID）：查询任务属性表里对应ID的int值，没有返回0 has_girl_friend:【主角专用】是否有女友，1表示有，0表示没有 current_girl_friend_name：【主角专用】女友姓名 girl_friend=角色ID：【主角专用】查询某人是否为主角女友 is_female：是否为女性角色，1表示是，0表示不是 available_quest：可用任务
[$called:call1:call2$]	NPC对玩家的称呼（当为男性时返回call1，当为女性时返回call2）
[$null$]	替换为空字符串
[$trig_tagtype$]	当前执行事件的触发对象类型
[$trig_tagid$]	当前执行事件的触发对象ID
[$input_str$]	前一个输入框的输入结果
[$argvs:INDEX$]	查询当前附加的参数信息，编号从0开始。（当前用于随机事件的参数填充）
[$tagplace:INFO:ID$]	查询一个地点的信息，当地点ID字段不存在时为查询当前地点 INFO可为如下内容： id:地点ID name:地点名称 campid:所属阵营ID mapid:所属地图ID campname:所属阵营名称 prosperity:当地繁荣度 defence:当地城防值 rep:当地好感度 security:当地治安值 size:地点规模值 lord_id:城主角色ID lord_name:城主角色名称 tag=(自定义扩展字段KEY):返回指定的自定义字段值 is_stronghold:是否据点类型（可驻守军队） is_weekhold:不可驻守军队的【资源点】 is_couldoccupy:当前是否可攻占 is_couldraid:当前是否可掠夺 is_raided:地点当前是否已被掠夺(处于恢复期) is_subplace:当前是否附属地点 stat=(状态值字段ID)：获取当前地点的指定状态值 building=(指定设施ID)：查询地点内指定建筑ID的设施数量 building_t=(指定设施类型)：查询当地指定类型的设施数量 custom_int=(自定义字段ID)：获取当前地点的整形自定义字段值 camp_rl:目标阵营与主角阵营之间的关系 0中立 1交战 2盟友 3己方 func_map=（指定字段KEY）:查询对应指令事件映射表映射的字段，如func_map=hirelist player_rep:玩家在该处的声望 hire_states:查询该处的招募状态 player_dist:玩家当前位置距离该地点的距离，如果不可达，则返回-1.
[$tagmap:INFO:ID$]	查询一个地图区块的信息： id:区块id name:区块名称 dominant_camp:如果存在完全统治的势力，则返回该势力名称，不存在则返回空 dominant_camps=(自定义字段ID):如果仅存在某几个指定id的势力，则返回1，否则返回0，自定义字段格式：势力1#势力2#势力3 camp_place_count=势力ID:返回在该区块某势力的据点数目 ExploreInfo=Info ID：查询某个探索地图信息的值
[$tagbuilding:INFO$]	查询当前目标建筑信息 id:建筑ID name:名称 inner_id:目标建筑的地点内置ID type:建筑类型 level:建筑等级 tag=(自定义扩展字段KEY):返回指定的自定义字段值
[$tagwb:INFO$]	查询当前遭遇战斗的信息INFO可为如下内容 id:战斗ID camp_a:参战A方的阵营ID camp_b:参战B方的阵营ID leader_a:参战A方的领袖人物ID leader_b:参战B方的领袖人物ID camp_a_rl:参战A方与主角阵营的关系 camp_b_rl:参战B方与主角阵营的关系 teamname_a:参战A方的阵营及将领名称 teamname_b:参战B方的阵营及将领名称
[$tagteam:INFO$] [$playerteam:INFO$]	查询当前遭遇队伍(tagteam)/主角队伍(playerteam)的信息。INFO可为如下内容 id:队伍ID campid:所属阵营ID campname:所属阵营名称 state_num:当前队伍的StateNum值 from_id:来自地点的ID from_name:来自地点的名称 lifetime:队伍自创建以来经历的游戏时间(天数) camp_rl:目标阵营与主角阵营之间的关系 0中立 1交战 2盟友 3己方 max_attr_lv=属性字段ID: 队伍中所有角色中某属性的最高值 exist_role=角色ID：返回队伍是否存在某人物ID，是返回1否0 role_vacancy：队伍剩余的英雄可用位置 soldier_vacancy：队伍剩余的可用小兵卡牌位置 map_info：当前地图位置信息
[$tagcamp:INFO:ID$]	查询目标阵营信息,当ID不存在时为查询当前阵营。INFO可为如下内容 id:势力ID campname:阵营名称 leaderid:领袖ID leadercalled:阵营领袖的称呼 lands_count:当前该势力的领地数量 camp_rl:目标阵营与主角阵营之间的关系 0中立 1交战 2盟友 3己方 camp_rl_value :目标阵营与主角阵营之间的好感度具体数值 stat=(状态值字段ID)：获取当前阵营的指定状态值 buff=(目标BUFF的ID)：查询当前阵营指定BUFF是否存在(1为是) buff_c=(BUFF类型)：查询当前阵营指定类型的BUFF数量 active_state:目标阵营的活跃状态 0：不活跃 1：活跃
[$tagbazzar:INFO$]	查询当前系统传入的集市的信息 start_day:集市的开始天数
[$tagbazzarItem:INFO:bazzarID:merchantID$]	查询某个集市的某个商人在当前时候买/卖的货物信息 item_desc：货物的描述（详细） item_desc_short：货物的描述（简略） item_buy_price：货物的购买价格 item_sell_price：货物的卖出价格
[$tagproduct:INFO:ID$]	查询某种特产的信息,ID不填时查询当前传入的特产信息 item_name:对应道具的名称 item_id:对应道具的ID item_level:对应道具的等级 item_price:对应道具的单个公允价 player_dist:该特产的中心位置离玩家当前位置的距离，-1表示该中心位置玩家不可达 place_include=地点ID:返回0表示指定地点没有售卖对应的道具，1表示指定地点在售卖对应的道具 place_include_tagQuestPlace:自动使用当前传入的任务发生地点信息来进
个文字探索地图的信息，copyID是因为探索地图可能存在多份副本，可以不填（基本上只有系统传入参数才会填这个copyID）。不填就是地图上可见的那种探索地图。 finCD:0表示没有CD概念或者CD已经ok，1表示正在冷却中
est:INFO:ID$]	查询任务信息 status:0：未领取 1：进行中 2：已完成 3:已超时（等待超时惩罚） 4:已超时（等待自动领取奖励） 5：已终结
[$arg_str_val1$] [$arg_str_val2$] [$arg_str_val3$]	当前事件字符串参数1、2、3
[$rnd_enum:PROB_A,RES_A:PROB_B,RES_B:PROB_C,RES_C[:...]$]	随机枚举值，根据所有项的概率分布返回其中一个项的RES值。比如[%rnd_enum:25,A:40,B:35,C%]表示有25%的概率返回”A”，40%的概率返回”B”，35%的概率返回”C”
[$tagitem:INFO$]	查询当前物品的信息，INFO可为以下内容 id:物品ID name:物品名称 count:物品数量 group_n:最大堆叠数量 quality:物品品质 level:物品等级 main_type:物品主类型 sub_type:物品子类型 equip_type:装备类别 gendays:生产日期距离今天已有的天数 tag=(自定义扩展字段KEY):返回指定的自定义字段值
[$tagproject:INFO:ID$]	查询一个项目的信息，如果不填ID将从SET_TEMP_ID指定的id中读取。 id:项目id state:项目状态（仅团体项目有效） 0：未开始 1：进行中 2：已完成 showPlaceName:项目执行地点描述 showProjectName:项目名称 roles:当前参与项目的所有角色
[$tagunit:INFO$]	查询当前查询目标小兵单位的信息 id:单位id name:单位名称 level:单位等级 statu=(自定义ID）：查询单位属性表里的相应ID的值
[$tagcard:INFO$]	查询指定卡牌的信息 id:卡牌id name:卡牌显示名 level:卡牌等级

全局存档查询指令字段

用来查询全局存档中的一些指令


查询指令	说明
[%global_int:ID%]	返回全局整形字段ID的值
[$global_str:ID$]	返回全局字符串字段ID的值

内置自定义变量字段

可使用SETINTVAR、CHANGEINTVAR等指令进行修改并保存的系统内置自定义变量。一般都具有特定的功能。


字段KEY值	说明
system_探索地图点数	探索地图点数
system_星星	星星数目
system_敌方角色血量百分比	当玩家与敌方角色对战时，对方血量的额外附加倍率
system_敌方角色攻击百分比	当玩家与敌方角色对战时，对方攻击力、魔法攻击力的额外附加倍率

对话框及一些通用UI中支持的字体颜色指定代码

在对话框、文字框以及一些常见的UI中，通常可以使用以下格式来为文本中的指定文字更改颜色。

例如：这是一段[[imp:红色字体]]，[[red:红色字体]],[[&ff6699ff:自定义颜色]]的字体

目前可支持的定制颜色如下（自定义颜色需用"&"符号替换"#"）：

place：地点名称的统一颜色
role：人物名称的统一颜色
camp：阵营名称的统一颜色
item：物品名称的统一颜色
imp：重要信息的统一颜色

人物角色位置指令格式

人物位置格式为：位置代码:位置参数

支持的位置代码有 0：未分配 1：地点中 2：队伍中 3：项目中

当位置代码为1地点中时：格式如下 1:地点ID,设施ID （设施ID为空表示在设施外部）
当位置代码为2队伍中是：格式如下 2:队伍ID

游戏内全局位置指令格式

当为一个队伍或者大地图上的对象指定位置信息时，就需要一个可以进行全局位置指定的指令格式(如使用TELEPORT指令等)。

全局位置格式为：

地图ID:坐标X,坐标y

特定战斗中的单位限制指令格式

在特定战斗表中，可以在“限制条件”一栏中填入以下格式的指令字段进行单位或者特殊限制。

格式如下：

命令1:参数1;命令2:参数2;...命令N:参数N;

目前支持的限制命令如下：

player 重置队伍英雄列表格式为：人物ID1,重置等级(-1或不填表示不重置)|人物ID2,重置等级|人物ID3,重置等级|...|人物ID N,重置等级
units 重置队伍小兵列表格式为一般卡牌列表格式
add_stat 附加角色属性状态格式为：目标人物ID#状态表

大地图单位控制指令表

大地图单位（队伍）控制指令是用来对大地图上的单位进行序列行为指定的控制方法。当单位被指定控制指令表后，会按照先后顺序逐步执行每一条指令，直到指令表执行完成。当单位执行动作进行中途保存退出后，读档时会按照之前的指令表继续执行指令。

注意：除了假人（包括剧情控制中需要的假人和游戏中的野怪等）外，其他类型的队伍的指令表执行结束后会自动解散队伍。

控制指令的格式是由整形数字的命令类型加命令内容组成，多行以“;”进行分隔，每行指令以指令类型代码+”,”开头，后面为指令参数，例如：

1,测试地图:100,100;1,测试地图:100,200;99,0

上述代码表示先移动到测试地图的坐标1(100,100)，再移动到2(100,200)，然后解散队伍；

目前支持的指令类型代码如下：


控制指令代码	说明
1	向大地图坐标移动参数为目标地图坐标（地图坐标格式地图ID:坐标X,坐标Y）
2	在原地停留参数为停留时间（单位：游戏内天数）
3	进入地点参数为目标地点ID
4	攻打目标地点参数为目标地点ID,攻占方式（0:占领 1：掠夺）
5	在目标地点内停留参数为目标地点ID,停留时间
7	执行一个事件参数为事件ID
8	更改当前StateNum值参数为新的StateNum值说明：StateNum 可以用来标记一些控制队伍的当前状态。例如：命令一个单位去地图某个地方执行一个动作，当它到达之前StateNum为0，到达后将StateNum改为1，这样就可以在脚本中判断该队伍当前处于什么状态了。
9	永久执行自定义运动命令，参数格式：运动方式,参数表目前可支持的运动方式及参数格式：范围内游荡：WANDER,运动半径,[中心坐标X,中心坐标Y](如不指定中心坐标则以当前位置为中心) 巡逻运动：PATROL,坐标1X,坐标1Y,坐标2X,坐标2Y,...,坐标NX,坐标NY(当第一个坐标等于最后一个坐标时执行循环运动，否则为往复运动) 其他为静止不运动
10	加入一个战团参数为战团的数字ID（系统内置方法，不推荐调用）
11	执行一个动作参数格式为：动作ID,循环次数(-1无限循环 ≥1有限次循环,当动作自身是循环动画时设置为1即可),单次动作时间(秒为单位，当非无限循环的动作次数播放结束后执行下一条指令),播放对象（0默认全体 1仅领队 2所有追随模型）,初始帧区间（0~1之间，1为动画最后一帧。-1为随机取0~1之间的值）,播放结束后是否转入下一个指令（默认为0否 1是）模型当前支持的默认动作表：循环动作：待机、移动、慢走、冲锋、蓄力单次动作：受击、闪避、格挡、攻击、射击、横劈、顺劈、直击、释放、咆哮、击飞、跳跃、庆祝、死亡
12	~~掠夺一个地点参数为目标地点ID~~【已废止】
13	开宝箱参数为宝箱ID
14	执行一个TimeLine动作参数格式为：TimeLineID,持续时间(默认-1，始终持续，当>0时播放执行时间后结束)
15	改变当前队伍对玩家的态度 0：中立 1：敌对
16	改变当前队伍移动速度参数为目标移动速度
17	交易成功参数为交易目标地点ID
18	进行交易参数为交易目标地点ID
19	跟随队伍目标参数为跟随目标的控制ID
99	解散当前队伍

物品列表信息格式

物品列表信息是最常使用的信息格式之一，各种物品获取相关的指令（GETITEMS等指令）、配置表中都会用到这种信息格式。

物品信息的格式如下：

物品代码1,数量1[,细节信息表]|物品代码2,数量2[,细节信息表]|....|物品代码N,数量N[,细节信息表]

细节信息表为格式为"key1=val1,key2=val2,..."的字典表，其支持以下信息字段内容：

【mf】自动匹配创建词缀：mf=最低品质N-最高品质N[-变量数值附加基数]

例：长剑,1,mf=0-3 说明：以mf开头的词缀代码表示自动适配出品质从0-3之间的词缀（0为不附带词缀）。

【cw】创建制定词缀：cw=词缀ID+变量数值附加基数（0-100）

例：长剑,1,cw=吸血剑+50 说明：表示附带吸血剑指定词缀的物品，所有变量数值指定由50-100之间。

【w】指定物品词缀详情：w=词缀ID$[变量代码数组]
【qv】指定物品属性的变量数组：qv=变量代码数组
【p】指定物品的记录买入价格：p=买入价格

变量代码数组由列数为2的二维数组组成，列1为枚举值，列2为品质数值（0-100），以”/”进行连接。比如一个词缀有3条词条，那么他的变量数组可能为：0/50/0/100/0/100

天气效果信息格式

使用指令代码控制天气时多以组合天气效果为主，多个天气效果以"|"进行连接。

天气效果描述信息格式为：

天气效果ID1,强度值|天气效果ID2,强度值|...天气效果IDn,强度值

目前游戏中支持的天气效果ID有：

雨：强度为0时关闭 1~50为普通 50~100为大雨
雪：强度为0时关闭 1~50为普通 50~100为大雪
风沙：强度为0时关闭 1~100
雷电：强度为0时关闭 1~100
雾：强度为0时关闭 1~100
黑暗：强度为0时关闭 1~100
炎热：强度为0时关闭 1~100（热变形特效）
云：强度为0时关闭 1~100（晴天时地面的云朵阴影）

地图编辑器及各种配置表中的天气效果信息字段填写格式如下：

概率1,持续时间1:[天气效果描述信息1];概率2,持续时间2:[天气效果描述信息2];概率3,持续时间3:[天气效果描述信息3];[...];概率N,持续时间N:[天气效果描述信息N]

比如：30,1:;50,3:雨,20|雾,10;20,5:风沙,30

表示30%的概率持续一天无天气效果，50%的概率持续3天下雨，20%的概率持续5天风沙天气

镜头滤镜效果信息格式

当使用SET_CAMERA_FILTER等指令时可以对当前游戏设置镜头滤镜效果。

镜头滤镜效果信息的格式为：

滤镜效果ID1,强度值|滤镜效果ID2,强度值|...滤镜效果IDn,强度值

目前游戏中支持的镜头滤镜效果ID有：

暗角：强度为0时关闭 1~100为镜头边框的暗影程度
黑白：强度为0时关闭 1~100为同一黑白照片效果
老旧：强度为0时关闭 1~100为老旧（泛黄）照片效果

人物表中具有特殊含义的TAG

目前一些程序中使用的人物TAG字段


字段	说明
LIKE	标识人物所喜欢的物品类型，影响好感度提升速度格式：LIKE:类型1\|类型2\|...
DEF_WEAPON_SPEED	默认的武器速度，有此tag时会在人物不装武器时候以此速度为默认武器速度

地点表中具有特殊含义的TAG

程序中具有实际功能的地点TAG表


字段	说明
迷你地图显示	除城镇地图默认显示外，其他地方如果要显示必须此tag=1
迷你地图不显示	顾名思义
AI出征关闭	有此tag的据点不会主动出征、巡逻、占领资源点

物品表中具有特殊含义的TAG

程序中具有实际功能的TAG字段：


字段	说明
不可丢弃或出售	该道具不能被丢弃或者出售
不占背包格子	该道具不会占据道具栏的使用空间

不可丢弃或出售：顾名思义

不占背包格子：顾名思义

物品道具词条信息格式

物品道具的词条以“词条类型:{枚举信息1,数值1;枚举信息2,数值2;...}”的格式设置在物品表中，其中词条类型分为以下几种：

a：被动增加角色属性，枚举信息为增加属性的Key
skill：增加角色可用技能，枚举信息为技能ID
dg_skill：替换角色当前的地城技能，枚举信息为地城技能ID

物品掉落信息格式

物品掉落信息格式为：

概率1,物品ID1,最低数量,最高数量[,附带参数表(见 物品列表信息格式 )]|概率2,物品ID2,最低数量,最高数量[,参数表]|...|概率N,物品N,最低数量,最高数量[,参数表]

（如LOOT*100.0,金钱,100,200|50.0,经验,100,200 表示100%的概率获取100~200金钱 50%的概率获取100~200经验）

其中，物品ID一项可指定特殊ID “QUERY”，表示从全局掉落表中查询一个掉落结果并返回。（见Q全局掉落表.xlsx 中格式）

QUERY的参数表格式为“参数1=val1,参数2=val2,....”，可支持以下查询参数：

【id】直接从全局掉落表中取目标ID的结果（此项存在且不为空时将忽略所有其他查询条件）

【lv】指定的适配等级，当-1时适配所有查询结果当为0时以主角当前等级进行查询

【tag1】查询筛选TAG1

【tag2】查询筛选TAG2

【tag3】查询筛选TAG3

地图假人设置及控制方法说明

地图编辑器中可以添加一些带有方向和位置信息的假人区域信息，其中有以下字段信息需要填写：

(带*号的为可选字段，如不填将由默认值代替)

dummy_id：假人全局索引编号（可重复，如重复则为批量控制）
model_id：大地图单位模型
*role_id：绑定对象人物的ID（默认为空时不显示目标名称）
*init_state：初始状态 -1：隐藏（默认） 0：正常
*init_dir：初始方向（默认0）
*move_info：假人行动方式（默认为静止。）
*interative：是否可交互0：否 1：是（默认）
*move_speed：假人移动速度（默认为100）
*camp_id：所属阵营（默认为空）

当需要绑定假人类型的地图交互触发器时，需指定触发事件为“encounter”，触发类型为“DUMMY”，触发ID为假人的dummy_id

地图宝箱设置说明

地图上可设置一些奖励类的可交互对象，当点击时会执行脚本并获取奖励

该类宝箱对象需要将mtype设置为chest，同时添加以下自定义字段：

chest_id：宝箱全局索引编号（可重复，如重复则为共享CD并批量控制）
info_id：宝箱的描述信息编号（所有信息定义在“地图宝箱信息表.xlsx”中
*init_state：初始状态 0：未开启（默认） -1：已开启
*init_dir：初始方向（默认0）

地图野怪设置说明

野怪属于地图刷新单位的一种，实现机制复用了地图假人系统。

设置地图野怪首先需要在Tiled中定义野怪刷新的位置和信息，设置方法为将矩形对象的mtype设置为monster，同时添加以下自定义字段：

monster_id：野怪的全局索引编号（可重复，如重复则为共享CD并批量控制）
m_group：野怪的索引组（所有信息定义在“野怪投放适配表.xlsx”中
min_lv：适配到的最低等级
max_lv：适配到的最高等级
*init_state：初始状态 0：未开启（默认） -1：已开启
*init_dir：初始方向（默认0）
*move_info：野怪行动方式（默认为静止。）命令格式参考6.7.9节
*move_speed：野怪移动速度（默认为100）

特效对象事件脚本指令格式

特效对象可以附加 eftEffectEventHelper 脚本为其增加播放事件，每个事件的输入格式为：事件时间点(start后的秒数):指令类型,参数1, 参数2,....,参数N

目前支持的指令类型有:

shake_cam：晃动屏幕参数1为晃动时间参数2为强度

play_sound：播放一个声音参数1为声音ID

@@ 第2,225行： / 第2,225行： @@
 |有此tag的据点不会主动出征、巡逻、占领资源点
 |}
-中立不可攻打：有此tag为不可攻打地点
-AI出征关闭：有此tag的据点不会主动出征、巡逻、占领资源点
-中立条件攻打：在没有设置customInt[取消中立]=”1”之前，不可攻打，之后可攻打
-迷你地图显示：除城镇地图默认显示外，其他地方如果要显示必须此tag=1
-迷你地图不显示：顾名思义
-大地图隐藏名称：在大地图上不显示名称
-<br />
 ===物品表中具有特殊含义的TAG===