太长不看提取重点版
大部分mod人物会存在一些冲突导致运行过程中闪退，其中最常见的就是点开饰品商店后闪退，这个问题解决方案很简单，你只需要到br_heroclass\trinkets中删掉这个文件夹里面的com.rarities.trinkets.json与crimson_court.rarities.trinkets.json，然后再到br_heroclass中找到modfiles.txt并删掉它，删除这三个文件后，即能大概率解决进入饰品商店后闪退的问题。
一、基础操作
为了方便接下来的叙事，我们将你要移植的英雄职业名称统一称为heroclass，请各位根据不同的mod，将英雄名与heroclass做替换（如游方乐师minstrel，本文中heroclass.info.darkest即指minstrel.info.darkest）
首先，你需要知道如何将原版mod拷贝到黑圣物中
原版mod的存放位置位于\Steam\steamapps\workshop\content\262060路径下，在这个路径中，每个文件夹都代表一个你从steam创意工坊中订阅的一个mod，文件夹的名称是数字编号的，这给我们定位具体的mod造成了一点难度，为了确定这个文件夹是你要找的mod，你可以进入文件夹，用记事本打开project.xml，其中的title属性能够帮助你确定这到底是你装的哪一个mod，或者你也可以直接双击打开preview_icon.png这个文件来确认mod的封面图
黑圣物的mod路径为\Steam\steamapps\common\BlackReliquary\mods，注意是mods不是modes，千万不要搞错了
原版与黑圣物的mod大体是通用的，如战斗加速，3x9大背包等mod可以直接拷进去使用，将你在原版mod路径下找到的数字id的文件夹全体拷贝并粘贴进黑圣物的mod路径中，打开黑圣物游戏，你就应该可以在enable/view addons这个选项下看到你的mod，为了方便后续操作，楼主强烈建议你在拷贝完成后将mod文件名由一串数字id更改成br_heroclass（自行替换heroclass为mod英雄名，后续将不再提示）以方便你能顺利的找到这个文件夹。
当然，大部分mod人物会存在一些冲突导致运行过程中闪退，其中最常见的就是点开饰品商店后闪退，这个问题解决方案很简单，你只需要到br_heroclass\trinkets中删掉这个文件夹里面的com.rarities.trinkets.json与crimson_court.rarities.trinkets.json，然后再到br_heroclass中找到modfiles.txt并删掉它，删除这三个文件后，即能大概率解决进入饰品商店后闪退的问题。
在这里我将简单说明一下我认为出现问题的原因，com.rarities.trinkets.json与crimson_court.rarities.trinkets.json，这两个文件是饰品稀有度定义文件，在原版游戏中，cc饰品与彗星饰品（不仅包括水晶马车贩卖的，还包括星空怪掉落的）的稀有度都是dlc中新加入的概念，因此这两个文件夹是在dlc中添加的。我们知道，dlc可以视作一个大型的mod，mod与mod在插入饰品稀有度上是平级的，因此，mod作者想要添加cc饰品与水晶饰品，都需要添加这两个文件。然而黑圣物本体游戏是带了这两个文件的，这个时候再加入这两个文件就相当于重复定义了本体已经具有的稀有度定义，因此出现了冲突。至于modfiles.txt文件，这个文件写明了mod中所有文件的文件名以及其文件大小，在实际操作的过程中，我观察到这个文件具有极高的优先度，在mod文件夹中添加的新文件，如果没在modfiles.txt中写出，那游戏将不会载入该文件。但是删除了这个文件后又完全不影响运行且所有文件都进行了加载，因此，如果你需要编辑mod，应尽早删除这个文件。
到此为止，你应该已经得到了一个能正常运行的mod人物了。恭喜你，但是将这个人物完全融入黑圣物mod，还有一段路要走，加油。

二、基础进阶
我们知道，原版英雄上了飞艇之后变得更强了，最直观的体现就是基础数值，如何更改英雄的基础数值就是这一部分要讲的东西。
英雄的基础数值文件位置是br_heroclass\heros\heroclass\heroclass.info.darkest
这个文件中包括了一个英雄的所有基本信息，但是在这一阶段，我们只需要关注开头的一部分就好了，拿官方mod覆面亡骸（veiled）来举例子，他的开头是这样的

相较于原版英雄，我们的英雄在上飞艇后需要获得的福利有：
1、死抗提高：resistance后面 .death_blow 如果为67%则请将其改为87%（或根据你人物特性酌情提高/减少），在黑圣物中，人物的死抗与竞技场相似，在濒死状态下的每一次受伤都将减少英雄的死抗，直到你的英雄终于运气够差脖子一歪
2、攻击力与速度提升：weapon后面.dmg后面的两个整数，将其数值x2，.spd后面的一个整数，将其数值x2，原版人物福利，攻击与速度翻倍，同时，你也可以平滑速度或攻击力成长（如8-8-9-9-10可以改为16-17-18-19-20）
3、血量提升armor后面.hp后的一个整数，将其数值x2 注意.def后面的是闪避率，.prot后面的才是防御力（减伤比率）
改完了这些数值，一个mod人物在原版中应有的强度在黑圣物中就能有一定体现了（当然如果这家伙在原版就是个大爹你完全可以不给他这些福利让他体会下被贬入凡间的无力，桀桀桀）

三、初步进阶
接下来真正有点麻烦的东西要来了，这部分的内容将会开始变得有些困难，不过说实话，对有编程基础的家伙（大学上过点程序设计课也算）来说，这应该根本不算什么。
在讲述具体功能如何更改之前，我想先简述一下mod文件中与技能效果、饰品效果有关的文件都是什么并且它们都起着怎么样的作用，这对我们进行实际操作将有很大的帮助，楼主在这里更希望各位感兴趣的读者可以触类旁通，在面对本文中没有提及的问题时也有能够修改的能力。当然，如果你熟悉mod开发，或者对什么原理之类的东西不感兴趣，你也可以跳过这一部分废话，直接去看后面的实际操作部分。
首先是一切英雄技能效果的起点，heroinfo文件，位于br_heroclass\heros\heroclass\heroclass.info.darkest，这个文件中会定义一个英雄的所有技能，并且会说明这个技能的一切效果（effect）
这个文件中以combat skill起始的一行即是技能效果的一个描述，后面的.id即使技能名称，一般与英雄的英文技能名称有一些对应关系。一个优秀的程序员应该让他的代码能够尽可能的被别人读懂。在这里就得小小吐槽一下游方乐师的作者，他的命名习惯就有那么一点点的缺陷……

（不过他做了注释其实也没有造成多少阅读上的不便）
注意一个同等级的combat skill也可以由多行来定义，只要id与level相同，该行定义的效果就会直接累加到技能效果之中。
那这些效果又是啥呢？这就要到effect文件中去找了。Effect文件位于br_heroclass\effect文件夹中，该文件夹下的所有文件均是有效的，你或许可以从命名上判断其大概作用，如heroclass.effect.darkest一般包括英雄技能效果，Trinkets.effects.darkest一般表示饰品特殊效果（这一部分如何引用将在后续部分说明），每个effect对应一个效果，如果是属性上的增加或减少，一般的dot/hot之类的很多效果都是定义好的可以直接调用，但是对于一些特殊机制，effect里面就会引用一个buff，可以交由buff文件中定义的buff来继续定义技能的复杂效果，这里用游方乐师的部分代码为例子

这里标出的"MS_guard_pierce_5"就是用来描述游方乐师星陨技能中对守护目标的穿甲buff，这个buff由游方乐师的buff文件定义，其文件位置位于br_heroclass\shared\buffs文件夹中，同样的，这里的所有文件都是有效文件，找对了文件并且或用ctrl+f就能很快找到对应buff，如下图

可以看到对被守护的目标有65穿甲（这个效果在技能描述里居然没有，算是隐藏效果吗？）
那么饰品又是如何呢？
饰品既可以调用buff，也可以调用effect，但是调用buff与effect的属性不同，buff属于常驻属性，典型的如加攻击、加暴击、加压力伤害、穿甲等，而effect是触发式属性，调用effect需要在特殊时机属性里面写明才可以，这里用麻风的琥珀饰品代码举例

其中buffs属性调用的是buff文件中定义的buff，attack_skill_additional_effects就是攻击命中会触发的effect，这些东西在effect文件中定义，friendly_skill_additional_effects是以友军为目标（包括以自己为目标）的技能会触发这些effect
因此，这些相关文件的关系如下图：

好了，废话讲完了，我们直接进入实操环节

3.1技能数值调整：
攻击力与血量与速度高了，相应的buff也得跟着水涨船高
需要调整数值的大概有这么些东西
-单次治疗的治疗量需要翻倍
-治愈翻倍
-流血与腐蚀伤害翻倍
这些一般都由通用效果定义，因此一般都位于effect文件中，文件位置br_heroclass\effect
你大概需要检查这个文件夹下的所有文件
治疗是.heal，腐蚀是.dotPoison，流血是.dotBleed，治愈是.dotHpHeal，将后面跟的数值x2即可
速度就麻烦了，速度一般都在buff文件里，文件位置
br_heroclass\shared\buffs
用ctrl+f在buff文件里找"speed_rating"关键字，一个一个找到对应的buff，将其amount属性数值x2

3.2标记技能调整
在黑圣物中，标记技能与debuff概率挂钩，黑圣物制作组已经写好了一套的标记技能的effect与effect描述，我们可以直接使用这些东西。
首先在你的heroinfo文件中的combat_skill后面的effect中找到造成标记的effect（一般名字里带target、或者简写tar的就是），把它删掉，改成”mark_target_1”,并在后面添加"mark_traget_1_tt"即可。
当然这样添加的标记目标标中概率是110%，标记持续时间是3t，如果你想提高概率，可以用”mark_traget_2” “mark_targe_2_tt”，这一套，其概率为120%，以此类推，最高的是”mark_traget_7” “mark_targe_7_tt”，170%概率（对应阿三满级标记概率），其中“mark_target_x”掌管标记的实际效果，但是它不会生成描述字符串，而“mark_targe_x_tt”，仅仅是效果描述的effect，它只负责在技能描述（或是在饰品描述上）生成描述标记效果的字符串，在战斗中无实际效果。

3.3穿甲技能调整
原版人物mod实现穿甲效果非常简单，只需要在heroinfo文件中combat_skill后面加上.ignore_protection true这个属性，即可让这个技能具有穿甲效果，但是，这个功能在黑圣物中被ban掉了（或许只是表面ban掉），如果是这样实现穿甲效果的mod人物，黑圣物制作组还贴心的给你的技能描述里提了个醒告诉你这种实现方式已经被禁用，需要你用buff的方式重新实现。当然，你也可以直接用制作组做好的effect，"ignore_prot_skill"，这个effect调用了穿甲buff实现穿甲，所以改动的方式就是去掉combat_skill后的.ignore_protection true，改成在它的.effect属性后面加上"ignore_prot_skill"就行了。
3.4反击技能调整
原版地牢中，强盗连续开反击是很蠢的事情，因为这会让反击debuff叠加，但是黑圣物就没有这种情况，因为它每次开反击之前会清空角色之前的反击buff，这也可以调用写好的effect，名称就是"highwayman_duelist_riposte_clear"（老兵、强盗通用的这玩意），所以可以在heroinfo文件找到开反击的技能加上这个effect记得这个effect要加在激活反击的effect前面，否则你这个技能将失去反击效果。
3.5暴击aoe负修正
黑圣物的aoe是由暴击负修正的，打击的目标越多，暴击的概率越低，而这个修正居然是通过一个effect来实现的，也就是说，如果你对aoe技能放着不管，它的暴击判定就跟原版一样而不会受到黑圣物的aoe暴击惩罚。
当然，如果你想加入这个暴击惩罚，只需要在heroinfo找到对应combat_skill，在.effect属性后面添加"double_target_negative_crit"（对应双目标aoe）或者"triple_target_negative_crit"（对应三目标aoe）或者"quad_target_negative_crit"（对应四目标aoe）即可
3.6无视准备回合精准减少
无视黑圣物准备回合所有技能精准减半惩罚的effect，可以直接拿来用，一样是heroinfo文件，找到想添加的combat_skill,在.effect后添加"negate_prep_round_acc"
3.7准备回合眩晕失效
这个效果的实现原理是，加入一个准备回合生效的buff，这个buff让你的眩晕概率减少1000%，眩晕技能生效完毕之后还要把这个概率加回来以防你以后都晕不到人。当然，这个也是有现成的effect可以调用的
同上，在heroinfo中找到对应的combat_skill，在.effect中找到造成眩晕的effect，在这个effect前添加"negate_prep_round_stun_chance"，在这个effect后添加"negate_prep_round_stun_chance_alt"，这个东西是带描述的，因此添加完毕后就能看到技能描述中多了准备回合不能眩晕的描述字眼
3.8如何实现准备回合与战斗回合双效果技能
参考蛮女的怒吼代码，我发现黑圣物实现这东西的原理也是相当简单粗暴，因为这种技能一般是准备回合用就给目标上debuff，战斗回合用就给目标造成眩晕，所以聪明的人就猜到了，我在准备回合把眩晕概率-1000，在战斗回合把debuff概率-1000不就好了，嗯，没错，黑圣物制作组就是这么实现的，添加位置同上，顺序
"debuff_prep_round_stun_after" “your_stun_effect”“your_debuff_effect” "debuff_prep_round_stun_after_alt"这玩意好像不带描述，因此添加完了你在技能描述中也看不到描述。但是实际战斗中是有效果的。

3.9、饰品特殊效果调整
饰品特殊属性一般都是百分比加成，因此大部分的数据并不需要翻倍，但是速度要翻倍，如何让速度翻倍其实在一开始已经讲过了，因为饰品的加速都是由buff决定的，因此只需把buff中的速度全都翻倍就好了。有些mod作者在制作饰品buff时用的时原版通用buff，如果原版通用buff速度翻倍后有对应的buff那直接改buffid就好了，如果没有，那你就只好自己在buff文件里添加一个buff了

四、中级进阶
在经历了以上改动之后，相信你的英雄应该能够很好的适应黑圣物的环境了，那么就差最后一步了，补充亿点点细节，让它看起来与别的人物完全相同
4.1如何限制人物信仰
黑圣物的人物信仰实现方式是利用怪癖实现的，人物信仰是一个正面怪癖，它的id是1_pagan、1_religious以及1_faithless，这三个怪癖是互不兼容的因此不用担心冲突问题，就算你什么都不做，在这个方面上也不会引发任何严重的问题。不过如果你想让你的人物有信仰限制，那只需要在heroinfo文件的末尾部分加入一个怪癖修正属性
quirk_modifier: .incompatible_class_ids 1_religious 1_pagna
这样就限制了人物的圣光信仰和异教信仰，当然不要把三个信仰都加到这一行里面去，会发生什么我可没尝试过，注意这里怪癖id是不带引号的，这个属性一般加在死门属性前面（deaths_door前面）
另外，还得为随机生成的初始信仰留下怪癖格子，在heroinfo文件末尾generation那一行.number_of_positive_quirks_min与.number_of_positive_quirks_max 属性的数字各加1

4.2如何让人物掉落cc饰品
黑圣物无法通过通常手段获取cc饰品，只能通过带这个人物下本，并且让他与奇物互动、带他战斗，每次获得物品的互动/每场战斗结束后，都有一定概率获得cc饰品，获得cc饰品的概率随着地牢难度增加而增加，奇物互动概率是0，1/100，1/90，1/80，战斗概率是0，1/394，1/358，1/313对应学徒，精英，冠军，极暗本，现在黑圣物还没有极暗本，不过获取概率却已经设定好了。
那么问题来了，如何让你的人物也掉cc饰品呢？
首先，你需要添加一个loot表，即掉落表，这个列表描述了cc物品的掉落规则，然后，让你的英雄在奇物互动和战斗结束后能够调用这个loot表
先从简单的说起，让你的英雄在战斗结束后调用loot表，只需要在你的heroinfo文件中加入以下两行
extra_battle_loot: .code "MEMENTO_BATTLE_HEROCLASS" .count 1
extra_curio_loot: .code "MEMENTO_HEROCLASS" .count 1
其中"MEMENTO_BATTLE_HEROCLASS"是战斗结束后调用的掉落表，"MEMENTO_HEROCLASS"是奇物互动的掉落表，记得将HEROCLASS替换成你的英雄名称，全大写只是编程习惯，小写可以但不建议，掉落表id应该是大小写敏感的，注意对应。
然后是比较麻烦的，如何制作loot表。
其实也没那么麻烦，我们可以直接用官方mod角色的loot表来改一个，找到Black Reliquary\mods\br_hexer\loot\hexer_mementos.loot.json
拷贝这个文件到到br_heroclass\loot文件夹中（如果没有这个文件夹就创建一个loot文件夹），并将其重命名为heroclass_mementos.loot.json然后利用替换功能将文件里的所有HEX全都替换成你的英雄名称，将hexer_turning_point与hexer_exquisite_humors分别换成两个cc饰品id即可

4.3如何让扎营技能显示timecost
掌管扎营技能的文件是br_heroclass\raid\camping\heroclass.camping_skills
扎营技能的timecost显示是利用了一个只有描述没有实际效果的扎营技能effect来添加描述，其形式如下：
{
"selection" : "aaaa",
"requirements" : [],
"chance" : { "code" : "brel", "amount": 1.0 },
"type" : "loot",
"sub_type" : "TIME_COST_2",
"amount" : 1
},
其中subtype属性后的"TIME_COST_2"会让这个扎营技能显示消耗时间2，当然你改成3就是3，改成4就是4，以此类推。
扎营技能本身的timecost在”effects”的上两行的“cost”属性，注意描述时间与实际消耗时间保持一致。

4.4 如何让人物的护甲与技能升级需求与黑圣物其它英雄相同
控制人物升级消耗的文件是
mods\br_heroclass\upgrades\heroes\heroclass.upgrades.json
在这个文件中你可以看到weapon与armor下的"requirements"属性中的"prerequisite_resolve_level"属性从code0、1、2、3分别为1、2、3、5，"prerequisite_resolve_level"属性改为2、3、4、5，
技能等级那里，同样是"prerequisite_resolve_level"属性，改成1、2、3、4、5递进的即可。

4.5如何显示英雄的额外信息
这部分将会是真的很麻烦，不像前面的改改代码加加属性，这个东西涉及到的知识点是真的有点多……
没关系，我们一步一步的来讲
首先，我必须简单阐述以下这个东西的基本原理，这个显示出的额外信息，其实是一个不会被选择的、每个英雄一开始就解锁了的扎营技能。额外信息里的所有字符串其本质都是这个扎营技能的技能描述。
原理上很简单，是吧？确实是这样的，但是要保证信息的完整和格式化却又很多讲究。
好在我们不用一行行的敲代码来创建一个新的扎营技能，最简单的办法，是从别的mod那里弄一个当作示例。
这里直接拿hexer的扎营技能当作示例吧,位置在
Black Reliquary\mods\br_hexer\raid\camping\zBR_addinfo_hexer.camping_skills.json

我们略过一个扎营技能必须有的id，level，cost等属性，还有前面的configuration，heroclass属性里为啥有abcdef这些都不关键，照抄就是了，不过注意别忘了把heroclass属性里的hexer改成你的heroclass。
我们主要关注effects里的每一个元素，在这里，每个元素对应类的额外信息描述，这个额外信息描述的标题是由selection属性决定的，这里只列出部分例子，完整的表格请到br的mod开发文档中查看
br111a - MeleeRiposte
br111b - RangedRiposte
br111c -Mystical Riposte
br211a - CritEffect
br241a – Modes
br311a –Passives
br341a -Starting Supplies
每一个subtype属性则决定了属性的具体描述字符串内容是什么。

这个字符串实在哪里定义的呢？以上图中br111b远程反击来举例子，它是由hexer的stingtable文件定义的，对于官方mod文件，其stringtable并不在它的mod文件夹内，hexer的stringtable位于\Black Reliquary\localization\hexer.string_table.xml，在这个文件中，我们可以看到

其对应的具体描述是ACC base: 85 / DMG mod: -40%
对于一个原版mod而言，其stringtable文件一般位于br_heroclass\localization\heroclass.string_table.xml，当你在camping skill里添加完一个effect后，你还需要在stringtable文件中添加对应的字符串描述，添加的格式如下：
<entry id="camping_skill_effect_loot_NAME"><![CDATA[DATA]]></entry>
其中NAME对应你camping skill的subtype，DATA对应你要写的东西。当然你在这里写什么都行
至于添加的位置，这个理论上来讲你需要对所有暗黑地牢支持的语言每一种添加一条，但是好在我相信你不会选择简体中文和英文以外的任何语言，因此其实只需要在english和schinese对应的位置添加这一行就行了，具体位置并不关键，建议加在 <language id="english">的下一行和 <language id="schinese">的下一行。
是不是添加完就可以直接在游戏里看到呢？不是的

暗黑地牢对字符串的调用并不是通过stringtable文件，而是通过loc和loc2文件的，因此你需要用你的stringtable文件来生成一个loc文件，不用担心，dd和黑圣物都提供了这个生成文件，你需要做的事情只有这些：
首先，***od里的所有loc和loc2文件清空，即删除除了stringtable.xml之外localization文件夹内的所有文件。
找到localization.bat(位置：Black Reliquary\localization\localization.bat)
右键-编辑，你会用记事本打开这个文件
把其中的内容改成如下形式
START ../_windows/localization.exe –prefix heroclass_ >> error_try.txt
把你编辑好的stringtable拷贝到localization.bat同目录下
Heroclass替换成你的mod人物名称，保存，关掉
双击运行localization.bat，你会观察到这个文件夹多了几个文件，这些文件的文件名都是以heroclass开头的loc2文件，把这些文件连同你的stingtable一起剪切-粘贴到你的mod文件夹localization处即br_heroclass\localization，
这样stringtable的修改就完成了。这就结束了吗？还没有，不过快了。