Installation

Blaze Puppeteer is distributed as a standard Blender extension. This guide covers the initial installation and configuration process for a professional production environment.

Technical Requirements

Prerequisites

Before proceeding, ensure your workstation meets the following specifications:

• Blender Version: Blender 4.2 or newer (including 4.5 and 5.0).
• Operating System: Windows 10/11, macOS 11.0+, or Linux (Ubuntu 22.04+ equivalent).
• Connectivity: Internet connection is required for server-side processing and authentication.
• Dependencies: The add-on includes all necessary Python libraries within the bundle.

---

Installation Steps

Follow these simple steps to get Blaze Puppeteer into Blender.

1. Instant Install (Drag & Drop)

   The fastest way to install Blaze Puppeteer in Blender 4.2+ is to drag the download link directly into your Blender viewport.

   • Try it now: Drag this link Blaze_Puppeteer.zip into your Blender 3D Viewport.
   • Blender will detect the file and ask if you want to install it.

   • Requirement

     This feature works best in Blender 4.2 or newer and requires an active internet connection.

2. Manual: Download the Addon

   If you prefer the traditional way:

   • Go to your Orders Page.
   • Find your Blaze Puppeteer order and click Go to Downloads to get the latest Blaze_Puppeteer.zip.

   • Important

     Do not unzip the file. Blender needs the .zip as it is.

3. Open Blender Preferences

   Open Blender and go to:

   Windows / Linux

   Edit → Preferences

   macOS

   Blender → Settings (or Preferences)

4. Install as an Extension

   • On the left sidebar, click the Get Extensions tab.
   • Click the arrow icon (⌄) in the top right corner.
   • Select Install from Disk… from the menu.
   • Find and select your Blaze_Puppeteer.zip file.

5. Enable the Tool

   • Once installed, search for Blaze in the search bar.
   • Make sure the tool is enabled.
   • It is now ready to use.

---

Updates & Reinstallation

We recommend checking for updates regularly for the best performance.

1. Remove: Go to Preferences → Get Extensions. Search for Blaze Puppeteer and click Remove.

   • Note

     If you installed it as an extension, it must be removed from the Get Extensions tab, not the older Add-ons tab.
2. Restart: Restart Blender to clear out the old files.
3. Install New: Install the new version following the Installation Steps above.

---

Where to find the UI

You can choose where the Blaze Puppeteer tools appear in the Add-on Preferences.

• Sidebar (N-Panel): Places a ‘Blaze’ tab in the 3D Viewport (common for animation).
• Properties Editor: Puts the tools inside the Data tab (Green Character icon) when an armature is present in the scene.
• Both: Shows it in both places so it’s always easy to find.