# Weaver Series: Setup Guide
~ Individual Tool Installation and Environment Setup ~

Last Updated: 2026-06-30

The Weaver Series (MotionWeaver / LayerWeaver / RigWeaver / BatchWeaver) can be installed and used individually. This guide explains the setup procedures to make each tool immediately available on your PC.

## 1. MotionWeaver (3D Motion Translator) Setup
The most efficient way to use MotionWeaver is to make it "callable from anywhere" via the right-click menu or batch files. To achieve this, setting up the Windows **Environment Variable (PATH)** is required.

### 1.1 Folder Placement
1. Move the downloaded folder (containing `MotionWeaver.exe`, the `templates` folder, etc.) to an easily manageable location on your PC (e.g., `C:\Tools\MotionWeaver`).
    * **Note (Latest File Structure):** `synonyms.json`, which was mentioned in older versions, is no longer included by default. The master schemas are now subdivided into `templates_layerbind.json` and `templates_rubberhose.json` within the `templates/` folder.
    * **Note:** If you change the folder location later, you will need to redo the environment variable setup, so please decide on the location first.

### 1.2 [IMPORTANT] Environment Variable (PATH) Setup
Set it up so that you can "call MotionWeaver with a single command from any folder".
1. **Open System Properties**: Press the Windows key, search for "Environment Variables" (環境変数), and select **"Edit the system environment variables"**.
2. **Environment Variables Button**: Click the "Environment Variables" button at the bottom right.
3. **Edit Path**: Find the item named `Path` in the lower "System variables" or upper "User variables" section, select it, and click "Edit".
4. **Add New**: Click "New" and paste the **full path of the folder** where you placed `MotionWeaver.exe` (e.g., `C:\Tools\MotionWeaver`).
5. **Finish**: Close all windows by clicking "OK".

### 1.3 Operation Check
1. Press `Win + R` on your keyboard, type `cmd`, and press Enter (to launch Command Prompt).
2. Type `MotionWeaver --help` and press Enter.
3. If the help message is displayed, the setup is successful. You can now call MotionWeaver via batch files, etc., from any project folder.

## 2. LayerWeaver (Krita Parsing Plugin) Setup
A plugin to automatically parse layer structures while drawing in Krita.

### 2.1 Navigate to the Destination
Copy and paste the following into the address bar of File Explorer and press Enter:
`%APPDATA%\krita\pykrita`

### 2.2 Place the Files
Copy both the downloaded **`LayerWeaver.desktop`** file and the **`Layerweaver`** folder to this location.
(* If you have `LayerWeaver.zip`, extract it and place the contents here.)

### 2.3 Enable in Krita
1. Launch Krita, go to `Settings` -> `Configure Krita...` -> `Python Plugin Manager`.
2. Check the box for **`LayerWeaver`**.
3. **[REQUIRED] Completely close and restart Krita.**

If LayerWeaver is registered in the "Scripts" under the Tools menu, it has loaded successfully.

## 3. RigWeaver (Moho Rigging Script) Setup
A script to instantly assemble parts drawn in Krita within Moho.

### 3.1 Placement Location
Place it in the following location within Moho's Custom Content folder:
`scripts/tool/we_rigweaver.lua`
(* Even if the filename has a prefix like `we_rigweaver.lua`, simply placing it inside the `tool` folder is fine.)

### 3.2 Operation Check
Launch Moho. If **`RigWeaver`** is displayed at the bottom of the Tools palette (or in the "Other" menu), the setup is complete.
Just load the PSD exported from Krita (LayerWeaver) and run this script to complete the rigging.

## 4. BatchWeaver (Batch Export Tool) Setup
BatchWeaver is an automation tool for running the MotionWeaver translation process sequentially across multiple angles and specific frame ranges.

### 4.1 Placement Location
Use the **`BatchWeaver.py`** included in the downloaded package.
Leave it in the same directory as MotionWeaver (e.g., `C:\Tools\MotionWeaver`).

### 4.2 Operation Check
1. With a Python environment installed, double-click `BatchWeaver.py` or run `python BatchWeaver.py` from the Command Prompt.
2. If the BatchWeaver UI (operation screen) launches, it's successful.

(* For specific instructions on how to write the CSV directive or generate the batch file (`RUN.bat`), please refer to the "BatchWeaver: Batch Export Guide".)

---

## 5. Troubleshooting
The most common stumbling block during setup is the "MotionWeaver path setup".
* **Command is not recognized**: Please double-check if the folder path is correct.
* **Plugin doesn't appear in Krita**: Did you forget to restart? Krita requires a "complete restart" after changing settings.

If the issue remains unresolved, please don't hesitate to contact the author for help. Once the setup is done, you can focus purely on your creative work!
