魔法工作室

Serena's Enchanted Studio

为每一个版本的你，带来一点魔法。

4X 角色 • 实验性 4X 世界 + 界面 • 完整自定义 • 纹理工坊 • 肖像工坊

---

Serena's Enchanted Studio 将《Sun Haven》的视觉增强与角色自定义工具整合到一个温馨、可拖拽的游戏内菜单中。

加载角色后按 End 键即可打开工坊。F8 作为备用快捷键。

本工坊不会覆盖《Sun Haven》的原始资源包。自动缩放、纹理替换、肖像包、NPC 显示名称和菜单设置均可随时移除。唯一有意的存档操作是你在按下“应用”后修改玩家名称。

---

主要功能

• 4X 角色 — 当《Sun Haven》加载玩家的模块化身体、皮肤、头发、眼睛、衣物、翅膀、尾巴、配饰和已装备图层时，自动应用边缘感知的 4 倍像素艺术处理。它在保持角色屏幕尺寸不变的同时，为渲染器提供更多像素信息。
• 更清晰的预览 — 同一角色处理流程适用于常规和备份的加载/存档预览。启用角色缩放时，《Sun Haven》原生的角色创建预览分辨率从 60x60 提升至 240x240。
• 4X 世界 + 界面 — 一个独立的、可选的实验性模式，适用于受支持的场景、道具、世界精灵、动物、NPC 美术、无碰撞瓦片、《Sun Haven》网格和标准菜单图像。默认为关闭状态，并会记住你的选择。
• 头发覆盖披风修正 — 修正朝北时的图层顺序，避免披风和背部装备绘制在长发之上。
• 完整角色自定义 — 无需前往美容院、传送或开新档，即可直接从工坊打开《Sun Haven》的完整角色创建界面。关闭自定义界面将应用正常的《Sun Haven》变更。
• 玩家与 NPC 名称 — 可通过《Sun Haven》正常的角色存档方式重命名玩家，或为 NPC 显示名称创建持久化覆盖，而无需更改其内部任务或关系身份。
• 纹理工坊 — 为普通 SpriteRenderer、标准 UI 图像、可重建网格、对话立绘和玩家图层/预览加载基于文件名的可选 PNG 替换。即使世界/界面 4x 关闭，纹理包依然有效。
• 肖像工坊 — 加载四季六表情肖像表以及受支持的单图特殊服装，并支持可选的位置和缩放调整。

4X 缩放的作用

角色和世界工具使用边缘感知的像素艺术算法。它们可以使曲线、头发边缘、眼睛、衣物和小型精灵细节看起来更清晰，但其中不包含手绘的替换美术。任何看似额外细节的内容均是从原始像素推断而来。

世界/界面 4X 并非对所有内容盲目套用的滤镜。 字体、渲染纹理、着色器与材质效果、粒子渲染器、打包或次纹理精灵、像素级可点击 UI 以及超大图集将保持原版，以确保兼容性和性能。受支持的美术效果将取决于《Sun Haven》当初如何构建该资源。

新的世界纹理会在《Sun Haven》完成自身的视觉加载之后才逐步处理。内存限制、受保护的 UI 容量、延迟的场景扫描和渐进式的首次生成均被纳入其中，以减少加载和移动时的峰值。

需求

• 通过 Steam 在 Windows 上游玩的《Sun Haven》。
• 《Sun Haven》的 BepInEx 5.4.23.5 整合包。

安装

1. 安装正确的《Sun Haven》BepInEx 5.4.23.5 整合包，包括 KeepAlive。
2. 移除或禁用旧的独立版 Serena's Player Upscaler.dll（如果存在）。
3. 下载主文件并将其 BepInEx 文件夹解压到《Sun Haven》的主游戏目录中。
4. 确认 DLL 位于以下路径：

Sun Haven\BepInEx\plugins\SerenaSunHavenStudio\Serena's Enchanted Studio - Sun Haven.dll

1. 启动《Sun Haven》，加载一个角色，然后按 End 键。如果其他程序占用了 End 键，请使用 F8。

工坊控制

• End — 打开或关闭工坊。
• F8 — 备用的打开/关闭快捷键。
• 标题栏 — 点击并拖拽可将菜单重新定位到屏幕任意位置。
• 设置标签页 — 开关角色 4x、实验性世界/界面 4x 以及头发/披风修正。
• 自定义标签页 — 打开《Sun Haven》的完整角色自定义界面。
• 名称标签页 — 应用玩家名称或管理 NPC 显示名称覆盖。
• 纹理与肖像标签页 — 打开包文件夹并重新加载已安装的包，无需重启游戏。

创建纹理包

将 PNG 文件放在以下目录：

Sun Haven\BepInEx\plugins\SerenaSunHavenStudio\TexturePacks\Your Pack\

PNG 文件名（不含 .png 扩展名）必须与原始 Unity 纹理名称完全一致，且替换文件必须保持原始宽高比。玩家替换会在自动角色 4x 处理之前应用。

打包图集、分离通道、次纹理和瓦片地图精灵将保持原版。纹理工坊刻意不替换瓦片地图纹理，因为其图集和碰撞关系无法在运行时安全重建。

创建肖像包

将肖像表放在以下目录：

Sun Haven\BepInEx\plugins\SerenaSunHavenStudio\PortraitPacks\Your Pack\

将每个表命名为 NPC_Season.png，使用 NPC 的原始/内部名称。

Spring、Summer、Fall、Winter 和 Swimsuit 表包含六个等宽横排姿势，顺序如下：

Normal • Romantic • Happy • Mad • Embarrassed • Sad

表宽度必须能被六整除。Wedding、Halloween 和 Witherball 使用单张肖像，并在对话请求其他情绪时保留该特殊服装。

对于玩家孩子，请在文件名中使用该孩子当前存档的名字，而不是 Kid。

可选的配套 JSON 文件可以调整位置：

{ "offsetX": 0, "offsetY": 0, "scale": 1.0 }

兼容性与坦诚的局限

• 世界/界面 4x 是实验性的、需主动启用的，并且依赖于资源本身。部分美术将刻意保持原版。
• 自动 4x 处理可能消耗额外的内存。默认已启用保守的每纹理和总缓存限制。
• 替换相同肖像、纹理、玩家图层或角色自定义挂钩的模组可能会产生冲突。
• 工坊会检查已审阅的 SunHaven.Core 构建版本。在游戏重大更新后，它可能会安全地自行禁用，直到兼容性得到评估。

卸载

删除以下目录：

Sun Haven\BepInEx\plugins\SerenaSunHavenStudio

这将移除工坊及其文件夹内存储的所有包。NPC 显示名称覆盖仅存于工坊配置中。已通过“名称”标签页应用的玩家名称仍保留在该角色的存档中，就像一次普通的《Sun Haven》改名一样。

故障排除与错误报告

如果工坊无法打开，请先确认已安装正确的《Sun Haven》BepInEx 整合包、KeepAlive 存在，且 HideManagerGameObject 为 true。报告问题时，请附上你的工坊版本、当时正在进行的操作、角色或世界/界面 4x 是否已启用、已安装的包名称，以及 BepInEx\LogOutput.log 的相关片段。

---

致谢与出处

由 Serena Enchanted 创作。

所有《Sun Haven》名称和游戏资源均归其各自创作者所有。

感谢您光临工坊。希望它能为您在《Sun Haven》中的旅程增添一丝额外的魔力。