ValheimLoading...TheEye1.2.8

You are viewing a potentially older version of this package. View Latest Version

Install

Date Uploaded

6 months ago

Downloads

155

Size

148KB

Dependency string

Wubarrk-TheEye-1.2.8

Download

Details Required (1)Versions

THE EYE

Valheim Deep API Scanner & Metadata Extractor

Version 1.0.0

❤️ Support Development

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

👉 https://ko-fi.com/YOURNAME

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
Wonderland — runtime inspector

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

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.