THE EYE

Valheim Deep API Scanner, Metadata Extractor, and ML Diff-er

Version 2.0.0

---

❤️ Support Development

If you find The Eye useful and want to support continued development, you can donate here:

👉 https://www.patreon.com/c/WubarrkDev

Your support helps keep Valheim tooling alive and evolving.

---

📖 Overview

The Eye is a deterministic, cross‑platform API extraction tool for Valheim.
It generates a complete, reflection‑grade snapshot of the game’s types, methods, fields, prefabs, ZDOs, and runtime metadata.

With the massive 2.0.0 Total Tool Overhaul, The Eye has been completely rebuilt from the ground up. Say goodbye to game freezes during dumps—the engine now uses asynchronous co-routines to stream data seamlessly. We've introduced a dedicated in-game HUD to control your pipelines, dynamic memory configuration profiles, and a powerful state-differencing engine called Huginn's Report.

This tool is designed for:

• Mod developers & Tool authors
• Artificial Intelligence / Machine Learning Coding Agents
• DLL stub generators & Prefab explorers
• Gameplay researchers
• Anyone who needs a stable, accurate view of Valheim’s internal API

The Eye is safe, structured, and future‑proof and may prove very useful for when Valheim v1.0 drops!

---

✨ Features

✔ Full Type & API Extraction

The Eye scans every loaded assembly and extracts Namespaces, Types, Base types, Fields, Properties, Methods, and Nested types.

✔ Prefab & Scene Registry

Generates a complete list of all active GameObjects, including PrefabHashes, component lists, and live scene instantiations.

✔ Async Co-Routines (No More Freezing)

The entire dump engine has been ported to asynchronous, threaded co-routines. You can now execute massive, multi-gigabyte memory dumps without your game client locking up or freezing.

✔ In-Game HUD Controls - Hit F8!

Manage your dumps directly from within Valheim. The Eye now features a native UI panel (EyeUIManager) allowing you to trigger pipelines, monitor progress, and configure the tool without tabbing out. Just Hit F8 to toggle the HUD! Which is draggable.

✔ Dynamic Memory Configurations

Optimize the tool for your rig. You can now select from multiple memory configuration profiles (e.g., Rig_32GB, Rig_64GB_Plus) inside wubarrk.theeye.cfg to optimize chunk sizes and differencing loads based on your available RAM.

✔ Huginn's Report (State Diff-er)

The Eye can compare your most recent memory dump against a baseline, generating a comprehensive Diff Report. Catch silent assembly injections, track microscopic Unity component changes, and map mod insertions effortlessly.

✔ Ghost ZDO Protection

Hooks directly into ZNetScene to bypass aggressive culling, forcing global ZDO existence so your memory dumps never miss an object outside the active player area.

✔ ML-Optimized Pipelines

While you can output standard HR (Human-Readable) JSON dumps, The Eye also features an ML configuration that packages everything into a massive JSON Lines (.jsonl) zipped flat-file. This is the gold standard for LLMs and AI Agents, eliminating token bloat and preventing nested parsing errors.

---

📂 Output Structure

The Eye creates time-stamped directories under: BepInEx/config/WubarrksEye_Dumps/

Depending on your configuration, a single dump will yield:

• API_Dump.json / Prefabs_Dump.json / Scene_Dump.json / ZDO_Dump.json (HR Format)
• AgentML_Complete_Dump.zip (ML Format)
• Huginn_Diff_Report.json(l) (If a previous baseline exists)

---

🧰 Use Cases

• Mod development & API mapping
• Supplying context to Agentic AI coding assistants
• DLL stub generation
• Catching rogue assembly injections
• API diffing across Valheim updates

---

🧱 Design Principles

Deterministic by Design

The Eye guarantees stable ordering, stable formatting, and stable block structure.

---

INSTRUCTIONS

You can trigger dumps and control settings using the new In-Game HUD Panel, or run the following command in the Valheim developer console or BepInEx terminal: dump_eye

You can customize the dump behaviors (HR vs ML, memory profiles, differ targets) in the generated wubarrk.theeye.cfg file.

---

❓ Troubleshooting

No Dumps folder?

Check your Plugin path, BepInEx version, and Game version.

Missing types?

Some assemblies load lazily. Enter a world to force more types to load.

Huginn's Diff Report is empty?

Make sure you are diffing the same format. If you change your config from HR to ML, Huginn won't diff an ML zip against an HR json file. Run another dump of the same type to establish a new baseline!

---

🙏 Credits

🛠 Lead Developer: Wubarrk — The Mad Architect of the Deep
🤖 Technical Assistant: Antigravity — The Tireless Code Goblin

🧪 Community Inspiration: Thanks to the Valheim modding community for stress-testing early builds and encouraging the madness.

📜 License

MIT License

Copyright (c) 2026 Ross G.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.