ObjToSchematic/README.md

54 lines
1.9 KiB
Markdown
Raw Normal View History

2021-07-01 23:25:27 +08:00
# ObjToSchematic
A tool to convert .obj files into Minecraft Schematics
2021-07-07 09:35:12 +08:00
:warning: This repo is in development and proper error handling is not currently my priority. Contributions are welcome.
2021-07-01 23:25:27 +08:00
![Preview](/resources/preview.png)
2021-07-07 09:35:12 +08:00
![MinecraftPreview](/resources/minecraft.png)
2021-07-05 00:04:56 +08:00
![DebugPreview](/resources/debug_preview.png)
![MeshingPreview](/resources/greedy_meshing.png)
2021-07-07 06:22:21 +08:00
2021-07-01 23:25:27 +08:00
# Progress
2021-07-07 09:35:12 +08:00
[0.1](https://github.com/LucasDower/ObjToSchematic/releases/tag/v0.1-alpha)
2021-07-04 00:41:01 +08:00
* ✔️ **.json model loading**
* ✔️ **Model voxelisation**
* ✔️ **Optimised voxelisation & rendering overhaul**
2021-07-04 23:02:49 +08:00
* ✔️ **Basic .obj file loader UI**
2021-07-04 00:41:01 +08:00
2021-07-07 09:35:12 +08:00
[0.2](https://github.com/LucasDower/ObjToSchematic/releases/tag/v0.2-alpha)
* ✔️ **Greedy voxel meshing**
2021-07-07 06:22:21 +08:00
* ✔️ **Export to schematic**
2021-07-04 00:41:01 +08:00
0.3
2021-07-11 05:53:21 +08:00
* ✔️ **Faster voxel splitting**
2021-07-23 03:33:49 +08:00
* ✔️ **Ambient occlusion**
2021-07-12 09:49:43 +08:00
**Multithreading* (see [web-workers](https://github.com/LucasDower/ObjToSchematic/tree/web-workers))
2021-07-23 07:08:53 +08:00
* Data-oriented programming for rendering & voxelisation
2021-07-07 09:35:12 +08:00
* Quality of life
2021-07-20 05:40:31 +08:00
* Model PSR, voxel size preview, progress bar, limit warnings
2021-07-07 09:35:12 +08:00
0.4
* Export to litematic
2021-07-07 09:35:12 +08:00
* .mtl support for block choice
2021-07-04 00:41:01 +08:00
2021-07-07 09:35:12 +08:00
0.5
* Building guides
* Slice viewer
2021-07-07 09:35:12 +08:00
* .fbx support
* Block painting
2021-07-04 00:41:01 +08:00
# Usage
2021-07-07 09:35:12 +08:00
You can either download the [latest release](https://github.com/LucasDower/ObjToSchematic/releases) or build it yourself by following the instructions below.
2021-07-04 00:41:01 +08:00
* 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`.
2021-07-04 00:44:01 +08:00
* Run `npm install`.
2021-07-04 00:41:01 +08:00
* Run `npm start`.
2021-07-07 09:35:12 +08:00
2021-07-23 23:24:09 +08:00
# 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).