> For the complete documentation index, see [llms.txt](https://flora.magneticarcade.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://flora.magneticarcade.com/samples/runtime-samples.md).

# Runtime Samples

Samples showcasing Flora's runtime features.

## Fish Boids

Fish Boids animates many runtime-created instances with Unity Jobs.

<figure><img src="https://2882982566-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fyo4B7EVXffipTxnJzee6%2Fuploads%2Fgit-blob-aff2e5cf63f7e8672ee908c999aac83559dd53e2%2Ffish-boids-6-4-5.webp?alt=media" alt="Fish Boids sample with many instanced fish moving through the scene"><figcaption></figcaption></figure>

### Scene Path

`Fish/Scenes/FishBoidsSample.unity`

### Demonstrates

* Runtime creation and ownership of many instances
* Job-based transform simulation
* Batch update upload into Flora runtime

### APIs

* `FloraSystem.GetOrCreate()`
* `CreateInstances(...)`
* `ScheduleUpdateInstanceWorldTransforms(...)`
* `DestroyInstances(...)`

### Run

1. Open `FishBoidsSample` and press Play.
2. Confirm fish schools animate continuously.
3. Confirm the fish move without per-fish rendering GameObjects.