Folder Sync & Mappings
Folder Sync walkthrough
Coming soon
A mapping is one rule that says “copy files from this folder into these folders.” It watches a single source folder and copies matching files into one or more destination folders, recreating the same subfolder structure. You add and edit mappings on the Mappings tab.
Mapping options
Section titled “Mapping options”Each mapping has these options:
| Option | What it does |
|---|---|
| Name | A label for the mapping, shown in the list and the activity log. Call it whatever helps you (e.g. “Characters”). |
| Source folder (Copy from) | The folder that is watched, including its subfolders. Your originals here are never changed. |
| Destination folders (Copy to) | One or more folders the files are copied into. The subfolder layout is recreated in each one. |
| Extensions | Which file types to copy, separated by commas (e.g. fbx, png, tga). Only these are copied; everything else is ignored. |
| Flatten folders | Folder names whose files should land directly in the destination without that folder. For example, flattening export means Sword/export/sword.fbx copies to Sword/sword.fbx. |
| Excluded folders | Folder names that should never be copied (see below). |
| Enabled | Turn this mapping on or off without deleting it. |
Excluded folders
Section titled “Excluded folders”Files inside an excluded folder are never copied, no matter what your other options say. Use this for work-in-progress or backup folders you don’t want in your project.
- Type folder names, like
wip,_backup,old. Any folder with that name, anywhere inside your source folder, is skipped along with everything in it. One entry covers every matching folder, even ones you add or rename later. - Capitalization and spaces don’t matter -
WIPandwipare treated the same. - Folder names only - a file named
wip.fbxis not excluded by awiprule; only folders are matched.
What gets copied
Section titled “What gets copied”When a file changes, it is copied only if:
- It is not inside an excluded folder.
- Its type is in your Extensions list.
- It is new or newer than the copy already in the destination.
The app also waits until a file has finished saving before copying it, so you never get a half-written file. Deleting a file from the source never deletes it from your project.