杀戮尖塔修改mod - 藍月なくる的小窝

超絕可愛の一抹多

舞台少女，天天进化中！

本站还在进化中...

标签

超絕可愛の一抹多

舞台少女，天天进化中！

本站还在进化中...

标签

Blogging hello world 制作测试游戏网络音乐

450 字

1 分钟

杀戮尖塔修改mod

2026-03-27

mod

制作

记录一下杀戮尖塔2的mod制作过程#

事前准备#

1
使用godot（自己去github上面找喵，也可以找我要）

alt text

2 创建一个游戏项目
注意项目名称要与你的mod名称一致，我这里就叫meihuamod好了

我们先来做事件的背景图#

1背景图用不上dll，可以选择跳过
用开源的杀戮尖塔2游戏文件找到events，这里有着你想要的事件。随机挑选个事件
然后在你创建的游戏项目里做一个一模一样的
改好后，选择项目，导出
点击添加，这里要确认导出模式是所有资源
点击导出，把项目包为pck 将你做的pck放到你的mod里面，还要创建一个.json文件，注意{mod}.json中,要mod名字。json文件内容如下

1
{
2
  "id": "MyMod",           // 必填，唯一 ID，建议和项目名一致
3
  "name": "我的 Mod",
4
  "author": "作者名",
5
  "description": "Mod 描述",
6
  "version": "1.0",
7
  "has_pck": true,         // 是否有 .pck 资源包,没有就改false
8
  "has_dll": true,        // 是否有 .dll 代码，没有就改false
9
  "dependencies": [""],     // 依赖的其他mod id
10
  "affects_gameplay": true // 多人模式时是否影响内容，如果是替换模型和优化等不影响内容的mod可填false，默认true
11
}

最后会有这样的形式，上号就能看到改变了

然后是改卡牌卡面#

我们这里一样按照上面的过程，我们用VScode做演示

1
如图，点击创建一个c#
2 在vscode找到这个文件，修改内容为

1
<Project Sdk="Godot.NET.Sdk/4.5.1">
2
  <PropertyGroup>
3
    <TargetFramework>net9.0</TargetFramework>
4
    <ImplicitUsings>true</ImplicitUsings>
5
    <LangVersion>12.0</LangVersion>
6
    <Nullable>enable</Nullable>
7
    <AllowUnsafeBlocks>true</AllowUnsafeBlocks>
8

9
    <!-- 改成你的杀戮尖塔2目录 -->
10
    <Sts2Dir>D:\xxx\Steam\steamapps\common\Slay the Spire 2</Sts2Dir>
11
    <Sts2DataDir>$(Sts2Dir)\data_sts2_windows_x86_64</Sts2DataDir>
12
  </PropertyGroup>
13

14
  <ItemGroup>
15
    <Reference Include="sts2">
16
      <HintPath>$(Sts2DataDir)\sts2.dll</HintPath>
17
      <Private>false</Private>
18
    </Reference>
19

20
    <Reference Include="0Harmony">
21
      <HintPath>$(Sts2DataDir)\0Harmony.dll</HintPath>
22
      <Private>false</Private>
23
    </Reference>
24
  </ItemGroup>
25

26
  <!-- 自动复制dll和json -->
27
  <Target Name="Copy Mod" AfterTargets="PostBuildEvent">
28
    <Message Text="Copying mod to Slay the Spire 2 mods folder..." Importance="high" />
29
    <MakeDir Directories="$(Sts2Dir)\mods\" />
30
    <Copy SourceFiles="$(TargetPath)" DestinationFolder="$(Sts2Dir)\mods\$(MSBuildProjectName)\" />
31
    <Copy SourceFiles="$(MSBuildProjectName).json" DestinationFolder="$(Sts2Dir)/mods/$(MSBuildProjectName)/" />
32
  </Target>
33
</Project>

3
然后创建一个Scripts文件夹，创建一个Entry.cs文件（两者命名随意，为了整洁美观）。内容改成以下：

1
using Godot.Bridge;
2
using HarmonyLib;
3
using MegaCrit.Sts2.Core.Logging;
4
using MegaCrit.Sts2.Core.Modding;
5

6
namespace Test.Scripts;
7

8
// 必须要加的属性，用于注册Mod。字符串和初始化函数命名一致。
9
[ModInitializer("Init")]
10
public class Entry
11
{
12
    // 初始化函数
13
    public static void Init()
14
    {
15
        // 打patch（即修改游戏代码的功能）用
16
        // 传入参数随意，只要不和其他人撞车即可
17
        var harmony = new Harmony("sts2.reme.testmod");
18
        harmony.PatchAll();
19
        // 使得tscn可以加载自定义脚本
20
        ScriptManagerBridge.LookupScriptsInAssembly(typeof(Entry).Assembly);
21
        Log.Debug("Mod initialized!");
22
    }
23
}

4 然后在此代码下面添加新的代码

1
[HarmonyPatch(typeof(CardModel), nameof(CardModel.PortraitPath), MethodType.Getter)]
2
public static class CardModel_GetPortrait_Patch
3
{
4
    // 按照类名和资源路径配对即可
5
    private static readonly Dictionary<string, string> CustomPortraits = new(StringComparer.OrdinalIgnoreCase)
6
    {
7
        [nameof(StrikeIronclad)] = "res://test/images/image.png",
8
        [nameof(DefendIronclad)] = "res://test/images/image.png",
9
    };
10

11
    static void Postfix(CardModel __instance, ref string __result)
12
    {
13
        var className = __instance?.GetType().Name;
14
        if (string.IsNullOrEmpty(className)) return;
15
        if (!CustomPortraits.TryGetValue(className, out var path)) return;
16
        if (!ResourceLoader.Exists(path)) return;
17
        __result = path;
18
    }
19
}