Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nimadez/voxel-builder
Voxel-based 3D modeling application
https://github.com/nimadez/voxel-builder
3d babylon-js bvh electron glsl gltf hdri magicavoxel modeling painting path-tracing symmetry terrain three-js voxel-generator voxelization voxelizer voxels webgl
Last synced: 3 days ago
JSON representation
Voxel-based 3D modeling application
- Host: GitHub
- URL: https://github.com/nimadez/voxel-builder
- Owner: nimadez
- License: mit
- Created: 2022-11-12T14:17:37.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-05-23T09:07:15.000Z (4 months ago)
- Last Synced: 2024-05-23T09:38:12.535Z (4 months ago)
- Topics: 3d, babylon-js, bvh, electron, glsl, gltf, hdri, magicavoxel, modeling, painting, path-tracing, symmetry, terrain, three-js, voxel-generator, voxelization, voxelizer, voxels, webgl
- Language: JavaScript
- Homepage: https://nimadez.github.io/voxel-builder/
- Size: 3.04 MB
- Stars: 109
- Watchers: 4
- Forks: 16
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Voxel Builder
**Voxel-based 3D Modeling Application**
**Model . Render . Export**
[https://nimadez.github.io/voxel-builder/](https://nimadez.github.io/voxel-builder/)
[Changelog](https://github.com/nimadez/voxel-builder/releases)
[Installation](https://github.com/nimadez/voxel-builder#installation)
[Documentation](https://github.com/nimadez/voxel-builder/wiki)
[Known Issues](https://github.com/nimadez/voxel-builder#known-issues)
[FAQ](https://github.com/nimadez/voxel-builder#faq)
## Features
**File I/O**
- Save and load JSON [?](https://github.com/nimadez/voxel-builder/wiki/File-Format)
- Import MagicaVoxel VOX
- Export to GLB, GLTF, OBJ, STL [?](https://github.com/nimadez/voxel-builder/wiki/project)
- Local storages, snapshots, quicksave, undo
**Model and Paint**
- High performance voxel engine
- Generators *(terrain, cube, sphere, isometric...)*
- Interactive modeling toolsets [?](https://github.com/nimadez/voxel-builder/wiki/model)
- Symmetric drawing and painting
- Color groups and voxel transforms
**Rendering**
- Three.js sandbox
- Three.js GPU path tracer
- Basic PBR rendering
**Voxelization**
- Fast BVH voxelization
- 3D model voxelizer [?](https://github.com/nimadez/voxel-builder/wiki/Voxelization)
- Image voxelizer
**Export Meshes**
- Bake voxels to editable meshes [?](https://github.com/nimadez/voxel-builder/wiki/export)
- Bake voxels by color groups
- Unbake meshes to voxels
- glTF compatible editor
**Extensibility**
- ES modules [?](https://github.com/nimadez/voxel-builder/wiki/Modules)
- WebSockets client [?](https://github.com/nimadez/voxel-builder/wiki/WebSocket-Client)
- User startup project
- Blender importer script
**More**
- Average startup time 300 ms
- Unique handcrafted user-interface
- Minimum dependency, portable, online and offline
- Ad-free, no trackers, no logging, no loading screens
## Installation
Install [Electron](https://github.com/electron/electron/releases) *(recommended)*
```
electron-v*-linux-x64.zip
electron-v*-win32-x64.zip
```
Clone
```
git clone https://github.com/nimadez/voxel-builder
cd voxel-builder
```
Run
```
# Start with Electron:
electron .
# Start with Node.js:
node server.js
```
Update
```
cd voxel-builder
python3 update.py
```
## Supported Browsers
- Electron *(recommended)*
- Google Chrome
- Mozilla Firefox
> - PWA A2HS-ready *(add to home screen)*
> - For the best experience, a tablet with pen or Wacom is recommended
> - Voxel Builder is not designed for mobile devices with small screens
## Known Issues
Higher than 512K is not recommended
```
Electron is recommended for working with a large number of voxels
Higher values can have the following problems:
- Intolerable delay when starting the renderer
- Chrome tab may freeze or crash
Of course, the number of voxels is unlimited,
I have rendered up to 1 million voxels.
```
Failed to import GLB meshes for voxelization
```
Multiple meshes need to have the same properties or they won't merge,
the only solution is to merge meshes before exporting to GLB.
```
Wacom tablet crashes randomly and throws warning on Linux (GNOME)
```
Warning: BJS - Max number of touches exceeded. Ignoring touches in excess of 2.
This problem is related to Babylon.js and nothing can be done.
```
Error: Exceeded the quota
```
Browser storage can handle 6 snapshots with 32x32x32 voxels
(use Electron for much higher capacity - 1 million)
```
## FAQ
How to go back to the previous version?
```
cd voxel-builder
git log -2 (copy the hash of the previous commit)
git reset --hard $HASH
```
How to merge vertices after export to GLB?
```
1- Open exported GLB file in Blender
2- Go to "Modeling" tab and choose vertex selection mode
3- Select all vertices (Ctrl + A)
4- Mesh > Clean Up > Merge by Distance
```
How to run Blender importer script?
```
1- Save project to JSON
2- Open Blender and go to "Scripting" tab
3- Click "Open" and select "blender-importer.py"
4- Run the script and select a JSON file
```
## History
```
↑ Initialize the core!
↑ Rendering was left to three and three-gpu-pathtracer
↑ ES6 (the original index.html playground was moved)
↑ x1.5 faster startup (2s to 350ms)
↑ Migrating to Linux: Firefox ready
↑ High performance GPU picking system
↑ Voxel engine updated to thin-instances (64k to 512k)
↑ Cut half precision (from 0.0 to 0.5 center to avoid -0.5/+0.5)
↑ Real-time GPU path tracing
↑ Introducing ES modules
↑ Advancing to the next level (bakery)
↑ Changed default handiness to right-handed coordinate
↑ New SPS particles to build the world
↑ 2019 - I wrote a playground for learning Babylon.js
```
Version 4.3.9 *(BJS 7 - Three r168)*
Version 3.0.0 *(BJS 4)* to 4.2.2 *(BJS 6)*
## License
Code released under the [MIT license](https://github.com/nimadez/voxel-builder/blob/main/LICENSE).
## Credits
- [Babylon.js](https://www.babylonjs.com/)
- [Three.js](https://threejs.org/)
- [Three-mesh-bvh](https://github.com/gkjohnson/three-mesh-bvh)
- [Three-gpu-pathtracer](https://github.com/gkjohnson/three-gpu-pathtracer)
- [Electron](https://www.electronjs.org/)
- [MagicaVoxel](https://ephtracy.github.io/)
- [Google Material Icons](https://github.com/google/material-design-icons)
- [Blender](https://blender.org/)
- [Sketchfab](https://sketchfab.com/)
- [KhronosGroup](https://github.com/KhronosGroup/)
- [Shadertoy](https://www.shadertoy.com/)
- [vengi](https://mgerhardy.github.io/vengi/)
#
- [Allen Hastings](https://www.linkedin.com/in/allenhastings)
- [David Catuhe](https://twitter.com/deltakosh)
- [Erich Loftis](https://github.com/erichlof)
- [Eric Heitz](https://eheitzresearch.wordpress.com/772-2/)
- [Evan Wallace](https://github.com/evanw)
- [Garrett Johnson](https://github.com/gkjohnson)
- [Inigo Quilez](https://www.iquilezles.org/)
- [knightcrawler25](https://github.com/knightcrawler25)
- [Mr.doob](https://mrdoob.com/)
#
###### Available in [Babylon.js community demos](https://www.babylonjs.com/community/)
