约顿巨人，瓦尔海姆图书馆

约顿巨人（/ˈjɔːtʊn/，“巨人”），Valheim库的创建旨在促进开发者的创造力，统一社区解决问题的努力，并通过整理常用辅助工具库来提高开发者的生产力。此外，它提供了特定的接口和抽象层，有助于模组互操作性、联机游戏一致性，并作为开发者与游戏内部变动之间的接口，免去了维护特定Valheim版本代码的需要。

该项目最初源自以下基础结构： 约顿海姆库，并拥有许多实体抽象和特性，来自 英灵神殿库 在我们继续后续实现之前，已将其合并。我们未来规划了许多功能，也希望社区能踊跃提出功能建议。我希望目前已实现的功能能够成为一个有用的基础，并让大家了解我们今后力求保持的一致性。

用途

请参阅我们的 文档我们已不遗余力地确保提供充足的文档，以促进开发者的学习体验。

安装

如果你使用的是模组安装器，你可以忽略这一部分。
如需更详细的安装指南，请查看 手动安装指南 在我们的文档中。
不过，这里有个快速概述：

1. 安装 BepInEx：
   下载 BepInEx，提取其中所有内容 BepInEx_Valheim 到你的英灵神殿文件夹中（通常 C:\<你的Steam库路径>\steamapps\common\Valheim)

2. 安装Jötunn：
   从以下任一位置下载 奈克萨斯 / 雷霆商店，解压ZIP并将所有内容放入 BepInEx/plugins/Jotunn 你的英灵神殿安装目录中。

就这样，启动游戏，尽情改装吧！

功能

JVL提供三组各具特色的功能。实体，将游戏自身的实体抽象为易于使用的接口。管理器，充当实体与原生集合或子系统之间的接口。实用工具，用于协助可跨越许多不同领域的通用/常见功能。

实体

• 自定义生物 - 代表自定义动物、敌人和NPC。
• 自定义物品 - 表示游戏内物品，如武器、工具和消耗品。
• 自定义物品转换 - 将烹饪台、发酵桶、熔炉和焚化炉的游戏内物品转换统一抽象表示。
• 自定义本地化 - 表示你的模组的自定义本地化内容。
• 自定义位置 - 代表从简单的石圈到完整村庄的自定义地点。
• 自定义棋子 - 代表游戏内建筑部件。
• 自定义部件表 - 代表游戏内建筑表格。支持自定义类别。
• 自定义配方 - 代表游戏内配方，用于管理物品的制作与升级。
• 自定义状态效果 - 表示游戏内状态效果，涵盖武器命中效果与守护者能力。
• 自定义植被 - 代表植被在各生物群系中的分布，从可采集物到装饰品。
• 拼装对象 - 表示由其他各种预制件的组件组装而成的自定义对象。
• 嘲讽 - 伪造任意原版预制体，并将其用于你的自定义资源——Jötunn 会在运行时解析对原版对象的引用。
• 配置类 - 除了主要实体之外，还有许多其他抽象，可以轻松创建按键绑定、自定义命令、技能等内容。

经理

• 命令管理器 - 便于实现可注册为可执行控制台命令的方法。
• 生物管理器 - 添加新生物或复制并修改原版生物。
• 图形界面管理器 - 允许通过代码动态调用UI预制体。
• 输入管理器 - 提供一个通过 ZInput 以一致方式绑定按键的接口，便于自定义按键提示。
• 物品管理器 抽象化应用于物品/配方的配置实现细节，为添加新物品提供一致的开发体验。简而言之，物品很简单！
• 套件拼装管理器 - 使用原生预制件中的各个部件创建自定义资产。
• 按键提示管理器 - 为你的武器和工具创建自定义按键提示，甚至可以精确到所选的部件。
• 本地化经理 - 提供多种将本地化数据加载到游戏中的方法，并公开一个接口用于添加额外语言，以便为不支持的语言提供本地化。
• 小地图管理器 - 修改地图数据或为地图创建叠加层。
• 部件管理器 - 与物品管理器非常相似，抽象了碎片/配方的配置实现细节。
• 预制体管理器 - 提供由其他管理器注册的预制体缓存，大多数开发者只会通过其他管理器查询已添加的预制体缓存。
• 渲染管理器 - 提供自定义渲染队列，将可见游戏对象渲染为精灵图 - 可用于为自定义物品生成图标。
• 技能管理器 - 支持额外的自定义技能。
• 撤销管理器 - 为模组提供全局撤销/重做队列，以便还原和重放游戏中的任何操作。
• 区域管理 - 创建自定义地点和植被，以添加到世界生成中。

功能

• 资产助手 - 便于引用和加载资源的方法。
• 骸骨重排器 修复骨骼排序问题： 蒙皮网格渲染器那些被提取并导入到Unity中的。
• 网络兼容性 - 允许插件为连接到服务器的客户端定义各自的版本要求。基于每个插件，确保与不同模组配置的客户端之间具有可自定义程度的互操作性。
• 配置同步 - 允许管理员通过游戏内菜单调整配置值。配置设置会同步到已连接的客户端。
• 模组注册表 - 按模组查询新增内容。
• 简单JSON - 应开发者要求，我们已将 SimpleJSON 导入到我们的库中，他们更希望已经处理好这个依赖项。我们使用的是 MIT 许可的 简单JSON

Bug反馈、技术支持、贡献者

请参阅我们的 文档 请求前 通过 Discord 获取支持如果有任何模组互操作性问题（不仅仅是JVL独占的问题）被开发者遇到，我们希望听到你的反馈！如果我们能通过提供通用接口或暴露原生英灵神殿对象（包括你创建的实用工具）来促进更好的模组互操作性，那么请随时创建一个新的 功能请求 或 拉取请求.

路线图

查看我们的 项目 如需查看当前正在开发的功能的更新列表，或想通过创建新主题来建议加入您自己的功能 功能请求

更新日志

查看完整 更新日志.

Jötunn（Valheim 库）贡献者

这些人对推动JVL走出困境至关重要，没有他们，我们不可能取得如此成就。请在GitHub、Thunderstore和Nexus上多多支持他们。

核心：

朱尔斯#7950: GitHub

Margmas#9562: GitHub, 雷鸣商店, 联结

iDeathHD#7866: GitHub, 雷霆商店

算法师#6741: GitHub

奎萨#5604: github

拉杜#0571: GitHub, 雷暴商店, 奈克瑟斯

帕迪#1337: GitHub, 雷霆商店

贡献者：

桂皮卷#0451: GitHub

金裘德#8965: GitHub, 奈克瑟斯

扎尔博兹#7828: GitHub, 雷霆商店, 联结

MarcoPogo#6095: GitHub, 联结

blaxxun#9098: GitHub

特克拉#1012: GitHub

乔伊帕里什#8644: GitHub, 雷商店, 奈克萨斯

诺西罗姆#2626: GitHub

杰雷#0989: GitHub, 雷暴商店, 联结

希瑞卡: GitHub, 雷霆商店

奥莉安娜冒险: GitHub, 雷暴商店