🛠 Setup & Troubleshooting

This section covers everything you need to get started with your OMNIA character and solve the most common setup issues. From preparing your project environment to fixing missing textures or script loading problems, you'll find step-by-step guidance to ensure the character works as intended.

Whether you're a new user or need to reconfigure a scene, this guide will help you streamline the process and avoid common pitfalls.

📦 What You Receive

When you download an OMNIA character package, the structure will typically look like this:

• • Notes.txt

  • UNZIP_FIRST.zip

  • .blend File
    This is the main character file. Its name follows a consistent format:

Notes.txt
A quick-start file also embedded in the Blender Text Editor. It includes:

• Requirements such as enabling the Rigify add-on.

• Viewport optimization using Simplify.

• Link to the OMNIA documentation.

• Contact for support.

UNZIP_FIRST.zip
This zip includes all required assets and must be extracted before opening the .blend. It contains:

• All texture files (UDIM or packed) required by the material system.

• The OMNIA Basics Tools panel script.

• The rig_ui.py script.

• Any additional supporting files.

Important: Once unzipped, make sure the folder is located next to the .blend file. This ensures all file paths work correctly, especially for textures and scripts.

🔄 Version Compatibility in Blender

My models are usually created using the latest stable version of Blender, but I always make sure they are compatible with version 4.0 and up.

All files are tested on their respective compatible versions before being released. 

🎨 Missing Textures (Pink Shader Issue)

If you open the .blend file and see pink textures, it means Blender can't locate the image files needed for the materials.

This is not a model error—it's just a sign that the textures are missing.

This typically happens when the UNZIP_FIRST.zip file has not been extracted, or when the extracted folder was moved or renamed after the .blend was saved.

✅ How to Fix It:

1. Unzip First: Make sure you’ve extracted the UNZIP_FIRST.zip file before opening the .blend. It contains all the necessary textures, shader setups, and scripts.

2. Keep File Structure Intact: Do not rename or move the extracted folder. The .blend is set up with relative paths, so the textures must remain in their expected locations.

3. Check File Paths:

   • Go to Edit > Preferences > File Paths and ensure "Relative Paths" is enabled.

   • In the .blend file, open the Shader Editor or Image Editor to verify the file paths.

4. Manually Re-Link (if needed):

   • Use File > External Data > Find Missing Files and select the extracted folder where the textures are located.

   • Blender will automatically search and relink them.

Once properly linked, the pink materials should be replaced with the correct skin, eye, clothing, and other shaders as designed.

💡 Important: The textures are separated from the .blend file to keep it lighter and more modular. 

You can also visit this explanatory video: 

🧩 Repeated Face Texture on the Whole Body

If you notice that the face texture appears repeated all over the character’s body, it means the UDIM setup wasn't properly recognized.

This happens when the texture nodes are set to “Single Image” instead of “UDIM Tile Sequence”.

How to fix it:

1. Go to the Shader Editor and select any pink texture node (Diffuse, Displacement, etc.).

2. In the node’s Image Texture settings (sidebar or image panel), change the Source to Tiled or UDIM Tiles.

3. Re-link the image by selecting the correct texture ending in .1001 (e.g., skin_diffuse_1001.png).

4. Blender will automatically load the remaining tiles and map them according to the UDIM layout.

This ensures the full skin texture covers the model properly, with each tile assigned to the correct UV space.

🧱 How to Move the Model Correctly in the Scene

The model should not be moved, scaled, or rotated directly.
It is locked for transformations and parented to the rig, which is the object you should manipulate.

✅ To move, rotate, or scale the character:

• Select the main rig (for example, OMNIA_Rig).

• Use the corresponding controllers to:

  • Move the entire character

  • Rotate or adjust the pose

  • Scale the whole setup (if necessary)

⚠️ Do not apply transformations (Ctrl + A) to the rig or the model unless you know exactly what you're doing. Applying scale incorrectly can cause visible deformations in the mesh.

🦴 An Optimized Rig Organized by Layers

The rig is designed to provide a clean and comfortable animation experience:

• Most bones are hidden to avoid distractions and mistakes.

• You’ll only see the essential controllers: IK, FK, joints, expressions, corrections, etc.

• Everything is organized into bone layers, which you can activate depending on what you need to animate.

The layers are accessible from the side panel (N key) in the OMNIA tab.

❓ Still Need Help?

If you're experiencing a different issue or need further clarification: