mxgmn/WaveFunctionCollapse

Health v2 · maintenance only

Flags: no_license

Adoption not part of the score

25292 stars · 1351 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded

A C# implementation of the Wave Function Collapse algorithm that generates bitmaps and tilemaps locally similar to a single example input, using an observation-propagation cycle inspired by quantum mechanics. It is the reference implementation that has been ported to many other languages.

Use cases

• generate tilemaps from a single example tileset
• procedurally generate textures for a game
• create pixel art variations from one sample image
• generate dungeon or level layouts procedurally
• learn how the wave function collapse algorithm works

When to choose

• you need procedural bitmap or tilemap generation constrained to patterns from a sample
• you want the canonical reference implementation of WFC
• you are building a game that needs locally-similar generated content

When to avoid

• you need guaranteed contradiction-free generation with high performance
• you need true quantum computing or actual quantum mechanics simulation
• you need a non-C# implementation without porting

Facets

library · maturity stable

graphics simulation data-generation image-processing graphics machine-learning cross-platform dotnet c procedural-generation wave-function-collapse tilemap-generation constraint-solving gamedev game-development algorithms

Member repositories

For agents

markdown · JSON · MCP: product_card(name="mxgmn/WaveFunctionCollapse")