WFC 3D Tool

A procedural 3D game world generation tool based on a Wave Function Collapse algorithm made in Godot 4.  This is a lightweight tool designed  to provide a platform to play around with Wave Function Collapse. The tool allows to import a custom-made set of 3D segments, edit WFC connection rules (sockets, in this case), generate a model out of imported 3D segments and export it (for now, only to .glb/.gltf).

Additionally, biomes have been added as an experimental feature and can be turned on in the settings, allowing the user to assign certain segments to certain biomes. During the model generation, a Voronoi tesselation will be generated and biome-assigned segments will be placed at corresponding biomes.

Developer's note

This project was made for a bachelor's thesis in engineering at the Wrocław University of Science and Technology.  There are many ways to break it or otherwise achieve results that may look like incorrect program functioning. Many of the design choices that are in place had to be made with intent to save time and work, and will be re-evaluated in the future. At the time of writing this, I have not a lot of free time to work on the project, so it may rest unchanged for a while. The project is just getting out of the proof-of-concept phase, meaning that many things will probably change.

If you have any suggestions, questions or just fancy a chat, feel free to contact me. 

dev742

Known issues

• No functionality to set grid unit size, meaning that for now only models that fit into a 1x1x1m cube will connect correctly.
• Multiple ways to crash the program by submitting empty fields.
• Biomes can cause incomplete generation results if not every biome-themed piece has a counterpart for other biomes.
• Weird shading for different rotations of the same segment (so a 10x10 plane of only grass segments will look like a checkerboard).

Roadmap

• Windows Build
• Hosting on GitHub pages
• .obj file support
• Socket Creator redesign
• Inspection toolset (ability to select a segment out of a generated model and see its data)
• Painting toolset (tools to place segments manually)