mirror/ObjToSchematic
2
0
Fork 1
mirror of https://github.com/LucasDower/ObjToSchematic.git synced 2024-12-15 02:59:55 +08:00
Code Issues Packages Projects Releases Wiki Activity
180 Commits 6 Branches 10 Tags 25 MiB
TypeScript 94.9%
GLSL 2.7%
CSS 1.9%
JavaScript 0.3%
HTML 0.2%
9c53a89142
Go to file
Lucas Dower 9c53a89142 Major refactor to rendering, importing and util
2022-02-12 01:54:31 +00:00
.github/workflows Update node.js.yml 2022-01-16 23:02:39 +00:00
.vscode
resources Preview update, small fix 2022-01-16 19:58:41 +00:00
shaders Major refactor to rendering, importing and util 2022-02-12 01:54:31 +00:00
src Major refactor to rendering, importing and util 2022-02-12 01:54:31 +00:00
tools Major refactor to rendering, importing and util 2022-02-12 01:54:31 +00:00
.eslintrc.json Updated linting rules 2022-02-12 00:59:14 +00:00
.gitignore
index.html Style updates 2022-01-16 19:52:35 +00:00
LICENSE
package.json Major refactor to importing and app context 2022-02-06 18:11:45 +00:00
README.md Update README.md for 0.5 features 2022-01-19 01:08:05 +00:00
styles.css Major refactor to rendering, importing and util 2022-02-12 01:54:31 +00:00
tsconfig.json

README.md

ObjToSchematic

A visual tool to convert .obj model files into Minecraft Schematics or Litematica.

Preview

Usage

You can either download the latest release or build it yourself by following the instructions below.

  • Download and install Node.js.
  • Run git clone https://github.com/LucasDower/ObjToSchematic.git in your command line.
  • Navigate to /ObjToSchematic-main.
  • Run npm install.
  • Run npm start.

Support for choosing the block palette is not yet supported. Instead, you can edit /tools/default-ignore-list.txt to include blocks you don't want to be used and then run npm run-script atlas. You can also place custom textures in /tools/blocks/ for more accurate block-colour matching when building with resource packs.

Progress

0.1

  • 🟢 .json model loading
  • 🟢 Model voxelisation
  • 🟢 Optimised voxelisation & rendering overhaul
  • 🟢 Basic .obj file loader UI

0.2

  • 🟠 Greedy voxel meshing (Removed)
  • 🟢 Export to schematic

0.3

  • 🟠 Voxel splitting (Removed)
  • 🟢 Ambient occlusion
  • 🟢 Quality of life
    • Model PSR, height limit warnings
  • 🟢 .mtl support for block choice
    • PNG support, JPEG support
  • 🟢 Convert to TypeScript

0.4

  • 🟢 Block choice exported
    • Export to .litematic
  • 🟢 Support for non-uniform block models (i.e. not all sides have same texture e.g. Oak Log, Crafting Table)
  • 🟢 UI Redesign
  • 🟢 Optimised ambient occlusion
  • 🟢 Transition to ray-based voxelisation
  • 🟢 Dithering

0.5

  • ⚪ Support for simplifying complex meshes
  • ⚪ Load custom block palettes and texture atlases
  • 🟡 Optimise construction of voxel mesh vertex buffers
  • 🟡 Web workers (see web-workers)
    • Progress bar
    • Prevent UI hanging
  • ⚪ Buffer refactor to support OES_element_index_uint WebGL extension (support for uint32 index buffers instead of uint16)
  • ⚪ Node.js C++ addons
  • ⚪ Alpha support
    • Alpha texture maps
    • Transparent blocks
  • ⚪ Export to .nbt (structure blocks)
  • ⚪ Import from .gltf

0.6

  • ⚪ Block painting
  • ⚪ Building guides
  • ⚪ Slice viewer
  • ⚪ .fbx import support
  • ⚪ Support for non-block models (e.g. slabs, stairs, trapdoors, etc.)

Disclaimer

⚠️ This repo is in development and proper error handling is not currently my priority. Contributions are welcome.

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.

MinecraftPreview

Debugging

To allow for your favourite debugging tools like breakpoints and call stacks, I've included launch options for debugging in VSCode. Use Ctrl+Shift+D, and run "Debug Main Process" and once the Electron window has initialised, run "Attach to Render Process".