К основному содержанию
скилл CX Codex

roblox-characters-animation — скилл для Claude Code: установка

Скилл roblox-characters-animation для Claude Code описывает работу с персонажами и анимацией в Roblox. Подключается к задачам про движение, урон, респаун, аватары, оружие и твины.

MIT 1 300 установок ★ 131 обновлён 2026-11-03

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add EL4CTEO/roblox-skills --skill roblox-characters-animation -a claude-code
Открыть на GitHub

Что делает roblox-characters-animation

Скилл помогает настраивать персонажей Roblox: свойства и состояния Humanoid, появление через LoadCharacterAsync, здоровье, урон и внешний вид через HumanoidDescription. Он также разбирает воспроизведение анимаций через Animator и AnimationTrack, маркеры, приоритеты и замену стандартных анимаций.

В материалах есть примеры для Tool, TweenService и IKControl, а также рекомендации по размещению логики на клиенте или сервере. Клиентские значения скорости и прыжка легко подменить, поэтому ограничения задают на сервере. Анимации должны принадлежать владельцу игры или быть доступны ему через разрешения на ассеты, иначе в опубликованной игре они могут не проиграться.

Какие задачи решает

  • настроить здоровье и урон персонажа
  • задать внешний вид аватара через HumanoidDescription
  • проиграть атаку с маркером попадания
  • заменить стандартные анимации персонажа
  • переместить дверь с помощью TweenService

Примеры запросов агенту

  • Настрой серверный урон и здоровье персонажа в combat.lua.
  • Добавь анимацию атаки с маркером Hit для персонажа.
  • Замени стандартную анимацию бега в Animate.

Как установить roblox-characters-animation

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/roblox-skills --skill roblox-characters-animation -a claude-code

2Вручную: положить файлы

~/.claude/skills/roblox-characters-animation/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/roblox-characters-animation/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о roblox-characters-animation

Как установить roblox-characters-animation в Claude Code?

Выполни npx skills add EL4CTEO/roblox-skills --skill roblox-characters-animation -a claude-code. Файл скилла находится по пути ~/.claude/skills/roblox-characters-animation/SKILL.md.

Что делает roblox-characters-animation?

Скилл помогает писать и менять код персонажей Roblox: от здоровья и появления до анимаций, инструментов и твинов.

Почему анимация может не проигрываться в опубликованной игре?

Ассет анимации должен принадлежать владельцу игры или быть расшарен ему через разрешения на ассеты.

Исходный текст

SKILL.md · MIT
---
name: roblox-characters-animation
description: Characters and animation - Humanoid properties/states, spawning (LoadCharacterAsync), health and damage, HumanoidDescription appearance, Animator/AnimationTrack playback, priorities and markers, default animation replacement, Tools, TweenService, IKControl, Character Controller Library (beta). Use when changing movement, abilities, damage, respawn, avatars, animations, tweens, or tools/weapons.
---

# Characters and animation

## Character basics

- A player character is a `Model` with a `Humanoid`, `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 `Model` named `StarterCharacter` in `StarterPlayer`. 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`.
- Client-set `WalkSpeed`/`JumpHeight` are trivially exploitable; enforce limits on the server or use
  server authority (`roblox-security`, `roblox-physics`).

## Health and damage (server)

```luau
--!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 `Health` script via `StarterCharacterScripts`.
- `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 — see `roblox-npc-ai`).

## Appearance

```luau
--!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 applyUniform
```

`Player:LoadCharacterWithHumanoidDescriptionAsync(description)` spawns directly with an outfit.
All the non-Async variants (`ApplyDescription`, `GetHumanoidDescriptionFromUserId`, ...) are deprecated.

## Animation playback

```luau
--!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 `Animation` once per Animator and reuse the track; don't call `LoadAnimation` every 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 with `AdjustWeight`,
  change speed with `AdjustSpeed`, stop with `Stop(fadeTime)`.
- Events: `track.Stopped`, `track.Ended`, markers via `GetMarkerReachedSignal` (`KeyframeReached` is 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 `Animate` script's `StringValue`/`Animation` children
  (`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

```luau
--!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 `CFrameValue` and call `model:PivotTo(value)` in its `Changed` handler, or tween the
  primary part with the rest welded to it.
- `TweenService:GetValue(alpha, style, direction)` for custom interpolation; `SmoothDamp` for 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](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).

© EL4CTEO · MIT · EL4CTEO/roblox-skills

Похожие скиллы

Все скиллы по теме «Дизайн» →
roblox-characters gamedev-skills Скилл roblox-characters для Claude Code помогает чинить скрипты персонажей Roblox, их анимации и управление движением. Активируется при сбоях после возрождения, проблемах с репликацией или конфликте спринта с Humanoid. CX Codex +1 9 300установок roblox-animation-vfx TabooHarmony Скилл roblox-animation-vfx для ИИ-агента, который помогает писать и чинить анимации, партиклы, лучи, трейлы и твины в Roblox. CX Codex +1 4 200установок roblox-animation nonlooped Скилл roblox-animation для Claude Code и других агентов: треки, IK-позы, маркерные события и твины интерфейса для анимаций персонажей Roblox. Собирает локомоцию и эмоции без потери приоритетов. CX Codex +1 992установок scenario-roblox-animation scenario-labs Скилл scenario-roblox-animation для Claude Code помогает создавать и отлаживать анимации персонажей, NPC и существ в Roblox. Подключается к задачам с приоритетами треков, маркерами, IK, лицевой анимацией и импортом из Blender. CX Codex +1 415установок model-characters CodePawl Скилл model-characters для Claude Code превращает рисунок, фото или текстовую идею в план 3D-персонажа. Подключается к задачам по моделированию, от low-poly до реалистичных моделей. CX Codex +1 ★ 350звёзд репо rig-characters CodePawl Скилл rig-characters для Claude Code собирает риги персонажей и предметов для 2D- и 3D-анимации. Подключается для настройки скелета, исправления деформаций или экспорта в игровой движок. CX Codex +1 ★ 350звёзд репо

Из того же набора22

Весь набор →
roblox-world-building Скилл roblox-world-building для Claude Code и других платформ, автоматизирующий создание 3D-миров и игровых механик в Roblox. Запускается при генерации окружения, уровней и визуальных эффектов. CX Codex +1 1 400установок roblox-performance Скилл roblox-performance для Claude Code, который диагностирует производительность игр в Roblox, ищет утечки памяти и устраняет просадки кадров. Включается при лагах, падении FPS, зависаниях и высоком пинге. CX Codex +1 1 300установок roblox-code-review Скилл roblox-code-review для Claude Code проверяет Roblox-код на уязвимости, потерю данных и ошибки жизненного цикла. Запускается при ревью PR или скрипта, аудите игры и обновлении устаревшего кода. CX Codex +1 1 300установок roblox-security Скилл roblox-security для Claude Code помогает проектировать серверную защиту игр на Roblox против эксплойтов. Включается при написании серверных обработчиков, проверке репликации, рейтов и механик боя. CX Codex +1 1 300установок roblox-game-systems Скилл roblox-game-systems для Claude Code и Codex помогает собирать игровые механики Roblox с серверной валидацией. Включается при создании экономики, раундов, инвентаря, боевой системы или чекпоинтов. CX Codex +1 1 300установок roblox-luau Скилл roblox-luau для Claude Code помогает писать и разбирать скрипты Roblox на Luau. Включается при создании, рефакторинге и объяснении скриптов, исправлении ошибок типов и обновлении старого Lua-кода. CX Codex +1 1 300установок roblox-ui Скилл roblox-ui для Claude Code и Codex формирует адаптивный интерфейс в Roblox. Включается при сборке HUD, инвентарей, магазинов или починке вёрстки под мобильные экраны и консоли. CX Codex +1 1 300установок roblox-testing Скилл roblox-testing для Claude Code помогает тестировать код Roblox и проверять игровые изменения. Подключается при добавлении тестов, настройке тестового запуска или CI. CX Codex +1 1 300установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой