110 - API文档汉化 - 入门指南
Updated 6 days ago入门指南
入门指南:安装
首先,我们将介绍如何安装所有《邪恶冥刻》模组依赖的框架BepInEx。这是运行模组化《邪恶冥刻》的必要步骤,请务必仔细遵循以下说明。
使用模组管理器安装
- 下载并安装Thunderstore Mod Manager、Gale或r2modman。
- 在BepInEx页面顶部点击Install with Mod Manager按钮。
- 通过模组管理器启动游戏。
若遇到模组管理器问题,请前往以下Discord服务器寻求支持:
手动安装
- 通过点击“Manual Download”安装BepInEx,将内容解压至文件夹(切勿解压到游戏目录!)
- 将“BepInExPack_Inscryption”文件夹内容移至游戏目录(即游戏可执行文件所在位置)
- 启动游戏。若操作正确,桌面将显示BepInEx控制台。待游戏加载完成后关闭
- 安装MonoModLoader并解压内容至文件夹
- 将“patchers”文件夹内容移至“BepInEx/patchers”(如相关BepInEx文件夹不存在,请手动创建)
- 安装Inscryption API并解压内容至文件夹
- 将“plugins”文件夹内容移至“BepInEx/plugins”,“monomod”文件夹内容移至“BepInEx/monomod”
- 再次启动游戏。若运行正常,控制台将显示API已加载的提示信息
Steam Deck安装指南
- 在Steam Deck桌面模式下载r2modman,通过其
AppImage
文件启动 - 下载计划使用的模组及其依赖项
- 进入模组配置文件的设置界面,点击
Browse Profile Folder
- 复制BepInEx文件夹,通过Steam打开《邪恶冥刻》属性菜单
- 进入
Installed Files
点击Browse
打开游戏本地文件目录,粘贴BepInEx文件夹 - 切换至游戏模式,在属性菜单的
Compatibility
中勾选“Force the use of a specific Steam Play compatibility tool” - 在启动参数中输入
WINEDLLOVERRIDES=“winhttp.dll=n,b” %command%
- 启动游戏。若操作正确,屏幕将显示控制台界面
Mac & Linux系统
- 首先完成此文档步骤:https://docs.bepinex.dev/articles/user_guide/installation/index.html
- 随后执行手动安装指南的第4-8步
- 至此游戏应已完成模组环境配置
如遇Mac/Linux、Steam Deck或手动安装问题,请前往游戏官方Discord:
- 《邪恶冥刻》模组开发Discord: 点击进入
入门指南:模组开发
《邪恶冥刻》模组开发需要掌握C#编程知识,多数情况下还需理解如何使用HarmonyPatch进行游戏补丁。
若您不熟悉这些技术,或仅希望创建卡牌与印记,可使用JSONLoader。
使用JSONLoader开发
JSONLoader是一款多功能模组,通过JSON语法为《邪恶冥刻》提供更友好的卡牌与能力创建方式,其复杂度远低于C#。
JSONLoader文档参见此处。
基础使用视频教程参见此处。
使用C#开发
开始C#模组开发前,需使用代码编辑器创建新的C#项目。我们推荐并默认您使用Microsoft Visual Studio。
项目目标框架需设置为netstandard2.0
。
创建项目后,进入项目 > 管理NuGet程序包...
。点击“程序包源”下拉菜单,确保已包含“BepInEx”和“nuget”。
如缺少BepInEx或nuget源,需手动添加:
- 点击程序包源选择器旁的齿轮图标
- 点击绿色加号按钮
- 添加BepInEx源:名称设为“BepInEx”,源链接设为
https://nuget.bepinex.dev/v3/index.json
- 添加nuget源:名称设为“nuget”,源链接设为
https://nuget.windows10ce.com/nuget/v3/index.json
将包源切换为“全部”后点击“浏览”,安装以下包(确保版本号匹配!):
- BepInEx.Analyzers v1.0.8
- BepInEx.Core v5.4.19
- HarmonyX v2.9.0
- Inscryption.GameLibs v1.9.0-r.0
- UnityEngine.Modules v2019.4.24
还需添加API引用,具体方法如下(任选其一):
- 进入
BepInEx/plugins
文件夹复制路径 - 通过
项目 > 添加项目引用... > 浏览 > 浏览...
添加“InscryptionAPI.dll” (该文件位于BepInEx插件目录BepInEx/plugins/API_dev-API
中)
如需引用其他模组作为依赖项,可同样添加其.dll文件。
替代方案是通过NuGet添加引用:
- 添加包源
https://nuget.bepinex.dev/v3/index.json
- 添加“API_dev-API”引用
完成上述步骤后,即可开始模组创作! 以下提供部分开发资源(含示例模组),或继续阅读本Wiki文档。
开发资源
Pages
- 0 - 邪恶冥刻模组简体中文语言包Wiki
- 100 - API文档汉化 - 首页
- 110 - API文档汉化 - 入门指南
- 120 - API文档汉化 - 卡牌
- 121 - API文档汉化 - 自定义卡牌费用系统
- 122 - API文档汉化 - 会说话的卡牌
- 123 - API文档汉化 - 自定义毛皮
- 130 - API文档汉化 - 能力
- 131 - API文档汉化 - 自定义触发器
- 132 - API文档汉化 - 自定义狙击逻辑
- 133 - API文档汉化 - 伤害护盾行为
- 134 - API文档汉化 - 卡槽修改功能
- 135 - API文档汉化 - 触发器与执行顺序
- 140 - API文档汉化 - 自定义/扩展属性
- 150 - API文档汉化 - 扬升(凯茜模组)
- 160 - API文档汉化 - 地图与遭遇战
- 170 - API文档汉化 - 对手
- 180 - API文档汉化 - 图腾
- 190 - API文档汉化 - 道具
- 1A0 - API文档汉化 - 规则书
- 1A1 - API文档汉化 - 添加自定义页面
- 1A2 - API文档汉化 - 添加文本重定向功能
- 1B0 - API文档汉化 - 本地化
- 1B0 - API文档汉化 - 声音
- 1B0 - API文档汉化 - 资产包
- 1C0 - API文档汉化 - 其他特性
- 200 - JSONLoader文档汉化 - Wiki
- 201 - JSONLoader文档汉化 - 枚举值