本工具引入了自动化的根据地图文件重建敌人路径以及重建敌方出怪波次的功能,在此文档中,将讲解如何正确地阅读与理解地图文件。
地图文件的基本结构
通常,地图文件至少需要包含以下的主结构:
{
"options":{
"characterLimit": ,
"maxLifePoint": ,
"initialCost": ,
"maxCost": ,
"costIncreaseTime": ,
"moveMultiplier": ,
"steeringEnabled": ,
"isTrainingLevel": ,
"isHardTrainingLevel": ,
"isPredefinedCardsSelectable": ,
"displayRestTime": ,
"maxPlayTime": ,
"functionDisableMask": ,
"configBlackBoard":
},
"levelID": ,
"mapID": ,
"bgmEvent": ,
"environmentSe": ,
"mapData":{
...
},
"tilesDisallowToLocate": [],
"runes":[
...
],
"optionalRunes": ,
"globalBuffs": ,
"routes":[
{
...
}
],
"extraRoutes": [],
"enemies": [],
"enemyDbRefs": [
{
"useDb": true,
"id": ,
"level": ,
"overwrittenData":
},
...
],
"waves": [
{
"preDelay": ,
"postDelay": ,
"maxTimeWaitingForNextWave": ,
"fragments": [
{
"preDelay": ,
"actions": [
{
"actionType": ,
"managedByScheduler": true,
"key": ,
"count": ,
"preDelay": ,
"interval": ,
"routeIndex": ,
"blockFragment": ,
"autoPreviewRoute": ,
"autoDisplayEnemyInfo": ,
"isUnharmfulAndAlwaysCountAsKilled": ,
"hiddenGroup": ,
"randomSpawnGroupKey": ,
"randomSpawnGroupPackKey": ,
"randomType": ,
"refreshType": ,
"weight": ,
"dontBlockWave": false,
"forceBlockWaveInBranch": false,
},
...
]
},
...
],
"advancedWaveTag": null
},
...
],
"branches": null,
"predefines": {
"characterInsts": [],
"tokenInsts": [
{
"position": {
"row": y_num,
"col": x_num
},
"direction": ,
"hidden": ,
"alias": ,
"uniEquipIds": ,
"showSpIllust": ,
"masterInfos": ,
"inst": {
"characterKey": ,
"level": ,
"phase": ,
"favorPoint": ,
"potentialRank":
},
"skillIndex": ,
"mainSkillLvl": ,
"skinIn": "",
"tmplID": null,
"overrideSkillBlackBoard": ,
"overrideTalents":
}
],
"characterCards": [],
"tokenCards": []
},
"hardPredefines": {
"characterInsts": [],
"tokenInsts": [],
"characterCards": [],
"tokenCards": []
},
"excludeCharIdList": null,
"randomSeed": ,
"operaConfig": null,
"cameraPlugin": ""
}
其中,大部分项都包含一个复杂或重复的子结构,将在下面进行讲解和解释。首先对主结构进行解释。
"options"
在一个正常的地图文件中, options 中必须包含上面代码结构中的所有项,且除 configBlackBoard 项之外的所有项均不能留空。其中每项对应的内容如下:
"characterLimit": 部署数量限制,
"maxLifePoint": 目标生命值,
"initialCost": 初始部署费用,
"maxCost": 部署费用上限,默认99,
"costIncreaseTime": 费用回复速度,默认1,
"moveMultiplier": 属性移速修饰,默认0.5,
"steeringEnabled": 移动惯性启用,截至目前始终保持true,
"isTrainingLevel": 是否为训练关卡,多在训练关以及干员悖论模拟中启用
"isHardTrainingLevel": 是否为困难训练关卡,已弃用参数,无实际意义,仅在活动“沃伦姆德的薄暮”的"TW-S-1"及"TW-S-2"中启用,对应文件为"level_act11d0_sub-1-1.json"以及"level_act11d0_sub-1-2.json",
"displayRestTime": 展示关卡剩余时间,
"isPredefinedCardsSelectable": 是否可选择关卡内的预定义项,默认false,本项仅在bossrush即引航者试炼中启用,
"maxPlayTime": 关卡最大持续时间,无时为-1,即持续时间无限,
"functionDisableMask": 禁用的功能,对应作用待解析,仅四张地图启用过本项,分别为新手教学1(511)、新手教学2(14)、训练关2(?,6)、空想花庭教学关1("CARD_LIST")
"configBlackBoard": 关卡配置黑板,无内容时填null
其中,configBlackBoard 的写法一般如下:
"configBlackBoard":[
{
"key": ,
"value": ,
"valueStr": ,
}
]
需要注意的是,此处的
configBlackBoard以及下文中所有提到的BlackBoard写法均一致,且黑板均为结构体,每一个"key"仅能对应一个值,当"key"下"valueStr"不为null时,则会读取"valueStr"的值,不论"value"中是否存在一个非0值都不会读取,当"valueStr"为null时,则会尝试读取"value"中的值
其中,最便于理解的用法是来自关卡主线14-10的战斗前与战斗后播放关卡内剧情文本功能:
"configBlackBoard": [
{
"key": "dialog_before_battle",
"value": 0,
"valueStr": "Obt/Tutorial/Level/main_14-10_a"
},
{
"key": "dialog_after_battle",
"value": 0,
"valueStr": "Obt/Tutorial/Level/main_14-10_b"
}
]
生息演算中,则可以通过此项控制摄像机起始地块等内容,其配置黑板如下:
...,
{
"key": "CAMERA_VIEW_LEVEL",
"value": 2,
"valueStr": null
},
{
"key": "CAMERA_START_GRID",
"value": 0,
"valueStr": "(4,5.5)"
},
...
值得一提的是,在act43side即红丝绒活动中,使用了和生息演算一样的配置方法,但是提供的均为默认配置,令人困惑(x)
在保全派驻中,本项则用于配置待部署区的初始手牌数量、初始持有资金、手牌价格增长、重抽次数等内容:
"configBlackBoard": [
{
"key": "legion_init_random_shuffle",
"value": 1,
"valueStr": null
},
{
"key": "legion_recycle_random_shuffle",
"value": 1,
"valueStr": null
},
{
"key": "legion_init_card_count",
"value": 10,
"valueStr": null
},
{
"key": "legion_init_redraw_count",
"value": 4,
"valueStr": null
},
{
"key": "legion_ingame_redraw_count",
"value": 3,
"valueStr": null
},
{
"key": "legion_gold_for_endprepare",
"value": 0,
"valueStr": null
},
{
"key": "legion_gold_for_wave_end",
"value": 40,
"valueStr": null
},
{
"key": "legion_init_gold",
"value": 30,
"valueStr": null
},
{
"key": "legion_init_card_price",
"value": 10,
"valueStr": null
},
{
"key": "legion_card_price_growth",
"value": 0,
"valueStr": null
},
{
"key": "legion_max_card_price",
"value": 10,
"valueStr": null
},
{
"key": "add_price_when_reshuffle",
"value": 2,
"valueStr": null
},
{
"key": "max_add_price_when_reshuffle",
"value": 10,
"valueStr": null
}
]
当然,直接将 configBlackBoard 写入到地图文件中的地图还是少数,上面保全派驻中的配置黑板更是仅在几张图中存在,实际上为了节省本机资源,大部分地图在为 null 时都会采用默认的配置方法或者从prefab中或者服务器中拉取对应的配置黑板,仅生息演算在所有地图中内签了 configBlackBoard。 (本段待验证)
levelID
无实际意义,仅沙洲遗闻的9个关卡中对此项填入了实际值,且均为 "[dev]test/level_training"
mapID
无实际意义,所有地图文件均未填入过此值
bgmEvent/关卡音乐
控制关卡播放的背景音乐,通常仅填入bgm名称,随后游戏会自动在audio目录中匹配并播放对应的音乐
environmentSe/环境控制器(已弃用)
早期环境效果控制项,仅在火蓝之心以及以此活动为蓝本的剿灭及干员悖论模拟地图中填入过值,游戏中本项仅被填入过 magma 用于控制岩浆喷口效果以及 beach 来控制水地形效果。(实际上由于早期水地形不可通行,因此本项存在的意义更类似滚木,因为实际上水地形均带有 "tag": "water" ,锡兰的检查也是检查对应的地形tag)。本项现疑似已弃用,环境效果均由装置 环境调控装置 实现。
上面就是一些最基本的对地图的设置,下面将进入正式的对地图文件的不同内容的详细讲解环节
mapData/地图数据
本项用于控制地图的创建、路径的创建、出怪等内容,其基本格式应当如下:
"mapData":{
"map":[
[...,
],
...
],
"tiles":[
{
"tileKey": ,
"heightType": ,
"buildableType": ,
"passableMask": ,
"playerSideMask": ,
"blackboard":{
},
"effects": ,
},
...
],
"blockEdges": ,
"tags": ,
"effects": ,
"layerRects":
}
map/地图创建
mapData 共由5个键组成,本项的核心是 "map",用来在地图创建阶段控制地图的创建并记录地块的编号,用于后续创建阶段地块类型的映射以及寻路中使用。目前主流的解析方式将本项分为了多个数组,其中每个数组对应地图中的一行,数组内则对应本行自左到右每个地块的编号;同时,在可读的地图文件中,数组也会按照编号从大到小的顺序依次排列。以主线7-18的地图文件为例:
"mapData": {
"map": [
[
84,
85,
86,
87,
88,
89,
90,
91,
92,
93,
94,
95
],
[
72,
73,
74,
75,
76,
77,
78,
79,
80,
81,
82,
83
],
...
],
...
}
*这里仅放出最上面两排的写法,全放出来会导致长度过长影响观感
7-18通过这种定义方式定义了一个y轴长8格,x轴长12格的地图。同时,这种地块编号顺序也是神奇在讲解寻路机制补充时,所提到的地块编号顺序内容的核心,即“从下到上,同排从左到右”。(因此在使用计算器时,本格式也是唯一可以被计算器解析的地块编号格式,以0,1表示地块高度或同行种类的文件格式不会被计算器接受。)
此外值得注意的是,方舟的地图必定为一个规则矩形,因此,在游戏中实际看到的地图和实际的地图大小并不一定完全一致,(通常将实际地图的左下标记为(0,0),而很多玩家会错将游戏中左下的第一个非装饰贴图的地块记作(0,0),这实际上是错误的)这可以通过将远程干员朝向地图外放置观察攻击范围被截断的位置观察,或者也可以通过现在成熟的辅助网站如PRTS Map看到,许多地图的外围实际上是一圈 tile_forbidden包围起来的(因为在这一圈里有蓝门或者红门,博士你也不想怪绕着外面跑一圈就冲家吧)
tiles/地块
由于此项的存在,在主线关的部分突袭作战/磨难关卡中,出现“地图中地形发生变化”的描述时,通常会创建一个本关的hard副本(命名格式为
level_hard_*.json,以区分标准的主线命名格式level_main_*.json)虽然可以通过符文对地块进行修改,但是通过符文修改的实现过于麻烦且不必要,yj的程序员都是直接对这种地图新建一个地图文件来解决。(yj也可以再弄一个environment controller来专门负责通过符文修改贴图,虽然在众生行记中有通过environment controller修改地块中部分键与值以及切换贴图的先例,但是通过这个来对单个地块精细调整还是过于变态,效率上讲真的不如地图编辑器重新弄一份地图来的快)
tiles则是对每个地块进行了定义,随后将定义后的地块按"map"中数组的顺序逐一映射到上创建的地块上(每个地块的意思就是每个地块,哪怕今天这个图里有600个地块也要把600个地块全在地图文件里写一遍.jpg)。以下是tiles中各键的翻译以及对应的可取键值:
"tileKey": 地块名
"heightType": 高度类型
// 有HIGHLAND和LOWLAND两种,还有个E_NUM哨兵值类型(不启用)
"buildableType": 部署类型
// 有NONE、MELEE、RANGED和ALL四种
"passableMask": 地块通行类型
// 通常为NONE、ALL或FLY_ONLY,存在WALK_ONLY但未启用过,不排除有朝一日yj反骨出个WALK_ONLY
// 实际上关于这个WALK_ONLY稍微有一点有意思,等后面展开聊一下不过也就只聊一下
"playerSideMask": 我好像不知道啊你问我吗.jpg
// 好吧不开玩笑,该键共存在四个取值,分别为"ALL"(0),"SIDE_A"(2),"SIDE_B"(4)和"NONE"(255),该键值用于在联机模式下控制单个地块的控制权归哪一方,在一番搜索后发现此键几乎已被废弃,仅在活动“罗德岛防御协议”以及促融共竞教学关填入过非255或0的值
"blackboard": 黑板
// 用来对地块赋予效果,如字格、源石地板等
// 仅地块tileKey的值是blackboard生效的先决条件,即仅特定的tileKey可以触发对应的blackboard内容,如同域共存中定义了来路不明的源石地板效果,但因为tileKey不符因此源石地板的效果未生效
"effects": 你是说有blackboard了还要用这个吗.jpg
// 用的兄弟,这个当然还是要用的,最经典的例子是“孤星”活动,其中每个重力碎屑的起始位置都使用effects写入了方向和三维偏移坐标,其中三维偏移坐标默认为(0,0,0)。在部分地图中,也会使用此项来标记地块为推荐的干员/障碍物放置点(tile_rcm_operator或tile_rcm_create)
tileKey仅存储了地块名和程序员在快速创建地图时所用地块的默认属性,实际上和高度类型、部署种类等内容,实际上并不会强制下面的属性使用特定的值,但是如上面所写,tileKey 还是会阻止与自身不符的blackboard的使用。
tileKey具有典型值,许多地块的贴图不同但是该键的值相同,文末链接中会列出部分tileKey的典型值。(值得注意的是,活动“火蓝之心”与“多索雷斯假日”中都存在“深水区”地块,但是两者的 tileKey 与 passableMask 不同,一个是 deepwater,一个是 deepseekdeepsea)
WARN本项仅对地图文件中的地块配置项进行了讲解,实际上部分关于地块的配置或相关参数并不会存入地图文件中,如地形标记(
AdvancedBuildableMask)、视作不可部署(isNonebuildableLike)、特殊参数地形类型(tileTypesMask)。如您想了解除了本章节讲解之外的更多关于地块的内容,推荐您阅读PRTS页面 #扩展阅读:地块
blockEdges/阻止通过特定地块边缘
"blockEdges" 则用于控制敌方单位在寻路时,禁止从某个地块某个方向上的边穿过,这一项的应用场景是地图中存在“假高台”,且“假高台”允许地面单位通行时,防止地面单位在寻路时直接由地面穿过高台。最典型的应用场景是活动“登临意”,其中应用了大量的“玉门天灾工事”,由于玉门天灾工事的passableMask为ALL,虽然其heightType被设置为了HIGHLAND ,但仍需要通过blockEdges 来防止其寻路穿过高度类型不同的地块。其次,如“崔林特尔梅之金”、“空想花庭”此类关卡自身不可破坏装置所在地块通行类型依旧为ALL的,也需要通过blockEdges防止寻路中敌方单位直接穿过装置
这里是一个使用例,来自地图文件 level_act23side_01.json :
"blockEdges": [
{
"pos": {
"row": 2,
// "row": y_num
"col": 2
// "col": x_num
},
"direction": "LEFT",
"blockMask": "WALK_ONLY"
},
...
]
其中,pos(position)定义了启用本项的地块的位置,坐标形式为 (y,x) ,"direction" 则阻止了敌方单位直接在此地块上直接跨越此边缘向目标位置寻路,"blockMask"用于过滤什么敌方单位会被受到 "blockEdges" 的寻路约束,其值来自 motionMask(NONE/WALK_ONLY/FLY_ONLY/ALL),此方法在部分地图中也会启用来阻止飞行敌人误入特定地块
本计算器由于并没有启用blockEdges相关配置,因此您在使用本计算器读取“登临意”和“空想花庭”的地图文件时,一定会出现大量“穿模”的奇观。这也算是直观展示了这项配置的必要性
tags很好理解,锡兰的家乡水检测的就是这项,需要有对应的tag才能生效,水陈的二模天赋也是创建了个临时地形tag,不再赘述。
effects是个更大的滚木项,疑似已弃用,这位更是没有在任何地图文件中启用过,所以其值也始终为null
layerRects在地图文件中也是滚木项,疑似已弃用。在Unity中使用Rect[]来控制创建或描述一个矩形,并对矩形进行几何变形或几何判断。本项可能为从Unity Rect方法延伸出的已弃用方法,用于控制渲染或地块交互逻辑,也有可能是地图编辑器版本更迭后的废弃项但未清理。fbs中本项的用法为 layerRects: [string]
关于Unity的Rect方法,见文章 #Rect
至此我们已经完全理解了地图文件的地块系统是如何工作的,恭喜你掌握了地图文件35%的内容,接下来继续讲解剩余的部分如何读懂。
好困,先写到这里.jpg
tilesDisallowToLocate/不可部署地块
本项后默认接一个空数组,意为定义不允许我方部署单位的地块,但实际上本项从未在本地文件中填入过
fbs中给出的用法:tilesDisallowToLocate: [clz_Torappu_GridPosition] ,即在数组中填入多个坐标。
runes/符文
为了更好地理解此部分内容,强烈建议您在阅读此部分前,阅读PRTS上的 #符文 页,以了解符文和符文运算,以及关卡符文与藏品符文之间的不同,下文中的“符文”均指于地图文件内或者与服务器通信取得的“关卡符文”
随着大部分方舟玩家对于游戏理解的日益提升,大家基本已经理解了符文的用法以及符文运算的规则,因此此处直接偷懒复制调零对于符文的讲解,作者偷懒去了
出于良心,作者这里还是对于符文进行一些讲解
来自prts的解释:符文是一类特殊加成的统称,通常使用于地图额外数据中,常见的如:
- 突袭特殊条件和危机合约合约条件; - 部分活动中的特殊机制对特定装置的修改。
我们在这里首先给出地图文件中的符文的基本格式:
"runes": [
{
"difficultyMask": ,
"key": ,
"professionMask": ,
"buildableMask": ,
"blackboard": [
{
"key": ,
"value": ,
"valueStr":
}
]
}
]
difficultyMask/(符文)关卡难度选择器
difficultyMask 用于控制该符文在本关卡的哪个难度中启用,该键可以取以下值:
{
"NONE": 0,
// 通常不会使用此值
"NORMAL": 1,
// 该值会在仅修改普通作战的符文中被填入
"FOUR_STAR": 2,
// 该值会在修改突袭/险境/紧急作战的符文中被填入
"EASY": 4,
// 该值会在仅修改简单作战的符文中被填入,典型启用关卡如主线剧情模式难度关卡
"SIX_STAR": 8,
// 该值会在主线突袭中启用
"ALL": 15
// 该值**在数值上**实际为上述值的加和,意为在所有难度中启用本符文
}
此处我们进行一个知识的插入讲解,即上面的
"ALL"的值在十进制下为什么恰好为所有值的和,有计算机基础或者对此部分不感兴趣的同学可以直接跳过在现代计算机中,此类整数方式的设置(明日方舟对于此值的设置方法为
enum enum__Torappu_LevelData_Difficulty : int{...})可以被存储为若干个固定二进制位,以便计算机读取和修改,其通常格式类似:15 0 ┌───────┬────────┬─────────┐ │ 保留位 │ Key ID │ Value │ │ 8 bit │ 4 bit │ 4 bit │ └───────┴────────┴─────────┘这里使用的例子为一个16位的整数存储配置,方舟的此类源自unity的enum方式正是整数存储方式,那么上面的难度表示可以转换为
key keyID value NONE 0000(示例用,非实际情况) 0000 NORMAL 0000 0001 FOUR_STAR 0000 0010 EASY 0000 0100 SIX_STAR 0000 1000 ALL 0000 1111 后面的
professionMask,也就是职业选择器,使用了同样的方法,所以很多图的此键后会跟随一个大小为1023的int值,意为“对全部职业适用”unity面向用户的脚本语言为C#,如果您想了解更多关于此方法的内容,可以阅读来自Microsoft Learn的文章 Enumeration types (C# reference)
Key/(符文)键
此键可以填入对应的值,来控制符文如何修改此地图,以下为一些经典的符文修改地图的用法:
"level_hidden_group_enable": 启用对应难度下的隐藏敌方单位
"level_enemy_replace": 启用对应难度下的敌方单位替换
"env_system_new": 关卡环境控制器
"env_gbuff_new": 为关卡添加环境级buff
// *!:此处的环境与通过`环境调控装置`实现的环境效果并不相同,此处可以修改关卡内天气(典型"env_system_new"应用例:阵雷),或者如“众生行记”关卡使用这两项符文实现伪地形调控。
"enemy_attribute_mul": 指定敌方增益修改(符文运算)
// 可指定使用本符文的单位,或指定对全体生效,典型配置为突袭全体敌人血防翻1.2倍
"char_attribute_mul": 指定单位增益修改(符文运算)
// 可指定使用本符文的单位,该符文生效单位默认指向我方单位,通常会通过"key":"char"的valueStr指向装置/召唤物。
// 应用例可见15章地图文件中,本符文指向“稳定萨卡兹术士结晶”与“冰镇饮料机”的同名装置,用来实现与"enemy_attribute_mul"相同的属性修改作用
"global_life_point": 修改对应难度下的关卡生命值
"char_cost_mul": 修改指定单位的部署费用
...
还有诸多在符文中应用的内容,此处不再一一列出。
professionMask/(符文)职业选择器
与大部分人认知中“方舟中存在八个职业”不同的是,方舟中实际存在十个职业,即除了干员列表中展示出的八个职业外,还存在“召唤物” (
TOKEN) 和“装置” (TRAP),通常这两个职业不会存在对应的分支。更多关于职业的内容,您可以阅读PRTS页面 #职业,这对于您了解此处的内容以及后续的predefine项都具有重要的帮助
本项控制符文对什么职业生效,此项同样为一个恒为2的n次方的int值,即采取了和上文difficulty中类似的设置储存方法,但通常的解析不会将此项转换为字符串后填入,以下是对应表:
| key | int | value |
|---|---|---|
| NONE | 0 | 0000000000 |
| WARRIOR | 1 | 0000000001 |
| SNIPER | 2 | 0000000010 |
| TANK | 4 | 0000000100 |
| MEDIC | 8 | 0000001000 |
| SUPPORT | 16 | 0000010000 |
| CASTER | 32 | 0000100000 |
| SPECIAL | 64 | 0001000000 |
| TOKEN | 128 | 0010000000 |
| TRAP | 256 | 0100000000 |
| PIORNIEER | 512 | 1000000000 |
| ALL! | 1023 | 1111111111 |
值得注意的是,此处列出的仅为职业对应的位,1表示启用,该项支持通过按位组合来选择多个职业: 例如
1000000011:"professionMask": "WARRIOR" | "SNIPER" | "PIORNIEER"↓
"professionMask": 515大部分对于敌方生效的rune此处的值均为1023,即默认对全体职业生效。实际上,通过本栏写法来实现过滤多个职业的方式在地图文件中也相当少见,此应用例待补充
buildableMask
取值同 [tiles/地块](#tiles地块) 章节的 "buildableMask"
此项用于控制符文生效的部署种类 待补充
blackboard/(符文)黑板
"blackboard" 用来给定当前符文的属性,其基本格式与本文档中"options"部分的 "configBlackBoard" 相同,下面选择沙盘血防修改的符文进行解析:
{
"difficultyMask": "SIX_STAR",
"key": "enemy_attribute_mul",
"professionMask": 1023,
"buildableMask": "ALL",
"blackboard": [
{
"key": "atk",
"value": 1.1,
"valueStr": null
},
{
"key": "def",
"value": 1.1,
"valueStr": null
},
{
"key": "max_hp",
"value": 1.2,
"valueStr": null
},
{
"key": "rune_alias",
"value": 0,
"valueStr": "sixstar_basic_attribute"
}
]
},
...
这是来自主线地图文件 level_main_15.07.json(主线关15-8) 的突袭敌方属性修改符文,这也是一个典型的对全体敌人(不含装置)生效的符文,除了 "blackboard" 之外的内容我们均已讲解过,因此我们关注黑板中的内容。在此黑板中共有四个值:
- "key": "atk" 用于修改敌方的攻击力属性,此处 "value" 即将敌方的攻击力属性修改为其原本的1.1倍(伪代码实现或者您在开发时公式可写为 attack * multiplier.rune.atk["value"] ) - "key": "def" 、"key": "max_hp"用于修改敌方的防御力和最大生命值,与上文的攻击力属性修改方式相同,通过此方式修改属性局参与符文运算,叠乘 - "key": "rune_alias" 直译为“符文别名”,此项不会在游戏中表现,仅作为对同名符文的区分,例如此处的 "valueStr" 对应值为 "sixstar_basic_attribute",意为“主线突袭作战基础加成”,此值也会作为部分特殊符文选择目标符文时的目标
当然,实际上对敌方的属性修改只是符文的用法之一,符文还可以用于控制隐藏出怪,该实例来自地图文件 level_recalrune_01-01.json(全息作战矩阵7-18):
"runes": [
{
"difficultyMask": "ALL",
"key": "level_hidden_group_enable",
"professionMask": 1023,
"buildableMask": "ALL",
"blackboard": [
{
"key": "key",
"value": 0,
"valueStr": "sotiab1"
}
]
}
]
通过此符文,控制使用具有 "hiddengroup": "sotiab1" 的大盾的出怪,不过由于涉及到后面关于 hiddengroup 的相关内容,此处不再详细解释。
还有许多其他的用法,如修改最大部署费用(第12章,通过"max_cost" 和 "max_cost_ceil" 的组合实现)、控制关卡中干员可用性(部分不能携带指定干员入场的关卡,通过 "char_exclude" 实现)、阻止指定地块部署我方单位(通过 "global_forbid_location" 实现)、指定难度下替换敌人(通过 level_enemy_replace 实现)、字格与拓印机制(又臭又长 ,此处不再给出实现方式),更多内容就等待各位博士自行发掘了。
但是但是但是,还请各位博士一定要分清符文提供的增益是属于可以参与符文运算的增益(即使符文运算之间,也有不同)还是属于符文修饰buff后通过buff提供增益 ,这样才能做出有益的计算
optionalRunes/可选(额外)符文
ok啊我们又见面了.jpg
在格式和填写方式上,此项和 [runes/符文](#runes符文) 章节中的内容无异,此项的应用例通常见主线沙盘,主线沙盘的地图基本都将对应tag的符文存储在了此处,根据玩家选择的tag进行启用。依旧以主线关卡15-8为例:
"optionalRunes": {
"rune_level1_1": [
...,
{
"difficultyMask": "SIX_STAR",
"key": "add_other_rune_blackb",
"professionMask": 1023,
"buildableMask": "ALL",
"blackboard": [
{
"key": "atk",
"value": 0.1,
"valueStr": null
},
{
"key": "def",
"value": 0.1,
"valueStr": null
},
{
"key": "max_hp",
"value": 0.2,
"valueStr": null
},
{
"key": "rune_alias",
"value": 0,
"valueStr": "sixstar_basic_attribute"
},
{
"key": "six_star_rune_alias",
"value": 0,
"valueStr": "rune_level1_1"
}
]
}
]
}
该optionalRunes的类型为 "add_other_rune_blackb" ,即向目标符文的黑板增加指定的值,此时符文不再遵循符文运算规则,该符文的黑板中与目标符文黑板中同键名的数值型参数值会加算运算后再进行符文运算,即原本 ("atk", "def", "max_hp") 中对应的值 (1.1, 1.1, 1.2) 会加算为 (1.1+0.1,1.1+0.1,1.2+0.2)=(1.2,1.2,1.4) (在文档写病句的来)后参与敌方的属性计算(符文运算规则)中,此时
"blackboard": [
...,
{
"key": "rune_alias",
"value": 0,
"valueStr": "sixstar_basic_attribute"
}
]
不再用于规定此符文“符文别名”,此项用于搜索在"runes"之中使用了该“符文别名”的项,规定此项符文“符文别名”的是这一段的下一段键值组合:
"blackboard": [
...,
{
"key": "six_star_rune_alias",
// 沙盘符文
"value": 0,
"valueStr": "run_level1_1"
}
]
此处可能会存在一个误区,即optionalRunes必须依赖已有的runes存在,但实际上并无此限制,如出怪替换、额外出怪、指定敌人的指定属性修改、加费等均可以独立存在,实际上如果设计师乐意,上面的属性也可以写成非加算后再进行符文运算的形式,但是通常不会有地图启用了optionalRunes但不启用runes
合约与全息作战中不会将tag效果存储到符文中,而是部分存储于本地prefab中,部分tag的效果也会存储于服务器中,玩家进入地图时根据选择的地图,读取本地存储的tag,同客户端与服务端进行通信拉取本地未存储的tag并令tag作为符文生效
至此,关于地图文件中符文的用法基本就讲解完毕了,由于篇幅有限且作者精力有限无法列出所有的符文与效果,因此更多的符文效果与用法就有待各位博士自行发掘了。
globalBuffs/关卡全局buff
此部分内容通常与关卡内路径重建与出怪无关,因此本章节的内容已被作为扩展阅读折叠,若您想要了解此部分的内容,可以点击对应按钮展开此部分内容
globalBuffs(通常缩写为 gbuff) 通常可用于控制启用作战的全局buff,此项可以用于向单位或全局提供buff,buff可以影响含干员视野在内的内容,或者向buff提供一个buff以通过此buff添加其他buff。
globalBuffs 的应用例可以在活动“玛莉娅·临光”或活动“尘影余音”中找到,当然也存在其他的应用例,这里以这两个活动为例。
首先是活动尘影余音,在活动尘影余音的关卡中,设计师在地图中添加了地形tag "magiccircuit" 来控制启用重整束流这一环境效果,然后在 globalBuffs 中指定了重整束流的效果:
"globalBuffs": [
{
"prefabKey": "character_in_magiccircuit_env",
"blackboard": [
{
"key": "sp_recover_ratio",
"value": -0.5,
"valueStr": null
},
{
"key": "character_in_magiccircuit[normal].sp_recover_ratio",
"value": 0.5,
"valueStr": null
}
],
"overrideCameraEffect": null,
"passProfessionMaskFlag": false,
"professionMask": "NONE",
"playerSideMask": "ALL"
}
]
globalBuffs 中,需要通过 prefabKey 给出需要启用的gbuff,此处使用的gbuff为 "character_in_magiccircuit_env",对应buff可以在 buff_template_table.json 中找到。
实际上,为了获取更准确的buff信息,应当阅读prefab,但是鉴于
buff_template_table在通常情况下提供的信息已经足够且prefab可读文件的获取与门槛极高,下文关于gbuff与buff的内容均会使用buff_templater_table.json中提供的内容进行讲解
globalBuffs 同样需要 blackboard 来控制buff效果。但其应用情况较为复杂,globalBuffs 既可以直接向干员添加一个取值源自 blackboard 的效果,也可以将值作为对应buff的黑板值通过buff来向干员添加效果。以上文的重整束流为例,下文是节选自 buff_template_table 的源码:
"character_in_magiccircuit_env" :{
...,
"eventToActions": {
"ON_BUFF_START": [
{
"$type": "Torappu.Battle.Action.Nodes+CheckCharacterInMagicCircuit, Assembly-CSharp",
"_targetType": "BUFF_OWNER"
},
{
"$type": "Torappu.Battle.Action.Nodes+CreateBuff, Assembly-CSharp",
"_buff": {
"attributes": {
...,
"attributeModifiers": [
{
"attributeType": "SP_RECOVER_RATIO",
"formulaItem": "MULTIPLIER",
"value": 0.0,
"loadFromBlackboard": true,
"fetchBaseValueFromSourceEntity": false
}
]
},
...
},
...
}
],
"ON_ENTER_MAGICCIRCUIT": [
{
"$type": "Torappu.Battle.Action.Nodes+CreateBuff, Assembly-CSharp",
"_buff": {
"attributes": {
...,
"attributeModifiers": [
{
"attributeType": "SP_RECOVER_RATIO",
"formulaItem": "MULTIPLIER",
"value": 0.0,
"loadFromBlackboard": true,
"fetchBaseValueFromSourceEntity": false
}
]
},
...
},
...
}
],
...,
}
}
我们重点关注上面源码中的两个 attributeModifiers 中的 attributeType 以及其对应的 loadFromBlackboard,attributeType 规定了这是什么种类的增益,loadFromBlackboard 后的布尔值则决定了此增益的 value 是否由黑板中读取,当设置为 true 时,我们可能会看到增益下的 value 被设置为0.0,但其具体值实际来自已有的 Blackboard (在部分buff的源码中, 。...FromBlackboard通常写作...FromBB,和此处内容无关,仅是提醒)
对于上面的源码中的两个 SP_RECOVER_RATIO,其 loadFromBlackboard 值均为 true,意为使用有以BuffKey为前缀的黑板Key赋予的值,已知 buffKey 为 character_in_magiccircuit[normal],则这两个值将会从关卡gbuff提供的黑板 character_in_magiccircuit[normal].sp_recover_ratio 中获取,随后根据formulaItem决定此值的应用方式(此处为 MULTIPLIER,即直乘)。此时黑板中剩余一个无前缀的 SP_RECOVER_RATIO ,该值将直接被使用,作为全局buff的修改(即全局技力回复速度-50%,直乘)
Routes/路径集
从本条目开始,将是地图文件系统的另一个核心
"routes"通常为一个数组,用于按顺序定义敌人将要在关卡内使用的路径: 从"routes"中的第一个"motionMode"开始,每一个"motionMode"会从0开始依次分配一个唯一的routeIndex,随后按照[waves](#Waves/波次)中的"routeIndex"来对每个敌方单位选择其路径。
"routes"中,通常包括如下结构:
"routes":[
{
"motionMode": ,
"startPosition": {
"row": y_num,
"col": x_num
},
"endPosition": {
"row": y_num,
"col": x_num
},
"spawnRandomRange": {
"x": x_num,
"y": y_num
},
"spawnOffset": {
"x": x_num,
"y": y_num
},
"checkpoints": [
{
"type": ,
"time": ,
"position": {
"row": y_num,
"col": x_num
},
"reachOffset": {
"x": x_num,
"y": y_num
},
"randomizeReachOffset": ,
"reachDistance":
},
...
],
"allowDiagonalMove": true,
"visitEveryTileCenter": ,
"visitEveryNodeCenter": ,
"visitEveryCheckPoint":
},
...
],
其中,至少需要包含motionMode, startPosition, endPosition, spawnRandomRange, spawnOffset, allowDiagonalMove, visitEveryTileCenter, visitEveryNodeCenter, visitEveryCheckPoint。其中,最后四项均为布尔值,可选启用与否。