https://github.com/al-asl/autolevel

Free procedural level generator for unity
https://github.com/al-asl/autolevel

fog-of-war fow level-design level-editor procedural procedural-generation procedural-level-generation procedural-levels unity unity-3d unity-editor unity3d wfc

Last synced: 7 days ago
JSON representation

Free procedural level generator for unity

• Host: GitHub
• URL: https://github.com/al-asl/autolevel
• Owner: Al-Asl
• License: mit
• Created: 2022-07-02T22:06:01.000Z (over 2 years ago)
• Default Branch: main
• Last Pushed: 2024-01-26T23:08:57.000Z (8 months ago)
• Last Synced: 2024-09-23T11:31:24.596Z (10 days ago)
• Topics: fog-of-war, fow, level-design, level-editor, procedural, procedural-generation, procedural-level-generation, procedural-levels, unity, unity-3d, unity-editor, unity3d, wfc
• Language: C#
• Homepage:
• Size: 92.4 MB
• Stars: 110
• Watchers: 5
• Forks: 15
• Open Issues: 2
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# AutoLevel

[![Autolevel Trailer](documentation/images/trailer.png)](https://www.youtube.com/watch?v=94toUiUJqB8 "Autolevel Trailer")

Free procedural level generator based on WFC algorithm for unity.

The target of this package is to create a procedural level generator that is controllable, easy to use, and fast to some extent by leveraging the power of the WFC.

## Features

* Weight, volume, and boundary constraints

* Editor tools to easily configure your art and constraint the builder

* Easily extended

* Selection rebuild

* Big block support

* Fbx export

* Multi-threaded solver (only work with constraints)

* Layers support

Complete C# source code is provided.

## Usage

Clone the repo with submodules using the following command:

```

git clone --recurse-submodules https://github.com/Al-Asl/AutoLevel.git

```

Auto level consists of the following components:

* `Level Builder` where you can do all of your constraints, building, and exporting.



* `Block Repo` is the resource needed by the `Level Builder` to run, it basically contains the pieces and the relationship between them.



* `Block Asset` is the main component needed to define the relationships between pieces.

* `Big Block Asset` is a composite of blocks generated by `Block Asset` used on blocks that need to be transformed together.

You can get started by watching the [tutorial](https://www.youtube.com/watch?v=1-M3W0y42L4).

you can also check the API usage to build the level at runtime by checking `Example Scenes\Runtime`

**FILLING**

When selecting a `Block Asset,` there is an option called filling in the scene view context menu dropdown. This will show handles to edit the block filling, red for empty and green for fill, similar to the marching cubes algorithm.

`Level Builder` can use that information to define the level rooms. The builder contains two built-in groups, the 'Empty' and 'Solid' groups, and you can use them to define the rooms and walls.

## PERFORMANCE TIPS

* Keep in mind that the Building performance depends on two factors the size of the builder and the number of blocks produced by the repo. You can get better performance by only building where needed using multiple builders. Also, using constraints can reduce the building time significantly.

* Multi-threaded solver can only give a better performance where constraints are used with a heavy load task and could yield up to 3x the original performance.

If you have any question or suggestion please join us on [Discord](https://discord.gg/yKMFA3ZE5H)