Skip to content

A modular, deterministic procedural generation framework for Unity, designed for extensible terrain, chunked worlds, and custom sampling pipelines.

License

Notifications You must be signed in to change notification settings

LucaMezz/TerraCore

Repository files navigation

TerraCore

TerraCore – Deterministic Procedural Generation Framework for Unity

TerraCore is a modular and extensible procedural generation framework designed for Unity developers. It allows you to create complex, deterministic procedural worlds, including chunked terrains, biomes, and advanced sampling pipelines.

Key Features

  • Chunk-Based Terrain: Generate large, seamless terrains in chunks for efficient memory usage and runtime performance.
  • Deterministic Generation: Ensure the same input produces the same world every time.
  • Biome and Environmental Systems: Temperature, moisture, and other environmental factors drive biome generation.
  • Modular Architecture: Easily swap samplers, noise functions, or terrain algorithms.
  • Unity Editor Integration: Preview generated chunks, biomes, and terrain in real-time.

Installation

Install TerraCore via Unity Package Manager (UPM) using the Git URL:


[https://github.com/yourname/terra-core.git#v0.1.0-alpha.1](https://github.com/yourname/terra-core.git#v0.1.0-alpha.1)

Replace v0.1.0-alpha.1 with the desired release tag.

Quick Start

  1. Open Unity and add TerraCore via Package Manager → Add package from Git URL.
  2. Import the TerraCore namespace:
using TerraCore;

Documentation

Full documentation, tutorials, and API references are available at TerraCore Docs.

Contribution Guidelines

We welcome contributions! Please read CONTRIBUTING.md for:

  • Branching strategy
  • Commit message conventions
  • Pull request process
  • Testing requirements

Versioning

TerraCore uses Semantic Versioning (SemVer) with pre-release tags for alpha and beta versions. See VERSIONING.md for a detailed guide.

Testing

  • Use the Unity Test Framework to run unit tests.
  • Run tests locally using:
npm test

License

TerraCore is licensed under the MIT License. Please credit "TerraCore by Luca Mezzavilla" in any game or project that uses it.

Quick Links

About

A modular, deterministic procedural generation framework for Unity, designed for extensible terrain, chunked worlds, and custom sampling pipelines.

Resources

License

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published