ObjToSchematic/README.md
2021-08-14 20:52:40 +01:00

62 lines
2.0 KiB
Markdown

# ObjToSchematic
A tool to convert .obj files into Minecraft Schematics.
:warning: This repo is in development and proper error handling is not currently my priority. Contributions are welcome.
![Preview](/resources/preview2.jpg)
![MinecraftPreview](/resources/minecraft.png)
![DebugPreview](/resources/debug_preview.png)
![MeshingPreview](/resources/greedy_meshing.png)
# Progress
[0.1](https://github.com/LucasDower/ObjToSchematic/releases/tag/v0.1-alpha)
* ✔️ **.json model loading**
* ✔️ **Model voxelisation**
* ✔️ **Optimised voxelisation & rendering overhaul**
* ✔️ **Basic .obj file loader UI**
[0.2](https://github.com/LucasDower/ObjToSchematic/releases/tag/v0.2-alpha)
* ✔️ **Greedy voxel meshing**
* ✔️ **Export to schematic**
0.3
* ✔️ **Faster voxel splitting**
* ✔️ **Ambient occlusion**
* ✔️ **Quality of life**
* ✔️ Model PSR, ✔️ voxel size preview ✔️ limit warnings
* ✔️ **.mtl support for block choice**
* ✔️ **Convert to TypeScript**
* ⌛ Block choice exported
0.4
* Block painting
* ⌛ Multithreading (see [web-workers](https://github.com/LucasDower/ObjToSchematic/tree/web-workers))
* Progress bar
0.5
* Export to .litematic
* Export to .mcstructure
0.5
* Node.js C++ addons
0.6
* Building guides
* Slice viewer
* .fbx support
# Usage
You can either download the [latest release](https://github.com/LucasDower/ObjToSchematic/releases) or build it yourself by following the instructions below.
* Download and install [Node.js](https://nodejs.org/en/).
* Execute `git clone https://github.com/LucasDower/ObjToSchematic.git` in your command line.
* Navigate to `/ObjToSchematic-main`.
* Run `npm install`.
* Run `npm start`.
# Disclaimer
This is an non-commercial **unofficial** tool that is neither approved, endorsed, associated, nor connected to Mojang Studios. Block textures used are from Minecraft and usage complies with the [Mojang Studios Brand And Assets Guidelines](https://account.mojang.com/terms#brand).