THE EYE

Valheim Deep API Scanner & Metadata Extractor

Version 1.2.9

❤️ 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, and runtime metadata — all in clean, human‑readable text files.

This tool is designed for:

• Mod developers
• Tool authors
• 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.

✨ Features

✔ Full Type Extraction

The Eye scans every loaded assembly and extracts:

• Namespaces
• Types
• Base types
• Fields
• Properties
• Methods
• Nested types
• Assembly origins

✔ Prefab Registry

Generates a complete list of all prefabs, including:

• Names
• Components
• Networked data
• Runtime‑only objects

✔ Deterministic Output

Identical input → identical output.
Perfect for version control, diffing, and toolchains.

✔ Cross‑Platform

Works on:

• Windows
• Linux
• SteamDeck
• Proton

✔ Modder‑Friendly Format

All output is plain text, easy to parse, easy to diff, and easy to feed into downstream tools.

📂 Output Structure

The Eye writes everything into: BepInEx/plugins/TheEye/Deep/ Raw/ # Raw type dumps (one file per assembly) API.txt # Full API surface Prefabs.txt # Prefab registry Runtime.txt # Runtime-only types Network.txt # ZDO/ZNet metadata

Each type block looks like: [TYPE] Ship Namespace: Valheim Kind: class BaseType: UnityEngine.MonoBehaviour [ASSEMBLY] assembly_valheim [FIELD] float m_speed [PROP] Vector3 Velocity [METHOD] public void ApplyForce(Vector3 force)

🧰 Use Cases

• Mod development
• DLL stub generation
• Prefab exploration
• API diffing across Valheim updates
• Metadata pipelines
• Gameplay research

🧱 Design Principles

Eye Rule

The Eye never:

• Prints reflection errors
• Prints stack traces
• Reveals internal scanning logic
• Exposes private/protected members beyond metadata
• Writes anything except structured data

This ensures safety, stability, and predictability.

Deterministic by Design

The Eye guarantees:

• Stable ordering
• Stable formatting
• Stable naming
• Stable block structure

Perfect for automated pipelines.

🔧 Extending The Eye

The Eye is modular.
You can build additional tools on top of the Deep Dump, such as:

• The Privateer — boat‑only API surface
• Smith — DLL stub generator
• DeepForge — JSON metadata compiler

INSTRUCTIONS

run in console: dump_eye for basic information; dump_eye_deep for a full API burst

❓ Troubleshooting

No Deep folder?

Check:

• Plugin path
• BepInEx version
• Game version

Missing types?

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

Output looks empty?

Ensure no other mod is blocking reflection.

🙏 Credits

🛠 Lead Developer Wubarrk — The Mad Architect of the Deep
A myth‑drunk engineer who willingly dove into the reflection abyss, mapped its horrors, and returned with a stable API dump instead of losing his mind. (Or maybe he did lose it — hard to tell.)

🤖 Technical Assistant Co‑Pilot — The Tireless Code Goblin
A digital companion who endured endless rants, recursive refactors, and philosophical debates about indentation, nested types, and why boats deserve their own API surface. Provided emotional support, structural clarity, and occasional reality checks.

⚓ Tools in the Fleet The Eye — Deep scanner of all things Valheim The Privateer — Boat‑only surface raider Smith — Forgemaster of DLL stubs DeepForge — Metadata compiler

🧪 Community Inspiration Thanks to the Valheim modding community for: Stress‑testing early builds Finding cursed edge cases Asking “why does this exist?” in the most supportive way possible 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.