mun1nm/viso-mod

Viso-Mod is a two-part tool for taking a piece of a Minecraft world and viewing it as a 3D model in a web browser. The first part is a mod for Fabric, a popular Minecraft modding platform, and the second part is a viewer that runs entirely on a webpage using Three.js, a JavaScript library for 3D graphics. Exporting a build starts inside the game itself. A player picks up an Export Wand from their creative inventory, left-clicks one corner of the area they want to capture and right-clicks the opposite corner, then types a chat command with a name for the export. The mod saves everything in that region, including blocks, textures, block states, and more complex objects like chests, skulls, banners, and copper golems, into a single compressed file. It also captures details like the color tint from a biome, the glow level of redstone, the flow direction of water, and the dye color on banners, so the exported model looks like the original. For debugging, a second command saves the same data as a plain, uncompressed file instead. Viewing an export does not require installing anything. A hosted web page lets a user drag and drop the exported file straight into the browser, where it renders as a true isometric view, the classic angled look used in strategy games, that can be rotated in 90 degree steps. A slider lets a user slice through the structure layer by layer to look inside it, which is useful for inspecting the interior of a build. The viewer only renders one copy of each identical block internally rather than a full model for every block, and it skips blocks that are fully hidden inside the structure, which keeps the frame rate high even on large builds. Hovering over any block also shows its identifier, coordinates, and other properties. The project is split into two folders, one for the mod's source code and one for the web viewer's source code, each with its own separate setup instructions for anyone who wants to build or run the code locally instead of using the hosted release. It is released under the MIT license and is aimed at Minecraft players and builders who want to show off or study their creations outside the game.