SyncTools Pro Installation & Usage Guide

📦 Installation

Unity Setup

Step 1: Install the FBX Exporter Package

1. Open the Unity Editor

2. Go to Window > Package Manager

3. Click the + button (top-left) and choose Add package from git URL

4. Enter: com.unity.formats.fbx

   • Or search FBX Exporter in Unity Registry and install it

5. Wait for the installation to complete

Step 2: Install the SyncTools Plugin

1. Copy the SyncTools folder into your Unity project’s Assets directory

2. Unity will compile automatically. Once finished, you’ll see the SyncTools menu in the top menu bar

Step 3: Configure Settings

1. Open SyncTools > Settings

2. Set Cache Path

   • Default: Documents/cache

   • ⚠️ Important: Must match the cache path used in Blender/Maya

3. Set Import Folder

   • Default: Assets/SyncToolsCache/Incoming

   • Must start with Assets/

🚀 Quick Start

Copy from Unity to Blender/Maya

1. Select objects

   • In Unity, select the GameObjects you want to export in the Hierarchy

2. Copy (Export Selected)

   • Menu: SyncTools > Copy (Export Selected)

   • Shortcut: Ctrl+Shift+C (Windows) or Cmd+Shift+C (Mac)

3. Done

   • The exported data is saved to the cache directory

   • You can now paste/import on the Blender/Maya side

Paste from Blender/Maya into Unity

1. Make sure the cache path matches

   • Confirm Unity’s Cache Path is the same as Blender/Maya’s

2. Paste (Import Latest)

   • Menu: SyncTools > Paste (Import Latest)

   • Shortcut: Ctrl+Shift+V (Windows) or Cmd+Shift+V (Mac)

3. Done

   • The latest cached content is imported and instantiated in the scene

   • Object names and hierarchy are automatically restored

⚙️ Settings Reference

Cache Path

• Purpose: Stores cache files used for copy/paste exchange

• Default: Documents/cache

• Requirement: Must be the same path used in Blender/Maya

Import Folder

• Purpose: Where imported assets are placed inside the Unity project

• Default: Assets/SyncToolsCache/Incoming

• Requirement: Must start with Assets/

Delete Cache Files After Import

• Purpose: Automatically cleans up cache files after a successful paste

• Default: Enabled

• Recommendation: Keep enabled to prevent the cache folder from growing

Set Imported Camera Near Clip

• Purpose: Automatically sets the near clipping plane for imported cameras

• Default: Enabled, value 1.0

• Use case: Helps avoid rendering issues caused by overly small near clip values in Unity

⌨️ Shortcuts

Customize shortcuts: Unity menu Edit > Shortcuts

📋 Workflow Examples

Scenario 1: Unity → Blender

1. Unity: Select objects → Copy (Ctrl+Shift+C)
2. Blender: Open target scene → Paste operation
3. Done: Objects are imported into Blender

Scenario 2: Maya → Unity

1. Maya: Select objects → Copy operation
2. Unity: Open target scene → Paste (Ctrl+Shift+V)
3. Done: Objects are imported into the Unity scene

Scenario 3: Iteration Loop

1. Unity → Blender (edit materials)
2. Blender → Unity (preview results)
3. Unity → Blender (continue tweaking)
... repeat as needed

⚠️ Troubleshooting

Issue 1: Copy fails and says FBX Exporter is missing

Solution:

• Verify the FBX Exporter package is installed

• In Package Manager, search and install com.unity.formats.fbx

Issue 2: Paste fails and cannot find cache files

Solution:

• Confirm the Cache Path matches Blender/Maya

• Make sure you performed a copy/export on Blender/Maya first

• Check that export_*.fbx files exist in the cache folder

Issue 3: Imported object names are incorrect

Solution:

• Confirm hierarchy.txt exists in the cache directory

• Check whether the file is locked by another process or corrupted

Issue 4: Materials are missing after import

Solution:

• Check material/texture paths inside the file

• Ensure texture files are in the expected directory

• Inspect the FBX import Materials settings in Unity Inspector

📌 Important Notes

1. ✅ Cache path must match across Unity, Blender, and Maya

2. ✅ FBX Exporter is required on the Unity side

3. ✅ Naming rules: avoid special characters (e.g., @#%)

4. ✅ Version matching: use the same SyncTools version on all platforms

5. ✅ Undo supported: all operations support Unity Undo (Ctrl+Z)

🔄 Version Compatibility

Unity Support

• ✅ Official: 2021.3 LTS / 2022.3 LTS / 2023.x

• ⚠️ Experimental: 2020.3 LTS

FBX Exporter

• Minimum: 7.1.0

• Recommended: Latest stable

📞 Getting Help

If you run into issues:

• Check Unity’s Console for error messages

• Confirm plugin versions match across all apps

• Verify your cache path settings are correct

SyncTools Pro — making cross-software collaboration easier! 🎨🚀