CASCADEUR-DAZ BRIDGE - COMMANDS FOR CASCADEUR
Version 1.0.1 | AuraVix Studio

This is the Cascadeur half of the bridge. The other half is the DAZ Studio
plugin in the folder above this one; both have to be installed.

IMPORTANT
The Cascadeur part is a Python command package, not a native DLL.
Do not copy it to Cascadeur\plugins. That folder contains Qt runtime plugins and does not load user commands.

CASCADEUR 2026.2
Cascadeur 2026.2 changed the way a command declares its name in the menu.
Commands from a bridge older than 1.0.1 still load on it, without any error in
the Cascadeur log, but register under an empty name and the whole DAZ Bridge
submenu is absent. If you updated Cascadeur to 2026.2 and the submenu
disappeared, install these files over the older ones. They carry both forms of
the declaration and work on 2026.2 and on earlier versions alike.

MANUAL INSTALLATION
1. Close Cascadeur.
2. If an older bridge version was installed previously, remove these old items from BOTH
     %LOCALAPPDATA%\Nekki Limited\Cascadeur\user_scripts\commands
   and
     %LOCALAPPDATA%\Nekki Limited\Cascadeur\cache\Program Files\Cascadeur\resources\scripts\python\commands
   - all daz_bridge_*.py files AND all matching daz_bridge_*.pyc files
   - the cascadeur_bridge folder
   (Cascadeur compiles each script to a .pyc file next to the .py file and keeps loading
   the .pyc even after the .py is deleted, so leftover .pyc files bring old commands back.)
3. Find the Cascadeur installation folder containing cascadeur.exe.
   The default location is usually:
     C:\Program Files\Cascadeur
4. Open COPY_TO_CASCADEUR_FOLDER in this package.
5. Copy its resources folder into the Cascadeur installation folder.
6. Allow Windows to merge the resources folders and approve administrator permission if requested.

After copying, verify that this file exists:
  C:\Program Files\Cascadeur\resources\scripts\python\commands\daz_bridge_01_import_latest_character.py

Also verify this package folder exists:
  C:\Program Files\Cascadeur\resources\scripts\python\commands\cascadeur_bridge

7. Start Cascadeur (a full start is required - the Reload commands menu items do not add
   new commands to the menu).
8. Open Commands > DAZ Bridge. It holds six entries: Import Model
   (Latest from DAZ, Saved from DAZ, Add Latest to Current Scene,
   Add Saved to Current Scene), Import Pose or Animation (Latest from DAZ,
   Saved from DAZ), Send Pose to DAZ, Export Animation to DAZ,
   Export Animations from Folder and Genesis Rig Assistant.

   The order they appear in is Cascadeur's, not ours, and it differs between
   Cascadeur versions. On 2026.2 every menu is sorted: the plain entries come
   first in alphabetical order, then the two submenus, also alphabetically -
   so Export Animation to DAZ leads and Import Model comes near the end. Up to
   2026.1 they appear in the workflow order listed above. The entries and what
   they do are identical either way.

CUSTOM SCRIPTS LOCATION
If ScriptsDir was changed in Cascadeur settings.ini, install the ten daz_bridge_*.py files and the cascadeur_bridge folder into the commands directory belonging to that custom scripts location instead.

UPDATE
Close Cascadeur, replace all daz_bridge_*.py files and the complete cascadeur_bridge folder,
and delete every loose daz_bridge_*.pyc beside them (see step 2). Then start Cascadeur.

UNINSTALL
Close Cascadeur and remove only these items from resources\scripts\python\commands
(both the .py and any matching .pyc files), in the installation folder and in the
cache location listed in step 2:
  daz_bridge_01_import_latest_character.py
  daz_bridge_02_import_saved_character.py
  daz_bridge_03_add_latest_character.py
  daz_bridge_04_add_saved_character.py
  daz_bridge_05_apply_latest_pose.py
  daz_bridge_06_apply_saved_pose.py
  daz_bridge_07_send_pose.py
  daz_bridge_08_export_animation.py
  daz_bridge_09_batch_export.py
  daz_bridge_10_rig_character.py
  cascadeur_bridge\

Exchange folders and exported FBX/JSON files are not stored here and should not be removed.

NOTE ON COMMAND NAMES
The bridge command names end with invisible characters. On Cascadeur 2026.1 and
earlier they pin the order the entries appear in; on 2026.2 Cascadeur sorts the
menu itself and they no longer have any effect. They are kept so that one
package serves both.
If you assigned custom hotkeys to bridge commands in a build older than rc2-dev9,
assign them again once after updating.

DOCUMENTATION
The complete user guide is the PDF in the Documentation folder of this package.