> ## 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.

# Features

# Features and Limitations

Blockscope is a headless Rust image-rendering engine that turns
Minecraft `.litematic` projections into PNG images. It is designed for general
backend services, batch tools, and automation pipelines.

The current workspace version is `0.2.0` and supports Windows, Linux, and macOS. The
repository contains parsing, materials, meshing, CPU rasterization, a CLI, and a
stdio service. It does not contain a chat-platform or bot adapter.

## Features

* Parse `.litematic` v1-v7: metadata, regions, palettes, packed block states,
  block entities, entities, and pending ticks
* Build a canonical Scene IR, material statistics, diagnostics, deterministic
  manifests, and SHA-256 hashes
* Built-in color catalog for common blocks, partial shapes, and fluids without
  a resource pack
* Resource packs: blockstates, models, parent chains, multipart, UVs, rotation,
  tint, cutout/translucent layers, PNG textures, and overlays
* Built-in chest body/lid/lock model and entity textures
* Mesh export: OBJ and colored PLY
* CPU orthographic camera, tiled rasterization, `flat-v1` / `simple-ao-v1`
  lighting, and PNG output
* Supersampling 1-4, multi-view output, parallel tiles, and paged streaming
* LOD with a fixed `2..=16` factor or `auto`
* `serve` worker and `supervise` process pool over newline-delimited JSON
* Capacity detection, memory budgets, mesh/render limits, and stable error codes
* Golden manifest/PNG, concurrency, and protocol tests

## Current Limitations

* No chat-platform or bot adapter; this repository provides only the renderer
  and stdio protocol
* No general entity models, entity animations, block-entity text/icons, banner
  patterns, or skull skins
* Tint is a fixed plains color; biome colormaps are not read
* No shadows, full light propagation, emissive bloom, or mipmaps
* LOD drops block entities, entities, and pending ticks
* Resource packs, client jars, and private `.litematic` files are not committed
* No network listener; `serve`/`supervise` communicate over stdio only

## Next

* [Installation and Quick Start](https://blockscope.linvin.net/user/en/getting-started.md)
* [CLI Reference](https://blockscope.linvin.net/user/en/cli.md)
* [Limits and Security](https://blockscope.linvin.net/user/en/limits.md)
* [中文](https://blockscope.linvin.net/user/features.md)


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