Skip to content

DezLife/RustMapViewer

Repository files navigation

RustMapViewer

Turns a Rust (Facepunch) .map file into a 3D viewer you can open in a browser. It reads the map format and the game's asset bundles directly, so there's no server and no dependency on any mod framework.

RustMapViewer

Open the live demo → — a real map running in your browser, nothing to install.

Download

Grab the latest Windows build from the releases page — a single RustMapViewer.exe with everything baked in. No .NET install, no extra files to keep around.

What you get

Point it at a .map and it writes a single self-contained .html with:

  • the full-resolution terrain painted with the game's own ground textures;
  • rivers, lakes and the ocean, with depth and shorelines;
  • roads and rails using their real in-game textures;
  • every monument marked on the map (hover to see its name, tier and whether it's a safe zone, click to fly there) and listed in the side panel;
  • build-zone and safe-zone toggles that paint each monument's real no-build (red) and safe (green) areas on the ground;
  • biome toggles that light up a whole biome at once;
  • a free-look fly camera and a click-to-read coordinate tool.

Usage

Drag a .map file onto RustMapViewer.exe, or run it from a terminal:

RustMapViewer.exe procgen4250.map

It creates procgen4250.viewer.html right next to the map. Open that file in any browser and you're done. (It loads three.js from a CDN, so the first open needs an internet connection.)

A couple of optional flags:

RustMapViewer.exe procgen4250.map --html out.html   # choose where to save the viewer
RustMapViewer.exe procgen4250.map --viewres 2049     # lighter file, lower terrain detail (default 4097)

Building from source

If you'd rather build it yourself, install the .NET 10 SDK and run from the project folder:

dotnet run -c Release -- procgen4250.map

Here -c Release is the build configuration and the -- just separates the build flags from the map path handed to the program. Same flags as above apply after it.

Assets

The textures under detail/ and the monument data in data/ are extracted from the game and remain the property of Facepunch Studios. They're bundled here only so the viewer looks right out of the box and are not covered by this project's license. Rust is a trademark of Facepunch Studios; this project is unofficial and not affiliated with or endorsed by them.


Made by DezLife.

About

Turn a Rust (Facepunch) .map file into a self-contained 3D web viewer — no server, no game needed

Topics

Resources

License

Stars

2 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors