# Tower Unite Blender Tools (1.2.4)

**URL:** <https://forums.pixeltailgames.com/t/tower-unite-blender-tools-1-2-4/41541>\
**Category:** Workshop Support & Bugs\
**Created:** [March 26, 2021, 9:36am UTC](https://forums.pixeltailgames.com/t/tower-unite-blender-tools-1-2-4/41541 "2021-03-26T09:36:18Z")\
**Posts on this page:** 7\
**Page:** 1

<div class="post-metadata">

**Author:** ![Spoom](https://forums.pixeltailgames.com/user_avatar/forums.pixeltailgames.com/spoom/32/51252_2.png) [@Spoom](https://forums.pixeltailgames.com/u/Spoom)\
**Post date:** [March 26, 2021, 9:36am UTC](https://forums.pixeltailgames.com/t/tower-unite-blender-tools-1-2-4/41541/1 "2021-03-26T09:36:18Z")

</div>

[![](https://cdn.discordapp.com/attachments/654457053141794828/824176470611722300/TU_Icon.png) Download v1.2.3](https://cdn.discordapp.com/attachments/871271381046808607/873278868927184897/TowerUniteSuite_1_2_3.zip) :: [v1.2.4 hotfix for Blender 3.0.0](https://cdn.discordapp.com/attachments/871271381046808607/918215175784530010/TowerUniteSuite_1_2_4.zip)  
Please support development: [Ko-Fi](https://ko-fi.com/spoomwolf) / [PayPal](http://paypal.me/SpoomWolf)

The **Tower Unite Blender Suite** is a community-made add-on for Blender which streamlines the model creation process. Aimed at the latest version of Blender, it is easy to use and provides powerful features:

- **Tower Unite Export** option - **File** \> **Export** \> **Tower Unite (.dae)**  
An easier export to COLLADA format with simplified options,  
Due to a lingering bug in Blender 2.8 and above, COLLADA exports do not include normal maps, but this method of exporting restores that functionality.
- **Export Pre-Processing** - An additional section in the **Tower Unite Export** above 🆕  
An extra set of steps the export can do to reduce your workload, such as fixing twist bones, fingers, and/or clavicles, removing invalid bones that would cause it to crash on import, enabling the use of basic colours for materials and applying modifiers without breaking player-models.  
_NOTE: If you have tested poses, switch the Armature to ‘Rest Position’ before exporting this way._
- **Tower Unite Armature** object - **Object Mode** \> **Add** \> **Armature** \> **Tower Unite Armature**  
The armature can be inserted directly into your scene at the correct scale.  
This eliminates the issues _(and effort)_ involved with importing the rig file into your scene, or vice versa. This method will also, by default, use an improved, symmetrical version of the rig with a straightened spine.
- **Adjust Tower Unite Armature** menu - **Edit Mode** \> **Armature** \> **Tower Unite Rig** \> **Adjust**  
This menu is automatically summoned after creating the Tower Unite armature with the previous menu.  
It will allow you to easily adjust the shoulder and arms of the rig to match your model’s proportions.
- **Tower Unite Pose Previews** menu - **Pose Mode** \> **Pose** \> **Tower Unite Rig** \> **Preview Pose**  
Provided for this add-on by the PixelTail Games development team, you can now preview your model in poses from Tower Unite directly in Blender.  
This allows for edits to be reflected in real-time, without the need to export and import with each change.

The best place to report any bugs would be directly to me on Discord: Spoom#0001  
This add-on will be maintained and there are many powerful features planned for future releases.  
If you find this add-on useful, please consider towards its development via [Ko-Fi](https://ko-fi.com/spoomwolf) or [PayPal](http://paypal.me/SpoomWolf)

[![](https://cdn.discordapp.com/attachments/654457053141794828/824176470611722300/TU_Icon.png) Download v1.2.3](https://cdn.discordapp.com/attachments/871271381046808607/873278868927184897/TowerUniteSuite_1_2_3.zip) :: [v1.2.4 hotfix for Blender 3.0.0](https://cdn.discordapp.com/attachments/871271381046808607/918215175784530010/TowerUniteSuite_1_2_4.zip)  
**Installation**

1. **Download** the add-on with the link above
2. **Open Blender** (2.8 or above) and go to **Edit** \> **Preferences**
3. On the left, click to switch to the **Add-ons** tab
4. At the top right corner, click **Install…** and choose the **zip file** you downloaded _(TowerUniteSuite\_1\_1\_0.zip)_
5. Ensure the **Community** tab is highlighted and find **Import-Export: Tower Unite Suite** in the list
6. Check the box to the left of it to **enable** the add-on
7. **IF** you are upgrading from **v1.0.0** you should **remove** the previous version from this list

> **Changelog**
>
> > **1.2.4 (Hotfix)**
> >
> > - Fixed a crash introduced in Blender 3.0.0. Beware this is likely to break on earlier versions.
> 
> > **1.2.3**
> >
> > - Fixed a few more issues affecting some of the Pre-processing features.
> > - Pose previews now display correctly when twist bones are missing.
> > - Added yet another pose to the pose previews.
> > - Added a missing icon to the Pre-processing menu.
> 
> > **1.2.1**
> >
> > - Fixed an issue affecting some of the Pre-processing features.
> 
> > **1.2.0**
> >
> > - Fixed a crash on export when in certain modes.
> > - Fixed errors encountered in export when material names contain brackets.
> > - Creating the armature now includes the twist bones as an option, off by default.
> > - Pose previews now correctly pose the arms when they were lowered from 100% on creation/adjust.
> > - Added two new poses and made all pose previews accessible directly from the context menu.
> > - Added Pre-processing features to the Export:  
> > • Limits the export to only contain mesh objects and, if applicable, the TU armature.  
> > • Removes all Vertex Groups that do not match the TU Armature, which would otherwise cause the model to fail to import.  
> > • Allows the use of materials with basic colours, without the need to make and link an image with that colour.  
> > • Modifiers are used in the export, and the Armature modifier is created automatically.  
> > • When using a mirror modifier, missing vertex group opposites will be created to ensure it mirrors the weights correctly.  
> > • Optionally excludes invisible/hidden objects from the export.  
> > • Optionally merges the clavicle bones into other bones (upperarms or spine\_01/02/03).  
> > • Optionally transfers all weights from twist bones to their counterparts.  
> > • Optionally transfers a percentage of weight from the fingers to the hands instead, to reduce sawtooth.
> 
> > **1.1.0**
> >
> > - Migrated to a brand new addon format for easier updates in future.
> > - Fixed errors encountered in export when material names start with a number character or contain spaces.
> > - You can now choose a colour scheme for your rig which will show in Pose Mode.
> > - Added the ability to adjust the Tower Unite armature through a new menu: Edit Mode → Armature → Tower Unite Rig → Adjust
> > - Improved the UI when adding the Tower Unite Armature: it is now expanded and requires confirmation to close.
> > - The create armature operator will now switch to the Adjust Armature menu when confirmed.
> > - Removed the ability to choose between left/right symmetry when creating the armature.
> > - Added a menu to Pose Mode to preview the rig in poses from Tower Unite, pose data courtesy of PixelTail Games.

> **Screenshots**
>
> ![](https://cdn.discordapp.com/attachments/654457053141794828/816268018652807188/unknown.png)  
> ![](https://cdn.discordapp.com/attachments/654457053141794828/816267874805088266/unknown.png)  
> ![](https://cdn.discordapp.com/attachments/654457053141794828/852418140574711808/unknown.png)  
> ![](https://cdn.discordapp.com/attachments/654457053141794828/852419274084974622/unknown.png)  
> ![](https://cdn.discordapp.com/attachments/654457053141794828/852352274776588318/unknown.png)  
> ![](https://cdn.discordapp.com/attachments/654457053141794828/852421005569818655/unknown.png)

---

<div class="post-metadata">

**Author:** ![Spoom](https://forums.pixeltailgames.com/user_avatar/forums.pixeltailgames.com/spoom/32/51252_2.png) [@Spoom](https://forums.pixeltailgames.com/u/Spoom)\
**Post date:** [June 10, 2021, 5:42am UTC](https://forums.pixeltailgames.com/t/tower-unite-blender-tools-1-2-4/41541/3 "2021-06-10T05:42:52Z")

</div>

**VERSION 1.1.0 IS OUT** - See the download link in the first post.

_Note that if you are upgrading from 1.0.0 you should remove or disable the old version. This should not be the case for future updates._

> **Changelog**
>
> - Migrated to a brand new addon format for easier updates in future.
> - Fixed errors encountered in export when material names start with a number character or contain spaces.
> - You can now choose a colour scheme for your rig which will show in Pose Mode.
> - Added the ability to adjust the Tower Unite armature through a new menu: Edit Mode → Armature → Tower Unite Rig → Adjust
> - Improved the UI when adding the Tower Unite Armature: it is now expanded and requires confirmation to close.
> - The create armature operator will now switch to the Adjust Armature menu when confirmed.
> - Removed the ability to choose between left/right symmetry when creating the armature.
> - Added a menu to Pose Mode to preview the rig in poses from Tower Unite, pose data courtesy of PixelTail Games.

> **Screenshots**
>
> ![](https://cdn.discordapp.com/attachments/654457053141794828/852419274084974622/unknown.png)  
> ![](https://cdn.discordapp.com/attachments/654457053141794828/852352274776588318/unknown.png)  
> ![](https://cdn.discordapp.com/attachments/654457053141794828/852421005569818655/unknown.png)

---

<div class="post-metadata">

**Author:** ![Spoom](https://forums.pixeltailgames.com/user_avatar/forums.pixeltailgames.com/spoom/32/51252_2.png) [@Spoom](https://forums.pixeltailgames.com/u/Spoom)\
**Post date:** [August 1, 2021, 6:20am UTC](https://forums.pixeltailgames.com/t/tower-unite-blender-tools-1-2-4/41541/4 "2021-08-01T06:20:50Z")

</div>

**VERSION 1.2.0 IS OUT** - See the download link in the first post.

_Note that if you are upgrading from 1.0.0 (not 1.1.0) you should remove or disable the old version._

> **Changelog**
>
> - Fixed a crash on export when in certain modes.
> - Fixed errors encountered in export when material names contain brackets.
> - Creating the armature now includes the twist bones as an option, off by default.
> - Pose previews now correctly pose the arms when they were lowered from 100% on creation/adjust.
> - Added two new poses and made all pose previews accessible directly from the context menu.
> - Added Pre-processing features to the Export:  
> • Limits the export to only contain mesh objects and, if applicable, the TU armature.  
> • Removes all Vertex Groups that do not match the TU Armature, which would otherwise cause the model to fail to import.  
> • Allows the use of materials with basic colours, without the need to make and link an image with that colour.  
> • Modifiers are used in the export, and the Armature modifier is created automatically.  
> • When using a mirror modifier, missing vertex group opposites will be created to ensure it mirrors the weights correctly.  
> • Optionally excludes invisible/hidden objects from the export.  
> • Optionally merges the clavicle bones into other bones (upperarms or spine\_01/02/03).  
> • Optionally transfers all weights from twist bones to their counterparts.  
> • Optionally transfers a percentage of weight from the fingers to the hands instead, to reduce sawtooth.

---

<div class="post-metadata">

**Author:** ![Spoom](https://forums.pixeltailgames.com/user_avatar/forums.pixeltailgames.com/spoom/32/51252_2.png) [@Spoom](https://forums.pixeltailgames.com/u/Spoom)\
**Post date:** [August 2, 2021, 3:38pm UTC](https://forums.pixeltailgames.com/t/tower-unite-blender-tools-1-2-4/41541/5 "2021-08-02T15:38:31Z")

</div>

**HOTFIX v1.2.1** - See the download link in the first post.  
_Note that if you are upgrading from 1.0.0 (not 1.1.0 or 1.2.0) you should remove or disable the old version._

> **Changelog**
>
> - Fixed an issue affecting some of the Pre-processing features.

---

<div class="post-metadata">

**Author:** ![Spoom](https://forums.pixeltailgames.com/user_avatar/forums.pixeltailgames.com/spoom/32/51252_2.png) [@Spoom](https://forums.pixeltailgames.com/u/Spoom)\
**Post date:** [August 6, 2021, 7:07pm UTC](https://forums.pixeltailgames.com/t/tower-unite-blender-tools-1-2-4/41541/6 "2021-08-06T19:07:38Z")

</div>

**VERSION 1.2.3 IS OUT** - See the download link in the first post.

_Note that if you are upgrading from 1.0.0 (not 1.1.0 or above) you should remove or disable the old version._

> **Changelog**
>
> - Fixed a few more issues affecting some of the Pre-processing features.
> - Pose previews now display correctly when twist bones are missing.
> - Added yet another pose to the pose previews.
> - Added a missing icon to the Pre-processing menu.

---

<div class="post-metadata">

**Author:** ![nini](https://forums.pixeltailgames.com/user_avatar/forums.pixeltailgames.com/nini/32/60254_2.png) [@nini](https://forums.pixeltailgames.com/u/nini)\
**Post date:** [November 15, 2023, 5:47pm UTC](https://forums.pixeltailgames.com/t/tower-unite-blender-tools-1-2-4/41541/7 "2023-11-15T17:47:51Z")

</div>

Since Blender 4 came out, I noticed that the addon no longer works properly, as bone layers have been removed. ([technically, superseded](https://developer.blender.org/docs/release_notes/4.0/animation_rigging/#bone-collections-and-colors))

I did a quick search through the scripts and saw bone layers weren’t used in any meaningful way, _(they were seemingly only used to hide the root bone)_ so I simply commented out lines 47-49 in TU\_Armature.py, which were causing problems, and it seemed to work fine. And updated the version number to 1.2.5 to avoid confusion.

![image](https://forums.pixeltailgames.com/uploads/default/original/3X/5/2/522c7cddd3f0fb49c5b3f42212f510b32880ffa5.png)

If you want a download link to check it you can grab it here: [https://files.catbox.moe/zz987g.zip](https://files.catbox.moe/zz987g.zip) _(you should grab the version CarbonCopyCat posted below, though)_

Obviously don’t trust my update implicitly, I dunno if anything else might be broken. But hopefully it’ll help any Blender 4 users going forward. I was able to export a model from Blender and import it into Tower Unite just fine with this tiny change.

---

<div class="post-metadata">

**Author:** ![CarbonCopyCat](https://forums.pixeltailgames.com/user_avatar/forums.pixeltailgames.com/carboncopycat/32/59964_2.png) [@CarbonCopyCat](https://forums.pixeltailgames.com/u/CarbonCopyCat)\
**Post date:** [November 15, 2023, 8:33pm UTC](https://forums.pixeltailgames.com/t/tower-unite-blender-tools-1-2-4/41541/8 "2023-11-15T20:33:17Z")

</div>

Here’s the same fix applied to the unreleased beta version, which fixes some stuff like the shoulder width slider not adjusting the clavicle positions properly.  
Should work with any version of Blender that’s 3.2 or above despite the title. Also did some testing myself and everything seems to work fine even when opening existing armatures generated with older versions of Blender.

Edit: linking to the version hosted by PixelTail instead  
[https://towerunite.com/sdk/resources/workshop/Tower\_Unite\_Suite\_BetaBlender4.0.zip](https://towerunite.com/sdk/resources/workshop/Tower_Unite_Suite_BetaBlender4.0.zip)
