Skip to content

Commit

Permalink
added update template guide
Browse files Browse the repository at this point in the history
added troubleshooting guide to update Blender 3.6 created templates to Blender 4+
  • Loading branch information
JoshQuake committed Jan 31, 2025
1 parent 5d5a041 commit 6c7f18b
Show file tree
Hide file tree
Showing 9 changed files with 48 additions and 2 deletions.
50 changes: 48 additions & 2 deletions docs/ue2rigify/trouble-shooting/faq.md
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,52 @@ Rigify generates a new rigify rig, those could get stomped on. Thus, renaming th
rig is necessary for this to work.

## Where are Rig templates stored?
Rig templates are stored within:
Default location for Rig templates if a custom location hasn't been set:
- windows: `%TEMP%\ue2rigify\resources\rig_templates`
- unix: `/tmp/ue2rigify/resources/rig_templates`
- unix: `/tmp/ue2rigify/resources/rig_templates`

## How do I update a metarig made in Blender 3.6 for use in 4.0+?
Since Blender 4.0 removed Bone Layers, Rigify had to change the generated template which causes an error when importing your UE2Rigify template.

However there is a solution built into Rigify that can update the metarig when you load a 3.6 Blend file in Blender 4+. Here's how you can update your template:

>Requires Blender 3.6
1. Open your exported template zip file and extract the metarig.py file to the following location in your Blender 3.6 install:

`C:\Program Files\Blender Foundation\Blender 3.6\3.6\scripts\addons\rigify\metarigs`

![1](./images/1.png)

2. Rename metarig.py to something recognizable i.e.
`demometarig.py`

3. Open Blender 3.6 and add your metarig to the scene

![2](./images/2.png)

4. Create a new save, close Blender 3.6, and open the new save in Blender 4+

5. Select the rig and open the Armature data tab. You should see Rigify tell you it needs to update to Collections. Click `Upgrade Metarig`

![3](./images/3.png)

6. Switch to Edit Mode with the armature still selected. A Rigify menu should appear at the top. Click `Rigify > Encode Metarig`

![4](./images/4.png)

7. Switch your Viewport to Text Editor and open the new metarig.py

![5](./images/5.png)

![6](./images/6.png)

8. Save the file to Desktop keeping the name as `metarig.py` and replace the metarig file in your template zip with the new one.

![7](./images/7.png)

9. Before attempting to import your template again, **you must delete the previous attempt from UE2Rigify's templates folder.** Default location can be found above.

10. Restart Blender 4+ and import your template. It should now work as intended!

![8](./images/8.png)
Binary file added docs/ue2rigify/trouble-shooting/images/1.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/ue2rigify/trouble-shooting/images/2.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/ue2rigify/trouble-shooting/images/3.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/ue2rigify/trouble-shooting/images/4.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/ue2rigify/trouble-shooting/images/5.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/ue2rigify/trouble-shooting/images/6.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/ue2rigify/trouble-shooting/images/7.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added docs/ue2rigify/trouble-shooting/images/8.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 6c7f18b

Please sign in to comment.