# Building Blocks

`v0.1.1-pre.1`   `23 Dec 2025`

The **MeshMap Building Blocks** package is a reusable Unity package shared across MeshMap projects.\
It contains common systems, utilities, and prefabs designed to accelerate gameplay and tool development.

[**Changelog**](https://github.com/MeshMap/com.meshmap.sdk.bb/blob/main/CHANGELOG.md)

***

## Features

* **Art** – Example image and video (2D and 3D stereo) prefabs.
* [**Audio**](https://docs.meshmap.com/unity-sdk/building-blocks/audio) – Centralized audio management with registries, mixer support, and in-game settings.
* [**Events**](https://docs.meshmap.com/unity-sdk/building-blocks/events) – Completable and repeatable trigger events for modular gameplay flow.
* [**Save System**](https://docs.meshmap.com/unity-sdk/building-blocks/save-system) – Scene-wide saving/loading for `ISaveable` components.
* **Utilities** – Common helpers for transforms, strings, audio, particles, NavMesh, and component management.
* **Interactions** – Collectables, damageable interfaces, and other runtime interaction contracts.
* **Testing & Logging** – Debug logger prefabs and utilities for runtime inspection.
* **Tools** – Simple camera behaviours, UI helpers, and logging systems.

For details on minor features, see [Other Features](https://docs.meshmap.com/unity-sdk/building-blocks/other-features).

***

## Getting Started

The easiest way to get started is to clone one of the [Example Projects](https://docs.meshmap.com/unity-sdk/overview/example-projects) and open the project using [Unity Hub](https://unity.com/unity-hub).

***

### Requirements

* Windows, Mac
* **Unity 2022.3.11 LTS** or later
  * Android Build Support
  * Universal Render Pipeline (URP)

***

### Package Dependencies

* Unity AI Navigation v1.1.5
* Unity Input System v1.11.2
* Unity TextMeshPro v3.0.7
  * Make sure to [Import TMP Essential Resources](https://docs.unity3d.com/Packages/com.unity.textmeshpro@4.0/manual/index.html).

***

### Import

The [com.meshmap.sdk.bb](https://github.com/MeshMap/com.meshmap.sdk.bb) package can be added via Unity Package Manager (UPM) from Git. Follow the import [instructions](https://docs.meshmap.com/unity-sdk/overview/using-packages).

***

### Basic Usage

After import, the files will be available in the Packages section of the Project window in Unity Editor.