@adiholick/nvstudio-mcp 2.3.0 → 2.4.1

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
+

package/studio-plugin/set_properties.lua

@@ -33,6 +33,79 @@ return function(targetInstance, data, ctx, targetPath)
                 targetInstance[prop] = BrickColor.new(val)
             elseif typeof(currentVal) == "CFrame" and type(val) == "table" then
                 targetInstance[prop] = CFrame.new(unpack(val))
+            elseif typeof(currentVal) == "ColorSequence" or (type(val) == "table" and val.t == "ColorSequence") then
+                local kps = {}
+                local rawList = (type(val) == "table" and val.t == "ColorSequence") and val.v or val
+                if type(rawList) == "table" then
+                    for _, kp in ipairs(rawList) do
+                        local t = kp[1] or 0
+                        local col = kp[2]
+                        local c3
+                        if typeof(col) == "Color3" then
+                            c3 = col
+                        elseif type(col) == "table" and col.t == "Color3" then
+                            c3 = Color3.new(col.v[1], col.v[2], col.v[3])
+                        elseif type(col) == "table" and #col >= 3 then
+                            c3 = (col[1] > 1 or col[2] > 1 or col[3] > 1) and Color3.fromRGB(col[1], col[2], col[3]) or Color3.new(col[1], col[2], col[3])
+                        else
+                            c3 = Color3.new(1, 1, 1)
+                        end
+                        table.insert(kps, ColorSequenceKeypoint.new(math.clamp(t, 0, 1), c3))
+                    end
+                end
+                if #kps >= 2 then
+                    table.sort(kps, function(a, b) return a.Time < b.Time end)
+                    -- Pastikan keypoint pertama t=0 dan terakhir t=1
+                    if kps[1].Time ~= 0 then
+                        kps[1] = ColorSequenceKeypoint.new(0, kps[1].Value)
+                    end
+                    if kps[#kps].Time ~= 1 then
+                        kps[#kps] = ColorSequenceKeypoint.new(1, kps[#kps].Value)
+                    end
+                    -- Pastikan waktu meningkat secara monoton murni
+                    for i = 2, #kps do
+                        if kps[i].Time <= kps[i - 1].Time then
+                            local newT = math.min(1.0, kps[i - 1].Time + 0.001)
+                            kps[i] = ColorSequenceKeypoint.new(newT, kps[i].Value)
+                        end
+                    end
+                    targetInstance[prop] = ColorSequence.new(kps)
+                elseif #kps == 1 then
+                    targetInstance[prop] = ColorSequence.new(kps[1].Value)
+                end
+            elseif typeof(currentVal) == "NumberSequence" or (type(val) == "table" and val.t == "NumberSequence") then
+                local kps = {}
+                local rawList = (type(val) == "table" and val.t == "NumberSequence") and val.v or val
+                if type(rawList) == "table" then
+                    for _, kp in ipairs(rawList) do
+                        if type(kp) == "table" then
+                            local t = kp[1] or 0
+                            local v = kp[2] or 0
+                            local env = kp[3] or 0
+                            table.insert(kps, NumberSequenceKeypoint.new(math.clamp(t, 0, 1), v, env))
+                        end
+                    end
+                end
+                if #kps >= 2 then
+                    table.sort(kps, function(a, b) return a.Time < b.Time end)
+                    -- Pastikan keypoint pertama t=0 dan terakhir t=1
+                    if kps[1].Time ~= 0 then
+                        kps[1] = NumberSequenceKeypoint.new(0, kps[1].Value, kps[1].Envelope)
+                    end
+                    if kps[#kps].Time ~= 1 then
+                        kps[#kps] = NumberSequenceKeypoint.new(1, kps[#kps].Value, kps[#kps].Envelope)
+                    end
+                    -- Pastikan waktu meningkat secara monoton murni
+                    for i = 2, #kps do
+                        if kps[i].Time <= kps[i - 1].Time then
+                            local newT = math.min(1.0, kps[i - 1].Time + 0.001)
+                            kps[i] = NumberSequenceKeypoint.new(newT, kps[i].Value, kps[i].Envelope)
+                        end
+                    end
+                    targetInstance[prop] = NumberSequence.new(kps)
+                elseif #kps == 1 then
+                    targetInstance[prop] = NumberSequence.new(kps[1].Value)
+                end
             elseif typeof(currentVal) == "EnumItem" and type(val) == "string" then
                 local enumType = tostring(currentVal.EnumType)
                 local successEnum, enumValue = pcall(function() return Enum[enumType][val] end)

package/studio-plugin/solve_limb_ik.lua

@@ -0,0 +1,63 @@
+--!strict
+-- ══════════════════════════════════════════════════════════════════════
+-- Skill Module: solve_limb_ik
+-- Deskripsi: Semantic Tool untuk AI Agent menghitung orientasi sendi
+-- lengan / kaki menuju koordinat sasaran 3D secara analitis O(1).
+-- ══════════════════════════════════════════════════════════════════════
+
+local HttpService = game:GetService("HttpService")
+local kinematicsMod = script.Parent:WaitForChild("nv_kinematics")
+local Kinematics = require(kinematicsMod)
+
+return function(targetInstance: Instance?, data: any, ctx: any, targetPath: string?)
+	if not targetInstance then
+		return { status = "error", error = "Target karakter rig untuk solve_limb_ik tidak ditemukan: " .. tostring(targetPath) }
+	end
+
+	local rigInfo = Kinematics.inspectRig(targetInstance:IsA("Model") and targetInstance or targetInstance:FindFirstAncestorOfClass("Model") :: any)
+	if not rigInfo then
+		return { status = "error", error = "Target bukan model karakter rig (R6/R15) yang valid: " .. targetInstance:GetFullName() }
+	end
+
+	local payload: { [string]: any } = {}
+	pcall(function()
+		if type(data) == "table" then payload = data
+		else payload = HttpService:JSONDecode(tostring(data)) end
+	end)
+
+	local limb = tostring(payload.limb or "RightArm")
+	local goalArr = payload.goal
+	if not goalArr or type(goalArr) ~= "table" or #goalArr < 3 then
+		return { status = "error", error = "Parameter 'goal' [X, Y, Z] wajib diisi." }
+	end
+
+	local goalPos = Vector3.new(goalArr[1], goalArr[2], goalArr[3])
+	local polePos: Vector3? = nil
+	if payload.pole and type(payload.pole) == "table" and #payload.pole >= 3 then
+		polePos = Vector3.new(payload.pole[1], payload.pole[2], payload.pole[3])
+	end
+
+	local apply = payload.apply_to_rig ~= false
+	local solved = Kinematics.solveLimb(rigInfo, limb, goalPos, polePos, apply)
+
+	if not solved then
+		return { status = "error", error = "Gagal menyelesaikan IK untuk anggota tubuh: " .. limb }
+	end
+
+	local resultC0: { [string]: any } = {}
+	for mName, cf in pairs(solved) do
+		resultC0[mName] = { t = "CFrame", v = { cf:GetComponents() } }
+	end
+
+	return {
+		status = "success",
+		result = {
+			limb = limb,
+			rigType = rigInfo.isR15 and "R15" or "R6",
+			applied = apply,
+			targetGoal = { goalPos.X, goalPos.Y, goalPos.Z },
+			solvedMotors = resultC0
+		}
+	}
+end
+

package/studio-plugin/ui_manager.lua

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