Skip to content
This repository was archived by the owner on Feb 19, 2026. It is now read-only.

denukernel/SM64DecompLevelViewer

Repository files navigation

SM64 Decomp Level Viewer

A powerful and modern C#/.NET 8 levels viewer for Super Mario 64 Decompilation projects. This tool allows you to visualize levels, collision data, and object placement (including macro and special objects) directly from your decomp repository.

Feature Preview

Key Features

  • 3D Level Rendering: High-performance visualization of level geometry using OpenTK.
  • Collision Mesh Support: Parse and view collision.inc.c data with vertex and triangle counts.
  • Full Object Support:
    • Standard Objects: Parsed from level scripts (script.c).
    • Macro Objects: Automatic parsing of macro.inc.c and preset resolution.
    • Special Objects: Extraction of trees, signs, and other modular pieces directly from collision data.
  • Dynamic Project Selection: 100% portable. Select any SM64 decomp root folder and the viewer handles the rest.
  • Advanced Parsing: Intelligent regex-based parsers that handle C-style comments, variable whitespace, and complex macro formats (OBJECT_WITH_ACTS, MARIO_POS, etc.).
  • Modern UI: Clean WPF-based interface with glassmorphism aesthetics and dark mode support.

Getting Started

Prerequisites

Installation & Usage

  1. Clone the repository:
    git clone https://github.com/User/Sm64DecompLevelViewer.git
  2. Build and run the project using Visual Studio or the .NET CLI:
    dotnet run
  3. Click on "Select SM64 Project Folder" and navigate to your SM64 decomp root.
  4. Select a level from the list on the left to view its details.
  5. Click "View 3D" to launch the interactive viewer.

Controls (3D Viewer)

  • WASD: Move camera
  • QE: Ascend/Descend
  • Mouse: Rotate camera
  • Left Click: Select objects for detailed information

Technical Stack

  • C# / .NET 8
  • WPF (Windows Presentation Foundation)
  • OpenTK (OpenGL bindings)
  • YamlDotNet (Level metadata parsing)

Contributing

Contributions are welcome! Please feel free to submit a Pull Request or open an Issue.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Known Bugs

  • Some levels like Inside Castle has no visual at all.
  • Sometimes the GUI doesn't close.
  • 3D Viewer has some screen bugs sometimes
  • Some things might be unfinished.

About

An Level Viewer for SM64 Decomp Projects.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages