Valheim数据库导出器是一个强大的模组，可将全面的游戏数据提取为结构化的JSON文件和预制体。该工具包含一个内置的交互式网页面板，可在本地浏览和筛选所有导出的资源与元数据。

🗑 英灵神殿数据库导出工具

英灵神殿数据库导出器 是一款强大的模组，旨在从英灵神殿中直接提取并导出内部游戏数据库结构、3D模型、纹理和预制体到你的本地文件系统。

无论你是模组开发者、Wiki维护者还是数据爱好者，这款工具都提供了一套完整的流水线，让你轻松提取游戏资源，并配有开箱即用的交互式网页仪表板，方便你浏览数据。

---

🚀 功能

• 深度数据提取：导出物品、生物、制作配方、可采集资源和建筑部件的详细元数据。
• 资源转储: 自动提取3D网格（.obj), 皮肤纹理 (.png），以及从纹理图集中裁剪出的UI图标。
• 预制体层级将完整的游戏对象变换和组件层级序列化为可读的JSON文件。
• 交互式网页仪表板生成一个响应式HTML前端，用于在本地或通过网络主机浏览、搜索和筛选您导出的数据。
• 高度可配置：通过命令行修饰符精确控制导出内容，跳过3D模型烘焙或图标渲染等重型进程。

---

🛠️ 安装

1. 确保你拥有 BepInEx 已为英灵神殿安装。
2. 下载最新版本的 英灵神殿数据库导出器.
3. 放置 瓦尔海姆数据库转储器.dll 进入你的 BepInEx/plugins 文件夹。
4. 启动游戏。模组将自动生成一个配置文件，位于 BepInEx/config/n1h1lius.valheimdbdumper.cfg.

---

💻 使用与控制台命令

要使用提取器，你需要 必须载入有你角色的世界 （游戏数据库需要在内存中完全初始化）。

打开游戏内控制台（通常 F5）并使用以下命令结构：

导出数据库 <分类> [修饰符]

可用类别

类别	描述
全部	导出所有数据库结构和资源。
配方	仅导出制造配方和制作需求。
物品	导出武器、护甲、工具和材料数据。
碎片	出口建筑结构、家具和制作站。
生物	导出动物、怪物、首领数据以及掉落表。
可拾取物品	导出野生生物、植物和地面资源节点。

可选修正符

你可以附加修饰符来跳过特定的提取流程，从而节省时间和处理能力：

修饰符	效果
--no-icon	完全绕过纹理图集渲染和PNG提取。
--no-json	跳过数据映射和JSON元数据生成。
无预制体	跳过预制体层级映射和 JSON 生成。
--no-model3d	跳过3D模型烘焙（.obj) 且皮肤纹理映射完全。

示例命令： 导出可拾取物数据库 无图标 无三维模型

---

📊 交互式网页仪表板

当你运行导出时，模组会自动将两个实用文件提取到你指定的导出文件夹中（默认为 桌面/ValheimDB_导出：一个 index.html 文件和 启动服务器.bat 文件。

这个前端仪表板让你可以直观地浏览、搜索和筛选你刚刚导出的JSON数据库。

如何查看仪表盘

由于标准浏览器安全策略（CORS），打开 index.html 直接双击文件会阻止JSON数据在本地加载。要查看数据，您有两种选择：

选项A：本地观看（推荐且最快）

1. 前往你的导出文件夹。
2. 双击生成的 启动服务器.bat 文件。
3. 此脚本会启动一个本地实时服务器，并自动在您的默认浏览器中打开仪表板，网址为 http://localhost:8000.
4. 需求： 你必须拥有 派森 已安装到你的系统中，用于 .bat 工作所需的文件。如果你没有安装Python，可以从以下网址下载： Python官方网站.

选项B：网站托管

1. 上传你导出文件夹的全部内容（即那个HTML文件，以及 数据, 图标, 模型, 预制件，以及 纹理 文件夹）上传到任何标准 Web 主机或本地 Web 服务器软件（如 XAMPP 或 Nginx）。
2. 通过服务器的URL访问它。此方法无需Python。

---

📁 导出的数据结构

完整转储完成后，你的导出目录将按如下方式组织：

• /data/：包含分类后的JSON元数据（例如， 生物.json, items.json) 映射属性、掉落和需求。
• /icons/: 包含 .png 从游戏精灵图集中直接裁剪出的UI物品栏图标文件。
• /prefabs/：包含 .json 详细说明每个游戏对象的确切变换层级和附加组件的文件。
• /models/: 包含烘焙的3D网格，位于 .obj 格式化。
• 纹理/：包含主要皮肤/材质纹理（主纹理) 供3D模型使用。
• **index.html & 启动服务器.bat**：Web应用程序和服务器启动器。

---

⚙️ 配置

导出行为可在 n1h1lius.valheimdbdumper.cfg 由BepInEx生成的文件：

• 导出文件夹：转储文件将保存到的绝对路径。默认情况下，它会创建一个 瓦尔海姆数据库导出 桌面上的文件夹。
• 调试模式：为开发目的启用扩展调试日志记录。
• 输出日志切换内部日志文件的生成。日志记录使用自定义的颜色编码内部系统，映射文件、方法和堆栈跟踪。

---

🤝 贡献与支持

• 发现漏洞了？ 打开一个 问题.
• 想帮忙吗？ 欢迎提交拉取请求！
• 支持项目： 如果这个模组帮助了你或你的社区，不妨考虑 请我喝杯咖啡.

---

由☕和⚡构建，作者是 n1h1lius