@adiholick/nvstudio-mcp 2.0.1 → 2.0.2

package/README.md

@@ -8,9 +8,14 @@ Sistem ini didesain menggunakan **Hybrid Architecture** yang memisahkan logika E
 
 ## 📥 Instalasi
 
-Langkah instalasinya **sangat gampang!**
+Langkah instalasi dirancang **sangat mudah dan otomatis!**
 
-### 1. Jalankan Installer (Otomatis)
+> 💡 **Apakah perlu install plugin Roblox secara manual?**
+> **TIDAK PERLU.** Jika Anda menjalankan skrip installer di bawah (Langkah 1), installer akan **secara otomatis menyalin plugin (`nvstudio_mcp.rbxmx`)** langsung ke folder plugin Roblox Studio di sistem operasi Anda.
+
+---
+
+### Langkah 1: Jalankan Installer (Otomatis & Direkomendasikan)
 
 Pilih perintah sesuai terminal yang Anda gunakan:
 
@@ -24,25 +29,40 @@ irm https://raw.githubusercontent.com/Adiholick/nvstudio-mcp/main/install.ps1 |
 curl -fsSL https://raw.githubusercontent.com/Adiholick/nvstudio-mcp/main/install.sh | bash
 ```
 
+**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. 🤖 Mengintegrasikan *AI Agent Skills* anti-halusinasi langsung ke **Antigravity IDE** (`~/.gemini/config/plugins/nvstudio-mcp`).
+4. ⚙️ Melakukan auto-konfigurasi jika mendeteksi editor **Cursor** (`.cursor/mcp.json`).
 
-**Installer ini akan secara otomatis melakukan hal berikut:**
-- Memasang dependensi Node.js dan melakukan kompilasi TypeScript (*Bridge Server*).
-- Menyalin file plugin `nvstudio_mcp.rbxmx` ke dalam sistem Plugin Roblox Studio di OS Anda (Windows/macOS/WSL) secara otomatis.
-- Mengintegrasikan *AI Agent Skills* langsung ke **Antigravity IDE** (`~/.gemini/config/plugins/nvstudio-mcp`).
-- Melakukan auto-konfigurasi JSON jika Anda menggunakan **Cursor Editor**.
+---
 
-### 2. Mengaktifkan Izin di Roblox Studio
-1. Buka proyek game Anda di Roblox Studio.
-2. Di pojok kiri atas, buka **Home** -> **Game Settings** -> **Security**.
-3. Centang (aktifkan) opsi **`Allow HTTP Requests`** agar plugin dapat berkomunikasi dengan AI.
+### Langkah 2: Mengaktifkan Izin di Roblox Studio (Wajib)
+
+Karena pembatasan keamanan bawaan Roblox Studio, akses HTTP harus diizinkan sekali per place/game:
+1. Buka game/place Anda di **Roblox Studio**.
+2. Di toolbar atas, buka tab **Home** ➔ **Game Settings** ➔ pilih menu **Security**.
+3. Centang (aktifkan) **`Allow HTTP Requests`**, lalu klik **Save**.
+4. **Auto-Detect Aktif!** Plugin Roblox Studio kini memiliki heartbeat pintar yang akan otomatis terhubung (*Auto-Connect*) segera setelah MCP server aktif — Anda tidak perlu lagi repot menekan tombol connect secara manual.
 
 ---
 
-## 🔌 Cara Menggunakan (Untuk AI Lain)
+### 📂 Alternatif: Instalasi Plugin Secara Manual (Opsional)
+
+Jika Anda **tidak** menggunakan skrip installer otomatis di atas (misalnya hanya menambahkan server via `npx` di klien AI), pasang file plugin Roblox Studio secara manual:
+1. Ambil file `nvstudio_mcp.rbxmx` dari folder [studio-plugin/nvstudio_mcp.rbxmx](file:///studio-plugin/nvstudio_mcp.rbxmx).
+2. Pindahkan/salin file tersebut ke direktori plugin Roblox di komputer Anda:
+   - **Windows:** `%LOCALAPPDATA%\Roblox\Plugins` (atau `C:\Users\<Username>\AppData\Local\Roblox\Plugins`)
+   - **macOS:** `~/Documents/ROBLOX/Plugins`
+3. Restart atau buka kembali Roblox Studio. Plugin akan muncul di tab **Plugins**.
 
-Jika Anda menggunakan AI Client lain (misalnya: **Claude Desktop** atau klien yang tidak dikonfigurasi otomatis), Anda dapat menambahkan `nvstudio-mcp` secara manual ke konfigurasi `mcp.json` Anda.
+---
 
-Salin konfigurasi ini:
+## 🔌 Cara Menggunakan (Konfigurasi MCP Klien AI)
+
+Jika Anda menggunakan AI Client lain seperti **Claude Desktop**, **Windsurf**, atau ingin menambahkan konfigurasi secara manual:
+
+Tambahkan konfigurasi berikut ke file `mcp.json` Anda:
 ```json
 {
   "mcpServers": {
@@ -56,7 +76,15 @@ Salin konfigurasi ini:
   }
 }
 ```
-*(Dengan ini, AI Anda akan selalu mengunduh dan menjalankan versi terbaru dari server Bridge langsung dari NPM, tanpa perlu path folder lokal!)*
+*(AI Anda akan selalu menjalankan versi terbaru dari server Bridge langsung dari NPM!)*
+
+---
+
+## 🖥️ Dashboard Visual & Fitur Pintar v2.0
+
+- **Visual Dashboard Real-time:** Buka [http://localhost:3055](http://localhost:3055) di browser Anda untuk melihat monitor antrean perintah, log aktivitas AI, status koneksi Studio, dan statistik eksekusi secara visual.
+- **Auto-Detect & Auto-Connect:** Plugin Roblox Studio otomatis menyambung ke server saat aktif dan kembali menunggu (*Waiting*) saat server mati tanpa interupsi manual.
+- **Anti-Zombie Port Handling:** Tidak perlu khawatir error `EADDRINUSE`. Jika port `3055` tertahan oleh proses zombie akibat restart editor/IDE, server akan otomatis membersihkan port tersebut secara aman.
 
 ---
 

package/dist/build-plugin.js

@@ -39,7 +39,7 @@ function buildRbxmx() {
     xml += `\t\t\t<bool name="DefinesCapabilities">false</bool>\n`;
     xml += `\t\t\t<string name="Name">nvstudio_mcp</string>\n`;
     xml += `\t\t\t<int64 name="SourceAssetId">-1</int64>\n`;
-    xml += `\t\t\t<SharedString name="Tags">yuZpQdnvvUBOTYh1jqZ2cA==</SharedString>\n`;
+    xml += `\t\t\t<SharedString name="Tags"></SharedString>\n`;
     xml += `\t\t</Properties>\n`;
     // Process files
     for (const file of files) {
@@ -49,8 +49,9 @@ function buildRbxmx() {
         // Main.server.lua is a Script, others are ModuleScripts
         const isMain = name === 'Main.server';
         const className = isMain ? 'Script' : 'ModuleScript';
-        // Use a simple hash-like referent
-        const referent = `RBX_${name.replace(/[^a-zA-Z0-9]/g, '_')}`;
+        const scriptName = isMain ? 'Main' : name;
+        // Use a clean referent
+        const referent = `RBX_${scriptName.replace(/[^a-zA-Z0-9]/g, '_')}`;
         xml += `\t\t<Item class="${className}" referent="${referent}">\n`;
         xml += `\t\t\t<Properties>\n`;
         xml += `\t\t\t\t<BinaryString name="AttributesSerialize"></BinaryString>\n`;
@@ -58,7 +59,7 @@ function buildRbxmx() {
         xml += `\t\t\t\t<bool name="DefinesCapabilities">false</bool>\n`;
         xml += `\t\t\t\t<bool name="Disabled">false</bool>\n`;
         xml += `\t\t\t\t<Content name="LinkedSource"><null></null></Content>\n`;
-        xml += `\t\t\t\t<string name="Name">${name}</string>\n`;
+        xml += `\t\t\t\t<string name="Name">${scriptName}</string>\n`;
         xml += `\t\t\t\t<int64 name="SourceAssetId">-1</int64>\n`;
         xml += `\t\t\t\t<SharedString name="Tags"></SharedString>\n`;
         if (isMain) {
@@ -73,11 +74,7 @@ function buildRbxmx() {
     }
     // Close Folder
     xml += `\t</Item>\n`;
-    // Shared Strings definition (required by Roblox XML format if Tags is used)
-    xml += `\t<SharedStrings>\n`;
-    xml += `\t\t<SharedString md5="yuZpQdnvvUBOTYh1jqZ2cA=="></SharedString>\n`;
-    xml += `\t</SharedStrings>\n`;
-    // Close Roblox
+    // Close Roblox root (No SharedStrings block needed when all Tags are empty)
     xml += `</roblox>\n`;
     fs_1.default.writeFileSync(OUTPUT_FILE, xml, 'utf-8');
     console.log(`[Build] Berhasil membuat ${OUTPUT_FILE}`);
@@ -111,5 +108,14 @@ function copyToRobloxPlugins() {
     else {
         console.log(`[Build] Platform ${process.platform} tidak didukung untuk auto-copy plugin.`);
     }
+    // Also update ~/.nvstudio-mcp/studio-plugin/nvstudio_mcp.rbxmx if present
+    const homeClonePlugin = path_1.default.join(os_1.default.homedir(), '.nvstudio-mcp', 'studio-plugin', 'nvstudio_mcp.rbxmx');
+    if (fs_1.default.existsSync(path_1.default.dirname(homeClonePlugin))) {
+        try {
+            fs_1.default.copyFileSync(OUTPUT_FILE, homeClonePlugin);
+            console.log(`[Build] ✅ Berhasil memperbarui ${homeClonePlugin}`);
+        }
+        catch { }
+    }
 }
 buildRbxmx();

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@adiholick/nvstudio-mcp",
-  "version": "2.0.1",
+  "version": "2.0.2",
   "description": "Local Bridge Server MCP for Roblox Studio",
   "main": "dist/index.js",
   "bin": {
-    "nvstudio-mcp": "./dist/index.js"
+    "nvstudio-mcp": "dist/index.js"
   },
   "files": [
     "dist",

package/studio-plugin/Main.server.lua

@@ -13,7 +13,7 @@ local ui = nil
 
 -- Membangun Tombol Toolbar (Toggle)
 local toolbar = plugin:CreateToolbar("NVStudio MCP")
-local toggleBtn = toolbar:CreateButton("Dashboard", "Buka Dashboard NVStudio MCP", "rbxassetid://82696893597722")
+local toggleBtn = toolbar:CreateButton("Dashboard", "Buka Dashboard NVStudio MCP", "rbxassetid://82696893597722", "NVStudio")
 
 -- Global State & Context AI
 local ctx = {
@@ -41,6 +41,14 @@ if uiModule then
     ui:setAutoConnectState(autoConnect)
     ui:setStatus("disconnected")
     
+    -- Sync state tombol toolbar dengan status widget
+    if ui.widget then
+        toggleBtn:SetActive(ui.widget.Enabled)
+        ui.widget:GetPropertyChangedSignal("Enabled"):Connect(function()
+            toggleBtn:SetActive(ui.widget.Enabled)
+        end)
+    end
+    
     -- Event Toggle GUI Panel
     toggleBtn.Click:Connect(function()
         ui:toggleVisibility()

package/studio-plugin/nvstudio_mcp.rbxmx

@@ -8,7 +8,7 @@
 			<bool name="DefinesCapabilities">false</bool>
 			<string name="Name">nvstudio_mcp</string>
 			<int64 name="SourceAssetId">-1</int64>
-			<SharedString name="Tags">yuZpQdnvvUBOTYh1jqZ2cA==</SharedString>
+			<SharedString name="Tags"></SharedString>
 		</Properties>
 		<Item class="ModuleScript" referent="RBX_create_instance">
 			<Properties>
@@ -367,14 +367,14 @@ end
 ]]></ProtectedString>
 			</Properties>
 		</Item>
-		<Item class="Script" referent="RBX_Main_server">
+		<Item class="Script" referent="RBX_Main">
 			<Properties>
 				<BinaryString name="AttributesSerialize"></BinaryString>
 				<SecurityCapabilities name="Capabilities">0</SecurityCapabilities>
 				<bool name="DefinesCapabilities">false</bool>
 				<bool name="Disabled">false</bool>
 				<Content name="LinkedSource"><null></null></Content>
-				<string name="Name">Main.server</string>
+				<string name="Name">Main</string>
 				<int64 name="SourceAssetId">-1</int64>
 				<SharedString name="Tags"></SharedString>
 				<token name="RunContext">0</token>
@@ -393,7 +393,7 @@ local ui = nil
 
 -- Membangun Tombol Toolbar (Toggle)
 local toolbar = plugin:CreateToolbar("NVStudio MCP")
-local toggleBtn = toolbar:CreateButton("Dashboard", "Buka Dashboard NVStudio MCP", "rbxassetid://82696893597722")
+local toggleBtn = toolbar:CreateButton("Dashboard", "Buka Dashboard NVStudio MCP", "rbxassetid://82696893597722", "NVStudio")
 
 -- Global State & Context AI
 local ctx = {
@@ -421,6 +421,14 @@ if uiModule then
     ui:setAutoConnectState(autoConnect)
     ui:setStatus("disconnected")
     
+    -- Sync state tombol toolbar dengan status widget
+    if ui.widget then
+        toggleBtn:SetActive(ui.widget.Enabled)
+        ui.widget:GetPropertyChangedSignal("Enabled"):Connect(function()
+            toggleBtn:SetActive(ui.widget.Enabled)
+        end)
+    end
+    
     -- Event Toggle GUI Panel
     toggleBtn.Click:Connect(function()
         ui:toggleVisibility()
@@ -945,8 +953,8 @@ function UIManager.init(pluginInstance, studioId)
     -- Membuat Widget Panel yang bisa di-dock (menempel)
     local widgetInfo = DockWidgetPluginGuiInfo.new(
         Enum.InitialDockState.Right,
-        false,  -- Initially hidden until toolbar button is clicked
-        false,  -- Override enabled
+        true,   -- Initially visible on first install so user immediately sees the dashboard
+        false,  -- Don't override user's saved state on subsequent launches
         380,    -- Default width
         520,    -- Default height
         280,    -- Min width
@@ -1414,7 +1422,4 @@ end
 			</Properties>
 		</Item>
 	</Item>
-	<SharedStrings>
-		<SharedString md5="yuZpQdnvvUBOTYh1jqZ2cA=="></SharedString>
-	</SharedStrings>
 </roblox>

package/studio-plugin/ui_manager.lua

@@ -5,8 +5,8 @@ function UIManager.init(pluginInstance, studioId)
     -- Membuat Widget Panel yang bisa di-dock (menempel)
     local widgetInfo = DockWidgetPluginGuiInfo.new(
         Enum.InitialDockState.Right,
-        false,  -- Initially hidden until toolbar button is clicked
-        false,  -- Override enabled
+        true,   -- Initially visible on first install so user immediately sees the dashboard
+        false,  -- Don't override user's saved state on subsequent launches
         380,    -- Default width
         520,    -- Default height
         280,    -- Min width