通用剧情事件指令说明
特别注意：脚本编辑时注意所有特殊符号必须为半角！！！同时在剧情和所有配置表里也要避免使用带有特殊符号的字符串，以防止和脚本配合使用时发生脚本注入错误！
目录
- 1 剧情事件
- 2 脚本命令列表
- 3 全局存档相关的操作指令
- 4 内置指令列表
- 5 脚本预设字段及含义
- 6 剧情事件中的结果脚本指令格式
- 7 条件表达式组格式
- 8 剧情事件中可用的嵌入式查询指令
- 9 全局存档查询指令字段
- 10 内置自定义变量字段
- 11 对话框及一些通用UI中支持的字体颜色指定代码
- 12 人物角色位置指令格式
- 13 游戏内全局位置指令格式
- 14 特定战斗中的单位限制指令格式
- 15 大地图单位控制指令表
- 16 物品列表信息格式
- 17 天气效果信息格式
- 18 镜头滤镜效果信息格式
- 19 人物表中具有特殊含义的TAG
- 20 地点表中具有特殊含义的TAG
- 21 物品表中具有特殊含义的TAG
- 22 物品道具词条信息格式
- 23 物品掉落信息格式
- 24 七、技能命令编辑说明
- 25 八、地图假人设置及控制方法说明
- 26 九、地图宝箱设置说明
- 27 十、地图野怪设置说明
- 28 十一、游戏数据中运算值表达式系统说明
- 29 十二、单位对象附加触发脚本编辑说明
- 30 十三、特效对象事件脚本指令格式
剧情事件
剧情事件是游戏过程中用来实现剧情脚本的基本元素。游戏中所有的剧情事件都是由触发器或者执行器调用并丢入指令队列中，然后在游戏中由世界事件管理器(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_SCREEN*0.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
|
| 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*指令内容
|
| 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|.......）#指令方式(见说明)#指令参数 目前指令方式支持以下几种：
|
| 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[为空表示当前目标角色]#指令代码:指令参数表
|
全局存档相关的操作指令
全局存档是用来记录一些所有存档共享的数据记录的存档。记录在全局存档中的数据更改后可以在所有不同的存档中进行访问。
| 指令 | 说明 |
|---|---|
| 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时执行
以下为条件表达式中支持的比较符号
- [=]：等于
- [>]：大于
- [>=]：大于等于
- [<]：小于
- [<=]：小于等于
- [<>]：不等于
剧情事件中可用的嵌入式查询指令
目前游戏中很多地方都支持插入嵌入式查询指令，通过这些查询指令，可以很方便的在一些文本或者条件表达式中插入我们想要的数值或者字符串类型的查询结果。所有嵌入式查询指令都是以[%QUERY:arg1:arg2...%]或者[$QUERY:arg1:arg2...$]这样的格式（两者等效）插入到目标位置的。
注意：目前暂不支持查询中再次嵌入查询指令！
目前支持的查询指令列表如下：
| 查询指令 | 说明 |
|---|---|
| [%result_code%] | 返回当前事件中最后一个有返回结果的命令结果值（比如在剧情事件脚本中代表返回的选择框选项、输入的数值、战斗的结果等）
以下为result_code在不同类型命令下返回的含义
|
| [%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可为如下内容：
|
| [$called:call1:call2$] | NPC对玩家的称呼（当为男性时返回call1，当为女性时返回call2） |
| [$null$] | 替换为空字符串 |
| [$trig_tagtype$] | 当前执行事件的触发对象类型 |
| [$trig_tagid$] | 当前执行事件的触发对象ID |
| [$input_str$] | 前一个输入框的输入结果 |
| [$argvs:INDEX$] | 查询当前附加的参数信息，编号从0开始。（当前用于随机事件的参数填充） |
| [$tagplace:INFO:ID$] | 查询一个地点的信息，当地点ID字段不存在时为查询当前地点
INFO可为如下内容：
|
| [$tagmap:INFO:ID$] | 查询一个地图区块的信息：
|
| [$tagbuilding:INFO$] | 查询当前目标建筑信息
|
| [$tagwb:INFO$] | 查询当前遭遇战斗的信息INFO可为如下内容
|
| [$tagteam:INFO$]
[$playerteam:INFO$] |
查询当前遭遇队伍(tagteam)/主角队伍(playerteam)的信息。INFO可为如下内容
|
| [$tagcamp:INFO:ID$] | 查询目标阵营信息,当ID不存在时为查询当前阵营。INFO可为如下内容
|
| [$tagbazzar:INFO$] | 查询当前系统传入的集市的信息
|
| [$tagbazzarItem:INFO:bazzarID:merchantID$] | 查询某个集市的某个商人在当前时候买/卖的货物信息
|
| [$tagproduct:INFO:ID$] | 查询某种特产的信息,ID不填时查询当前传入的特产信息
|
个文字探索地图的信息，copyID是因为探索地图可能存在多份副本，可以不填（基本上只有系统传入参数才会填这个copyID）。不填就是地图上可见的那种探索地图。
| |
| 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可为以下内容
|
| [$tagproject:INFO:ID$] | 查询一个项目的信息，如果不填ID将从SET_TEMP_ID指定的id中读取。
|
| [$tagunit:INFO$] | 查询当前查询目标小兵单位的信息
|
| [$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 | 永久执行自定义运动命令，参数格式：运动方式,参数表
目前可支持的运动方式及参数格式：
|
| 10 | 加入一个战团 参数为战团的数字ID（系统内置方法，不推荐调用） |
| 11 | 执行一个动作 参数格式为：动作ID,循环次数(-1无限循环 ≥1有限次循环,当动作自身是循环动画时设置为1即可),单次动作时间(秒为单位，当非无限循环的动作次数播放结束后执行下一条指令),播放对象（0默认全体 1仅领队 2所有追随模型）,初始帧区间（0~1之间，1为动画最后一帧。-1为随机取0~1之间的值）,播放结束后是否转入下一个指令（默认为0否 1是）
模型当前支持的默认动作表：
|
| 12 | |
| 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为不可攻打地点
AI出征关闭：有此tag的据点不会主动出征、巡逻、占领资源点
中立条件攻打：在没有设置customInt[取消中立]=”1”之前，不可攻打，之后可攻打
迷你地图显示：除城镇地图默认显示外，其他地方如果要显示必须此tag=1
迷你地图不显示：顾名思义
大地图隐藏名称：在大地图上不显示名称
物品表中具有特殊含义的TAG
程序中具有实际功能的TAG字段：
| 字段 | 说明 |
|---|---|
| 不可丢弃或出售 | 该道具不能被丢弃或者出售 |
| 不占背包格子 | 该道具不会占据道具栏的使用空间 |
不可丢弃或出售：顾名思义
不占背包格子：顾名思义
物品道具词条信息格式
物品道具的词条以“词条类型:{枚举信息1,数值1;枚举信息2,数值2;...}”的格式设置在物品表中，其中词条类型分为以下几种：
- a：被动增加角色属性，枚举信息为增加属性的Key
- skill：增加角色可用技能，枚举信息为技能ID
- dg_skill：替换角色当前的地城技能，枚举信息为地城技能ID
物品掉落信息格式
物品掉落信息格式为：
概率1,物品ID1,最低数量,最高数量[,附带参数表(同6.8节)]|概率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
七、技能命令编辑说明
以下命令适用于战斗中技能的效果与事件。
技能命令条以”\n”换行符分隔，每条由延迟时间*[条件表达式(可选)]#命令内容组成，参考格式如下：
0*条件表达式1#技能命令1
0.2#技能命令2
……
当条件表达式不为空时，根据条件表达式判定结果执行。
条件语句中可以使用一些内置命令来实现一些例如重复之类的特殊效果，例如
*REPEAT_START:9
语句1
语句2
[@0.01*[%rpt_index%]@]#技能命令
...
语句N
*REPEAT_END
表示将REPEAT_START行与REPEAT_END之间的所有行重复9遍，期间可以通过[%rpt_index%]来查询当前语句处于第几次循环
*SELECT_UNITS:[目标筛选条件表达式](注意，次数查询cast_info中的target为当前单位)
语句1
语句2
...
语句N
*SELECT_END
表示对SELECT_UNITS行与SELECT_END之间所有的命令行，对SELECT_UNITS:后所有满足指定条件表达式的对象使用，并以该对象作为caster对象
其中，嵌入到[@...@]中的语句为保留两位小数的结果运算取值，此类查询仅在技能命令中有效。
目前支持的技能命令有：
1. stop_act：立即停止当前所有技能动作并按照之前指令行动
stop_act#1
2. add_eft：向战场中添加一个预定义的特效体
add_eft#特效体ID#初始位置#运动参数#修改伤检对象(可选，为空时为默认)#附带伤害表达式（可选，为空时按照特效表中定义的伤害表达式计算，格式见6.4节）#目标参数(见7.4节说明)#特效体TAG（用于replace_eft指令查询）
初始位置格式为：位置类型,偏移x,偏移y,偏移z（偏移量为相对于初始方向的偏移）
支持的位置类型有：
cast_pos：技能施放动作的预设位置
tag_pos：技能施放目标单位或者目标坐标的位置
hit_pos：技能命中目标单位当前的位置
unit_pos：技能施放单位当前的位置
start_pos：技能释放时的开始位置
rnd_pos：技能释放单位周围一个任意的位置
dim_pos：通过set_dimpos命令定义的预设位置
reinf_pos：施法者阵营方的增援位置
emitter_pos=EMITTER_ID：ID为EMITTER_ID的发射器发射点位置
unit_round=DIR:LEN：距离施法者正方向偏移DIR角度，距离为LEN的位置
rnd_round=RAD[-MIN_RAD]：施法者半径RAD范围内的随机位置，可选参数MIN_RAD表示随机范围距中心的最小距离，默认为0
eft_pos=TAG：返回查询到的第一个指定特效体TAG的特效体位置，如不存在则返回caster的当前位置 注意：仅支持查询由caster本单位创建的特效体
……
运动参数格式为：运动类型:运动参数（形如：参数1,参数2,参数3.....）
支持的运动类型有：
l 0：不运动 无参数
l 1：运动至技能目标点 偏移x,偏移y,偏移z
l 2：运动至技能目标单位 无参数(当目标参数不为空时使用目标参数指定的目标，否则按照技能释放目标)
l 3：向指定方向运动 偏移角度,移动距离(最大不超过战场宽度)
l 4：向指定方向往返运动 偏移角度,移动距离(最大不超过战场宽度)
l 5：跟随目标运动 跟随类型(0固定相对位置，1发射点位置),偏移x,偏移y,偏移z,持续时间（-1为永久）
l 6：运动至dim_pos 偏移x,偏移y,偏移z
l .。。
3. dmg_check：进行伤害判定
dmg_check#判断类型#伤害值表达式#目标对象参数#判断参数表(“,”分隔)#是否过滤掉重复检定对象(可选，默认关闭)
支持的判断类型有：
l 0：单体判断（目标对象参数为目标单位见下一小节，为空表示技能目标）
l 1：半径范围判断 目标对象参数为目标类型(0:敌方 1：我方 2：双方) 参数表中参数1为参考位置类型（见add_eft命令的位置类型） 参数2,3,4,5分别为偏移坐标的x,y,z及半径
l 2：多边形范围判断 目标对象参数同上 参数表中参数1同上 参数2为旋转角度 参数3为多边形顶点数，参数4以后为以参考点坐标为(0,0)的多边形坐标信息
4. add_buff：对目标施加BUFF
add_buff#buff ID#BUFF目标参数#持续时间（如不指定则采用BUFF默认持续时间）#叠加层数（默认为1）#上限层数(默认为配置表中的数值，只有大于0时生效)
可支持的内置目标参数有：
caster：技能释放者
target：目标单位（指向性技能的目标或技能命中的目标）
roleid,ROLEID：查询单位绑定人物ID为ROLEID的一个目标对象
buffgiver,BUFFID：查询当前caster身上一个ID为BUFFID的BUFF给与者
find_tag_res：查询指定目标的结果单位（必须先执行一次[%find_tag:TAGINFO%]查询才可调用）
tag_next_fu,距离D：当前命中目标的下一个小于距离D的友方单位
caster_next_fu,距离D：施法者的下一个小于距离D的友方目标
caster_next_eu,距离D：施法者的下一个小于距离D的敌方目标
5. remove_buff：移除目标的BUFF
remove_buff#移除目标（同上）#移除方式#参数1,参数2,参数3...
目前支持的移除方式如下
l 0：全部移除
l 1：移除指定BUFF 参数1为BUFF ID，参数2为移除层数（默认-1为全部移除）
l 2：移除有害BUFF 参数1为移除数量（默认-1全部移除），参数2为BUFF子类型（默认-1不限）
l 3：移除有益BUFF 参数1为移除数量（默认-1全部移除），参数2为BUFF子类型（默认-1不限）
1:
6. dart_move：突进类移动
dart_move#动作ID#移动类型#速度参数#冲撞质量#绑定特效#运动结束承接技能,技能等级(默认1级)[可为空],时间偏移(秒，在运动结束前开始执行承接技能向前的时间偏移量>=0)[可为空]#操作对象(可选，默认为caster)#修正目标位置(可选，参数格式见节2)#是否强制(默认0 为1时强制移动)
移动类型分为：
0：匀速运动
1：跳跃
2：击退运动
3：击飞运动 （当为击飞运动时，速度参数为击飞的滞空时间）
速度参数为角色移动时的水平速度（当速度小于等于0时为闪现至目标）
冲撞质量在匀速运动时表示刚体质量，0为无视碰撞 (当为跳跃运动时该参数代表跳跃高度)——由于不使用物理引擎了，目前暂时无用了，参数还必须要填写。
绑定特效为运动时附加在单位上的特效ID
运动结束承接技能为执行运动结束后立即执行的技能ID
7. stop_dartmove：停止当前突进运动
stop_dartmove#1
8. explode：在目标位置进行一次爆破物理效果
explode#初始位置(见2节解释)#爆破半径#力度参数
9. add_force：对目标单位进行一次击退效果
add_force#力度参数#目标单位（可省略，默认target）
10. play_sound：播放一个指定音效
play_sound#音效ID#音效位置（同第一节解释）
11. unit_sound_dic：单位根据模型配置播放指定音效字典中的字段对应音效
unit_sound_dic#音效字典KEY值#单位目标参数
12. cast_sound：播放一个指定音效（在施法者处）
cast_sound#音效ID
13. chain_eft_to：播放一个链式特效
chain_eft_to#释放单位#目标单位#特效预制体#传播速度(-1为瞬间)#维持时间#命中目标的伤害值表达式
释放目标的参数同本章第4小节
14. taunt：嘲讽效果，让目标立即攻击释放者
taunt#释放者#目标单位
15. use_skill：立即触发一个不需要吟唱时间的单体目标技能(可以是当前施法者没有的技能)
use_skill#技能ID,技能等级(默认1级)#释放者#目标单位#目标位置(同2小节，为空表示同目标单位位置)
16. set_cmd_val：操作当前命令行参数
set_cmd_val#操作方式#操作值D
操作方式：0：设置为值D 1：增加值D 2：减少值D
注意：与其他缓冲后一次执行的指令不同，该指令不会进入执行队列，将立即执行生效。这是为了在一些需要在执行语句上下文中使用临时变量进行信息中继所设计的结构。
17. set_dimpos：设置预设位置参数
set_dimpos#操作方式#操作参数[#偏移参数(仅在查询单位位置时生效)]
操作方式：
0：我方增援出兵位置 操作参数分别为 x,y,z的偏移
1：查询目标单位位置 操作参数为查询指令(见第4小节)
2：查询技能参数位置 操作参数为查询指令(见第2小节位置信息)
18. play_sk_act：播放一个已定义的技能动作
play_sk_act#目标单位#技能动作ID名称#播放速度系数(默认1)#是否停止移动(默认否)
19. summon_unit：召唤一个单位
summon_unit#召唤方式#对象参数[,血量百分比(可选参数，默认为100)]#初始位置参数#持续时间#附加状态表#附加特效参数
召唤方式：0：对象的镜像 1：通过人物ID召唤 2：通过小兵ID召唤
对象参数： 当召唤方式为0时表示对象单位（参考本章4节）；当召唤方式为1时表示人物模版ID,等级；当召唤方式为2时表示兵种单位ID
初始位置参数见本章2节
持续时间小于等于0时表示本次战斗永久持续，大于0时表示持续秒数
附加状态为该单位的附加属性表，如： s_生命,-[&[%s_生命%]*0.5&]|s_攻击,-[&[%s_攻击%]*0.5&] 表示召唤出的单位生命与攻击力均为原单位的一半
附加特效参数：默认为0 当为1时显示半透明影子效果
20. set_unitpos强制改变目标单位的当前位置
set_unitpos#操作对象(同4节)#位置信息(同2节)
21. set_active设置目标单位的激活状态
set_active#操作对象(同4节)#是否激活(1是0否),是否隐藏(1是0否，仅在非激活时有效)
22. kill_unit目标立即被击倒（无视无敌属性）
kill_unit#操作对象(同4节)
23. down_unit目标主动倒下
down_unit#操作对象（同4节）
24. b_talk在目标头上弹出一个对话气泡
b_talk#操作对象#对话内容#持续时间(秒数，可省略)
25. yell目标呼喊出几个字（多为技能）
yell#操作对象#喊话内容
26. warning_area播放一个圆形战场警告区域
warning_area#目标位置信息#半径#持续时间(秒)
27. timeline播放一个TimeLine技能对象
timeline#指定的TimeLine ID
28. block_act 设置当前施法者的动作锁定状态
block_act#状态类型(见下表)#是否可打断该状态(0否1是)#锁定时间(单位：秒 Timeline里编辑时可不指定该时间，以再度调用 block_act#0#0#0的时间差为准)
可用的锁定状态
0：不锁定
1：锁定攻击及移动
2：仅锁定攻击
29. camera_shake 镜头抖动
camera_shake#时长（秒）#幅度
30. rotate 控制角色进行旋转
rotate#目标参数（见7.4）#起始偏转角度(相对于当前方向)#共计旋转角度数(负数为反转)#持续时间(秒)
31. replace_eft：查找并用指定的特效体在当前位置替换目标特效体
replace_eft#指定的特效体TAG#匹配数量（≤0时为匹配全部，>0为匹配生成时间最早的有限几个）#用于替换的特效体ID(可为空表示直接停止目标特效)#初始位置(默认空或hit_pos为替换目标的当前位置，否则同add_eft)#运动参数#修改伤检对象(可选，为空时为默认)#附带伤害表达式（同add_eft）#目标参数(同add_eft)#特效体TAG（用于replace_eft指令查询）#原特效体创建者的对象参数(可选，默认为所有人)
32. hitstop 角色顿帧
hitstop#操作对象#曲线起点降速幅度（倍率）#曲线终点降速幅度（倍率）#时长（秒）
（结束后角色动作速度恢复为1倍）
33. global_hitstop 全局顿帧
global_hitstop#曲线起点降速幅度（倍率）#曲线终点降速幅度（倍率）#时长（秒）
（结束后全局速度恢复为1倍）
34. set_skill_cd 更改施法者的技能CD
set_skill_cd#技能ID表(为空或者为ALL表示单位的所有技能，多个技能ID以”|”分隔)#操作方式(0:减少 1:直接赋新值)#操作值(单位:秒)
35. get_items 战斗中立即获得道具或资源(增加的道具只对主角自己使用时有效)
get_items#道具列表(道具表格式同剧情指令中的GETITEMS指令)#获得道具的对象目标参数
36. set_unit_intvar 为此单位设置一个自定义的整形变量值
set_unit_intvar#变量ID#操作方式(0:±改变 1:直接赋值)#操作值#操作对象目标参数(可选，默认为施法者)
37. call_battle_event 执行一个指定的战斗事件
call_battle_event#事件ID#执行者的目标参数(可选,事件脚本中THIS对象的默认值)
38. change_skill 替换施法者单位的当前技能列表
change_skill#技能列表信息
39. revert_skill 还原施法者的当前技能列表
revert_skill#1
40. change_dungeon_skill 替换施法者的地城技能
change_dungeon_skill#技能ID,等级
41. revert_dungeon_skill 还原施法者的地城技能
revert_dungeon_skill#1
42. replace_tag_skill 将一个单位的指定技能暂时替换为其他技能
replace_tag_skill#原技能ID#替换为新的技能ID,等级(如需还原该技能则为空)#替换时长(≤0时为永久，>0为持续指定秒数)#对象单位目标参数
43.
八、地图假人设置及控制方法说明
大地图上，可在任意对象层中设置一些mtype为dummy的矩形区域，同时可以添加以下一些自定义字段来完善该单位信息：
(带*号的为可选字段，如不填将由默认值代替)
1. dummy_id：假人全局索引编号（可重复，如重复则为批量控制）
2. model_id：大地图单位模型
3. *role_id：绑定对象人物的ID（默认为空时不显示目标名称）
4. *init_state：初始状态 -1：隐藏（默认） 0：正常
5. *init_dir：初始方向（默认0）
6. *move_info：假人行动方式（默认为静止。）命令格式参考6.7.9节
7. *interative：是否可交互0：否 1：是（默认）
8. *move_speed：假人移动速度 （默认为100）
9. *camp_id：所属阵营 （默认为空）
当需要绑定假人类型的地图交互触发器时，需指定触发事件为“encounter”，触发类型为“DUMMY”，触发ID为假人的dummy_id
九、地图宝箱设置说明
地图上可设置一些奖励类的可交互对象，当点击时会执行脚本并获取奖励
该类宝箱对象需要将mtype设置为chest，同时添加以下自定义字段：
1. chest_id：宝箱全局索引编号（可重复，如重复则为共享CD并批量控制）
2. info_id：宝箱的描述信息编号（所有信息定义在“地图宝箱信息表.xlsx”中
3. *init_state：初始状态 0：未开启（默认） -1：已开启
4. *init_dir：初始方向（默认0）
十、地图野怪设置说明
野怪属于地图刷新单位的一种，实现机制复用了地图假人系统。
设置地图野怪首先需要在Tiled中定义野怪刷新的位置和信息，设置方法为将矩形对象的mtype设置为monster，同时添加以下自定义字段：
1. monster_id：野怪的全局索引编号（可重复，如重复则为共享CD并批量控制）
2. m_group：野怪的索引组（所有信息定义在“野怪投放适配表.xlsx”中
3. min_lv：适配到的最低等级
4. max_lv：适配到的最高等级
5. *init_state：初始状态 0：未开启（默认） -1：已开启
6. *init_dir：初始方向（默认0）
7. *move_info：野怪行动方式（默认为静止。）命令格式参考6.7.9节
8. *move_speed：野怪移动速度 （默认为100）
9.
十一、游戏数据中运算值表达式系统说明
在游戏中很多地方可以以“[&expression&]”的格式嵌入一些数值公式进去（如BUFF列表的状态值等）
数值公式中支持一些基本数学运算，目前支持的运算符号如下：
1. +：加法运算
2. -：减法运算
3. *：乘法运算
4. /：除法运算
5. %：模运算（取余）
6. ^：幂运算
7. ( )：改变运算优先级
此外，当数值公式以 @func(expression1,expression2...) 的格式出现时，则调用相关的内置函数返回计算结果。目前支持的内置函数如下（注意：当前此等内置函数只能用于最外层的计算）
1. @min(a,b)：返回a与b中较小的一个值
2. @max(a,b)：返回a与b中较大的一个值
比如某段数据中[&1+2*3&]将会被替换为7，[&@max(1+2*3, 8)&]将会被替换为8，[&@min(1+2*3, 8)&]将会被替换为7……
十二、单位对象附加触发脚本编辑说明
通过在地城单位对象中的触发命令中定义，可对该单位附加若干触发器脚本。角色表中角色也可以通过在TAG中指定attached_script字段为一个脚本事件ID来给该角色附加触发脚本。定义格式为：
[CMD_BEGIN]#触发类型1#触发条件(可选)#触发参数(可选)
命令行1
命令行2
...
命令行N
[CMD_END]
[CMD_BEGIN]#触发类型2#触发条件(可选)#触发参数(可选)
命令行1
命令行2
...
命令行N
[CMD_END]
...
每个对象可挂载多个地城对象触发器，当前已支持的触发类型有：
on_spawn：当刷新出时
enter_combat：进入战斗
get_hurt：单位受到伤害
dead：单位死亡时
on_timer：当单位身上的计时器(战斗指令SET_UNIT_TIMER设置)到时时触发
on_skill：该单位开始释放技能时触发 触发参数位技能ID
hp_pct：单位血线第一次少于目标百分比时触发 触发参数位目标血线的百分比
以下为一段示例附加脚本：
[CMD_BEGIN]#enter_combat#
B_TALK*THIS#关门，放狗！
[CMD_END]
[CMD_BEGIN]#get_hurt#[%this_hp_pct%][<=]5&[%dg_int_val:测试计数器1%][<=]0
SET_DG_INTVAR*测试计数器1#1#1
SKILL_CMD*THIS#THIS#0#add_buff#中立#caster B_TALK*THIS#别打了！别打了！我认输，什么都给你！
CMD_RETREAT*1
[CMD_END]
十三、特效对象事件脚本指令格式
特效对象可以附加 eftEffectEventHelper 脚本为其增加播放事件，每个事件的输入格式为： 事件时间点(start后的秒数):指令类型,参数1, 参数2,....,参数N
目前支持的指令类型有:
shake_cam：晃动屏幕 参数1为晃动时间 参数2为强度
play_sound：播放一个声音 参数1为声音ID