> ## Documentation Index
> Fetch the complete documentation index at: https://blockscope.linvin.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Blockscope Documentation

> High-performance Minecraft .litematic schematic parser, mesh generator, and CPU software rasterizer

## Welcome to Blockscope

**Blockscope** is an offline, standalone Minecraft schematic inspection and rendering engine written in Rust. It turns `.litematic` files into Scene IR, generates color-block or textured meshes (OBJ/PLY), and produces orthographic preview PNGs on the CPU without requiring a GPU or a running Minecraft client.

> **[Quick Start](https://blockscope.linvin.net/user/en/getting-started.md)**
>
> Install prebuilt binaries and render your first schematic in seconds.

> **[CLI Reference](https://blockscope.linvin.net/user/en/cli.md)**
>
> Explore commands for inspecting, validating, meshing, and rendering.

> **[用户指南 (中文)](https://blockscope.linvin.net/user/getting-started.md)**
>
> 面向部署者与开发者的完整中文指南与操作参考。

> **[Technical Specs](https://blockscope.linvin.net/rendering.md)**
>
> Deep-dive into CPU rasterization, mesh geometry, and the stdio protocol.

## Core Capabilities

**1. 1. Container Parsing (Phase 1)**

Streaming, memory-bounded NBT reader capable of parsing `.litematic` files (v1 through v7). Reconstructs region hierarchy, resolves palettes, and normalizes block states into a queryable `Scene`.

**2. 2. Mesh Geometry (Phase 2)**

Paginates scene geometry into 16³ voxel chunks with automatic face culling, smooth ambient occlusion (AO), and quad deduplication. Exports to standard Wavefront OBJ and Stanford PLY.

**3. 3. CPU Rasterization (Phase 3)**

Custom software rasterizer rendering anti-aliased orthographic previews to RGBA PNG. Supports both built-in color-block palettes and official Java resource-pack textures without GPU dependencies.

**4. 4. Service Protocol (Phase 4)**

Single-job worker isolation with stdio JSONL wire protocol (`serve` / `supervise`), supervisor process management, and predictable error handling.

## Navigation

* **User Guide (EN)**: Comprehensive guides for installation, CLI flags, resource packs, LOD, Docker, and service mode.
* **用户指南**: 完整的中文使用指南与排查手册。
* **Technical Specs**: Deep dive documentation covering rendering mathematics, mesh formats, engine protocols, and deployment assets.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.