Mode d’emploi
- Copiez la commande et examinez le paquet avant de l’installer dans votre environnement agent.
- Consultez le document original pour les outils, identifiants et environnements requis.
- Décrivez les entrées et le livrable souhaité ; comparez la sortie aux sources.
npx skills add https://github.com/el4cteo/roblox-skills --skill roblox-characters-animationAvant de commencer
- L’installation n’inclut ni abonnement au modèle, ni quota API, ni accès aux fichiers.
- Étoiles et installations reflètent l’activité, pas un test indépendant de qualité ou de sécurité.
Rendu depuis le dépôt source en conservant titres, exemples, code, tableaux, liens et images.
Characters and animation
Character basics
- A player character is a
Modelwith aHumanoid,HumanoidRootPart(the root; move the character
with character:PivotTo(cframe)), R15 body parts, and an Animate LocalScript.
- Defaults (walk speed, jump, health, R6/R15, collisions, body scaling) are configured in Studio's
Avatar Settings window and StarterPlayer (CharacterWalkSpeed, CharacterJumpHeight or CharacterUseJumpPower + CharacterJumpPower).
- Custom character: put a
ModelnamedStarterCharacterinStarterPlayer. Custom per-player
spawns: Players.CharacterAutoLoads = false, then player:LoadCharacterAsync() when ready (e.g. after data loads). LoadCharacter (non-Async) is deprecated.
- Characters are destroyed and recreated on death/respawn: bind per-character logic in
CharacterAdded. Workspace.PlayerCharacterDestroyBehavioris on by default since Nov 11, 2026: the old character is
destroyed right after CharacterRemoving handlers run, and the Player 5 s after PlayerRemoving. Read what you need (leaderstats, attributes, UserId) before yielding in those handlers. Disabled is a temporary opt-out that is removed at the end of February 2027.
- Client-set
WalkSpeed/JumpHeightare trivially exploitable; enforce limits on the server or use
server authority (roblox-security, roblox-physics).
Health and damage (server)
--!strict
local Players = game:GetService("Players")
local function damage(target: Model, amount: number, source: Player?)
local humanoid = target:FindFirstChildOfClass("Humanoid")
if not humanoid or humanoid.Health <= 0 then
return
end
humanoid:SetAttribute("LastDamagedBy", if source then source.UserId else 0)
humanoid:TakeDamage(amount) -- respects ForceField; use Health -= amount to bypass
end
Players.PlayerAdded:Connect(function(player)
player.CharacterAdded:Connect(function(character)
local humanoid = character:WaitForChild("Humanoid") :: Humanoid
humanoid.MaxHealth = 150
humanoid.Health = 150
humanoid.Died:Once(function()
local killerId = humanoid:GetAttribute("LastDamagedBy")
print(`{player.Name} died (killer {killerId})`)
end)
end)
end)
return damage- Disable default regen by deleting/replacing the
Healthscript viaStarterCharacterScripts. Humanoid.BreakJointsOnDeath = false+ ragdoll constraints for ragdolls.- States:
humanoid:ChangeState(Enum.HumanoidStateType.Jumping),SetStateEnabled(state, false),
StateChanged. MoveDirection, FloorMaterial, RootPart, SeatPart are read-only helpers.
humanoid:MoveTo(position)walks NPCs (times out after 8 s; re-issue for long paths — seeroblox-npc-ai).
Appearance
--!strict
local Players = game:GetService("Players")
local function applyUniform(player: Player)
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
if not humanoid then
return
end
local ok, description = pcall(function()
return Players:GetHumanoidDescriptionFromUserIdAsync(player.UserId)
end)
if not ok then
return
end
description.Shirt = 123456 -- asset ids
description.Pants = 654321
description.HeightScale = 1.05
pcall(function()
humanoid:ApplyDescriptionAsync(description) -- server-side; replicates
end)
end
return applyUniformPlayer:LoadCharacterWithHumanoidDescriptionAsync(description) spawns directly with an outfit. All the non-Async variants (ApplyDescription, GetHumanoidDescriptionFromUserId, ...) are deprecated.
Animation playback
--!strict
local function playAttack(character: Model, animation: Animation): AnimationTrack?
local humanoid = character:FindFirstChildOfClass("Humanoid")
local animator = humanoid and humanoid:FindFirstChildOfClass("Animator")
if not animator then
return nil
end
local track = animator:LoadAnimation(animation) -- Humanoid:LoadAnimation is deprecated
track.Priority = Enum.AnimationPriority.Action
track.Looped = false
track:GetMarkerReachedSignal("Hit"):Connect(function(param)
print("hit frame reached", param) -- apply damage window, play sound, etc.
end)
track:Play(0.1) -- fade time
return track
end
return playAttack- Where to play: the local player's own character → play on the client (replicates automatically via
its Animator); NPCs → play on the server (or on clients for purely cosmetic, high-count NPCs).
- Load each
Animationonce per Animator and reuse the track; don't callLoadAnimationevery time an
action happens (there's a per-Animator track limit). Exception: server authority (query live tracks).
- Priorities:
Core < Idle < Movement < Action < Action2 < Action3 < Action4. Blend withAdjustWeight,
change speed with AdjustSpeed, stop with Stop(fadeTime).
- Events:
track.Stopped,track.Ended, markers viaGetMarkerReachedSignal(KeyframeReachedis superseded). - Animation assets must be owned by (or shared with, via asset permissions) the experience's owner —
otherwise they silently fail to play in live servers.
- Replace defaults by editing the
Animatescript'sStringValue/Animationchildren
(animate.run.RunAnim.AnimationId) on CharacterAdded, or ship a custom Animate in StarterCharacterScripts.
- Procedural:
IKControl(look-at, foot planting, reaching) instead of hand-written joint math.
Tweening
--!strict
local TweenService = game:GetService("TweenService")
local door = Instance.new("Part")
door.Anchored = true
door.Parent = workspace
local info = TweenInfo.new(0.6, Enum.EasingStyle.Quad, Enum.EasingDirection.Out)
local open = TweenService:Create(door, info, { CFrame = door.CFrame * CFrame.new(0, 8, 0) })
open.Completed:Once(function(state)
print("door tween finished:", state)
end)
open:Play()- Tween anchored parts or UI. For unanchored/physics objects use constraints.
- Tweening on the server replicates every frame and stutters: for visual-only motion, tween on each client
(the server sets the final state or an attribute clients react to).
- Models: tween a
CFrameValueand callmodel:PivotTo(value)in itsChangedhandler, or tween the
primary part with the rest welded to it.
TweenService:GetValue(alpha, style, direction)for custom interpolation;SmoothDampfor follow motion.
Tools
Tool in StarterPack/Backpack with a Handle part (or RequiresHandle = false). Equipped, Unequipped, Activated fire on both client and server (Activated comes from the client: validate rate and state on the server). Keep weapon logic in modules and use tags rather than scripts inside every tool clone.
Character Controller Library (beta)
Roblox's CCL (require("@rbx/AvatarAbilities")) replaces the fixed Humanoid state machine with composable abilities (Running, Jumping, Climbing, custom Dash...) coordinated by labels, sensors, conditions (StartsWhen/RunsWhile with All/Any/Not), conflicts (Blocks/Stops/Suspends), and lifecycle callbacks. Enable it via File → Beta Features and Avatar Settings → Movement → Abilities. Only use it when the project has opted in; APIs may change while in beta. Sketch: references/character-controller-library.md.
Related skills
roblox-npc-ai (NPC movement), roblox-physics (ragdolls, knockback), roblox-input (ability inputs), roblox-security (movement/damage validation), roblox-game-systems (combat).