为英灵神殿添加沉浸式的季节性星级系统修饰符和季节性生物称号。

赛季SLS桥 1.4.8

季节限定SLS桥 连接 季节性 和 星级系统 为Valheim的生物赋予季节性战斗特性和可选的外观变体。

目标很简单：让世界感觉更有生气、更难以预料，同时不改变StarLevelSystem本身、不替换其修饰符名称，也不从Seasonality手中夺走控制权。

社区与支持

关于模组问题、漏洞报告、创意想法、纹理贡献或一般讨论，请加入社区Discord：

https://discord.gg/kN3cqHqWYA

1.4.8版本新内容

版本1.4.8改进 星级系统兼容处理 并为生物悬停名称新增一层本地季节图标。

• 星级系统 1.18.2 已明确验证。
• 较新的星級系統版本不再仅仅因為版本号更高而被拒绝。如果经过验证的公共API保持兼容，桥接将继续工作并显示 单次启动警告.
• 如果所需的公共 API 确实不兼容或缺失，桥接器会安全地禁用 StarLevelSystem 集成并报告问题，而不会尝试不安全的调用。
• 经过验证的公开StarLevelSystem API现已通过委托进行绑定，降低了加载未来版本时不再暴露某个预期函数的风险。
• 季节悬浮名称现在可以显示本地图标，用于 冬天, 春天, 夏天 和 秋天.
• 显示赛季标题 可以隐藏文本标题（维特巴恩, 城堡之子, 夏日之子, 房屋之子同时保留图标。
• 显示赛季图标, 赛季图标尺寸 和 赛季图标间距 控制本地图标界面。
• 季节图标使用 128×128 RGBA PNG 资源，且不得修改ZDO数据、StarLevelSystem状态或网络权限。

1.4.7 仅更新了文档 且未改变玩法、赛季逻辑或视觉系统行为。

视觉系统

视觉系统旨在补充季节性系统，而非取代它。

当前美术状态： 目前已包含完全完成的公共自定义纹理，用于 巨魔，那 灰矮人家族 和 骷髅.
更广泛的视觉框架和生物目录已为更多族群做好准备，这些族群将继续逐步加入。

当受支持的生物拥有匹配的修正符时，季节性SLS桥接可为该生物应用本地视觉变体。

示例包括：

• 冰霜 — 冬季/寒冷外观
• 火 — 灼热或火山般的外观
• 火焰新星 — 更不稳定的火焰外观
• 毒 ——有毒/杂草丛生的外观
• 剧毒新星 — 不稳定的毒素外观
• 闪电 — 风暴充能外观
• 元素混沌 — 不稳定的奥术外观
• 大 — 冬季厚重 / 在支持的情况下可呈现威严外观
• 噬魂者 ——黑暗通用外观
• 残暴 — 攻击性通用外观

未编辑或不支持的属性保持原样，以便Seasonality可以继续处理其正常的季节性视觉效果。

巴伦德人形随机生成器变体

支持 骷髅 和 尸鬼 由 BalrondHumanoidRandomizer 创建的变体，该桥接会将随机生成的原型解析回其编目基础生物，并复用该基础生物现有的纹理集。

这样可以避免为每个随机变体维护重复的纹理，也不会导致有意排除的基础预制体被重新添加到视觉目录中。

1.4.6 版本还改进了材质属性处理：不相关的属性块不再阻止受支持的纹理贴图，首次应用失败后可以重试，并且视觉警告会包含受影响的预制体名称，以便更轻松地诊断问题。

视觉优先级

如果生物符合多个支持的视觉效果，桥接会使用固定优先级：

1. 元素修饰，季节主要元素优先
2. 噬魂者
3. 残暴
4. 大

此订单在1.4.6版本中未更改。 大 现在可以全年使用支持的视觉效果，而无需依赖特定季节。

这样可以保持结果可预测，避免多个系统试图覆盖同一材质。

元素视觉回退

由StarLevelSystem直接施加的元素修饰符，即使生物没有记录出生季节，也仍然可以使用匹配的视觉效果。

仅用于视觉选择：

• 霜降归于冬
• 火焰、闪电和火焰新星回退到夏季版本
• 毒素、元素混沌和毒素新星回退到泉水
• 受支持的秋季变体可在适当情况下作为反季节备用方案
• 大个子可以在任何赛季使用其支持的视觉

这些回退方案 仅视觉他们不记录出生季节、更改头衔、重掷修正值或改变游戏状态。

功能

每个符合条件的新生物都会记录其出生季节。

季节、出生地环境与自然亲和力决定季节性修正参数。

使用默认的100%门槛和 确保赛季修正 启用后，原本为空的有效掷骰可以使用次要季节回退：

• 冬天： 大
• 春天： 快
• 夏天： 抗火
• 秋日： 警报

星级系统必须仍然接受选定的修饰符。

冬天 — 风息谷仓

寒冷系特质更受青睐：

• 霜冻
• 霜冻抗性
• 大
• 耐力消耗
• 抗性穿透
• 斩击抗性
• 抗钝击
• 以太流失

春 — 要塞之子

春天青睐毒药、适应与奇异突变：

• 中毒
• 元素混沌
• 剧毒新星
• 毒抗
• 快
• 进化中
• 分线器

夏日—— 夏日之子

夏日偏爱高温与强力的元素效果：

• 火焰
• 火焰新星
• 抗火
• 闪电
• 快速
• 残暴
• 大

秋意渐浓 — 豪斯特巴恩

秋季青睐闪电、毒素和灵魂效果：

• 闪电
• 中毒
• 元素混乱
• 噬魂者
• 精神抵抗
• 警报
• 毒抗
• 大

结果是加权计算的，因此并非每个生物都会获得相同的修正值。

季节生物名称

符合条件的新生物会保留其出生季节称号，不受修正结果影响：

• 维特巴恩骷髅
• 灰矮人瓦巴恩
• 德拉乌格·苏玛巴恩
• 灰矮人秋屋

桥不 不 重写StarLevelSystem的修饰符名称。

季节头衔会单独添加到生物悬停名称中。

赛季悬停图标

版本1.4.8在生物悬停名称旁添加了本地季节图标，适用于：

• 冬天
• 春季
• 夏日
• 秋

图标和文本形式的赛季标题是独立控制的。

• 显示赛季称号 — 显示或隐藏 风栖谷仓, 城府之子, 夏日之子 和 家中小孩.
• 显示赛季图标 — 启用或禁用季节性图标。
• 赛季图标尺寸 — 控制本地图标大小。
• 称号.赛季图标间距 — 控制图标与悬停名称文本之间的间距。

例如，这允许仅使用图标的季节性标识，而不带文本后缀。

季节性图标资源为 128×128 的 RGBA PNG 文件图标层仅为本地且仅限外观：它不会写入额外的ZDO状态，不会修改StarLevelSystem修正值，也不会改变网络权限。

截图

下方的巨魔截图仍是当前公开展示。1.4.1版本还包含已完成的灰矮人家族和骷髅的自定义材质。

火焰 — 夏日之子

噬魂者

剧毒 — 瓦尔巴恩

元素混沌

闪电 — 秋之子

霜寒 — 维特巴恩

配置

配置文件：

BepInEx/配置/TheLionCid.SeasonalSLSBridge.cfg

主要设置：

设置	默认	描述
季节抽取概率	100	生成的生物获得季节性修饰符的概率百分比。
延迟秒数	0.75	生成后延迟一段时间再应用赛季修正。
包含已驯服	假	被驯服的生物是否能获得季节性修正。
已应用修正	真	记录成功的季节申请。
确保季节修正	真	用季节性次要后备项填充空的合法卷。
视觉.已启用	真	启用或禁用本地视觉系统。
视觉.纹理过滤	点数	纹理过滤模式。Point保留原版像素细节；Bilinear/Trilinear可用于高清材质包。
显示赛季称号	真	显示或隐藏季节性文本后缀，如Vetrbarn或Haustbarn。
显示赛季图标	真	显示或隐藏悬停名称旁的本地季节图标。
赛季图标尺寸	可配置	控制本地季节图标的大小。
赛季图标间距	可配置	控制图标与悬停名称文本之间的间距。

更新时可保留现有配置，新设置会自动添加。

自定义材质

该视觉包特意设计得轻量且易于编辑。

个人PNG编辑会通过纹理准备流程保留，从而可以在不改变桥接游戏逻辑的情况下构建自定义或高清视觉包。

紧凑包内含有所需的纹理基底及 准备纹理.ps1 以重建可编辑的纹理树。

要求

所需依赖：

• BepInExPack Valheim
• 霜巨人
• YamlDotNet
• 星级系统
• 季节性

明确验证的 StarLevelSystem 版本：

• 1.14.0.0
• 1.15.0.0
• 1.16.0.0
• 1.17.0.0
• 1.18.0.0
• 1.18.1
• 1.18.2

1.18.2 是当前明确验证的 StarLevelSystem 版本。

较新版本在校验的公共 API 合约保持兼容时可能继续正常工作。在这种情况下，Seasonal SLS Bridge 会发出单条启动警告并继续正常运行。

如果所需的 API 契约实际上不兼容或缺失，StarLevelSystem 集成会被安全禁用，并报告一条兼容性警告。

安装

雷区商店

安装 赛季SLS桥 以及其依赖项通过你的模组管理器。

为获得最佳多人游戏体验，请在服务器和客户端使用相同的模组版本和视觉文件。

手动安装

1. 安装所需的依赖项。
2. 放置 SeasonalSLSBridge.dll 在：

BepInEx/plugins/SeasonalSLSBridge/

1. 放置 季节性纹理 DLL 旁的文件夹。
2. 如果使用紧凑纹理包，请运行 准备纹理.ps1 生成可编辑的视觉变体。
3. 移除旧的实验性 纹理测试 如果仍然安装，则为附加组件。
4. 启动英灵神殿。

更新时不会重新随机生成现有生物。

关于1.4.8专门的技术说明和建议验证步骤，请参阅 更新_1.4.8.md.

只有相应的服务器权限才能应用玩法变更。玩家、首领、商人和默认情况下的驯服生物仍不受季节性修正的影响。

兼容性与设计

季节性SLS桥梁旨在成为现有模组之间的桥梁。

确实如此 否:

• 修改StarLevelSystem的内部修正器定义；
• 替换星级系统修正名称；
• 直接编辑生物属性；
• 修改生成率；
• 更改战利品；
• 需要手动编辑StarLevelSystem配置；
• 修改季节性的季节系统；
• 编写网络游戏状态仅用于显示视觉变体；
• 写入ZDO或StarLevelSystem状态仅用于显示季节悬浮图标。

视觉系统为本地装饰性功能。如果无法加载支持的纹理，游戏应继续以正常生物外观运行。

稳定性

季节性SLS桥接会在启用集成前，验证其实际需要的公共StarLevelSystem API。

对于 星级系统 1.18.2，兼容性已明确验证。

对于未来版本：

• 若所需的公共API契约保持兼容，桥接器将通过委托绑定已验证的函数，对未验证的较新版本发出一次启动警告，然后继续运行；
• 如果所需功能缺失或不兼容，星阶系统集成将被安全禁用，并报告该问题。

桥接不会仅仅为了强行兼容而尝试不安全的内部修改。生物存储的季节身份与修饰符应用成功与否保持独立。

支持、反馈与贡献

社区 Discord 链接在此 README 顶部附近。欢迎贡献和反馈，尤其是来自经验丰富的 Valheim/BepInEx 模组作者和纹理美术师。

AI辅助开发

本模组开发的重要部分，包括代码生成、调试、编译协助、测试和故障排除，均借助了AI完成。

作者， 狮子西德，并非一位经验丰富的英灵神殿模组开发者，公开发布此项目是为了让更有经验的模组制作者能够审查它、发现问题并帮助改进。

欢迎提供反馈、错误报告和代码改进建议。

权限

您可以在尊重本项目及其依赖项的许可和署名前提下，自行改编或修改本项目以供个人使用。

不要将他人的作品作为自己的作品重新分发。

制作人员

• 狮子西德 — 季节性SLS桥
• 午夜模组 — 星级系统
• 锈蚀模组 — 季节性
• 瓦尔海姆模组 — 巨人族与YamlDotNet
• BepInEx / 英灵神殿模组社区 —模组框架与生态系统

免责声明

这是一个独立的兼容性桥接模组。它并非StarLevelSystem或Seasonality的官方组件。

Valheim、StarLevelSystem 或 Seasonality 的更新可能需要更新桥梁。