Metadata-Version: 2.1
Name: CraftSlicer
Version: 2.0
Summary: A portal from reality to Minecraft
Home-page: https://github.com/ThatAquarel/CraftSlicer
Author: Aquarel
Author-email: flyingrobot910@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Win32 (MS Windows)
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.9
Classifier: Operating System :: OS Independent
Classifier: Topic :: Games/Entertainment
Description-Content-Type: text/markdown
Requires-Dist: numpy
Requires-Dist: numpy-stl
Requires-Dist: pyrr
Requires-Dist: PyQt5
Requires-Dist: Pillow
Requires-Dist: nbt
Requires-Dist: trimesh
Requires-Dist: qdarkstyle
Requires-Dist: setuptools
Requires-Dist: PyOpenGl

# CraftSlicer

<p>
<a href="https://github.com/badges/shields/graphs/contributors">
        <img src="https://img.shields.io/badge/version-2.0-brightgreen" alt="version 2.0"/>
        <img src="https://img.shields.io/github/license/ThatAquarel/CraftSlicer" alt="licence MIT"/>
</a>
</p>

CraftSlicer is a pure python application to import 3D objects into your Minecraft world. Models and scans in the .stl
format can be converted into blocks, and then colored using reference images. At the press of a button, they can open in
your game directly, or be converted into a format compatible with
the [Litematica mod](https://github.com/maruohon/litematic).

## Demo

Insert video here

## Installation

The current version (2.0) only supports MS Windows, though macOS and Linux distributions will be in the future.

#### Windows

Download the latest Python interpreter (version 3.9.x) via the [Python website](https://www.python.org/downloads/).
During the installation process, make sure to check the option `Add Python 3.9.x to PATH`. To install and open
CraftSlicer, run the following commands in a command prompt:

```shell
py -3.9 -m pip install CraftSlicer
py -3.9 -m craftslicer
```

For the converted models to open directly in your world, download
the [CraftSlicer Litematica mod](https://github.com/ThatAquarel/litematica/releases/). Then place the .jar file in the
Minecraft mods folder, located by default at `%appdata%/.minecraft/mods/`. Note that this is only
a [Fabric](https://fabricmc.net/) mod for 1.16.4 and 1.16.5.

## Documentation

If you are unsure about the usage of CraftSlicer after installing, refer to this link:

|Index          |Link                                                                                              |
|---------------|--------------------------------------------------------------------------------------------------|
|App user manual| [CraftSlicer/doc/MANUAL.md](https://github.com/ThatAquarel/CraftSlicer/blob/master/doc/MANUAL.md)|


