自定义骨架加载器

创作者: Khiral

已更新:2026-04-13 07:39:39

22KB

下载

前置 MOD

使用自定义骨架加载器时将自动安装

模组配置

806KB

关于此 MOD

无需修改或重新打包游戏文件。该工具可在运行时将游戏内角色、怪物、界面、特效等骨骼动画替换为外部自定义Spine资源，实现无侵入式资源替换。

杀戮尖塔2 自定义骨架加载器

概览

CustomSkeletonLoader 是《杀戮尖塔2》的一款强力运行时骨架替换工具，让模组作者无需修改游戏文件即可用自定义资源替换游戏内的Spine骨架动画。

支持超过136种可替换骨架，涵盖可操作角色、怪物、商人、背景、界面元素及视觉效果。

该模组内置导出工具包，可从PCK包中提取所有官方骨骼资源，配备智能名称匹配算法以处理多种命名变体，并支持ModConfig面板的无缝集成，实现调试与一键导出功能。

◈ 如果这个模组对你有帮助，请点击“认可”按钮以表示支持。:)

特色功能

1. 自定义骨架替换

这个模组会自动扫描

替换资源

模组目录内用于存放自定义骨架文件（.atlas、.skel、.png）的文件夹，通过Harmony补丁在运行时替换游戏默认骨架，对原始代码库零侵入。

支持的资源类型：

.atlas
.skel
抱歉，我没有看到您提供的文本内容。请您将需要翻译的游戏文本粘贴在消息中，我会根据要求进行专业的本地化翻译。

替换覆盖内容包括：

可玩角色：铁甲战士、静默猎手、故障机器人、死灵缚法师、执政官（含战斗与武器变体）。
商人变体：5名角色拥有独特的待机商店动画。
休息点：角色专属休息动画（包含死灵缚者的奥斯蒂伙伴）。
角色选择：完整展示全部5个职业的角色选择界面骨架。
怪物：全章节90多种敌人类型（首领、精英、普通）。
背景：祭典猛兽、藏宝室（第1/2/3幕）、商人房间、主菜单、特斯卡塔拉。
UI元素：战斗法球（暗影、寒霜、晶璃、雷电、等离子），MegaCrit标志动画。
视觉特效：首领爆炸、激光射线、护盾特效、划痕、刀光、藤蔓触手。

2. 骨骼导出工具

该模组内置完整的导出功能，可通过ModConfig面板调用，能将游戏PCK包中所有可替换的Spine骨骼资源提取为标准文件格式，方便直接编辑修改。

导出功能：

从 .spatlas（Godot 压缩格式）中提取完整的 .atlas 文件。
将 .spskel 二进制文件转换为 Spine 编辑器可用的标准 .skel 格式。
导出所有关联的 .png 纹理页，并保留正确的文件名。
支持多页纹理集（例如，necrobinder.png + necrobinder_2.png）。
自动创建统一子目录并重命名文件集，便于浏览查看。
合并重复骨架（基于MD5哈希比对）以减少冗余。

导出输出结构：

脊椎_资源/
抱歉，您提供的文本内容似乎不完整或格式有误（仅显示路径“├── ironclad/”）。请提供需要翻译的完整游戏文本内容，以便我为您进行专业的中文本地化翻译。
│铁甲.atlas
│ironclad.skel
│铁甲.png
│└── unified/  
    （统一文件夹/已整合内容）
│ ├── ironclad.atlas
│ 铁甲军阵.skel
│ └── 铁甲.png
└── necrobinder/
    └── 死灵缚法师/
│necrobinder 图集
│necrobinder.skel
│死灵束缚者
│死灵缚者_2.png
│└── unified/
│ └── ...
└── ...（含130多个骨架目录）

总出口量： 136+ 套完整贴图数据的骨架组，非常适合制作自定义骨架模组或研究官方动画结构。

3. 运行稳定性

稳定性功能：

并发安全缓存： 使用ConcurrentDictionary实现线程安全的骨架数据缓存，并具备空值保护（加载失败的数据不会被缓存）。
资源生命周期管理： 在 try-catch-finally 块中正确处理 GodotObject 可避免加载失败时的内存泄漏。
和谐非侵入式修补： 所有替换均使用Harmony前缀/后缀，以确保在必要时保留原始方法行为作为后备机制。
优雅降级： 缺失或无效的自定义文件将被自动跳过，游戏继续使用默认资源。
调试日志系统： 可配置详细日志记录，用于问题排查（通过ModConfig开关控制）。
导出安全设置： 原子级导出操作具备重复检测功能，可防止数据损坏；并发导出请求将进入队列处理。
路径自动寻路： 自动定位模组目录至DLL所在位置，无需手动配置。

4. 安装

从模组页面下载最新版本。
将内容解压至《杀戮尖塔2》的Mods文件夹中：
.../《杀戮尖塔2》/模组/
安装所需依赖：
- 模组配置 – 游戏内设置面板与导出功能必需（未安装时仅可使用基础替换功能）。

模组目录结构：

自定义骨骼加载器/
`CustomSkeletonLoader.dll`
CustomSkeletonLoader.pck
自定义骨架加载器.json
└── ReplaceResources/
 │(请在此处放置自定义骨架文件)
 │好的，请提供需要翻译的文本。
 ││ironclad.atlas
 ││ironclad.skel
 ││└── 铁甲.png
 │├── silent/  →  ├── 静默目录/
 ││└── ...
 │└── ...（其他骨架目录）

请提供需要翻译的文本内容。

配置

所有设置均可通过游戏内菜单进行调整 模组配置 "CustomSkeletonLoader" 部分下的面板：

启用调试日志 (开关，开)
导出所有骨架 一键提取全部136+个游戏骨架至/Spine_resource文件夹。将Godot格式（.spatlas/.spskel）转换为标准Spine格式（.atlas/.skel），并导出所有PNG贴图。
/spine目录下/unified文件夹中的文件仅是为方便导入编辑工具而重命名，**不得**用于实际资源替换。

使用

创建自定义骨架

使用以下方式导出基础游戏骨骼导出模组配置面板中的按钮。
导航至导出目录： .../mods/CustomSkeletonLoader/Spine_resource/{skeleton_name}/unified/
使用兼容Spine的工具（如Spine Essential、第三方编辑器）编辑骨骼文件。
修改后的文件放置位置： .../mods/CustomSkeletonLoader/ReplaceResources/{skeleton_name}/
检查替换文件的文件名是否与原文件名一致。
重启游戏后，骷髅模型将在首次访问时动态加载（延迟加载）。

文件名命名规则

自定义骨架文件内部必须遵循以下结构：

替换资源/

目录名称：使用目标骨架标识符
阿特拉斯文件： {name}.atlas
骷髅数据： {name}.skel
纹理页： {name}.png, {name}_2.png等（以图鉴为准）

支持命名示例：

替换资源/
铁甲/  # 替换战斗铁甲船
│ironclad.atlas
│├── 铁甲.skel
│铁甲舰.png
黑铁商贩  # 替换商店：铁甲(自动匹配)
│铁甲商人图集
│ironclad_merchant.skel
│铁甲商人.png
死灵束缚者/  # 替换战斗死灵缚法者
│└── ...
仪式之兽/# 替换首领怪物
│└── ...
└── dark_orb/  
└── 暗黑法球/  # 替换界面光球动画
 └── ...