# Artificer Documentation

#### Artificer Overview

<figure><img src="/files/bI4WGdeLdQ1RZl7ZedvK" alt=""><figcaption></figcaption></figure>

{% embed url="<https://www.youtube.com/watch?v=nHaCmnQ-g2g>" %}

Welcome to the documentation for our Artificer Mesh Assembly and Dismantling asset for the Unity Game Engine. Artificer allows you to easily split up any mesh or meshes into component parts and then have those parts build themselves up and dismantle themselves with full artistic control over how that happens. No special work needs to be done to any mesh Artificer will automatically handle the splitting up into elements.&#x20;

Your game projects can now have impressive spawning of new objects in your scene with just a few clicks. Introduce new characters or objects into your game worlds in endless new ways. Have your buildings or units upgrade by dismantling themselves away into a box and then building up the new version of themselves all without any complicated animation clips, pre processing of meshes and so on.

Even use Unity Splines to give even more control over build orders or have your parts move along splines and smoothly into place. Have your objects build from boxes for even more interest.

And if you don't need the object in the scene anymore you can explode it into loads of pieces as easily as turning off a game object.

#### Performance

Artificer is super fast when playing back the assembly and dismantle animations as most of the hard work is done when the animation is created in the editor, though you can create at runtime as well if you have need to do so such as procedural meshes etc.

<div><figure><img src="/files/DAIqhvvaP01R53NQXtCS" alt=""><figcaption><p>Demo Scene Mid Dismantle.</p></figcaption></figure> <figure><img src="/files/RZZ2foWFQgFshmzb28p2" alt=""><figcaption><p>Demo Scene Mid Assembly.</p></figcaption></figure></div>

<div><figure><img src="/files/ZwvNZ3GRkDynf1ajrIS4" alt=""><figcaption><p>Dismantle CPU Time 0.11ms</p></figcaption></figure> <figure><img src="/files/blwRfSwXuGrFtLucBcWm" alt=""><figcaption><p>Assembly CPU Time 0.1ms</p></figcaption></figure></div>

The demo scene included in the asset for example is split into 170 elements and the playback of the assembly of the object takes 0.1ms and the dismantle is 0.11ms. You have control over how fast items are placed so you can tweak it even further.

### Get Artificer

If don't already own a copy of Artificer then get your copy now from either the Unity Asset Store or the Fab Store.

{% hint style="danger" %}
Please note the various models and assets seen in the examples and tutorial videos are not included in the asset. You can find links to the assets used in the [<mark style="color:orange;">**Used Assets Section**</mark>](/artificer/used-assets.md).
{% endhint %}

<table data-card-size="large" data-view="cards"><thead><tr><th data-hidden align="center"></th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center">Unity Asset Store</td><td><a href="/files/IucA44M6asnnWfXkYFGt">/files/IucA44M6asnnWfXkYFGt</a></td><td><a href="https://prf.hn/click/camref:1101lGoK/destination:https://assetstore.unity.com/packages/tools/animation/artificer-341008">https://prf.hn/click/camref:1101lGoK/destination:https://assetstore.unity.com/packages/tools/animation/artificer-341008</a></td></tr><tr><td align="center">Fab Store</td><td><a href="/files/EbH4SuiJB7zftZbwKmSX">/files/EbH4SuiJB7zftZbwKmSX</a></td><td><a href="https://www.fab.com/listings/2a47e010-853f-4039-a3c9-ca3181ae02da">https://www.fab.com/listings/2a47e010-853f-4039-a3c9-ca3181ae02da</a></td></tr></tbody></table>

## Features

Some of the features of Artificer are:

* Works with any meshes no preparation required
* As little as 2 clicks to have it working
* Single Mesh or dozens of meshes no problem
* Works with Skinned Meshes
* Works with Lod Meshes
* Test Animations quickly in Edit Mode
* Super Fast
* Many different ways to split the meshes
* Custom splitting option available if you need something specific
* Full Control over order of build
* Use Unity Splines for complex paths and builds giving amazing control
* Full control of the assembly animation with tons of options to shape the look and feel, control speed, directions, scaling rotation etc.
* Easily Chain assembles and dismantles together for complex objects
* Support for custom Assembly, code your own look with a simple class
* Full Events system to have your code interact during building etc.
* Handles Lights, Audio, Particles and Line renderings automatically
* Enable and disable objects during builds
* Explode your objects to dismantle with various options for collisions and physics
* Multiple Assembly and Dismantle styles included to get you started quickly
* Auto remap materials during builds, useful for back faces etc.
* Control builds from script, easy to build piece by piece or groups
* Options to have different values for different parts of the same mesh for more control
* Volume based or user set selection of elements for custom options
* Have multiple profiles for your meshes and select at runtime for more variation
* Works on all pipelines and Platforms
* Full Undo Support
* Complete Tooltips for all values
* Full documentation and right click help on every option
* Numerous example videos and tutorial videos
* Use of Burst and Jobs for super fast splitting
* Support for Runtime splitting
* Instant build to any point feature
* Click to Build Option
* Included Double Sided shaders for showing insides of meshes
* Show Unbuilt Parts
* Show Placing Parts


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://tubbycrumbles.gitbook.io/artificer/artificer-documentation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
