@adiholick/nvstudio-mcp 2.2.3 → 2.4.0

package/studio-plugin/Main.server.lua

@@ -1,5 +1,5 @@
 -- ══════════════════════════════════════════════════════════════════════
--- NVStudio MCP Plugin v2.2.2
+-- NVStudio MCP Plugin v2.4.0
 -- 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/animate_character.lua

@@ -0,0 +1,36 @@
+--!strict
+-- ══════════════════════════════════════════════════════════════════════
+-- Skill Module: animate_character
+-- Deskripsi: Semantic Tool untuk AI Agent membuat animasi karakter halus
+-- Menggunakan NV-Animation Engine (Walk, Slash, Punch, Idle, atau Custom)
+-- ══════════════════════════════════════════════════════════════════════
+
+local HttpService = game:GetService("HttpService")
+local dispatcherMod = script.Parent:WaitForChild("nv_anim_dispatcher")
+local Dispatcher = require(dispatcherMod)
+
+return function(targetInstance: Instance?, data: any, ctx: any, targetPath: string?)
+	if not targetInstance then
+		return { status = "error", error = "Target karakter rig untuk animate_character tidak ditemukan: " .. tostring(targetPath) }
+	end
+
+	local payload: { [string]: any } = {}
+	local ok, err = pcall(function()
+		if type(data) == "table" then
+			payload = data
+		else
+			payload = HttpService:JSONDecode(tostring(data))
+		end
+	end)
+
+	if not ok or type(payload) ~= "table" then
+		return { status = "error", error = "Format payload animasi tidak valid: " .. tostring(err) }
+	end
+
+	local action = tostring(payload.action or "walk_cycle")
+	local parameters = payload.parameters or {}
+	local keyPoses = payload.key_poses
+
+	return Dispatcher.createAnimation(targetInstance, action, parameters, keyPoses)
+end
+

package/studio-plugin/apply_vfx.lua

@@ -0,0 +1,59 @@
+--!strict
+-- ══════════════════════════════════════════════════════════════════════
+-- Skill Module: apply_vfx
+-- Deskripsi: Menerapkan tabel data VFX murni ke instance target di Studio
+-- ══════════════════════════════════════════════════════════════════════
+
+local HttpService = game:GetService("HttpService")
+local serializerMod = script.Parent:WaitForChild("nv_vfx_serializer")
+local Serializer = require(serializerMod)
+
+return function(targetInstance: Instance?, data: any, ctx: any, targetPath: string?)
+	if not targetInstance then
+		return { status = "error", error = "Target instance untuk apply_vfx tidak ditemukan: " .. tostring(targetPath) }
+	end
+
+	local payload = {}
+	local ok, err = pcall(function()
+		if type(data) == "table" then
+			payload = data
+		else
+			payload = HttpService:JSONDecode(tostring(data))
+		end
+	end)
+
+	if not ok or type(payload) ~= "table" then
+		return { status = "error", error = "Format payload VFX tidak valid: " .. tostring(err) }
+	end
+
+	-- Extract treeData (bisa di payload.data atau langsung di payload)
+	local treeData = payload.data or payload
+	if not treeData.nodes then
+		return { status = "error", error = "Payload tidak memiliki struktur 'nodes' yang valid untuk deserialisasi." }
+	end
+
+	local scale = tonumber(payload.scale) or 1
+	local enabled = payload.enabled
+
+	local desResult = Serializer.deserialize(treeData, targetInstance, {
+		scale = scale,
+		enabled = enabled
+	})
+
+	if desResult.status == "error" then
+		return {
+			status = "error",
+			error = "Gagal merekonstruksi VFX: " .. table.concat(desResult.errors or {}, "; ")
+		}
+	end
+
+	return {
+		status = "success",
+		result = {
+			message = string.format("Berhasil menerapkan VFX '%s' (%d node) ke '%s'", tostring(treeData.rootName or "VFX"), desResult.createdCount, targetInstance:GetFullName()),
+			createdCount = desResult.createdCount,
+			errors = desResult.errors
+		}
+	}
+end
+

package/studio-plugin/batch_create_instances.lua

@@ -0,0 +1,128 @@
+--!strict
+-- ============================================================================
+-- Skill Module: batch_create_instances
+-- Deskripsi: Pembangun Hierarki Instance Massal & Deklaratif (Tree / Batch List)
+-- ============================================================================
+
+local HttpService = game:GetService("HttpService")
+
+return function(targetInstance: Instance?, data: any, ctx: any, targetPath: string?)
+    local success, config = pcall(function()
+        if type(data) == "table" then return data end
+        return HttpService:JSONDecode(tostring(data))
+    end)
+
+    if not success or type(config) ~= "table" then
+        return { status = "error", error = "Format data JSON tidak valid untuk batch_create_instances." }
+    end
+
+    local setPropsFunc = require(script.Parent:WaitForChild("set_properties"))
+    local defaultParent = targetInstance or game.Workspace
+
+    if config.target and ctx and ctx.getInstanceFromPath then
+        local resolved = ctx.getInstanceFromPath(config.target)
+        if resolved then defaultParent = resolved end
+    end
+
+    local createdList = {}
+    local errors = {}
+    local createdCount = 0
+
+    local function applyProps(inst: Instance, props: any)
+        if not props or type(props) ~= "table" or not next(props) then return end
+        local propJson = HttpService:JSONEncode(props)
+        local res = setPropsFunc(inst, propJson, ctx, inst:GetFullName())
+        if res and res.status == "error" then
+            table.insert(errors, string.format("[%s] Error properti: %s", inst.Name, tostring(res.result or res.error)))
+        end
+    end
+
+    -- 1. MODE HIERARCHICAL TREE (Pohon Bersarang)
+    local function buildTreeNode(parentInst: Instance, node: any): Instance?
+        local className = node.className or node.ClassName
+        if not className or type(className) ~= "string" then
+            table.insert(errors, "Node pohon tidak memiliki ClassName yang valid.")
+            return nil
+        end
+
+        local ok, inst = pcall(function()
+            local newObj = Instance.new(className)
+            if node.name or node.Name then
+                newObj.Name = tostring(node.name or node.Name)
+            end
+            newObj.Parent = parentInst
+            return newObj
+        end)
+
+        if not ok or not inst then
+            table.insert(errors, string.format("Gagal membuat instance '%s': %s", className, tostring(inst)))
+            return nil
+        end
+
+        createdCount = createdCount + 1
+        table.insert(createdList, inst:GetFullName())
+
+        -- Terapkan properti
+        applyProps(inst, node.properties or node.Properties)
+
+        -- Rekursif untuk seluruh child
+        local children = node.children or node.Children
+        if children and type(children) == "table" then
+            for _, childNode in ipairs(children) do
+                buildTreeNode(inst, childNode)
+            end
+        end
+
+        return inst
+    end
+
+    -- Eksekusi Mode Tree jika disediakan
+    if config.tree and type(config.tree) == "table" then
+        buildTreeNode(defaultParent, config.tree)
+    end
+
+    -- 2. MODE FLAT ARRAY (Daftar Instance Terpisah)
+    local instancesArray = config.instances or config.items
+    if instancesArray and type(instancesArray) == "table" then
+        for idx, item in ipairs(instancesArray) do
+            local parentInst = defaultParent
+            if item.parent and ctx and ctx.getInstanceFromPath then
+                local resParent = ctx.getInstanceFromPath(item.parent)
+                if resParent then parentInst = resParent end
+            end
+
+            local className = item.className or item.ClassName
+            if className then
+                local ok, inst = pcall(function()
+                    local newObj = Instance.new(className)
+                    if item.name or item.Name then
+                        newObj.Name = tostring(item.name or item.Name)
+                    end
+                    newObj.Parent = parentInst
+                    return newObj
+                end)
+
+                if ok and inst then
+                    createdCount = createdCount + 1
+                    table.insert(createdList, inst:GetFullName())
+                    applyProps(inst, item.properties or item.Properties)
+                else
+                    table.insert(errors, string.format("Item #%d (%s) gagal dibuat: %s", idx, tostring(className), tostring(inst)))
+                end
+            end
+        end
+    end
+
+    local status = (createdCount > 0 or #errors == 0) and "success" or "error"
+    return {
+        status = status,
+        result = {
+            totalCreated = createdCount,
+            created = createdList,
+            hasErrors = (#errors > 0),
+            errors = errors,
+            message = string.format("Berhasil membuat %d instance secara batch.", createdCount)
+        }
+    }
+end
+

package/studio-plugin/batch_set_properties.lua

@@ -0,0 +1,69 @@
+--!strict
+-- ============================================================================
+-- Skill Module: batch_set_properties
+-- Deskripsi: Modifikasi Properti Massal untuk Beberapa Instance Sekaligus
+-- ============================================================================
+
+local HttpService = game:GetService("HttpService")
+
+return function(targetInstance: Instance?, data: any, ctx: any, targetPath: string?)
+    local success, config = pcall(function()
+        if type(data) == "table" then return data end
+        return HttpService:JSONDecode(tostring(data))
+    end)
+
+    if not success or type(config) ~= "table" then
+        return { status = "error", error = "Format data JSON tidak valid untuk batch_set_properties." }
+    end
+
+    local setPropsFunc = require(script.Parent:WaitForChild("set_properties"))
+    local updates = config.updates or config
+    if type(updates) ~= "table" then
+        return { status = "error", error = "Parameter 'updates' harus berupa array pembaruan properti." }
+    end
+
+    local updatedCount = 0
+    local successfulTargets = {}
+    local errors = {}
+
+    for idx, updateItem in ipairs(updates) do
+        local inst = targetInstance
+        local instPath = updateItem.target or updateItem.path
+        if instPath and ctx and ctx.getInstanceFromPath then
+            local resolved = ctx.getInstanceFromPath(instPath)
+            if resolved then
+                inst = resolved
+            else
+                table.insert(errors, string.format("Item #%d: Target path '%s' tidak ditemukan.", idx, tostring(instPath)))
+                continue
+            end
+        end
+
+        local props = updateItem.properties or updateItem.props
+        if inst and props and type(props) == "table" then
+            local propJson = HttpService:JSONEncode(props)
+            local res = setPropsFunc(inst, propJson, ctx, inst:GetFullName())
+            if res and res.status == "error" then
+                table.insert(errors, string.format("[%s]: %s", inst.Name, tostring(res.result or res.error)))
+            else
+                updatedCount = updatedCount + 1
+                table.insert(successfulTargets, inst:GetFullName())
+            end
+        else
+            table.insert(errors, string.format("Item #%d: Instance atau properties tidak valid.", idx))
+        end
+    end
+
+    local status = (updatedCount > 0 or #errors == 0) and "success" or "error"
+    return {
+        status = status,
+        result = {
+            totalUpdated = updatedCount,
+            updatedInstances = successfulTargets,
+            hasErrors = (#errors > 0),
+            errors = errors,
+            message = string.format("Berhasil memperbarui properti untuk %d instance.", updatedCount)
+        }
+    }
+end
+

package/studio-plugin/edit_rig.lua

@@ -0,0 +1,35 @@
+--!strict
+-- ══════════════════════════════════════════════════════════════════════
+-- Skill Module: edit_rig
+-- Deskripsi: Semantic Tool untuk AI Agent mengelola rig, Motor6D, Weld,
+-- C0/C1 pivot compensation, auto-rigging, dan pengelasan model.
+-- ══════════════════════════════════════════════════════════════════════
+
+local HttpService = game:GetService("HttpService")
+local dispatcherMod = script.Parent:WaitForChild("nv_rig_dispatcher")
+local Dispatcher = require(dispatcherMod)
+
+return function(targetInstance: Instance?, data: any, ctx: any, targetPath: string?)
+	if not targetInstance then
+		return { status = "error", error = "Target instance untuk edit_rig tidak ditemukan: " .. tostring(targetPath) }
+	end
+
+	local payload: { [string]: any } = {}
+	local ok, err = pcall(function()
+		if type(data) == "table" then
+			payload = data
+		else
+			payload = HttpService:JSONDecode(tostring(data))
+		end
+	end)
+
+	if not ok or type(payload) ~= "table" then
+		return { status = "error", error = "Format payload edit_rig tidak valid: " .. tostring(err) }
+	end
+
+	local action = tostring(payload.action or "inspect")
+	local parameters = payload.parameters or payload
+
+	return Dispatcher.dispatch(targetInstance, action, parameters)
+end
+

package/studio-plugin/insert_asset.lua

@@ -1,23 +1,96 @@
-return function(targetInstance, data, ctx, targetPath)
-    local InsertService = game:GetService("InsertService")
-    local rawId = tostring(data or ""):gsub("rbxassetid://", ""):gsub("%s+", "")
+--!strict
+-- ============================================================================
+-- Skill Module: insert_asset (Upgraded with Asset Security Scanner & Script Stripper)
+-- ============================================================================
+
+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 stripScripts = true  -- Default TRUE demi keamanan mutlak
+    local scanSecurity = 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.strip_scripts ~= nil then stripScripts = parsed.strip_scripts end
+            if parsed.scan_security ~= nil then scanSecurity = parsed.scan_security end
+        else
+            assetIdStr = data
+        end
+    elseif typeof(data) == "table" then
+        assetIdStr = tostring(data.asset_id or data.assetId or "")
+        if data.strip_scripts ~= nil then stripScripts = data.strip_scripts end
+        if data.scan_security ~= nil then scanSecurity = data.scan_security end
+    end
+
+    local rawId = string.gsub(assetIdStr, "rbxassetid://", "")
+    rawId = string.gsub(rawId, "%s+", "")
     local assetId = tonumber(rawId)
-    if not assetId then
+
+    if not assetId or assetId <= 0 then
         return { status = "error", error = "Asset ID harus berupa angka yang valid." }
     end
-    
+
     local success, model = pcall(function()
         return InsertService:LoadAsset(assetId)
     end)
-    
-    if success and model then
-        if targetInstance == game or targetInstance.ClassName == "DataModel" then
-            model.Parent = game.Workspace
+
+    if not success or not model then
+        return {
+            status = "error",
+            error = "Gagal memuat aset. Pastikan Asset ID benar dan model berstatus publik di Creator Store."
+        }
+    end
+
+    local securityNotes = {}
+    local removedScripts = {}
+
+    -- 1. Scan keamanan jika diaktifkan
+    if scanSecurity then
+        local scanResult = SecurityScanner.scanInstance(model, true)
+        if scanResult.riskLevel == "DANGEROUS" then
+            table.insert(securityNotes, string.format("⚠️ PERINGATAN: Aset ini memiliki %d ancaman BERBAHAYA (Backdoor/Obfuscation/Webhook)!", scanResult.highThreats))
+        end
+    end
+
+    -- 2. Sanitasi: Hapus skrip jika strip_scripts = true
+    if stripScripts then
+        removedScripts = SecurityScanner.stripScripts(model)
+        if #removedScripts > 0 then
+            table.insert(securityNotes, string.format("🛡️ Keamanan: %d skrip bawaan telah dihapus secara otomatis demi keamanan game Anda.", #removedScripts))
         else
-            model.Parent = targetInstance
+            table.insert(securityNotes, "🛡️ Keamanan: Aset bersih, tidak ditemukan skrip berbahaya.")
         end
-        return { status = "success", result = "Aset berhasil dimasukkan ke " .. model.Parent.Name .. "." }
     else
-        return { status = "error", error = "Gagal memuat aset. Pastikan Asset ID benar dan akun/plugin Anda memiliki izin (Ownership/Public)." }
+        table.insert(securityNotes, "ℹ️ Catatan: strip_scripts = false, skrip bawaan model dipertahankan.")
+    end
+
+    -- 3. Masukkan model ke target
+    local parentTarget = targetInstance
+    if not parentTarget or parentTarget == game or parentTarget.ClassName == "DataModel" then
+        parentTarget = game.Workspace
     end
+
+    model.Parent = parentTarget
+
+    return {
+        status = "success",
+        result = {
+            message = string.format("Aset '%s' (ID: %d) berhasil dimasukkan ke %s.", model.Name, assetId, parentTarget.Name),
+            assetName = model.Name,
+            assetId = assetId,
+            parent = parentTarget:GetFullName(),
+            stripScriptsApplied = stripScripts,
+            removedScriptsCount = #removedScripts,
+            removedScripts = removedScripts,
+            securityNotes = table.concat(securityNotes, "\n"),
+        }
+    }
 end

package/studio-plugin/nv_anim_dispatcher.lua

@@ -0,0 +1,239 @@
+--!strict
+-- ══════════════════════════════════════════════════════════════════════
+-- NVStudio Subsystem: nv_anim_dispatcher
+-- Deskripsi: Headless Modular Command Dispatcher untuk Pembuatan Animasi
+-- Mengatur inisialisasi rig, analytical IK, generasi keyframe kurva halus,
+-- dan ekspor resmi ke KeyframeSequence di Roblox Studio.
+-- ══════════════════════════════════════════════════════════════════════
+
+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)
+
+local Dispatcher = {}
+
+-- ── 1. Helper: Temukan Rig dari Instance atau Path ────────────────────────────
+function Dispatcher.getRigInfo(targetInstance: Instance?): Kinematics.RigInfo?
+	if not targetInstance then return nil end
+	local model = targetInstance:IsA("Model") and targetInstance or targetInstance:FindFirstAncestorOfClass("Model")
+	if not model then return nil end
+	return Kinematics.inspectRig(model)
+end
+
+-- ── 2. Buat KeyframeSequence Resmi di Roblox ─────────────────────────────────
+function Dispatcher.buildKeyframeSequence(
+	rigInfo: Kinematics.RigInfo,
+	clipName: string,
+	keyframes: { Motion.KeyframeData },
+	options: { loop: boolean?, priority: Enum.AnimationPriority? }?
+): KeyframeSequence
+	local opts = options or {}
+	local isR15 = rigInfo.isR15
+
+	local seq = Instance.new("KeyframeSequence")
+	seq.Name = clipName
+	seq.Loop = opts.loop ~= false
+	seq.Priority = opts.priority or Enum.AnimationPriority.Action
+
+	-- Urutkan keyframes berdasarkan waktu
+	table.sort(keyframes, function(a, b) return a.time < b.time end)
+
+	for _, kfData in ipairs(keyframes) do
+		local kf = Instance.new("Keyframe")
+		kf.Time = kfData.time
+		kf.Name = string.format("Frame_%.2f", kfData.time)
+
+		-- Root Pose (HumanoidRootPart)
+		local rootPose = Instance.new("Pose")
+		rootPose.Name = "HumanoidRootPart"
+		rootPose.Weight = 1
+		rootPose.EasingStyle = Enum.PoseEasingStyle.Cubic
+		rootPose.EasingDirection = Enum.PoseEasingDirection.InOut
+
+		local function createPose(name: string, cf: CFrame?, parent: Instance?): Pose
+			local p = Instance.new("Pose")
+			p.Name = name
+			p.Weight = 1
+			p.EasingStyle = Enum.PoseEasingStyle.Cubic
+			p.EasingDirection = Enum.PoseEasingDirection.InOut
+			if cf then p.CFrame = cf end
+			if parent then p.Parent = parent end
+			return p
+		end
+
+		if isR15 then
+			-- LowerTorso pose
+			local lowerTorsoPose = createPose("LowerTorso", kfData.poses["Root"], nil)
+
+			-- UpperTorso pose
+			local upperTorsoPose = createPose("UpperTorso", kfData.poses["Waist"], nil)
+
+			-- Head
+			if kfData.poses["Neck"] then
+				createPose("Head", kfData.poses["Neck"], upperTorsoPose)
+			end
+
+			-- Arms
+			for _, side in ipairs({ "Left", "Right" }) do
+				local shoulderPose = createPose(side .. "UpperArm", kfData.poses[side .. "Shoulder"], nil)
+				local elbowPose = shoulderPose
+				if kfData.poses[side .. "Elbow"] then
+					elbowPose = createPose(side .. "LowerArm", kfData.poses[side .. "Elbow"], shoulderPose)
+				end
+				if kfData.poses[side .. "Wrist"] then
+					createPose(side .. "Hand", kfData.poses[side .. "Wrist"], elbowPose)
+				end
+				shoulderPose.Parent = upperTorsoPose
+			end
+
+			-- Legs
+			for _, side in ipairs({ "Left", "Right" }) do
+				local hipPose = createPose(side .. "UpperLeg", kfData.poses[side .. "Hip"], nil)
+				local kneePose = hipPose
+				if kfData.poses[side .. "Knee"] then
+					kneePose = createPose(side .. "LowerLeg", kfData.poses[side .. "Knee"], hipPose)
+				end
+				if kfData.poses[side .. "Ankle"] then
+					createPose(side .. "Foot", kfData.poses[side .. "Ankle"], kneePose)
+				end
+				hipPose.Parent = lowerTorsoPose
+			end
+
+			upperTorsoPose.Parent = lowerTorsoPose
+			lowerTorsoPose.Parent = rootPose
+		else
+			-- R6 Pose Structure
+			local torsoPose = createPose("Torso", kfData.poses["RootJoint"], nil)
+
+			if kfData.poses["Neck"] then
+				createPose("Head", kfData.poses["Neck"], torsoPose)
+			end
+
+			for _, limb in ipairs({ "Left Shoulder", "Right Shoulder", "Left Hip", "Right Hip" }) do
+				if kfData.poses[limb] then
+					local partName = limb == "Left Shoulder" and "Left Arm"
+						or limb == "Right Shoulder" and "Right Arm"
+						or limb == "Left Hip" and "Left Leg"
+						or "Right Leg"
+					createPose(partName, kfData.poses[limb], torsoPose)
+				end
+			end
+
+			torsoPose.Parent = rootPose
+		end
+
+		-- Lampirkan VFX KeyframeMarkers jika ada event di frame ini
+		if opts.vfx_events and type(opts.vfx_events) == "table" then
+			for _, evt in ipairs(opts.vfx_events) do
+				local evtTime = tonumber(evt.time) or 0
+				if math.abs(evtTime - kfData.time) <= 0.08 then
+					local marker = Instance.new("KeyframeMarker")
+					marker.Name = evt.marker_name or "VFX"
+					marker.Value = evt.value or evt.action or "Emit"
+					marker.Parent = kf
+				end
+			end
+		end
+
+		rootPose.Parent = kf
+		kf.Parent = seq
+	end
+
+	return seq
+end
+
+-- ── 3. Eksekusi Perintah Pembuatan Animasi ────────────────────────────────────
+function Dispatcher.createAnimation(
+	targetInstance: Instance,
+	action: string,
+	parameters: { [string]: any }?,
+	keyPoses: { any }?
+): { [string]: any }
+	local rigInfo = Dispatcher.getRigInfo(targetInstance)
+	if not rigInfo then
+		return { status = "error", error = "Target bukan model karakter rig (R6/R15) yang valid: " .. targetInstance:GetFullName() }
+	end
+
+	local params = parameters or {}
+	local clipName = params.clipName or (action .. "_" .. (rigInfo.isR15 and "R15" or "R6"))
+	local keyframes: { Motion.KeyframeData }
+
+	if action == "walk_cycle" or action == "walk" then
+		keyframes = Motion.generateWalkCycle(rigInfo, params)
+	elseif action == "melee_slash" or action == "slash" or action == "sword" then
+		keyframes = Motion.generateMeleeSlash(rigInfo, params)
+	elseif action == "punch" or action == "combat_punch" then
+		keyframes = Motion.generatePunch(rigInfo, params)
+	elseif action == "idle" or action == "idle_breath" then
+		keyframes = Motion.generateIdle(rigInfo, params)
+	elseif action == "custom" and keyPoses and #keyPoses > 0 then
+		-- Parser custom keyposes dari input agent
+		keyframes = {}
+		for _, kp in ipairs(keyPoses) do
+			local motorCfs: { [string]: CFrame } = {}
+			if kp.poses then
+				for mName, cVal in pairs(kp.poses) do
+					if type(cVal) == "table" and cVal.t == "CFrame" then
+						motorCfs[mName] = CFrame.new(table.unpack(cVal.v))
+					elseif type(cVal) == "table" and cVal.angles then
+						local a = cVal.angles
+						motorCfs[mName] = CFrame.Angles(math.rad(a[1] or 0), math.rad(a[2] or 0), math.rad(a[3] or 0))
+					end
+				end
+			end
+			table.insert(keyframes, {
+				time = tonumber(kp.time) or 0,
+				poses = motorCfs
+			})
+		end
+	else
+		return {
+			status = "error",
+			error = "Action tidak dikenal: '" .. tostring(action) .. "'. Pilihan: walk_cycle, melee_slash, punch, idle_breath, custom."
+		}
+	end
+
+	-- Simpan KeyframeSequence ke AnimSaves pada Rig
+	local animSaves = rigInfo.model:FindFirstChild("AnimSaves")
+	if not animSaves then
+		animSaves = Instance.new("Model")
+		animSaves.Name = "AnimSaves"
+		animSaves.Parent = rigInfo.model
+	end
+
+	local kfSeq = Dispatcher.buildKeyframeSequence(rigInfo, clipName, keyframes, {
+		loop = params.loop,
+		priority = Enum.AnimationPriority.Action,
+		vfx_events = params.vfx_events
+	})
+	kfSeq.Parent = animSaves
+
+	-- Terapkan pose pertama ke karakter di Studio untuk live feedback
+	if keyframes[1] and keyframes[1].poses then
+		for mName, cf in pairs(keyframes[1].poses) do
+			local m = rigInfo.motors[mName]
+			if m then
+				pcall(function() m.C0 = cf end)
+			end
+		end
+	end
+
+	return {
+		status = "success",
+		result = {
+			clipName = clipName,
+			action = action,
+			rigType = rigInfo.isR15 and "R15" or "R6",
+			keyframeCount = #keyframes,
+			duration = keyframes[#keyframes].time,
+			savedPath = kfSeq:GetFullName(),
+			message = string.format("Animasi '%s' berhasil dibuat dan disimpan ke '%s'", clipName, kfSeq:GetFullName())
+		}
+	}
+end
+
+return Dispatcher
+