ValheimDBDumper
Valheim DB Dumper is a powerful mod that extracts comprehensive game data into structured JSON files and prefabs. The tool includes a built-in interactive web dashboard to browse and filter all export
模組介紹 作者原文
🗑 Valheim DB Dumper
Valheim DB Dumper is a powerful mod designed to extract and dump internal game database structures, 3D models, textures, and prefabs directly from Valheim into your local file system.
Whether you are a modder, wiki maintainer, or data enthusiast, this tool provides a comprehensive pipeline to extract game assets effortlessly, paired with an out-of-the-box interactive web dashboard to browse your data.
🚀 Features
- Deep Data Extraction: Exports detailed metadata for items, creatures, crafting recipes, pickable resources, and building pieces.
- Asset Dumping: Automatically extracts 3D meshes (.obj), skin textures (.png), and cropped UI icons from texture atlases.
- Prefab Hierarchies: Serializes complete GameObject transform and component hierarchies into readable JSON files.
- Interactive Web Dashboard: Generates a responsive HTML front-end to navigate, search, and filter your exported data locally or via a web host.
- Highly Configurable: Control exactly what gets dumped using command-line modifiers to skip heavy processes like 3D model baking or icon rendering.
🛠️ Installation
- Ensure you have BepInEx installed for Valheim.
- Download the latest release of Valheim DB Dumper.
- Place the ValheimDBDumper.dll into your BepInEx/plugins folder.
- Launch the game. The mod will automatically generate a configuration file located at BepInEx/config/n1h1lius.valheimdbdumper.cfg.
💻 Usage & Console Commands
To use the dumper, you must be loaded into a world with your character (the game database needs to be fully initialized in memory).
Open the in-game console (usually F5) and use the following command structure:
dumpdb [modifiers]
Available Categories
| Category | Description |
| --- | --- |
| all | Exports absolutely all database structures and assets. |
| recipes | Exports manufacturing recipes and crafting requirements exclusively. |
| items | Exports weapons, armor, tools, and material data. |
| pieces | Exports building structures, furniture, and crafting stations. |
| creatures | Exports animals, monsters, boss data, and drop tables. |
| pickables | Exports wild spawns, plants, and ground resource nodes. |
Optional Modifiers
You can append modifiers to skip specific extraction pipelines to save time and processing power:
| Modifier | Effect |
| --- | --- |
| --no-icon | Bypasses texture atlas rendering and PNG extraction completely. |
| --no-json | Skips data mapping and JSON metadata generation. |
| --no-prefab | Skips prefab hierarchy mapping and JSON generation. |
| --no-model3d | Skips 3D model baking (.obj) and skin texture mapping completely. |
Example Command:
dumpdb pickables --no-icon --no-model3d
📊 The Interactive Web Dashboard
When you run an export, the mod automatically extracts two utility files into your designated export folder (default is Desktop/ValheimDB_Export): an index.html file and a start_server.bat file.
This front-end dashboard allows you to visually browse, search, and filter the JSON databases you just exported.
How to View the Dashboard
Due to standard browser security policies (CORS), opening the index.html file directly by double-clicking it will block the JSON data from loading locally. To view your data, you have two options:
Option A: Local Viewing (Recommended & Fastest)
- Navigate to your export folder.
- Double-click the generated start_server.bat file.
- This script spins up a local live server and automatically opens the dashboard in your default browser at
- Requirement: You must have Python installed on your system for the.bat file to work. If you do not have Python installed, you can download it from the Official Python Website.
Option B: Web Hosting
- Upload the entire contents of your export folder (the HTML file, along with the data, icons, models, prefabs, and textures folders) to any standard web host or local web server software (like XAMPP or Nginx).
- Access it via your server's URL. No Python required for th
安裝與使用 安裝:BepInEx 外掛
- 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
- 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
- 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
- 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。
帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。 多人連線時,主機與所有用戶端需要安裝一致的模組。