@adiholick/nvstudio-mcp 2.2.3 → 2.4.0

package/studio-plugin/preview_asset.lua

@@ -0,0 +1,99 @@
+--!strict
+-- ============================================================================
+-- Skill Module: preview_asset
+-- Deskripsi: Pratinjau & Pemindaian Keamanan Aset Creator Store Secara Terisolasi
+-- ============================================================================
+
+local HttpService = game:GetService("HttpService")
+local InsertService = game:GetService("InsertService")
+
+local SecurityScanner = require(script.Parent:WaitForChild("security_scanner"))
+
+return function(targetInstance: Instance?, data: any, ctx: any, targetPath: string?)
+    local assetIdStr = ""
+    local deepScan = true
+
+    if typeof(data) == "string" then
+        local success, parsed = pcall(function()
+            return HttpService:JSONDecode(data)
+        end)
+        if success and typeof(parsed) == "table" then
+            assetIdStr = tostring(parsed.asset_id or parsed.assetId or "")
+            if parsed.deep_scan ~= nil then deepScan = parsed.deep_scan end
+        else
+            assetIdStr = data
+        end
+    elseif typeof(data) == "table" then
+        assetIdStr = tostring(data.asset_id or data.assetId or "")
+        if data.deep_scan ~= nil then deepScan = data.deep_scan end
+    end
+
+    local cleanIdStr = string.gsub(assetIdStr, "rbxassetid://", "")
+    cleanIdStr = string.gsub(cleanIdStr, "%s+", "")
+    local assetId = tonumber(cleanIdStr)
+
+    if not assetId or assetId <= 0 then
+        return { status = "error", error = "Asset ID tidak valid. Berikan Asset ID angka (contoh: 123456789)." }
+    end
+
+    -- Muat Aset secara terisolasi (unparented / memory only)
+    local ok, model = pcall(function()
+        return InsertService:LoadAsset(assetId)
+    end)
+
+    if not ok or not model then
+        return {
+            status = "error",
+            error = string.format("Gagal memuat aset ID %d. Pastikan Asset ID publik dan terdaftar di Creator Store.", assetId)
+        }
+    end
+
+    local scanResult
+    local scanOk, err = pcall(function()
+        scanResult = SecurityScanner.scanInstance(model, deepScan)
+    end)
+
+    local rootName = model.Name
+    local childrenOverview = {}
+    for _, child in ipairs(model:GetChildren()) do
+        table.insert(childrenOverview, {
+            name = child.Name,
+            className = child.ClassName,
+        })
+    end
+
+    -- Hancurkan model sementara dari memori (Cleanup Mutlak)
+    pcall(function()
+        model:Destroy()
+    end)
+
+    if not scanOk or not scanResult then
+        return {
+            status = "error",
+            error = "Gagal memindai aset: " .. tostring(err)
+        }
+    end
+
+    local recommendation = "Aman untuk dimasukkan langsung menggunakan insert_asset."
+    if scanResult.riskLevel == "DANGEROUS" then
+        recommendation = "PERINGATAN: Aset ini memiliki ancaman BERBAHAYA! Wajib gunakan 'insert_asset' dengan strip_scripts = true, atau hindari aset ini."
+    elseif scanResult.riskLevel == "WARNING" then
+        recommendation = "Perhatian: Aset mengandung skrip atau peringatan moderat. Periksa kembali atau gunakan strip_scripts = true jika skrip tidak diperlukan."
+    end
+
+    return {
+        status = "success",
+        result = {
+            assetId = assetId,
+            assetName = rootName,
+            riskLevel = scanResult.riskLevel,
+            recommendation = recommendation,
+            stats = scanResult.stats,
+            highThreatsCount = scanResult.highThreats,
+            mediumThreatsCount = scanResult.mediumThreats,
+            threats = scanResult.threats,
+            topLevelChildren = childrenOverview,
+        }
+    }
+end
+

package/studio-plugin/scan_security.lua

@@ -0,0 +1,81 @@
+--!strict
+-- ============================================================================
+-- Skill Module: scan_security
+-- Deskripsi: Audit Keamanan Instance/Model yang Sudah Ada di Tempat Kerja Studio
+-- ============================================================================
+
+local HttpService = game:GetService("HttpService")
+local SecurityScanner = require(script.Parent:WaitForChild("security_scanner"))
+
+return function(targetInstance: Instance?, data: any, ctx: any, targetPath: string?)
+    local target = targetInstance or game.Workspace
+    local deepScan = true
+    local cleanThreats = false
+
+    if typeof(data) == "string" and #data > 0 then
+        local success, parsed = pcall(function()
+            return HttpService:JSONDecode(data)
+        end)
+        if success and typeof(parsed) == "table" then
+            if parsed.deep_scan ~= nil then deepScan = parsed.deep_scan end
+            if parsed.clean_threats ~= nil then cleanThreats = parsed.clean_threats end
+        end
+    elseif typeof(data) == "table" then
+        if data.deep_scan ~= nil then deepScan = data.deep_scan end
+        if data.clean_threats ~= nil then cleanThreats = data.clean_threats end
+    end
+
+    local scanResult
+    local ok, err = pcall(function()
+        scanResult = SecurityScanner.scanInstance(target, deepScan)
+    end)
+
+    if not ok or not scanResult then
+        return {
+            status = "error",
+            error = "Gagal memindai target: " .. tostring(err)
+        }
+    end
+
+    local cleanedScripts = {}
+    if cleanThreats and #scanResult.threats > 0 then
+        -- Hapus skrip yang terdeteksi bahaya (HIGH severity)
+        local scriptsToDestroy = {}
+        for _, threat in ipairs(scanResult.threats) do
+            if threat.severity == "HIGH" and threat.scriptPath then
+                scriptsToDestroy[threat.scriptPath] = true
+            end
+        end
+
+        local function purge(instance: Instance)
+            for _, desc in ipairs(instance:GetDescendants()) do
+                if desc:IsA("LuaSourceContainer") and scriptsToDestroy[desc:GetFullName()] then
+                    table.insert(cleanedScripts, {
+                        name = desc.Name,
+                        className = desc.ClassName,
+                        path = desc:GetFullName(),
+                    })
+                    pcall(function() desc:Destroy() end)
+                end
+            end
+        end
+
+        purge(target)
+    end
+
+    return {
+        status = "success",
+        result = {
+            target = target:GetFullName(),
+            riskLevel = scanResult.riskLevel,
+            stats = scanResult.stats,
+            highThreatsCount = scanResult.highThreats,
+            mediumThreatsCount = scanResult.mediumThreats,
+            threats = scanResult.threats,
+            cleanedThreatsCount = #cleanedScripts,
+            cleanedScripts = cleanedScripts,
+            isCleaned = cleanThreats,
+        }
+    }
+end
+

package/studio-plugin/scan_vfx.lua

@@ -0,0 +1,85 @@
+--!strict
+-- ══════════════════════════════════════════════════════════════════════
+-- Skill Module: scan_vfx
+-- Deskripsi: Memindai efek visual (ParticleEmitter, Beam, Trail, Light)
+-- pada objek target di Roblox Studio dan mengubahnya menjadi tabel murni
+-- ══════════════════════════════════════════════════════════════════════
+
+local HttpService = game:GetService("HttpService")
+local serializerMod = script.Parent:WaitForChild("nv_vfx_serializer")
+local Serializer = require(serializerMod)
+
+local function detectCategory(name: string, data: any): string
+	local lower = string.lower(name)
+	if lower:find("slash") or lower:find("blade") or lower:find("sword") or lower:find("cut") then
+		return "Slash"
+	elseif lower:find("explosion") or lower:find("burst") or lower:find("blast") or lower:find("boom") or lower:find("fire") then
+		return "Explosion"
+	elseif lower:find("aura") or lower:find("glow") or lower:find("shield") or lower:find("barrier") then
+		return "Aura"
+	elseif lower:find("laser") or lower:find("beam") or lower:find("ray") then
+		return "Beam"
+	elseif lower:find("magic") or lower:find("spell") or lower:find("rune") or lower:find("circle") or lower:find("portal") then
+		return "Magic"
+	elseif lower:find("hit") or lower:find("impact") or lower:find("spark") or lower:find("clash") then
+		return "Impact"
+	elseif lower:find("projectile") or lower:find("bullet") or lower:find("arrow") or lower:find("missile") then
+		return "Projectile"
+	end
+	return "Ambient"
+end
+
+return function(targetInstance: Instance?, data: any, ctx: any, targetPath: string?)
+	if not targetInstance then
+		return { status = "error", error = "Target instance untuk scan_vfx tidak ditemukan: " .. tostring(targetPath) }
+	end
+
+	local parsedData = {}
+	if data and data ~= "" then
+		pcall(function()
+			if type(data) == "table" then
+				parsedData = data
+			else
+				parsedData = HttpService:JSONDecode(tostring(data))
+			end
+		end)
+	end
+
+	local vfxName = parsedData.name or targetInstance.Name or "Unnamed_VFX"
+	local rawCat = parsedData.category or detectCategory(vfxName, parsedData)
+	local category = "Ambient"
+	if type(rawCat) == "string" and #rawCat > 0 then
+		category = string.upper(string.sub(rawCat, 1, 1)) .. string.lower(string.sub(rawCat, 2))
+	end
+	local tags = parsedData.tags or { string.lower(category) }
+
+	local ok, serialized = pcall(function()
+		return Serializer.serialize(targetInstance)
+	end)
+
+	if not ok or not serialized then
+		return { status = "error", error = "Gagal memindai VFX: " .. tostring(serialized) }
+	end
+
+	if serialized.nodeCount == 0 or (serialized.stats.emitters == 0 and serialized.stats.beams == 0 and serialized.stats.trails == 0 and serialized.stats.lights == 0) then
+		return {
+			status = "error",
+			error = "Objek '" .. targetInstance.Name .. "' tidak memiliki komponen VFX (ParticleEmitter, Beam, Trail, atau Light)."
+		}
+	end
+
+	return {
+		status = "success",
+		result = {
+			name = vfxName,
+			category = category,
+			tags = tags,
+			description = parsedData.description or ("Scanned VFX from " .. targetInstance:GetFullName()),
+			stats = serialized.stats,
+			nodeCount = serialized.nodeCount,
+			rootClass = serialized.rootClass,
+			data = serialized
+		}
+	}
+end
+

package/studio-plugin/scrub_timeline.lua

@@ -0,0 +1,122 @@
+--!strict
+-- ══════════════════════════════════════════════════════════════════════
+-- Skill Module: scrub_timeline
+-- Deskripsi: Headless Timeline Scrubbing & VFX Playhead Controller
+-- Mengevaluasi pose rig dan memicu burst/scrub VFX pada timestamp spesifik (t)
+-- secara deterministik langsung di Viewport Roblox Studio.
+-- ══════════════════════════════════════════════════════════════════════
+
+local HttpService = game:GetService("HttpService")
+local kinematicsMod = script.Parent:WaitForChild("nv_kinematics")
+local Kinematics = require(kinematicsMod)
+local curvesMod = script.Parent:WaitForChild("nv_curves")
+local Curves = require(curvesMod)
+local motionMod = script.Parent:WaitForChild("nv_motion_generator")
+local Motion = require(motionMod)
+
+return function(targetInstance: Instance?, data: any, ctx: any, targetPath: string?)
+	if not targetInstance then
+		return { status = "error", error = "Target instance untuk scrub_timeline tidak ditemukan: " .. tostring(targetPath) }
+	end
+
+	local payload: { [string]: any } = {}
+	pcall(function()
+		if type(data) == "table" then payload = data
+		else payload = HttpService:JSONDecode(tostring(data)) end
+	end)
+
+	local timePos = tonumber(payload.time) or 0.0
+	local action = payload.action or "melee_slash"
+	local emitVfx = payload.emit_vfx == true or payload.emit == true
+	local emitCount = tonumber(payload.emit_count) or 20
+
+	local rigInfo = Kinematics.inspectRig(targetInstance:IsA("Model") and targetInstance or targetInstance:FindFirstAncestorOfClass("Model") :: any)
+	local appliedMotors: { string } = {}
+
+	-- 1. Scrub Rig Joint Poses jika target adalah Rig
+	if rigInfo then
+		local keyframes: { Motion.KeyframeData }
+		if action == "walk_cycle" then
+			keyframes = Motion.generateWalkCycle(rigInfo, payload.parameters)
+		elseif action == "punch" then
+			keyframes = Motion.generatePunch(rigInfo, payload.parameters)
+		elseif action == "idle" or action == "idle_breath" then
+			keyframes = Motion.generateIdle(rigInfo, payload.parameters)
+		else
+			keyframes = Motion.generateMeleeSlash(rigInfo, payload.parameters)
+		end
+
+		if #keyframes > 0 then
+			table.sort(keyframes, function(a, b) return a.time < b.time end)
+			local totalDur = keyframes[#keyframes].time
+			local clampedTime = math.clamp(timePos, 0, totalDur)
+
+			-- Cari segmen [kA, kB]
+			local kA = keyframes[1]
+			local kB = keyframes[#keyframes]
+			for i = 1, #keyframes - 1 do
+				if clampedTime >= keyframes[i].time and clampedTime <= keyframes[i + 1].time then
+					kA = keyframes[i]
+					kB = keyframes[i + 1]
+					break
+				end
+			end
+
+			local segDur = kB.time - kA.time
+			local alpha = segDur > 1e-5 and ((clampedTime - kA.time) / segDur) or 0
+			local curvedAlpha = Curves.evaluate(payload.easing or "QuadInOut", alpha)
+
+			for motorName, cfA in pairs(kA.poses) do
+				local cfB = kB.poses[motorName] or cfA
+				local interpCF = Curves.slerp(cfA, cfB, curvedAlpha)
+				local m = rigInfo.motors[motorName]
+				if m then
+					pcall(function()
+						m.C0 = interpCF
+						table.insert(appliedMotors, motorName)
+					end)
+				end
+			end
+		end
+	end
+
+	-- 2. Scrub & Trigger VFX Emitters
+	local emittersTriggered = 0
+	local beamsToggled = 0
+
+	local function checkVfx(inst: Instance)
+		if inst:IsA("ParticleEmitter") then
+			if emitVfx then
+				pcall(function()
+					inst:Emit(emitCount)
+					emittersTriggered += 1
+				end)
+			end
+		elseif inst:IsA("Beam") or inst:IsA("Trail") then
+			if payload.enabled ~= nil then
+				pcall(function()
+					inst.Enabled = payload.enabled
+					beamsToggled += 1
+				end)
+			end
+		end
+	end
+
+	checkVfx(targetInstance)
+	for _, desc in ipairs(targetInstance:GetDescendants()) do
+		checkVfx(desc)
+	end
+
+	return {
+		status = "success",
+		result = {
+			time = timePos,
+			action = action,
+			motorsPosed = #appliedMotors,
+			emittersTriggered = emittersTriggered,
+			beamsToggled = beamsToggled,
+			message = string.format("Timeline di-scrub ke t=%.2fs (Pose: %d joint, VFX: %d emitter burst)", timePos, #appliedMotors, emittersTriggered)
+		}
+	}
+end
+