@adiholick/nvstudio-mcp 2.3.0 → 2.4.0

package/README.md

@@ -6,8 +6,22 @@ Sistem ini didesain menggunakan **Hybrid Architecture** yang memisahkan logika E
 
 ---
 
-## 🌟 Fitur Unggulan v2.3
-
+## 🌟 Fitur Unggulan v2.4 (Animation, VFX & Rigging Suite)
+
+- 🏗️ **NV-Rig Engine & Joint Kinematics (`inspect_rig`, `auto_rig`, `edit_rig_joint`, `weld_assembly`, `mirror_rig`)**:
+  - **Pure Headless Dispatcher**: Operasi rigging deterministik instan ($O(1)$) tanpa overhead render visual.
+  - **Hukum Non-Dislokasi Poros (*Non-Dislocation Law*)**: Menggeser/memutar titik engsel sendi di dunia nyata dengan kompensasi otomatis $C_1 = C_{1\text{old}} \times \text{diff}$ tanpa pernah mendislokasi part anak.
+  - **1-Click Auto-Rigging**: Membangun rig lengkap R6 (6 part), R15 (15 part), maupun penautan senjata (`WeaponGrip`) secara instan dengan auto-unanchor.
+  - **Bilateral X-Axis Mirroring & Assembly Welder**: Refleksi simetris sendi kiri $\leftrightarrow$ kanan dan pengelasan seluruh komponen armor/prop ke part jangkar utama.
+- 🏃 **NV-Animation Engine & Kinematics (`animate_character`, `solve_limb_ik`, `scrub_timeline`)**:
+  - **Human-like Motion Synthesis**: Menghasilkan animasi karakter berkualitas tinggi (Walk, Slash, Punch, Idle Breath) berbasis prinsip animasi alami (Anticipation, Follow-Through).
+  - **Interpolasi Kurva Halus**: Menggunakan kurva Cubic Bezier (`PoseEasingStyle.Cubic`) dan Quaternion SLERP 4D rotation interpolation bebas *Gimbal Lock*.
+  - **Analytical 2-Link LimbIK O(1)**: Penyelesaian sudut tekukan siku dan lutut menggunakan Hukum Cosinus sudut tertutup instan dan ekstensi SoftIK anti-snapping.
+  - **Official KeyframeSequence**: Animasi disimpan langsung ke instance resmi di `AnimSaves` karakter, bukan script loop runtime.
+- ✨ **NV-VFX Subsystem & Cross-Project Database (`scan_vfx`, `apply_vfx`, `list_vfx_database`, `delete_vfx`)**:
+  - **1:1 Pure Table Serializer**: Mengonversi `ParticleEmitter`, `Beam`, `Trail`, `Light`, dan `Attachment` menjadi tabel data murni JSON dengan relasi pointer yang aman.
+  - **Database Lintas-Proyek**: Pindai VFX di Project A dan pasang kembali di Project B dengan faktor skala ukuran opsional (`scale`). Dilengkapi 5 preset bawaan (*Cyan Slash*, *Solar Burst*, *Dragon Aura*, *Arcane Rune*, *Emerald Beam*).
+  - **Web Category Browser**: Tab antarmuka web modern dengan filter kategori, pencarian real-time, preview JSON, dan aksi 1-klik.
 - ⚡ **Batch Instance Builder (`batch_create_instances`, `batch_set_properties`)**:
   - Membangun hierarki objek/UI bersarang puluhan tingkat secara instan dalam 1 putaran request (mengeliminasi 10–20 latency roundtrips).
   - Pembaruan properti massal secara atomik dengan dukungan penuh tipe data Roblox (`UDim`, `UDim2`, `Vector2`, `Vector3`, `NumberRange`, `Rect`, dll).
@@ -53,7 +67,7 @@ curl -fsSL https://raw.githubusercontent.com/Adiholick/nvstudio-mcp/main/install
 **Apa saja yang dilakukan installer ini secara otomatis?**
 1. 📦 Mengunduh source code, memasang dependensi Node.js, dan mengkompilasi TypeScript (*Bridge Server*).
 2. 🧩 **Memasang Plugin Roblox Studio (`nvstudio_mcp.rbxmx`) otomatis** ke folder sistem Roblox Studio Anda (`%LOCALAPPDATA%\Roblox\Plugins` di Windows atau `~/Documents/ROBLOX/Plugins` di macOS).
-3. 🧠 **Universal AI Skill Installer**: Menginjeksi skill pemandu (*nvstudio-mcp-guide*, *nvstudio-gui-standards*, *nvstudio-assets-terrain-guide*, *nvstudio-roblox-sync-guide*) dan aturan anti-halusinasi langsung ke struktur editor AI Anda (**Antigravity IDE**, **Cursor**, **Claude Code**, **Codex**, **OpenCode**, dan **Windsurf**).
+3. 🧠 **Universal AI Skill Installer**: Menginjeksi skill pemandu (*nvstudio-mcp-guide*, *nvstudio-gui-standards*, *nvstudio-animation-vfx*, *nvstudio-rig-engine*, *nvstudio-assets-terrain-guide*, *nvstudio-roblox-sync-guide*) dan aturan anti-halusinasi langsung ke struktur editor AI Anda (**Antigravity IDE**, **Cursor**, **Claude Code**, **Codex**, **OpenCode**, dan **Windsurf**).
 4. ⚙️ Melakukan auto-konfigurasi registrasi MCP server pada editor yang terdeteksi.
 
 ---

package/agent-plugin/rules/AGENTS.md

@@ -84,4 +84,35 @@ Saat merancang komponen interaktif khusus, patuhi pola NV-Series:
   - **Item Seleksi:** Gunakan `UIStroke` bernama `SelectStroke`: Active = `Color3.fromRGB(0, 255, 255)` (Cyan), Inactive = `Color3.fromRGB(60, 60, 65)`.
   - **Tombol Non-Aktif / Limit:** Set `AutoButtonColor = false` dan teks status (contoh: `"WAIT (Xs)"`, `"OUT OF QUOTA"`).
 
+## 8. NV-Animation Engine & Kinematics (Anti-Hallucination Ground Truth)
+Saat diminta menganimasikan karakter di Roblox Studio, Anda WAJIB mematuhi ground truth berikut:
+- **DILARANG MENGGUNAKAN LOOP RUNTIME**: Animasi karakter tidak boleh dibuat menggunakan script loop `while true do task.wait() ...`. Animasi wajib dibuat sebagai instance resmi `KeyframeSequence` di dalam `AnimSaves` rig (gunakan tool semantic `animate_character` atau `solve_limb_ik`).
+- **SENSITIVITAS SPASI NAMA MOTOR6D**:
+  - Karakter R15: Menggunakan CamelCase TANPA SPASI (`LeftShoulder`, `LeftElbow`, `LeftWrist`, `LeftHip`, `LeftKnee`, `LeftAnkle`, `Waist`, `Neck`, `Root`).
+  - Karakter R6: WAJIB MENGGUNAKAN SPASI (`Left Shoulder`, `Right Shoulder`, `Left Hip`, `Right Hip`, `Neck`, `RootJoint`).
+- **BATAS SUDUT ANATOMIS AMAN**:
+  - Siku (`LeftElbow`, `RightElbow`) dan Lutut (`LeftKnee`, `RightKnee`) adalah sendi engsel (hinge joint). Dilarang memutar sumbu Roll/Yaw. Sudut tekukan Pitch hanya $0^\circ \dots 145^\circ$ untuk siku dan $0^\circ \dots 135^\circ$ untuk lutut. Dilarang menekuk siku atau lutut ke arah berlawanan (dislokasi).
+  - Torso/Waist pitch dibatasi $-25^\circ \dots 35^\circ$, twist yaw $\pm 45^\circ$.
+- **PRINSIP GERAKAN HALUS (Disney 12 Principles)**:
+  - Setiap gerakan wajib memiliki fase ancang-ancang (*Anticipation*), interpolasi pelambatan (*QuadInOut* atau *CubicInOut*), dan peredaman akhir (*Follow-Through*).
+
+## 9. NV-VFX Serializer & Cross-Project Database Protocols
+Saat memindai, merekonstruksi, atau menerapkan efek visual antar-proyek:
+- **ATTACHMENT HARUS VALID**: Properti `Attachment0` dan `Attachment1` pada `Beam` atau `Trail` HANYA BOLEH menunjuk ke instance bertipe `Attachment`. Dilarang keras menunjuk ke Part atau Model.
+- **ATURAN URUTAN KEYPOINT**: Setiap `ColorSequence` dan `NumberSequence` WAJIB memiliki keypoint awal pada $t = 0.0$ dan keypoint akhir pada $t = 1.0$.
+- **ALUR KERJA LINTAS-PROYEK**:
+  - Gunakan tool `scan_vfx` pada Project A untuk mengonversi partikel, beam, trail, dan light menjadi tabel data murni yang disimpan secara persisten di database MCP.
+  - Gunakan tool `apply_vfx` pada Project B untuk menginstansiasi efek dari database ke target objek dengan parameter `scale` opsional.
+  - Dokumentasi referensi lengkap: lihat `docs/NV_ANIMATION_AND_VFX_GUIDE.md`.
+
+## 10. NV-Rig Engine & Joint Kinematics Protocols (Anti-Hallucination Ground Truth)
+Saat memeriksa, membuat, atau memodifikasi sendi karakter (`Motor6D` / `Weld`):
+- **PERSAMAAN KESEIMBANGAN SAMBUNGAN**: Hubungan spasial sendi diatur oleh `Part0.CFrame * C0 = Part1.CFrame * C1`.
+- **HUKUM NON-DISLOKASI PIVOT**: Saat menggeser atau memutar poros sendi, DILARANG hanya mengubah `C0` sepihak karena akan mendislokasi posisi fisik `Part1`. Nilai `C1` WAJIB dikompensasi secara simultan: `diff = C0_old:ToObjectSpace(C0_new); C1_new = C1_old * diff` (gunakan tool `edit_rig_joint`).
+- **ATURAN WAJIB UNANCHOR**: Seluruh part anak (`Part1`) yang dihubungkan dengan `Motor6D` atau `Weld` WAJIB disetel `Anchored = false`. Part yang berstatus anchored tidak akan dapat bergerak dalam simulasi fisika atau animasi.
+- **URUTAN KERJA RIGGING SEBELUM ANIMASI**: Dilarang memanggil `animate_character` pada model yang belum memiliki hierarki sendi valid. Selalu jalankan `inspect_rig` untuk diagnosa atau `auto_rig` untuk membuat kerangka standar.
+- **PENGELASAN ASSEMBLY SENJATA/PROP**: Gunakan `weld_assembly` untuk menyatukan seluruh komponen prop/senjata secara kaku ke part pegangan sebelum ditautkan ke karakter.
+- **DOKUMENTASI REFERENSI LENGKAP**: lihat `docs/NV_RIG_ENGINE_GUIDE.md`.
+
+
 

package/agent-plugin/skills/nvstudio-animation-vfx/SKILL.md

@@ -0,0 +1,120 @@
+---
+name: nvstudio-animation-vfx
+description: Panduan AI Agent untuk membuat animasi karakter halus (Walk, Slash, Punch, Idle, Custom IK) menggunakan NV-Animation Engine dan mengelola efek visual lintas-proyek dengan NV-VFX Database di Roblox Studio.
+---
+
+# NVStudio Animation Engine & VFX Subsystem Guide
+
+Panduan resmi untuk AI Agent dalam memanfaatkan kemampuan pembuatan animasi karakter manusiawi (*Human-like Motion Synthesis*) dan sistem efek visual portabel lintas-proyek.
+
+---
+
+## 1. Pembuatan Animasi Karakter (`animate_character`)
+
+Gunakan tool `animate_character` untuk menghasilkan animasi yang halus (*smooth*) dengan kurva interpolasi Bezier, pelambatan *easing*, dan *LimbIK* analitis tanpa perlu menghitung sudut CFrame secara manual.
+
+### Parameter Utama:
+- `target`: Path ke Model karakter rig R6 atau R15 di Studio (contoh: `"Workspace.Dummy"`).
+- `action`: Jenis gerakan yang ingin disintesis:
+  - `"walk_cycle"`: Siklus berjalan seimbang dengan pergeseran berat badan dan ayunan tangan berlawanan.
+  - `"melee_slash"`: Serangan tebasan pedang dengan ancang-ancang (*wind-up*), *acceleration snap*, dan *follow-through*.
+  - `"punch"`: Pukulan terarah dengan pemanfaatan LimbIK ke sasaran dan putaran bahu.
+  - `"idle_breath"`: Pernapasan lembut dengan ritme naik-turun dada dan sedikit kemiringan kepala.
+  - `"custom"`: Pose kunci kustom yang disediakan di parameter `key_poses`.
+- `parameters` (opsional):
+  - `duration`: Durasi animasi dalam detik (contoh: `1.0`).
+  - `intensity`: Skala intensitas gerakan (contoh: `1.2`).
+  - `easing`: Jenis kurva interpolasi (`"QuadInOut"`, `"CubicInOut"`, `"BackOut"`, `"ElasticOut"`, dll).
+  - `loop`: Boolean apakah animasi berulang (default: `true` untuk walk/idle, `false` untuk serangan).
+  - `clipName`: Nama klip animasi di `AnimSaves`.
+
+### Contoh Pemanggilan Tool:
+```json
+{
+  "target": "Workspace.Dummy",
+  "action": "melee_slash",
+  "parameters": {
+    "duration": 0.8,
+    "intensity": 1.2,
+    "easing": "CubicInOut",
+    "loop": false,
+    "clipName": "KatanaSlash"
+  }
+}
+```
+
+Hasilnya akan secara otomatis terkompilasi menjadi `KeyframeSequence` resmi di dalam folder `AnimSaves` karakter pada Studio.
+
+---
+
+## 2. Kalkulasi Kinematika Lengan / Kaki (`solve_limb_ik`)
+
+Gunakan tool `solve_limb_ik` untuk mengarahkan telapak tangan atau kaki karakter ke target koordinat 3D secara instan menggunakan solver analitis sudut tertutup $O(1)$ (Hukum Cosinus).
+
+### Parameter:
+- `target`: Path ke karakter rig (contoh: `"Workspace.Dummy"`).
+- `limb`: Anggota tubuh (`"LeftArm"`, `"RightArm"`, `"LeftLeg"`, atau `"RightLeg"`).
+- `goal`: Array posisi 3D `[X, Y, Z]` di world space.
+- `pole`: Array arah tekukan siku/lutut `[X, Y, Z]` (opsional).
+- `apply_to_rig`: Boolean apakah langsung diterapkan ke sendi karakter di Studio (default: `true`).
+
+---
+
+## 3. Scrubbing Timeline & Preview VFX (`scrub_timeline`)
+
+Gunakan tool `scrub_timeline` untuk menggeser playhead waktu animasi dan memicu semburan (burst) partikel VFX pada timestamp tertentu langsung di Viewport Studio tanpa perlu memutar animasi secara penuh:
+
+### Parameter:
+- `target`: Path model karakter rig atau folder VFX (contoh: `"Workspace.Dummy"`).
+- `time`: Posisi timestamp waktu dalam detik (contoh: `0.35`).
+- `action`: Aksi animasi yang di-scrub (`"melee_slash"`, `"walk_cycle"`, `"punch"`, `"idle_breath"`).
+- `emit_vfx`: Boolean apakah memicu semburan partikel pada frame waktu ini (default: `true`).
+- `emit_count`: Jumlah partikel yang disemburkan (default: `20`).
+
+---
+
+## 4. Modifikasi Properti Partikel & VFX (`set_properties` / `batch_set_properties`)
+
+Gunakan `set_properties` untuk mengubah properti partikel VFX secara granular, termasuk `ColorSequence`, `NumberSequence`, `NumberRange`, dan `Rate`:
+```json
+{
+  "target": "Workspace.FlameBurst.ParticleEmitter",
+  "properties": {
+    "Rate": 50,
+    "Speed": [15, 30],
+    "Size": [
+      [0, 1.5, 0],
+      [1, 0.2, 0]
+    ],
+    "Color": [
+      [0, [1, 0.8, 0.2]],
+      [1, [0.8, 0.1, 0]]
+    ]
+  }
+}
+```
+
+---
+
+## 5. Pindai Efek Visual Lintas-Proyek (`scan_vfx`)
+
+Gunakan tool `scan_vfx` pada Project A untuk mengekstrak seluruh hierarki partikel, beam, trail, dan light menjadi tabel data murni yang disimpan secara persisten di database MCP.
+
+### Parameter:
+- `target`: Path objek di Studio (contoh: `"Workspace.FireSpell"`).
+- `name`: Nama efek visual di database (contoh: `"FlameBurst_Ultimate"`).
+- `category`: Kategori efek (`"Slash"`, `"Explosion"`, `"Aura"`, `"Projectile"`, `"Magic"`, `"Impact"`, `"Beam"`, atau `"Ambient"`).
+- `tags`: Array kata kunci (contoh: `["fire", "orange", "anime"]`).
+
+---
+
+## 4. Terapkan Efek Visual di Proyek Lain (`apply_vfx`)
+
+Buka proyek baru (Project B), lalu panggil `apply_vfx` untuk menginstansiasi efek visual yang tersimpan dengan fidelitas 100%.
+
+### Parameter:
+- `vfx_id`: ID efek visual dari database (contoh: `"preset-cyan-slash"`).
+- `target`: Path objek tujuan di Studio (contoh: `"Workspace.Boss.RightHand"`).
+- `scale`: Skala ukuran efek (contoh: `1.5` untuk memperbesar 50%, `0.8` untuk mengecilkan 20%).
+- `enabled`: Boolean opsional untuk menyalakan/mematikan seluruh emitter saat pertama dibuat.
+

package/agent-plugin/skills/nvstudio-mcp-guide/SKILL.md

@@ -67,3 +67,17 @@ Sebelum menulis skrip Luau atau menggunakan API/Service yang belum pasti nama pr
 ## Modifikasi Skrip Cerdas (`patch_script_source`)
 - Jika hanya ingin mengubah sebagian baris kode tanpa menimpa seluruh file skrip, gunakan `patch_script_source` dengan parameter `search` dan `replacement`.
 - Untuk penggantian skrip utuh, gunakan `update_script_source` (otomatis dicek oleh AST Validator di Node.js untuk mencegah syntax error fatal).
+
+## Rigging, Animasi Karakter & Efek Visual (v2.4+)
+nvstudio-mcp dilengkapi dengan rangkaian modular tripartit:
+1. **NV-Rig Engine** (lihat skill `nvstudio-rig-engine`):
+   - Gunakan `inspect_rig` untuk diagnosa kesehatan sendi & anchor status.
+   - Gunakan `auto_rig` untuk membuat rig R6, R15, atau menautkan senjata (`Weapon`).
+   - Gunakan `edit_rig_joint` untuk memindahkan pivot tanpa dislokasi part anak.
+   - Gunakan `weld_assembly` untuk menyatukan armor/prop/kendaraan.
+2. **NV-Animation Engine** (lihat skill `nvstudio-animation-vfx`):
+   - Gunakan `animate_character` untuk membuat animasi resmi `KeyframeSequence` di `AnimSaves` (Walk, Slash, Punch, Idle).
+   - Gunakan `solve_limb_ik` untuk analytical 2-link LimbIK ke koordinat 3D.
+   - Gunakan `scrub_timeline` untuk scrubbing playhead waktu deterministik.
+3. **NV-VFX Subsystem** (lihat skill `nvstudio-animation-vfx`):
+   - Gunakan `scan_vfx` untuk memindai efek visual dan `apply_vfx` untuk merekonstruksinya dari database persisten.

package/agent-plugin/skills/nvstudio-rig-engine/SKILL.md

@@ -0,0 +1,170 @@
+---
+name: nvstudio-rig-engine
+description: Panduan AI Agent untuk memeriksa, membuat, mengedit poros (C0/C1 tanpa dislokasi), auto-rigging R6/R15/senjata, dan mengelas assembly model di Roblox Studio menggunakan NV-Rig Engine.
+---
+
+# NV-Rig Engine: Headless Modular Rigging Suite Guide
+
+Panduan resmi untuk AI Agent dalam mengoperasikan sistem rigging Roblox secara headless menggunakan **NV-Rig Engine**. Modul ini melengkapi **NV-Animation Engine** dan **NV-VFX Subsystem** untuk menghasilkan alur kerja karakter yang lengkap dan anti-halusinasi.
+
+---
+
+## 1. Kapan Harus Menggunakan NV-Rig Engine
+
+Gunakan tool-tool NV-Rig Engine saat:
+- Karakter atau model impor belum memiliki `Motor6D` / sendi gerak.
+- Titik tumpu (*pivot*) bahu, siku, lutut, atau sayap berada di posisi yang salah dan perlu digeser tanpa merusak susunan visual part.
+- Bagian tubuh masih ter-anchor (`Anchored = true`) sehingga animasi tidak dapat menggerakkannya.
+- Ingin menautkan senjata, perisai, atau pedang ke tangan karakter (`Weapon Grip`).
+- Ingin mengelas (*weld*) seluruh komponen helm, armor, atau kendaraan menjadi satu kesatuan kaku.
+- Ingin menyalin konfigurasi sendi sisi kiri ke sisi kanan secara simetris cermin (*X-axis mirror*).
+
+---
+
+## 2. Inspeksi Rig Mendalam (`inspect_rig`)
+
+Selalu awali dengan memanggil `inspect_rig` sebelum melakukan rigging atau animasi untuk mendeteksi potensi masalah secara dini:
+
+```json
+{
+  "target": "Workspace.CharacterModel"
+}
+```
+
+### Yang Didiagnosis oleh `inspect_rig`:
+1. **Daftar Joint**: Semua `Motor6D` dan `Weld`, lengkap dengan nama `Part0`, `Part1`, $C_0$, $C_1$, dan koordinat poros dunia 3D.
+2. **Anchor Warning**: Mendeteksi part yang masih `Anchored = true`. Part anak yang ter-anchor tidak akan bergerak saat dianimasikan!
+3. **Circular Dependency**: Mendeteksi jika ada siklus sambungan tertutup yang dapat membekukan simulasi fisika Roblox.
+4. **Root Part**: Menemukan calon part induk utama (misal `HumanoidRootPart` atau `Torso`).
+
+---
+
+## 3. Auto-Rigging Cerdas 1-Klik (`auto_rig`)
+
+Alih-alih membuat belasan sendi satu per satu, gunakan `auto_rig` untuk membangun pohon hierarki standar dalam sekejap:
+
+### A. Auto-Rig Avatar R15
+Membangun 15 sambungan Motor6D lengkap (`Root`, `Waist`, `Neck`, bahu, siku, pergelangan tangan, panggul, lutut, pergelangan kaki):
+```json
+{
+  "target": "Workspace.CustomR15Avatar",
+  "rig_type": "R15"
+}
+```
+
+### B. Auto-Rig Avatar R6
+Membangun 6 sambungan Motor6D klasik (`RootJoint`, `Neck`, `Left Shoulder`, `Right Shoulder`, `Left Hip`, `Right Hip`):
+```json
+{
+  "target": "Workspace.CustomR6Avatar",
+  "rig_type": "R6"
+}
+```
+
+### C. Auto-Rig Senjata / Tool
+Menghubungkan senjata ke tangan karakter dengan `Motor6D` dinamai `WeaponGrip` dan mengelas seluruh bagian senjata lainnya ke `Handle`:
+```json
+{
+  "target": "Workspace.Knight",
+  "rig_type": "Weapon",
+  "weapon_target": "Workspace.GreatSword",
+  "target_limb": "RightHand"
+}
+```
+
+---
+
+## 4. Manipulasi Poros Sendi Presisi (`edit_rig_joint`)
+
+Gunakan `edit_rig_joint` untuk menggeser, memutar, mereset, menyelaraskan, atau membuat sendi baru.
+
+### A. Geser Poros Sendi (Non-Dislocation Law)
+Menggeser titik engsel sendi di dunia nyata tanpa membuat part anak terlempar:
+```json
+{
+  "target": "Workspace.CharacterModel",
+  "action": "edit_pivot",
+  "joint_name": "RightShoulder",
+  "delta_world": [0, 0.5, 0]
+}
+```
+
+### B. Pindahkan Poros ke Koordinat Dunia Tertentu
+Menempatkan titik engsel tepat pada koordinat target 3D:
+```json
+{
+  "target": "Workspace.CharacterModel",
+  "action": "edit_pivot",
+  "joint_name": "RightElbow",
+  "target_world": [10.5, 5.0, -12.3]
+}
+```
+
+### C. Putar Orientasi Poros
+Memutar orientasi sumbu lokal sendi sebesar sudut Euler derajat:
+```json
+{
+  "target": "Workspace.CharacterModel",
+  "action": "rotate_pivot",
+  "joint_name": "Neck",
+  "rotate_euler_deg": [0, 90, 0]
+}
+```
+
+### D. Reset Poros ke Pusat Part Anak
+Mengembalikan $C_0$ langsung ke origin Part1 dan mengosongkan $C_1$:
+```json
+{
+  "target": "Workspace.CharacterModel",
+  "action": "reset_pivot",
+  "joint_name": "LeftShoulder"
+}
+```
+
+### E. Buat Sendi Baru Secara Spesifik
+```json
+{
+  "target": "Workspace.CharacterModel",
+  "action": "create_joint",
+  "joint_name": "TailJoint1",
+  "part0": "LowerTorso",
+  "part1": "TailBase"
+}
+```
+
+---
+
+## 5. Pengelasan Assembly Model (`weld_assembly`)
+
+Gunakan `weld_assembly` untuk menyatukan seluruh komponen pada sebuah model (aksesori, sayap dekoratif, helm, armor, kendaraan) ke part jangkar utama:
+```json
+{
+  "target": "Workspace.ArmorSet",
+  "primary_part": "Chestplate"
+}
+```
+*Catatan: Semua part anak otomatis di-unanchor dan dilas ke `Chestplate` menggunakan transformasi $C_0$ yang presisi.*
+
+---
+
+## 6. Pencerminan Simetri Bilateral (`mirror_rig`)
+
+Jika Anda telah mengonfigurasi poros sendi sisi kiri (`LeftShoulder`, `LeftElbow`, dll.), gunakan `mirror_rig` untuk mencerminkan nilai $C_0$ dan $C_1$ ke sisi kanan secara simetris sepanjang sumbu $X$:
+```json
+{
+  "target": "Workspace.CharacterModel",
+  "source_side": "Left"
+}
+```
+
+---
+
+## 7. Alur Kerja Komprehensif: Rigging $\rightarrow$ Animasi $\rightarrow$ VFX
+
+Ketika pengguna meminta animasi pertarungan lengkap:
+1. **Langkah 1**: Panggil `inspect_rig` pada karakter. Jika belum ada joint, jalankan `auto_rig` (mode `"R15"`).
+2. **Langkah 2**: Jika ada senjata, panggil `weld_assembly` pada senjata, lalu panggil `auto_rig` mode `"Weapon"`.
+3. **Langkah 3**: Buat animasi halus menggunakan `animate_character` (misal aksi `"melee_slash"` dengan `vfx_events`).
+4. **Langkah 4**: Pasang efek visual menggunakan `apply_vfx` dari database persisten.
+5. **Langkah 5**: Scrub timeline menggunakan `scrub_timeline` ke timestamp tebasan untuk memverifikasi pose dan partikel.
+