@adiholick/nvstudio-mcp 2.4.0 → 2.4.1

package/agent-plugin/rules/AGENTS.md

@@ -114,5 +114,30 @@ Saat memeriksa, membuat, atau memodifikasi sendi karakter (`Motor6D` / `Weld`):
 - **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`.
 
+## 11. Standar Dekomposisi VFX Prosedural & Protokol Creator Store Higienis (Anti-Shortcut Ground Truth)
+Saat diminta merancang efek visual, sihir, aura, proyektil, atau skill anime/game (seperti Rasengan, Fireball, Katana Slash, Aura Super, dll):
+- **HAKEKAT DASAR VFX**: Sejatinya sebuah efek visual di Roblox adalah gabungan dari gambar/decal/tekstur 2D yang diputar (`RotSpeed`), diskalakan (`SizeSequence`), diinterpolasi warnanya (`ColorSequence`), dipancarkan via `ParticleEmitter` / `Beam` / `Trail`, diperkaya pencahayaan dinamis (`PointLight`), dan disinkronkan dengan efek suara (`Sound`).
+- **LARANGAN KERAS PENGGUNAAN MENTAH (ANTI-RAW MODEL SHORTCUT)**:
+  - Dilarang keras mengandalkan free model Creator Store yang disuntikkan secara mentah ke karakter atau workspace dengan script bawaannya yang rentan backdoor, malware, laggy loop, dan ukuran tidak proporsional.
+- **KATEGORI CREATOR STORE RESMI YANG DIIZINKAN**:
+  - `Images` (Decals/Textures): Mengambil aset visual 2D murni (misal: *wind swirl*, *energy blade*, *magic ring*, *lightning sprite*, *flipbook sheet*) tanpa risiko kode eksekusi.
+  - `Visual Effects` (Sub-kategori `Particle Effects`): Mengambil preset partikel kompleks.
+  - `Audio`: Mengambil efek suara resmi (*charge whine*, *whoosh*, *blast*, *boom*).
+- **PROTOKOL PEMBEDAHAN ASET (ASSET SURGERY PROTOCOL)**:
+  Jika mengimpor aset dari kategori `Visual Effects` atau Model:
+  1. **Audit Keamanan Mutlak**: Wajib panggil `scan_security` untuk memusnahkan seluruh script, backdoor, dan `require(id)`.
+  2. **Dekomposisi Visual**: Ekstrak HANYA objek visual murni (`ParticleEmitter`, `Beam`, `Attachment`, `TextureId`, sequences).
+  3. **Pemusnahan Container**: Hapus model pembungkus asli beserta script-scriptnya.
+  4. **Rekonstruksi Higienis**: Pasang partikel bersih ke anchor/rig karakter menggunakan `batch_create_instances` / `set_properties`.
+  5. **Simpan ke Database**: Simpan konfigurasi ke NV-VFX Database via `scan_vfx` agar menjadi aset mandiri portabel proyek.
+- **BLUEPRINT 5-LAYER PROSEDURAL WAJIB**:
+  Setiap efek skill berkekuatan tinggi wajib dibangun dengan dekomposisi 5 layer:
+  1. *Core Anchor*: Part/Mesh Ball Neon transparan + Attachment pusat rotasi.
+  2. *Dynamic Emitters*: `ParticleEmitter` akselerasi inward (hisapan angin/energi) dengan `RotSpeed` tinggi.
+  3. *Ribbons & Blades*: `Beam` atau `Trail` silang (*X-Shape*) membentuk bilah tajam memotong.
+  4. *Atmosphere & Glow*: `PointLight` dinamis (pantulan ke tubuh karakter) + cincin shockwave tanah.
+  5. *Acoustic Feedback*: Objek `Sound` (Charge high-pitch whine + Burst impact).
+
+
 
 

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

@@ -108,7 +108,7 @@ Gunakan tool `scan_vfx` pada Project A untuk mengekstrak seluruh hierarki partik
 
 ---
 
-## 4. Terapkan Efek Visual di Proyek Lain (`apply_vfx`)
+## 6. 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%.
 
@@ -118,3 +118,100 @@ Buka proyek baru (Project B), lalu panggil `apply_vfx` untuk menginstansiasi efe
 - `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.
 
+---
+
+## 7. Dekomposisi Partikel Prosedural & Pembedahan Aset Creator Store (Asset Surgery)
+
+DILARANG mengambil free model mentah dari Creator Store untuk efek skill/kemampuan game. Seluruh efek wajib dirakit secara prosedural atau dibedah secara higienis melalui alur berikut:
+
+### A. Blueprint 5-Layer Prosedural Wajib:
+1. **Core Anchor**: Objek bola neon (`Ball`, `Neon`, transparansi $0.2-0.4$) atau `Attachment` pusat gravitasi.
+2. **Rotational Emitters**: `ParticleEmitter` berkecepatan putar tinggi (`RotSpeed = [400, 700]`) dengan akselerasi inward (menyedot ke pusat).
+3. **Ribbons & Blades**: 4 `Beam` atau `ParticleEmitter` silang (*X-Shape*) untuk membentuk bilah energi berputar.
+4. **Atmosphere & Shockwave**: `PointLight` dinamis (Range: 12, Brightness: 3, Color Cyan/Orange) + partikel cincin gelombang kejut (*Ring Wave*).
+5. **Acoustic SFX**: Objek `Sound` (Charge whine frekuensi tinggi + Burst explosion impact).
+
+### B. Pengambilan Aset Creator Store yang Sah & Higienis:
+- **`Images` (Decals/Textures)**: Cari aset visual 2D (seperti *wind swirl*, *energy blade*, *magic ring*, *lightning sprite*). Salin `Texture` ID dan gunakan langsung di properti `Texture` dari `ParticleEmitter` atau `Beam`.
+- **`Visual Effects` (Sub-kategori `Particle Effects`)**: Jika mengimpor preset partikel kompleks:
+  1. Jalankan `scan_security` untuk memastikan 100% bebas script backdoor dan `require(id)`.
+  2. Ekstrak hanya instance visual (`ParticleEmitter`, `Beam`, sequences).
+  3. Hapus model pembungkus asli dan seluruh script bawaan.
+  4. Rakit ulang ke rig karakter via `batch_create_instances`.
+  5. Simpan ke NV-VFX Database via `scan_vfx`.
+
+### C. Contoh Blueprint Perakitan Prosedural (`batch_create_instances`):
+```json
+{
+  "instances": [
+    {
+      "className": "Attachment",
+      "parent": "Workspace.Dummy.RightHand",
+      "name": "RasenAnchor",
+      "properties": {
+        "Position": [0, -1.2, 0]
+      },
+      "children": [
+        {
+          "className": "Part",
+          "name": "CoreOrb",
+          "properties": {
+            "Shape": "Ball",
+            "Size": [1.2, 1.2, 1.2],
+            "Material": "Neon",
+            "Color": [0, 0.85, 1],
+            "Transparency": 0.25,
+            "CanCollide": false,
+            "Anchored": false
+          }
+        },
+        {
+          "className": "ParticleEmitter",
+          "name": "InwardSwirl",
+          "properties": {
+            "Rate": 60,
+            "Lifetime": [0.3, 0.5],
+            "Speed": [1, 3],
+            "RotSpeed": [400, 800],
+            "Acceleration": [0, 0, 0],
+            "Color": [
+              [0, [0.4, 0.9, 1]],
+              [1, [0.9, 1, 1]]
+            ],
+            "Size": [
+              [0, 1.8, 0],
+              [1, 0.2, 0]
+            ],
+            "Transparency": [
+              [0, 0.8, 0],
+              [0.5, 0.1, 0],
+              [1, 1, 0]
+            ]
+          }
+        },
+        {
+          "className": "PointLight",
+          "name": "AmbientGlow",
+          "properties": {
+            "Color": [0, 0.8, 1],
+            "Range": 14,
+            "Brightness": 3.5,
+            "Shadows": true
+          }
+        },
+        {
+          "className": "Sound",
+          "name": "ChargeSFX",
+          "properties": {
+            "Volume": 0.85,
+            "Looped": true,
+            "PlaybackSpeed": 1.15
+          }
+        }
+      ]
+    }
+  ]
+}
+```
+
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adiholick/nvstudio-mcp",
-  "version": "2.4.0",
+  "version": "2.4.1",
   "description": "Local Bridge Server MCP for Roblox Studio with Animation, VFX, and Rigging Engines",
   "main": "dist/index.js",
   "bin": {

package/public/index.html

@@ -1156,7 +1156,7 @@
         </nav>
 
         <div class="sidebar-footer">
-            <span class="badge-v2" id="pkg-version">v2.4.0</span>
+            <span class="badge-v2" id="pkg-version">v2.4.1</span>
             <span style="font-size:10px; opacity:0.6;">Model Context Protocol</span>
         </div>
     </aside>
@@ -1484,7 +1484,7 @@
             <div class="page" id="page-about">
                 <div class="about-section">
                     <div class="about-hero">
-                        <h2>nvstudio-mcp <span class="v2-chip" id="about-version-chip">v2.4.0</span></h2>
+                        <h2>nvstudio-mcp <span class="v2-chip" id="about-version-chip">v2.4.1</span></h2>
                         <p>Jembatan pintar berbasis <strong>Model Context Protocol (MCP)</strong> yang menghubungkan AI Agent (Antigravity IDE, Cursor, Claude Desktop, Windsurf) secara langsung ke dalam <strong>Roblox Studio</strong>.</p>
                         <div class="about-links">
                             <a class="about-link" href="https://github.com/Adiholick/nvstudio-mcp" target="_blank">
@@ -1499,7 +1499,7 @@
                     </div>
 
                     <div class="about-card">
-                        <h3>🚀 Fitur Baru v2.4.0</h3>
+                        <h3>🚀 Fitur Baru v2.4.1</h3>
                         <ul>
                             <li><strong>🦴 NV-Rig Engine:</strong> Rigging headless presisi $O(1)$ untuk R6, R15, dan Custom Rig. Menyediakan inspeksi sendi (<code>inspect_rig</code>), pemindahan poros C0/C1 simultan anti-dislokasi (<code>edit_rig_joint</code>), auto-rigging instan (<code>auto_rig</code>), dan assembly welding senjata/prop (<code>weld_assembly</code>).</li>
                             <li><strong>🎬 NV-Animation Engine:</strong> Pembuatan animasi karakter halus alami (Walk, Slash, Punch, Idle, IK) langsung menjadi <code>KeyframeSequence</code> resmi dengan interpolasi Bezier (Cubic/Quad) dan penegakan batas anatomis aman tanpa glitch.</li>

package/studio-plugin/Main.server.lua

@@ -1,5 +1,5 @@
 -- ══════════════════════════════════════════════════════════════════════
--- NVStudio MCP Plugin v2.4.0
+-- NVStudio MCP Plugin v2.4.1
 -- Arsitektur: Dual-Mode WebSocket Duplex (Port 3055/ws) + Fallback Long-Polling
 -- Plugin auto-connect saat dimuat via WebSocket native, dengan fallback otomatis
 -- ke HTTP stream jika WebSocket tidak tersedia di environment Roblox Studio ini.

package/studio-plugin/nvstudio_mcp.rbxmx

@@ -976,7 +976,7 @@ end
 				<BinaryString name="Tags"></BinaryString>
 				<token name="RunContext">0</token>
 				<ProtectedString name="Source"><![CDATA[-- ══════════════════════════════════════════════════════════════════════
--- NVStudio MCP Plugin v2.4.0
+-- NVStudio MCP Plugin v2.4.1
 -- Arsitektur: Dual-Mode WebSocket Duplex (Port 3055/ws) + Fallback Long-Polling
 -- Plugin auto-connect saat dimuat via WebSocket native, dengan fallback otomatis
 -- ke HTTP stream jika WebSocket tidak tersedia di environment Roblox Studio ini.
@@ -5584,7 +5584,7 @@ function UIManager.init(pluginInstance, studioId)
 
     -- Version
     local versionLabel = Instance.new("TextLabel")
-    versionLabel.Text = "v2.4.0"
+    versionLabel.Text = "v2.4.1"
     versionLabel.Font = Enum.Font.Gotham
     versionLabel.TextSize = 11
     versionLabel.TextColor3 = Color3.fromRGB(120, 120, 130)

package/studio-plugin/ui_manager.lua

@@ -95,7 +95,7 @@ function UIManager.init(pluginInstance, studioId)
 
     -- Version
     local versionLabel = Instance.new("TextLabel")
-    versionLabel.Text = "v2.4.0"
+    versionLabel.Text = "v2.4.1"
     versionLabel.Font = Enum.Font.Gotham
     versionLabel.TextSize = 11
     versionLabel.TextColor3 = Color3.fromRGB(120, 120, 130)