= Overview =
Welcome to **Mutable**! [[ https://mutable.games/ | Mutable ]] is a middleware to create character customization systems for games and other applications using Unreal Engine 4. At development time you can create objects and decide how they can be modified inside your project. Then Mutable builds instances of these objects at runtime based on options selected by the user or by your application. With Mutable you can clip and merge meshes, morph them, change texture colours, project images, and more. Mutable focuses on building these objects at runtime at the maximum performance, while giving your artists all the flexibility they need. This middleware is built from the experience of developing character customisation systems for games like PUBG (PlayerUnknown's BattleGrounds), KUF2 (Kingdom Under Fire 2), or All Points Bulletin Reloaded (APB).
The most important starting point to learn about mutable is the documentation [[ mutable/unreal-engine-4/ | Table of Contents ]].
We recommend you to also read the [[ mutable/unreal-engine-4/faq/ | Frequently Asked Questions ]].
When you are ready, you can follow the [[ mutable/unreal-engine-4/getting-started/step-by-step | Step-by-step Guide ]] to set it up and get it working in a project.
= Licensing =
Mutable for Unreal Engine 4 can be licensed directly from Anticto. It is offered under several [[ https://mutable.games/mutable-licensing/ | different licenses ]] to try to cover all needs:
* Learning
* Indie studio
* Per-project per-platform license
* Studio-wide license, with an unlimited number of projects and platforms
It is not allowed to ship any product with Mutable or containing Mutable-created assets unless one of the licenses above is obtained. Don't hesitate to [[ https://mutable.games/contact/ | contact us ]] if you need more information.
=== Starter Evaluation Version ===
A limited non commercial version of mutable is provided only for evaluation or learning purposes.
If don't have an account, please [[ mutable/unreal-engine-4/getting-started/evaluation/ | follow these steps ]] to grant you access to the Evaluation version of Mutable.
The latest release can be found here:
| Unreal | Version | Last update | Platform |
|----------|---------------|--------------| -------|
| 4.27 | [[./changelog/1.4.5|1.4.5]] Eval | 7th October 2021 | [[ mutable/unreal-engine-4/download-windows-lite/ | Windows]] |
Each platform release has several files, including:
* The plugin zip : It contains the source and binaries of the Mutable plugin. You can unzip it in your project's **Plugins** folder.
* Engine patches: Some engine versions and platforms require source code patches to unlock all the features and performance. The patches are in standard format and they can be applied with standard patching tools like the ones included with //git//.
* Demo projects: Full source and data for the demonstration projects, which is also used for documentation and howtos in this site.
= Download =
Please follow the [[ mutable/unreal-engine-4/getting-started/step-by-step | Step-by-step Guide ]] if it is the first time you set up a project with Mutable.
| Unreal | Mutable | Date | Updated platforms |
|----------|-----------|-------|-----------|
| 4.27 | [[./changelog/1.4.5|1.4.5]] | 7th October 2021 |[[mutable/unreal-engine-4/download-windows#version145|Windows]] [[mutable/unreal-engine-4/download-linux#version145|Linux]] [[mutable/unreal-engine-4/download-macos#version145|MacOS]] [[mutable/unreal-engine-4/download-android#version145|Android]] [[mutable/unreal-engine-4/download-ios#version145|iOS]] [[mutable/unreal-engine-4/download-ps4#version145|PS4]] [[mutable/unreal-engine-4/download-ps5#version145|PS5]] [[mutable/unreal-engine-4/download-xboxone#version145|XBoxOne]] [[mutable/unreal-engine-4/download-xboxsx#version145|XBoxSeriesX]] [[mutable/unreal-engine-4/download-switch#version145|Switch]] |
| 4.26 | [[./changelog/1.4|1.4.2]] | 28th May 2021 |[[mutable/unreal-engine-4/download-windows#version142|Windows]] [[mutable/unreal-engine-4/download-linux#version142|Linux]] [[mutable/unreal-engine-4/download-macos#version142|MacOS]] [[mutable/unreal-engine-4/download-android#version142|Android]] [[mutable/unreal-engine-4/download-ios#version142|iOS]] [[mutable/unreal-engine-4/download-ps4#version142|PS4]] [[mutable/unreal-engine-4/download-ps5#version142|PS5]] [[mutable/unreal-engine-4/download-xboxone#version142|XBoxOne]] [[mutable/unreal-engine-4/download-xboxsx#version142|XBoxSeriesX]] [[mutable/unreal-engine-4/download-switch#version142|Switch]] |
| 4.25 | [[./changelog/1.3|1.3]] | 24th December 2020 |[[mutable/unreal-engine-4/download-windows#version13|Windows]] |
| 4.25 | [[./changelog/1.2|1.2]] | 20th November 2020 |[[mutable/unreal-engine-4/download-windows#version12|Windows]] [[mutable/unreal-engine-4/download-linux#version12|Linux]] [[mutable/unreal-engine-4/download-macos#version12|MacOS]] [[mutable/unreal-engine-4/download-android#version12|Android]] [[mutable/unreal-engine-4/download-ios#version12|iOS]] [[mutable/unreal-engine-4/download-ps4#version12|PS4]] [[mutable/unreal-engine-4/download-xboxone#version12|XBoxOne]] [[mutable/unreal-engine-4/download-switch#version12|Switch]] |
| 4.25 | [[./changelog/1.1|1.1]] | 21th September 2020 |[[mutable/unreal-engine-4/download-windows#version11|Windows]] [[mutable/unreal-engine-4/download-linux#version11|Linux]] [[mutable/unreal-engine-4/download-macos#version11|MacOS]] [[mutable/unreal-engine-4/download-android#version11|Android]] [[mutable/unreal-engine-4/download-ios#version11|iOS]] [[mutable/unreal-engine-4/download-ps4#version11|PS4]] [[mutable/unreal-engine-4/download-xboxone#version11|XBoxOne]] [[mutable/unreal-engine-4/download-switch#version11|Switch]] [[mutable/unreal-engine-4/download-stadia|Stadia]] |
| 4.24 | [[./changelog/1.0|1.0]] | 12th June 2020 | [[mutable/unreal-engine-4/download-windows#version10|Windows]] [[mutable/unreal-engine-4/download-linux#version10|Linux]] [[mutable/unreal-engine-4/download-macos#version10|MacOS]] [[mutable/unreal-engine-4/download-android#version10|Android]] [[mutable/unreal-engine-4/download-ios#version10|iOS]] [[mutable/unreal-engine-4/download-ps4#version10|PS4]] [[mutable/unreal-engine-4/download-xboxone#version10|XBoxOne]] [[mutable/unreal-engine-4/download-switch|Switch]] [[mutable/unreal-engine-4/download-stadia|Stadia]] |
= Demos =
You can download the latest demos ready to run here:
| Demo | Version | Last update| Platform |
|----------|-------|-----------|-----------|
| Cyborg | [[./changelog/1.4.5|1.4.5]] | 7th October 2021 | [[ mutable/unreal-engine-4/download-windows#demos | Windows ]] |
| Village | [[./changelog/1.4.5|1.4.5]] | 7th October 2021 | [[ mutable/unreal-engine-4/download-windows#demos | Windows ]] |
The source code and data for these demos is available with each released version of the plugin.
= Mutable Populations =
[[ mutable/unreal-engine-4/user-documentation/population/ | Mutable Populations ]] is a Mutable plug-in to automatically generate crowds or populations in Unreal Engine.
Create random variations to add content procedurally. Define what is a valid output for different populations to create cohesive outputs that communicate a common origin or culture. Assign each new asset some tags so it pops up automatically on new instances made by existing populations.
The Mutable Population plugin extends and requires Mutable Plugin.
| Unreal | Version | Date | Platforms
| Warnings |
|----------|----------|-------|-------------|
------------|
| 4.27 | 1.1 |
3rd14rd December 2021 | [[ mutable/unreal-engine-4/download-populations#version110 | All platforms ]] |
Incompatible with **Population** assets from 1.0 version. **Population Class** assets from 1.0 should be fine. Please, apply the following patch to Mutable Plugin 1.4.5 to be able to use Population 1.1: {F410208}|
| 4.27 | 1.0 | 13th October 2021 | [[ mutable/unreal-engine-4/download-populations#version100 | All platforms ]]
| |
= Status and support =
Support for Mutable is provided through this site. Create [[ /maniphest/task/edit/form/1/ | new issues for bugs or questions ]], however be aware that other users in the site may be able to see your items. For private inquires you can [[https://mutable.games/contact/ | contact us]] directly.
We offer dedicated premium support for integration and optimisation in your project as well as development of new specific features or support for additional platforms that you may need.
== Supported platforms ==
These are the supported platforms and their status. If your platform is not listed here, [[ https://mutable.games/contact/ | contact us ]] for support. It may mean we are developing support for it but cannot be listed for legal reasons.
<table>
<tr>
<th scope="row"></th>
<th scope="col">Planned</th>
<th scope="col">Testing</th>
<th scope="col">Implemented</th>
<th scope="col">Mature</th>
</tr>
<tr>
<th scope="row" style="text-align: left;">Windows 64 bit</th>
<td/><td/><td/><td>✔</td>
</tr>
<tr>
<th scope="row" style="text-align: left;">Windows 32 bit</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">Linux 64 bit</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">Linux 32 bit</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">OSX</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">XBox One</th>
<td/><td/><td/><td>✔</td>
</tr>
<tr>
<th scope="row" style="text-align: left;">XBox Series X</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">Playstation 4</th>
<td/><td/><td/><td>✔</td>
</tr>
<tr>
<th scope="row" style="text-align: left;">Playstation 5</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">Switch</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">IOS</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">Android</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">Stadia</th>
<td/><td/><td>✔</td><td/>
</tr>
</table>
== Feature development ==
Mutable has many features, but not all are at the same level of maturity. Please check the following table. If you require improvements in one specific feature, don't hesitate to [[ https://mutable.games/contact/ | contact us ]].
<table>
<tr>
<th scope="row">Feature</th>
<th scope="col">Planned</th>
<th scope="col">Testing</th>
<th scope="col">Implemented</th>
<th scope="col">Mature</th>
</tr>
<tr>
<th scope="row" style="text-align: left;">[[ mutable/unreal-engine-4/user-documentation/add-mesh-based-cloth-pieces/ | Mesh merging ]]</th>
<td/><td/><td/><td>✔</td>
</tr>
<tr>
<th scope="row" style="text-align: left;">[[ mutable/unreal-engine-4/user-documentation/remove-unseen-parts/ | Mesh removal of hidden parts ]]</th>
<td/><td/><td/><td>✔</td>
</tr>
<tr>
<th scope="row" style="text-align: left;">[[ mutable/unreal-engine-4/user-documentation/nodes/mesh-layout/texture-layout-packing-strategies/ | Mesh texture layout packing ]]</th>
<td/><td/><td/><td>✔</td>
</tr>
<tr>
<th scope="row" style="text-align: left;">[[ mutable/unreal-engine-4/user-documentation/add-shape-variations-mesh-morphs/ | Mesh morph baking ]]</th>
<td/><td/><td/><td>✔</td>
</tr>
<tr>
<th scope="row" style="text-align: left;">[[ mutable/unreal-engine-4/user-documentation/how-to/interpolate-between-textures/ | Texture layer blending ]]</th>
<td/><td/><td/><td>✔</td>
</tr>
<tr>
<th scope="row" style="text-align: left;">[[ mutable/unreal-engine-4/user-documentation/create-projected-tattos-stickers/ | Texture projectors ]]</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">[[ mutable/unreal-engine-4/user-documentation/basic-concepts/#object-hierarchy | Hierarchical object system ]]</th>
<td/><td/><td/><td>✔</td>
</tr>
<tr>
<th scope="row" style="text-align: left;">[[ mutable/unreal-engine-4/user-documentation/basic-concepts/#object-interactions | Object interaction variations ]]</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">[[ mutable/unreal-engine-4/data-driven-ui/ | Data driven user-interface ]]</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">Object States optimization</th>
<td/><td/><td>✔</td><td/>
</tr>
<tr>
<th scope="row" style="text-align: left;">[[ mutable/unreal-engine-4/user-documentation/level-of-detail/ | LOD Support ]]</th>
<td/><td/><td/><td>✔</td>
</tr>
<tr>
<th scope="row" style="text-align: left;">Data streaming</th>
<td/><td/><td/><td>✔</td>
</tr>
</table>
=== Early Access to Unstable Versions ===
Mutable Licensees with access to a platform can access at their own risk to Mutable unstable versions before they are released. Please use it carefully, make backup copies of your projects before testing them. These versions are not intended for production or commercial purposes, therefore Anticto will not be responsible of any harm it may cause if it is used incorrectly.
| Unreal | Mutable | Updated platforms |
|----------|-----------|-------|-----------|
| 5.ea | 1.5.4 | [[mutable/unreal-engine-4/download-windows/early-access#version154|Windows]] [[mutable/unreal-engine-4/download-ps5/early-access#version154 |PS5]] [[mutable/unreal-engine-4/download-xboxsx/early-access#version154 |XSX]] |
| 5.ea | 1.5.3 | [[mutable/unreal-engine-4/download-windows/early-access#version153|Windows]] [[mutable/unreal-engine-4/download-ps5/early-access#version153 |PS5]] |
| 5.ea | 1.5.1 | [[mutable/unreal-engine-4/download-windows/early-access#version151|Windows]] [[mutable/unreal-engine-4/download-ps5/early-access#version151 |PS5]] |
| 4.27 | 1.4.7a | [[mutable/unreal-engine-4/download-windows/early-access#version147a|Windows]] [[mutable/unreal-engine-4/download-linux/early-access#version147a|Linux]] [[mutable/unreal-engine-4/download-android/early-access#version147a|Android]] [[mutable/unreal-engine-4/download-ps4/early-access#version147a|PS4]] [[mutable/unreal-engine-4/download-ps5/early-access#version147a|PS5]] [[mutable/unreal-engine-4/download-xboxone/early-access#version147a|XBoxOne]] [[mutable/unreal-engine-4/download-xboxsx/early-access#version147a|XBoxSeriesX]] [[mutable/unreal-engine-4/download-switch/early-access#version147a|Switch]] |
| 4.27 | 1.4.7 | [[mutable/unreal-engine-4/download-windows/early-access#version147|Windows]] [[mutable/unreal-engine-4/download-linux/early-access#version147|Linux]] [[mutable/unreal-engine-4/download-macos/early-access#version147|MacOS]] [[mutable/unreal-engine-4/download-android/early-access#version147|Android]] [[mutable/unreal-engine-4/download-ios/early-access#version147|iOS]] [[mutable/unreal-engine-4/download-ps4/early-access#version147|PS4]] [[mutable/unreal-engine-4/download-ps5/early-access#version147|PS5]] [[mutable/unreal-engine-4/download-xboxone/early-access#version147|XBoxOne]] [[mutable/unreal-engine-4/download-xboxsx/early-access#version147|XBoxSeriesX]] [[mutable/unreal-engine-4/download-switch/early-access#version147|Switch]] |
| 4.27 | 1.4.6 | [[mutable/unreal-engine-4/download-windows/early-access#version146|Windows]] |
| 4.27 | 1.4.5 | [[mutable/unreal-engine-4/download-windows/early-access#version145|Windows]] |
| 4.26 | 1.4.4a | [[mutable/unreal-engine-4/download-windows/early-access#version144|Windows]] [[mutable/unreal-engine-4/download-android/early-access#version144|Android]] [[mutable/unreal-engine-4/download-ps4/early-access#version144|PS4]] [[mutable/unreal-engine-4/download-ps5/early-access#version144|PS5]] [[mutable/unreal-engine-4/download-xboxone/early-access#version144|XBoxOne]] [[mutable/unreal-engine-4/download-xboxsx/early-access#version144|XBoxSeriesX]] [[mutable/unreal-engine-4/download-switch/early-access#version144|Switch]] |
| 4.26 | 1.4.3 | [[mutable/unreal-engine-4/download-windows/early-access#version143|Windows]] |
| 4.26 | 1.4.2 | [[mutable/unreal-engine-4/download-windows/early-access#version142|Windows]] [[mutable/unreal-engine-4/download-ps5/early-access#version142|PS5]] [[mutable/unreal-engine-4/download-xboxsx/early-access#version142|XBoxSeriesX]] |
| 4.26 | 1.4.1a | [[mutable/unreal-engine-4/download-windows/early-access#version141a|Windows]] |
= Source code access =
If your organization has access to [[ mutable/unreal-engine-4/download-core/| the development source code ]], you can find instructions [[ mutable/unreal-engine-4/download-core/setup-and-compile/ | here ]].