CustomMenu

一个为《杀戮尖塔2》设计的主菜单定制模组。

此模组允许你完全自定义游戏的主菜单。

本模组需同时安装 ModConfig 模组以获得图形化设置界面，它是前置。

主要特性

• 自定义背景：支持 PNG / JPG 格式，轻松换上你喜欢的壁纸。
• 自定义音乐：支持 OGG 格式，让每次打开游戏都伴随你最爱的旋律。
• 图形化配置界面：基于 ModConfig 框架，在游戏内“设置 -> 模组”中即可轻松调整。
• 一键访问资源目录：提供“打开 user:// 文件夹”按钮，方便你放置文件。
• 智能路径处理：支持 user:// 短路径和绝对路径，并自动处理反斜杠等常见问题。
• 兼容：游戏更新时无需额外适配，也通常与绝大多数模组兼容。

安装方法

1. 手动安装：将 CustomMenu 文件夹放入 [游戏根目录]/mods/ 文件夹中。
2. 确保 Mod 文件夹结构正确：最终路径应为 .../mods/CustomMenu/CustomMenu.dll。
3. 安装 ModConfig（可选但强烈推荐）：访问 ModConfig 页面 下载并放入 mods 文件夹。

如何使用

• 推荐使用 user:// 短路径：打开 开始 -> 运行 -> %AppData%\SlayTheSpire2，把你准备好的背景图片和音乐文件放进去。
• 启动游戏：点击 设置 -> 模组 -> Custom Menu，勾选“启用自定义背景/音乐”，并在路径框中输入文件名（例如 user://bg.png）。
• 重启游戏：所有配置需重启游戏后生效。

注意事项

• 路径格式：强烈建议使用 user:// 短路径。如果使用绝对路径，请使用正斜杠 /，例如 D:/my_images/poster.png。（注意：路径文本过长可能导致此功能失效。）
• 图片尺寸：图片分辨率不限，模组会自动缩放以完整显示（可能会有黑边）。如需完全无黑边，可选择“铺满”模式（后续版本）。
• 音频格式：测试支持的格式为 OGG。

已知问题

• 【无】
• 如果您发现了任何问题，欢迎在评论区留言反馈！

更新计划

• 支持 GIF / MP4 动态背景
• 支持随机背景池

致谢

• 开发 & 发布：桐生 飞羽左
• 特别感谢：ModConfig 的作者 皮一下就很凡，本模组的图形化界面基于其框架。
• 感谢所有测试和反馈的朋友！
• 注：本模组的部分代码在开发过程中借助了 AI 辅助工具生成，所有内容均已人工测试和验证。