map_scatter

Rule‑based object scattering for games and tools with clear rules, multiple distribution styles, and reproducible results. Use it to populate worlds with trees, rocks, props, resources, and decals.

What is this?

This repository is a Rust workspace with:

• Core library: map_scatter - fast, composable engine for rules, sampling, and layering.
• Bevy plugin: bevy_map_scatter - Bevy 0.19 integration (Assets, ECS, async).
• Examples: map_scatter_examples and bevy_map_scatter_examples.

Where to start

• Building your own engine/tools? Start with the core crate: crates/map_scatter.
• Using Bevy? Start with the plugin: crates/bevy_map_scatter. The current bevy_map_scatter 0.5 line targets Bevy 0.19.

The crate READMEs include:

• Practical use cases
• A short "how it works" (fields => sampling => layering)
• Quick Start and links to runnable examples

For architecture details, see crates/map_scatter/ARCHITECTURE.md.

Why use it

• Data‑driven placement instead of bespoke loops
• Mix distribution styles (blue‑noise, grids, clustered, low‑discrepancy)
• Deterministic, chunked evaluation for performance and reproducibility

License

This project is dual-licensed under either:

• MIT License or
• Apache License, Version 2.0