튜토리얼 · 게임 시스템

Roblox Studio에서 칼 만드는 방법

Roblox의 칼은 두 스크립트가 세 가지 일을 나눠 맡는 Tool입니다. 플레이어의 기기는 클릭을 알아채고 휘두르는 동작을 재생하며, 서버는 누가 맞았고 체력이 얼마나 줄었는지 결정합니다. 이 가이드에서는 플레이어가 조작할 수 없는 쿨다운과 히트박스를 갖춘 두 스크립트를 만들고, 애니메이션이 어디에 들어가는지 보여 줍니다.

업데이트: 2026년 11월 20일읽는 데 16분작성:

요약

StarterPack에 Sword라는 이름의 Tool을 넣고, 그 안에 Handle이라는 파트를 둡니다. Tool 안의 LocalScript가 Tool.Activated를 듣고, 휘두르기 애니메이션을 재생하고, 인자 없이 RemoteEvent를 호출합니다. ServerScriptService의 Script는 쿨다운과 플레이어가 살아 있고 칼을 들고 있는지 확인한 뒤, workspace:GetPartBoundsInBox로 플레이어 앞 박스 안의 Humanoid를 찾고 대상마다 한 번씩 Humanoid:TakeDamage를 호출합니다.

  • 칼날의 Touched 이벤트로 피해를 주지 마세요. 플레이어의 기기가 자기 캐릭터를 제어하므로 어디서든 Touched를 일으킬 수 있으며, Roblox의 network ownership 페이지가 예로 드는 것이 바로 칼입니다.
  • 클라이언트는 대상도 피해량도 보내지 않습니다. 쿨다운, 히트박스, 피해량은 서버가 맡습니다.
  • 대상에게 ForceField가 있는 동안, 예를 들어 SpawnLocation에서 스폰한 뒤 처음 10초 동안에는 TakeDamage가 아무것도 하지 않습니다.
  • 공격이 벽을 통과하거나, 휘두르는 동작이 대상에 닿아 보이기 전에 맞나요? 휘두르기 타이밍과 벽 확인이 들어간 서버 스크립트를 쓰세요.
이 페이지의 내용
  1. 구조
  2. 1. Tool 만들기
  3. 2. 서버 스크립트
  4. 3. LocalScript
  5. 히트박스
  6. 히트박스 방식
  7. 타이밍과 벽 확인
  8. 휘두르기 애니메이션
  9. 예전 튜토리얼
  10. 보호의 한계
  11. 4. 테스트
  12. 확장
  13. Common errors
  14. RoCode로
  15. 자주 묻는 질문
  16. 출처와 더 읽을거리

제대로 동작하는 칼의 구조

예시 영상최소 0.6초 간격으로 휘두르면 체력이 20씩 줄고, 쿨다운 안의 클릭은 아무것도 하지 않으며, 다섯 번째 공격에 리그가 쓰러집니다.

실제 게임에서 동작하는 칼은 플레이어의 기기와 서버로 나뉩니다. Roblox의 도구 페이지에 따르면 도구 입력은 LocalScript에 있어야 합니다. 입력이 언제 일어나는지는 플레이어의 기기만 알기 때문입니다. 또한 대부분의 도구에는 LocalScript, 서버 Script, 그리고 그 사이의 RemoteEvent가 필요합니다. 이 가이드는 정확히 이렇게 나눕니다. 한 번 휘두르는 과정은 다음과 같습니다:

  1. 플레이어가 Sword를 장착한 채 클릭하거나, 탭하거나, 게임패드 트리거를 누릅니다. LocalScript에서 Tool.Activated가 발생합니다.
  2. LocalScript가 휘두르기 애니메이션이 있으면 재생하고, RemoteEvent SwordSwing을 호출합니다. 그 밖에는 아무것도 보내지 않습니다.
  3. 서버 Script가 쿨다운, 플레이어가 살아 있는지, Sword를 손에 들고 있는지 확인합니다.
  4. 서버가 플레이어 캐릭터 앞에 자기 히트박스를 만들고, 그 안에 있는 모든 Humanoid를 찾습니다.
  5. 그 Humanoid는 각각 TakeDamage로 한 번씩 체력을 잃습니다.
칼의 구성 요소
요소위치하는 일
Tool SwordStarterPack플레이어가 드는 것입니다. Roblox는 플레이어 캐릭터가 스폰할 때마다 StarterPack의 모든 것을 플레이어의 Backpack에 복사합니다.
Part HandleTool 안캐릭터가 쥐는 파트입니다. 칼날이 여기에 용접됩니다.
LocalScript SwordClientTool 안클릭을 듣고, 휘두르기 애니메이션을 재생하고, 리모트를 호출합니다.
RemoteEvent SwordSwingReplicatedStorage (SwordService가 만듦)플레이어 기기에서 서버로 "휘둘렀다"를 인자 없이 전달합니다.
Script SwordServiceServerScriptService모든 휘두르기를 확인하고, 플레이어 앞에 누가 있는지 찾아 피해를 줍니다. 공격이 일어날 수 있는 유일한 곳입니다.
칼이 완성되었을 때의 Explorer. 게임이 실행되면 SwordService가 ReplicatedStorage에 SwordSwing이라는 RemoteEvent를 추가합니다.
ServerScriptService
  SwordService Script new
StarterPack
  Sword Tool new
    Handle Part new
    Blade Part new
      WeldConstraint WeldConstraint new
    SwordClient LocalScript new

1단계: 칼 Tool 만들기

  1. Explorer에서 Workspace에 마우스를 올리고 + 버튼을 눌러 Tool을 넣습니다. 이름을 Sword로 바꾸세요. 서버 스크립트는 정확히 이 이름을 찾습니다. Roblox 도구 페이지가 권하는 대로 칼은 Workspace에서 만듭니다. 그곳에서는 파트가 보여서 움직이고 크기를 바꿀 수 있기 때문입니다. 마지막 단계에서 StarterPack으로 옮깁니다.
  2. Tool 안에 Part를 넣고 이름을 Handle로 정합니다. 캐릭터가 칼을 쥐는 손잡이입니다. Tool의 직접 자식이어야 하고 그 이름을 가진 유일한 파트여야 합니다. Handle이 두 개면 Roblox가 하나를 무작위로 골라, 캐릭터가 칼날을 쥘 수도 있습니다.
  3. Tool 안에 두 번째 Part를 넣고 이름을 Blade로 정한 다음, 모양을 잡고 Handle 위쪽으로 튀어나오게 배치합니다.
  4. Blade 안에 WeldConstraint를 넣습니다. Properties 창에서 Part0을 Handle로, Part1을 Blade로 설정해 플레이어가 들고 다니는 동안 칼이 한 덩어리로 유지되게 하세요.
  5. 두 파트를 모두 선택하고 Anchored가 꺼져 있는지 확인합니다. 도구에 고정된 파트가 있으면 장착할 때 캐릭터가 그 자리에 묶여 버립니다. 휘두를 때 칼날이 플레이어나 벽에 부딪히지 않도록 두 파트 모두 CanCollide도 끄세요.
  6. Tool을 선택하고 CanBeDropped 체크를 해제합니다. 체크되어 있으면 Backspace를 눌렀을 때 칼이 Workspace로 떨어집니다.
  7. 완성된 Sword를 Workspace에서 StarterPack으로 끌어다 놓습니다. Workspace에 남겨 둔 Tool은 한 플레이어가 주워 가는 아이템이지, 처음부터 모두의 Backpack에 들어 있는 칼이 아닙니다.

MeshPart 하나로 된 칼도 괜찮습니다. 그 MeshPart의 이름을 Handle로 정하고 Weld는 건너뛰세요. 테스트할 때 캐릭터가 칼을 이상한 각도로 쥐면 Tool을 선택하고 Properties 창에서 그립 속성(GripPos, GripForward, GripRight, GripUp)을 조정하세요.

2단계: 서버 스크립트 추가하기

ServerScriptService에 마우스를 올리고 SwordService라는 이름의 Script를 넣은 다음 아래 코드를 붙여 넣으세요. 칼 공격이 일어날 수 있는 유일한 곳입니다. 맨 위의 설정이 바꾸라고 둔 줄입니다.

Script 위치: ServerScriptService 이름: SwordService
-- ServerScriptService에 있는 SwordService라는 이름의 Script.
-- 칼 공격이 일어날 수 있는 유일한 곳: 휘두르기를 확인하고, 자체 히트박스로
-- 공격자 앞의 대상을 찾아 피해를 줍니다.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- 설정
local SWORD_NAME = "Sword" -- StarterPack에 있는 Tool의 이름
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- SwordClient에도 같은 값을 쓰세요
local HIT_RANGE = 6 -- 공격자 앞쪽 스터드 수
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false -- false: 같은 팀 플레이어끼리는 피해를 줄 수 없음
-- 정확히 COOLDOWN_SECONDS 간격으로 보낸 휘두르기도 네트워크 지연 뒤에는
-- 조금 더 가깝게 도착할 수 있으므로, 서버가 이만큼 여유를 두어 진짜 휘두르기를 버리지 않습니다
local NETWORK_SLACK = 0.1

-- 칼의 LocalScript가 호출하는 리모트. 인자가 없습니다: 누가 맞을지는
-- 서버가 정하므로 클라이언트가 조작할 것이 없습니다.
local swingEvent = Instance.new("RemoteEvent")
swingEvent.Name = "SwordSwing"
swingEvent.Parent = ReplicatedStorage

local lastSwing: { [Player]: number } = {}

local function isTeammate(attacker: Player, target: Player?): boolean
	if FRIENDLY_FIRE or not target then
		return false
	end
	-- 중립 플레이어(팀 없음)는 언제나 서로 공격할 수 있습니다
	return not attacker.Neutral and not target.Neutral and attacker.Team == target.Team
end

local function onSwing(player: Player)
	-- 1. 리모트를 얼마나 자주 호출하든 쿨다운당 한 번만 휘두르기
	local now = os.clock()
	local last = lastSwing[player]
	if last and now - last < COOLDOWN_SECONDS - NETWORK_SLACK then
		return
	end

	-- 2. 공격자가 살아 있고 칼을 들고 있어야 함
	local character = player.Character
	local humanoid = character and character:FindFirstChildOfClass("Humanoid")
	local rootPart = humanoid and humanoid.RootPart
	if not (character and humanoid and rootPart) or humanoid.Health <= 0 then
		return
	end
	local sword = character:FindFirstChild(SWORD_NAME)
	if not (sword and sword:IsA("Tool")) then
		return
	end
	lastSwing[player] = now

	-- 3. 서버 자체 히트박스: 공격자 루트 파트 앞의 박스
	local params = OverlapParams.new()
	params.FilterType = Enum.RaycastFilterType.Exclude
	params.FilterDescendantsInstances = { character }
	local boxCFrame = rootPart.CFrame * CFrame.new(0, 0, -HIT_RANGE / 2)
	local parts = workspace:GetPartBoundsInBox(boxCFrame, Vector3.new(HIT_WIDTH, HIT_HEIGHT, HIT_RANGE), params)

	-- 4. 박스 안의 Humanoid는 파트가 여러 개 들어 있어도 한 번만 피해를 받음
	local alreadyHit: { [Humanoid]: boolean } = {}
	for _, part in parts do
		local model = part:FindFirstAncestorOfClass("Model")
		local target = model and model:FindFirstChildOfClass("Humanoid")
		if model and target and not alreadyHit[target] and target.Health > 0 then
			alreadyHit[target] = true
			if not isTeammate(player, Players:GetPlayerFromCharacter(model)) then
				target:TakeDamage(DAMAGE) -- 대상에게 ForceField가 있는 동안에는 아무것도 하지 않음
			end
		end
	end
end

swingEvent.OnServerEvent:Connect(onSwing)

Players.PlayerRemoving:Connect(function(player: Player)
	lastSwing[player] = nil
end)

SwordService는 게임이 시작될 때 RemoteEvent SwordSwing을 직접 만들므로, ReplicatedStorage에 따로 넣을 것은 없습니다. 같은 이름의 RemoteEvent를 이미 만들었다면 지우세요. LocalScript가 그쪽을 찾을 수 있는데, 서버에서는 아무도 그것을 듣지 않습니다.

SwordService 맨 위의 설정
설정여기서의 값바뀌는 것
SWORD_NAME"Sword"서버가 플레이어 손에 있으리라 기대하는 Tool 이름입니다. Tool 이름이 다르면 바꾸세요.
DAMAGE20공격 한 번에 줄어드는 체력입니다. Humanoid는 체력 100으로 시작하므로 다섯 번이면 테스트 리그가 쓰러집니다. 플레이어 캐릭터는 기본적으로 매초 MaxHealth의 1%를 회복하므로, 최대 속도로 맞는 플레이어는 다섯 번째 공격을 버티고 여섯 번째가 필요합니다.
COOLDOWN_SECONDS0.6휘두르기 사이의 시간입니다. SwordClient에도 같은 값을 넣으세요.
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT6, 5, 6스터드 단위 히트박스입니다. 플레이어 앞으로 얼마나 멀리 닿는지, 너비와 높이가 얼마인지 정합니다.
FRIENDLY_FIREfalsefalse이면 같은 팀 플레이어끼리는 피해를 줄 수 없습니다. 팀이 없는 플레이어는 언제나 서로 공격할 수 있고, NPC는 언제나 공격할 수 있습니다.
NETWORK_SLACK0.1쿨다운보다 얼마나 일찍 온 휘두르기까지 서버가 받아 주는지입니다. 0.6초 간격의 두 클릭도 네트워크 지연 뒤에는 조금 더 가깝게 도착할 수 있어서, 이 여유가 없으면 플레이어가 이미 본 진짜 휘두르기를 서버가 버리게 됩니다.

3단계: Tool에 LocalScript 추가하기

Sword Tool 안에 LocalScript를 넣고 이름을 SwordClient로 정한 다음 이 코드를 붙여 넣으세요:

LocalScript 위치: StarterPack의 Sword Tool 이름: SwordClient
-- Sword Tool 안에 있는 SwordClient라는 이름의 LocalScript.
-- Tool.Activated는 플레이어 기기에서 발생하므로, 이 스크립트가 클릭,
-- 탭, 트리거를 듣고 휘두르기 애니메이션을 재생한 뒤 서버에 휘두르기를 요청합니다.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local tool = script.Parent :: Tool
local swingEvent = ReplicatedStorage:WaitForChild("SwordSwing") :: RemoteEvent

local COOLDOWN_SECONDS = 0.6 -- SwordService와 같은 값
local SWING_ANIMATION_ID = "" -- 선택 사항: "rbxassetid://" 뒤에 내 애니메이션 id

local player = Players.LocalPlayer
local lastSwing = 0
local swingTrack: AnimationTrack? = nil
local trackCharacter: Model? = nil

-- 캐릭터마다 애니메이션을 한 번 불러옵니다. 내 기기에서 내 캐릭터에
-- 재생한 애니메이션은 모든 플레이어에게 보입니다.
local function loadSwing()
	local character = player.Character
	if SWING_ANIMATION_ID == "" or not character or character == trackCharacter then
		return
	end
	local humanoid = character:FindFirstChildOfClass("Humanoid")
	local animator = humanoid and humanoid:FindFirstChildOfClass("Animator")
	if animator then
		local animation = Instance.new("Animation")
		animation.AnimationId = SWING_ANIMATION_ID
		swingTrack = animator:LoadAnimation(animation)
		trackCharacter = character
	end
end

tool.Equipped:Connect(loadSwing)

tool.Activated:Connect(function()
	local now = os.clock()
	if now - lastSwing < COOLDOWN_SECONDS then
		return -- 서버도 확인합니다. 여기서 확인하면 불필요한 요청을 줄입니다
	end
	lastSwing = now
	if swingTrack then
		swingTrack:Play()
	end
	swingEvent:FireServer()
end)

일단 SWING_ANIMATION_ID는 비워 두세요. 맞았는지는 어차피 서버가 정하므로 애니메이션 없이도 칼은 동작합니다. 채우는 방법은 휘두르기 애니메이션 추가하기 섹션에 있습니다.

Activated는 마우스 클릭, 휴대폰 탭, 게임패드 트리거에서 발생하므로 같은 스크립트가 모든 기기에서 동작합니다. Roblox는 플레이어 캐릭터가 스폰할 때 Tool과 그 안의 LocalScript를 각 플레이어의 Backpack에 복사하므로, 플레이어마다 자기 사본이 동작합니다.

LocalScript가 자체 쿨다운을 두는 것은 서버가 어차피 무시할 요청을 보내지 않기 위해서일 뿐입니다. 보안 검사가 아닙니다. 치터는 이것을 지우거나 바꾸거나 자기 코드에서 SwordSwing을 호출할 수 있습니다. RemoteEvent 가이드는 모든 리모트를 서버에서 검증해야 하는 이유를 설명하고, Script vs LocalScript vs ModuleScript(영어)는 LocalScript가 바꿀 수 있는 것과 없는 것을 보여 줍니다.

서버가 누가 맞았는지 정하는 방법

SwordSwing이 도착해도 SwordService는 클라이언트에게 아무것도 묻지 않습니다. 서버가 보는 위치에서 공격자 캐릭터 앞에 박스를 만들고, workspace:GetPartBoundsInBox로 그 안에 어떤 파트가 있는지 엔진에 묻습니다. 이 메서드는 Roblox가 더 이상 권장하지 않는 예전 FindPartsInRegion3를 대체합니다.

박스의 중심은 공격자 루트 파트 앞 3스터드에 있습니다. 이것이 CFrame.new(0, 0, -HIT_RANGE / 2) 오프셋입니다. CFrame은 음의 Z축 방향을 바라보며, 이것이 LookVector입니다. 그래서 박스는 캐릭터 한가운데부터 앞으로 6스터드 뻗어 있고, 너비는 5스터드, 높이는 6스터드입니다. 이 쿼리는 각 파트의 경계 상자(bounding box), 즉 부피를 상자 모양으로 빠르게 근사한 것을 비교하므로, 둥근 파트와 메시는 보이는 것보다 조금 크게 계산됩니다. 칼에는 이 작은 여유가 오히려 도움이 됩니다.

SwordService가 박스 안의 파트로 하는 일
단계코드이유
공격자 제외Exclude와 공격자 캐릭터를 넣은 OverlapParams공격자 자신의 팔, 다리, 칼도 박스 안에 있습니다.
캐릭터 찾기part:FindFirstAncestorOfClass("Model")박스 안의 파트는 팔다리, 모자, 손에 든 도구일 수 있습니다. FindFirstAncestorOfClass는 정확한 클래스 이름을 비교하므로 모자(Accessory 클래스)와 손에 든 도구(Tool 클래스, Tool이 Model의 한 종류이긴 해도)를 지나쳐 캐릭터 모델에서 멈춥니다.
Humanoid 찾기model:FindFirstChildOfClass("Humanoid")Humanoid가 있는 것은 모두 공격할 수 있습니다. 플레이어, NPC, 테스트 더미입니다. 벽과 바닥은 건너뜁니다.
Humanoid당 한 번alreadyHit 테이블보통 한 캐릭터의 파트 여러 개가 박스에 들어옵니다. 테이블이 없으면 파트마다 피해를 다시 주게 됩니다.
살아 있는 대상만target.Health > 0이미 쓰러진 캐릭터는 다시 때리지 않습니다.
팀isTeammateFRIENDLY_FIRE가 false이면 같은 팀 플레이어는 건너뜁니다. Neutral 속성이 true인 플레이어는 팀이 없습니다.
피해target:TakeDamage(DAMAGE)대상이 ForceField로 보호받고 있지 않으면 Health를 줄입니다.

alreadyHit 테이블은 휘두를 때마다 새로 만들어지므로, 쿨다운이 지나면 다음 휘두르기로 같은 플레이어를 다시 때릴 수 있습니다. 이것이 Touched 기반 칼이 늘 애를 먹는 "휘두르기당 대상마다 한 번" 규칙입니다.

스크립트는 Health를 직접 대입하지 않고 TakeDamage를 씁니다. Roblox 레퍼런스에 따르면 TakeDamage는 ForceField가 보호하는 동안 Humanoid를 건드리지 않지만, Health를 직접 대입하면 ForceField를 무시합니다. SpawnLocation에서 스폰한 플레이어는 기본적으로 10초 동안 ForceField를 받으므로(SpawnLocation의 Duration), 막 들어온 플레이어는 나타나는 순간 공격받지 않습니다.

칼 히트박스를 만드는 네 가지 방법 비교

칼 튜토리얼은 주로 한 가지에서 갈립니다. 칼날이 무엇에 맞았는지 어떻게 알아내느냐입니다. 흔히 쓰는 답은 네 가지입니다. 칼날을 얼마나 정확히 따라가는지, 서버에 얼마나 부담을 주는지, 치터가 결과를 조작할 수 있는지가 다릅니다.

칼 히트박스를 만드는 방법. "누가 정하나"는 그 답이 인정되는 쪽입니다
방법작동 방식누가 정하나정확도가장 잘 맞는 용도
칼날의 Touched칼날 파트가 캐릭터에 닿을 때마다 피해자기 캐릭터와 칼을 소유한 공격자의 기기칼날을 따라가지만 한 번 닿을 때 여러 번 발생다른 플레이어가 있는 게임에서는 어디에도 맞지 않음: 공격자의 기기가 어디서든 일으킬 수 있음
플레이어 앞의 박스(이 가이드)휘두를 때마다 서버에서 GetPartBoundsInBox 쿼리 한 번서버칼날 경로가 아니라 고정된 박스. 메시는 경계 상자로 계산되어 약간 넉넉함대부분의 게임: 간단하고, 저렴하고, 조작할 것이 없음
히트박스 파트에 GetPartsInPart휘두르는 동안 칼날 궤적 모양 파트로 서버 쿼리서버정확한 모양: Roblox 문서에 따르면 완전한 기하 검사를 하며, 정확도가 덜 필요할 때는 더 저렴한 박스나 구 쿼리를 권함모양이 특이한 큰 무기, 예를 들어 낫의 궤적
칼날을 따라 레이캐스트휘두르는 매 프레임마다 칼날 위의 점에서 지난 프레임 위치까지 짧은 광선을 쏨광선을 쏘는 쪽. 서버에서 하려면 칼날 위치에 대한 서버 쪽 정보가 필요애니메이션을 가깝게 따라감정확한 휘두르기 경로가 중요한 게임. 커뮤니티 히트박스 모듈이 이렇게 동작함

박스가 처음 고르기에 알맞습니다. 휘두를 때마다 쿼리 한 번이고, 치터가 바꿀 수 있는 애니메이션에 절대 의존하지 않으며, 숫자 세 개로 쉽게 조정할 수 있습니다. 공격 범위가 박스와 많이 다른 무기에서 플레이어가 타격감이 이상하다고 할 때 알맞은 모양의 파트나 칼날을 따르는 광선으로 바꾸고, 같은 규칙은 지키세요. 쿼리 실행과 피해는 서버가 합니다.

칼 프리셋: 단검부터 양손검까지

같은 SwordService로 설정 다섯 개만 바꿔 아주 다른 무기를 만들 수 있습니다. 표는 Health 100인 Rig Generator 더미를 기준으로 계산한 출발점입니다. "쓰러뜨리기까지 시간"은 쿨다운이 허락하는 즉시 매번 맞힌다고 가정하고 첫 공격부터 셉니다.

흔한 근접 무기용 SwordService 설정과, Health 100인 더미를 쓰러뜨리는 공격 횟수 및 시간. 측정이 아니라 계산한 값
무기DAMAGECOOLDOWN_SECONDSHIT_RANGEHIT_WIDTH공격 횟수(시간)초당 피해
단검120.35449 (2.8초)약 34
칼(이 가이드)200.6655 (2.4초)약 33
양손검351.1773 (2.2초)약 32
창180.8936 (4초)약 23
  • 플레이어는 회복하고 더미는 회복하지 않습니다. 플레이어 캐릭터는 기본적으로 매초 MaxHealth의 1%를 회복합니다. 공격 5번에 피해가 정확히 100이면, 최대 속도로 맞는 플레이어는 다섯 번째 공격을 버티고 여섯 번째가 필요합니다. 공격 횟수가 정확해야 한다면 20 대신 21처럼 여유를 두세요.
  • NETWORK_SLACK은 쿨다운에 맞춰 조정하세요. 가이드의 0.1초는 0.6의 6분의 1입니다. 쿨다운 0.35초인 단검에 0.1을 그대로 두면 치터가 0.25초마다, 40% 더 빠르게 공격할 수 있습니다. COOLDOWN_SECONDS의 약 6분의 1을 쓰세요. 단검이면 0.06입니다.
  • SwordClient도 맞춰 두세요. 거기에도 같은 COOLDOWN_SECONDS를 넣으세요. 그렇지 않으면 클라이언트가 서버가 무시하는 휘두르기를 보냅니다.

버전 2: 휘두르기 타이밍과 벽 너머 공격 차단

기본 칼이 동작하면 불만이 두 가지 나옵니다. 휘두르기 애니메이션이 대상에 닿기도 전에, 플레이어가 클릭한 바로 그 순간 공격이 들어갑니다. 그리고 박스가 벽을 고려하지 않기 때문에 얇은 벽 반대편에 선 사람까지 맞을 수 있습니다. 이 버전의 SwordService는 둘 다 고칩니다. 2단계 스크립트를 대체하며, 이름도 리모트도 설정도 같으므로 SwordClient는 바꿀 필요가 없습니다.

Script 위치: ServerScriptService 이름: SwordService
-- ServerScriptService에 있는 SwordService라는 이름의 Script(휘두르기 타이밍과 벽 확인 버전).
-- 2단계 스크립트를 대체합니다: 같은 설정과 리모트에 규칙 두 개를 더합니다. 공격은
-- 클릭 후 WINDUP_SECONDS 뒤, 휘두르기가 대상에 닿을 때 들어가고, 벽 너머의
-- 누구도 맞히지 않습니다.

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

-- 설정
local SWORD_NAME = "Sword"
local DAMAGE = 20
local COOLDOWN_SECONDS = 0.6 -- SwordClient에도 같은 값을 쓰세요
local WINDUP_SECONDS = 0.15 -- 클릭부터 공격까지의 시간. 내 휘두르기 애니메이션에 맞추세요
local HIT_RANGE = 6
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false
local NETWORK_SLACK = 0.1

local swingEvent = Instance.new("RemoteEvent")
swingEvent.Name = "SwordSwing"
swingEvent.Parent = ReplicatedStorage

local lastSwing: { [Player]: number } = {}

local function isTeammate(attacker: Player, target: Player?): boolean
	if FRIENDLY_FIRE or not target then
		return false
	end
	return not attacker.Neutral and not target.Neutral and attacker.Team == target.Team
end

-- 공격자가 살아 있고 칼을 들고 있는 동안 캐릭터와 루트 파트를 돌려줍니다
local function getArmedCharacter(player: Player): (Model?, BasePart?)
	local character = player.Character
	local humanoid = character and character:FindFirstChildOfClass("Humanoid")
	local rootPart = humanoid and humanoid.RootPart
	if not (character and humanoid and rootPart) or humanoid.Health <= 0 then
		return nil, nil
	end
	local sword = character:FindFirstChild(SWORD_NAME)
	if not (sword and sword:IsA("Tool")) then
		return nil, nil
	end
	return character, rootPart
end

-- 공격자와 대상 사이에 대상 말고는 아무것도 없으면 true
local function hasClearLine(attacker: Model, from: BasePart, target: Model, to: BasePart): boolean
	local params = RaycastParams.new()
	params.ExcludeInstances = { attacker }
	local result = workspace:Raycast(from.Position, to.Position - from.Position, params)
	return result == nil or result.Instance:IsDescendantOf(target)
end

local function strike(player: Player)
	-- 휘두르기 타이밍 뒤에 다시 확인: 공격자가 죽었거나 칼을 넣었을 수 있음
	local character, rootPart = getArmedCharacter(player)
	if not (character and rootPart) then
		return
	end
	local params = OverlapParams.new()
	params.FilterType = Enum.RaycastFilterType.Exclude
	params.FilterDescendantsInstances = { character }
	local boxCFrame = rootPart.CFrame * CFrame.new(0, 0, -HIT_RANGE / 2)
	local parts = workspace:GetPartBoundsInBox(boxCFrame, Vector3.new(HIT_WIDTH, HIT_HEIGHT, HIT_RANGE), params)

	local alreadyHit: { [Humanoid]: boolean } = {}
	for _, part in parts do
		local model = part:FindFirstAncestorOfClass("Model")
		local target = model and model:FindFirstChildOfClass("Humanoid")
		local targetRoot = target and target.RootPart
		if model and target and targetRoot and not alreadyHit[target] and target.Health > 0 then
			alreadyHit[target] = true
			if not isTeammate(player, Players:GetPlayerFromCharacter(model)) and hasClearLine(character, rootPart, model, targetRoot) then
				target:TakeDamage(DAMAGE)
			end
		end
	end
end

swingEvent.OnServerEvent:Connect(function(player: Player)
	local now = os.clock()
	local last = lastSwing[player]
	if last and now - last < COOLDOWN_SECONDS - NETWORK_SLACK then
		return
	end
	local character = getArmedCharacter(player)
	if not character then
		return
	end
	lastSwing[player] = now
	task.delay(WINDUP_SECONDS, strike, player)
end)

Players.PlayerRemoving:Connect(function(player: Player)
	lastSwing[player] = nil
end)

먼저 2단계의 SwordService를 지우세요. 그렇지 않으면 두 스크립트가 각각 SwordSwing 리모트를 만듭니다. WINDUP_SECONDS는 휘두르기 애니메이션에서 칼날이 캐릭터 앞을 지나가는 순간으로 맞추세요. 빠른 휘두르기라면 0.15가 적당합니다.

  • 휘두르기 타이밍. 쿨다운과 "살아 있고 칼을 들고 있는지" 확인은 클릭이 도착할 때 하고, 그다음 task.delay가 WINDUP_SECONDS 뒤에 strike를 실행합니다. 그사이 공격자가 죽었거나 칼을 넣었을 수 있으므로 strike는 공격자를 한 번 더 확인한 뒤에야 박스를 만듭니다. 타이밍 동안 사거리 밖으로 벗어난 대상은 맞지 않으며, 플레이어가 휘두르는 모습을 볼 때 기대하는 것이 바로 이것입니다.
  • 벽 확인. 박스 안의 대상마다 hasClearLine이 공격자 자신의 캐릭터를 제외하고 공격자 루트 파트에서 대상 루트 파트로 광선을 쏩니다. 처음 만나는 것이 대상의 것이거나 아무것도 만나지 않으면 공격이 인정됩니다. 사이에 있는 벽, 문, 다른 플레이어는 공격을 막습니다.
  • 비용. 휘두르기마다 대상당 광선 하나가 추가되며, 박스 쿼리 자체에 비하면 적습니다.

휘두르기 타이밍은 누군가에게 순간이동하는 바로 그 순간 공격하는 치터에게도 칼을 더 공정하게 만듭니다. 서버가 조금 뒤에, 그 시점에 서버가 보는 캐릭터 위치에서 대상을 찾기 때문입니다. 순간이동 자체를 막지는 않습니다. 그러려면 익스플로이터가 할 수 있는 것과 없는 것 섹션에서 설명하는 이동 확인이 필요합니다.

휘두르기 애니메이션 추가하기(선택 사항)

SwordClient는 ID만 주면 바로 애니메이션을 재생합니다. 애니메이션은 Studio의 Animation Editor에서 한 번만 만들면 됩니다:

  1. 애니메이션용 리그를 넣습니다. Avatar 또는 Home 탭에서 Character를 눌러 Rig Generator를 열고, 게임의 아바타에 맞는 리그를 고르세요. 예를 들어 R15, 그다음 Block Avatar입니다.
  2. Avatar 탭에서 Clip Editor를 눌러 Animation Editor를 열고, 리그를 선택해 오른팔로 짧게 휘두르는 포즈를 잡습니다.
  3. 우선순위를 Action으로 설정합니다. 에디터 재생 컨트롤의 … 버튼을 누르고 Set Animation Priority에 마우스를 올린 다음 Action을 고르세요. Action은 Movement, Idle, Core보다 높으므로, 휘두르기가 걷기와 서 있기 애니메이션에 밀리지 않고 그 위에 재생됩니다.
  4. 같은 … 메뉴에서 Publish to Roblox를 고릅니다. 게임이 그룹 소유라면 보내기 전에 Creator 필드에서 그 그룹을 고르세요.
  5. Toolbox에서 애니메이션의 asset ID를 복사하고, SwordClient에서 SWING_ANIMATION_ID를 "rbxassetid://" 뒤에 그 숫자를 붙인 값으로 설정합니다.

SwordClient는 Roblox가 더 이상 권장하지 않는 예전 Humanoid:LoadAnimation이 아니라 캐릭터의 Animator로 휘두르기를 불러옵니다. Roblox의 Animator 레퍼런스에 따르면 플레이어 기기가 그 플레이어 자신의 캐릭터에 재생한 애니메이션은 서버와 다른 모든 플레이어에게 복제되므로, LocalScript가 휘두르기를 재생해도 모두가 봅니다. 같은 곳에 Animator는 서버에서 만들어야 한다고 적혀 있으므로 LocalScript에서 절대 만들지 마세요. 플레이어 캐릭터에서는 보통 Humanoid 안에 있으며, Roblox의 공식 애니메이션 예제도 바로 그곳에서 찾습니다.

애니메이션은 겉모습을 위한 것일 뿐입니다. 타격은 애니메이션에 의존하지 않으므로, 애니메이션이 느리거나 없거나 바뀌어도 누가 맞는지는 절대 달라지지 않습니다.

키를 눌러, 반복으로, 또는 NPC에게 애니메이션을 재생하는 방법은 애니메이션 스크립트 가이드를 읽어 보세요.

예전 칼 튜토리얼이 틀리는 부분

이 가이드를 영상이나 포럼 글과 비교하고 있다면, 중요한 차이점과 각 방법이 문제를 일으키는 이유는 다음과 같습니다.

칼 튜토리얼에서 흔한 방법과 이 가이드가 대신 하는 것
튜토리얼문제이 가이드
칼날의 Touched 이벤트로 피해를 줌공격자의 기기는 어디서든 자기 칼에 Touched를 일으킬 수 있고(Roblox network ownership 페이지), Touched는 한 번 닿을 때 여러 번 연달아 발생합니다(Roblox debounce 페이지).서버가 자체 박스로 대상을 찾으며, 휘두르기당 Humanoid마다 한 번입니다.
LocalScript에서 Health를 줄임LocalScript가 다른 사람의 캐릭터에 한 변경은 그 기기 하나에만 남습니다.모든 피해는 SwordService에서 줍니다.
쿨다운에 wait(0.5) 사용Roblox는 전역 wait()를 더 이상 권장하지 않고 task.wait()를 대신 쓰며, 클라이언트에만 있는 쿨다운은 아무도 막지 못합니다.서버에서 os.clock() 시간을 비교합니다. 아무것도 기다리지 않습니다.
Humanoid:LoadAnimation으로 휘두르기 재생더 이상 권장되지 않으며, 대신 Animator:LoadAnimation을 씁니다.Animator로 휘두르기를 불러옵니다.
Region3와 FindPartsInRegion3로 대상 찾기더 이상 권장되지 않습니다. Roblox는 새 프로젝트에 OverlapParams와 함께 GetPartBoundsInBox를 쓰라고 권합니다.GetPartBoundsInBox를 씁니다.
서버 Script를 Tool 안에 두고 Activated를 들음플레이어마다 칼이 서버 코드 사본을 따로 실행하고, 이런 스크립트는 흔히 Touched로 피해를 줍니다(첫 번째 줄). 기본 설정에서 Script는 Workspace나 ServerScriptService에서만 실행되므로, Tool 안의 Script는 칼을 처음 장착할 때까지 실행되지 않습니다. Roblox 도구 페이지는 대부분의 도구를 입력용 LocalScript, 효과용 서버 Script, 그 사이의 RemoteEvent로 설명합니다.ServerScriptService의 SwordService 하나가 게임의 모든 칼을 처리합니다.

익스플로이터가 할 수 있는 것과 없는 것

치터가 자기 기기의 모든 것을 제어한다고 생각하세요. LocalScript를 읽고 바꿀 수 있으며, Roblox 보안 가이드에 따르면 RemoteEvent를 아무 빈도로나 임의의 인자와 함께 호출할 수 있습니다. 이 칼에서 그것이 뜻하는 바는 다음과 같습니다.

치터가 시도할 수 있는 것과 SwordService의 대응
치터의 시도결과이유
코드가 할 수 있는 최대 속도로 SwordSwing을 호출하거나 오토클리커 사용0.5초에 최대 한 번의 휘두르기만 인정서버 쿨다운은 0.6초에서 네트워크 여유 0.1초를 뺀 값입니다. 이 여유가 치터가 얻는 최대치입니다.
리모트에 대상, 피해량, 위치를 함께 보냄무시됨onSwing은 Roblox가 직접 넣어 주는 플레이어만 읽습니다. 리모트로 보낸 나머지는 절대 읽지 않습니다.
SwordClient를 바꿈, 예를 들어 쿨다운 제거서버에 영향 없음SwordService는 플레이어에게 절대 전송되지 않는 ServerScriptService에 설정을 둡니다.
죽은 상태나 칼을 들지 않은 상태로 공격무시됨SwordService는 Humanoid가 살아 있는지, 그리고 Sword라는 Tool이 캐릭터 안에 있는지 확인합니다. Roblox는 장착할 때 도구를 캐릭터 안으로 옮깁니다.
맵 반대편에서 누군가를 공격아무 일도 없음박스는 서버가 보는 공격자 캐릭터 위치 주변에 만들어지며, 앞으로 6스터드까지만 닿습니다.
플레이어에게 순간이동한 다음 공격가능각 기기는 자기 캐릭터의 이동을 제어하며, Roblox는 클라이언트가 자기 캐릭터로 할 수 있는 일에 아무 곳으로나 순간이동하기를 포함합니다. 서버 쪽 이동 확인으로 잡아낼 수 있습니다.
얇은 벽 너머로 공격6스터드 박스 안에서는 가능2단계의 박스 쿼리는 벽을 찾지 않습니다. 버전 2가 벽 확인을 더합니다.
아무 애니메이션이나 재생하거나 재생하지 않음타격에 영향 없음타격은 절대 애니메이션에 의존하지 않습니다. Roblox는 치터가 자기 캐릭터에 임의의 애니메이션을 재생할 수 있다고 밝힙니다.

두 줄에 "가능"이라고 적혀 있으며, 솔직하게 말한 것입니다. 이 칼은 치터가 누구를, 얼마나 세게, 얼마나 자주 때릴지 고르지 못하게 합니다. 하지만 자기 캐릭터를 움직이는 것까지 막지는 못합니다. Roblox 보안 문서에 따르면 클라이언트는 자기 캐릭터의 이동과 물리를 제어하며, 이동 확인은 게임마다 맞춰 설정해야 합니다. 경쟁 게임이라면 다음 단계는 서버 쪽 이동 확인(달리기 가이드가 이것을 만들며, 노골적인 스피드핵과 먼 거리 순간이동을 경고합니다)이나 Roblox의 server authority입니다. server authority는 2026년 10월 13일 저희가 확인했을 때 문서에 베타로 설명되어 있었습니다.

4단계: 테스트하기

  1. 때릴 대상을 추가합니다. Avatar 또는 Home 탭에서 Character를 눌러 Rig Generator를 열고 리그(예: R15, 그다음 Block Avatar)를 고르면 Workspace에 들어갑니다. SpawnLocation에서 몇 스터드 떨어뜨려 두세요.
  2. Play를 누르고 핫바에서 Sword를 장착한 다음 리그에 다가가 클릭하세요. 첫 공격 뒤 리그 위에 체력 바가 나타납니다. Humanoid는 기본적으로 Health가 MaxHealth보다 낮을 때만 체력 바를 보여 주기 때문입니다. Humanoid는 체력 100으로 시작하므로 다섯 번째 공격에 쓰러집니다.
  3. 최대한 빠르게 클릭해 보세요. 0.6초에 한 번의 휘두르기만 효과가 있습니다.
  4. 리그에서 약 8스터드 떨어지거나 리그에 등을 돌리고 휘둘러 보세요. 리그의 파트가 하나도 박스 안에 없으므로 아무 일도 일어나지 않습니다.
  5. 실제 플레이어로 테스트하세요. 테스트 모드 드롭다운에서 Server & Clients를 고르고 클라이언트를 2개로 설정한 뒤 Play를 누르세요. 다른 플레이어가 스폰한 지 10초 안에 때리면 스폰 ForceField 때문에 아무 일도 일어나지 않습니다. 그 뒤로는 공격마다 20씩 줄어듭니다. 플레이어 캐릭터는 기본적으로 매초 MaxHealth의 1%를 회복하므로, 싸움 사이사이에 체력이 조금씩 돌아옵니다.
  6. 게임에 Teams가 있다면 두 테스트 플레이어를 같은 팀에 넣으세요. FRIENDLY_FIRE가 false이면 서로의 휘두르기가 아무 효과도 없습니다.

그동안 Output 창을 열어 두세요(Window 메뉴, 그다음 Output). 이 스크립트들은 제대로 동작할 때 아무것도 출력하지 않으므로, SwordService나 SwordClient에서 나온 빨간 오류는 모두 실제 문제입니다. 자주 나오는 오류를 참고하세요.

칼을 전투 시스템으로 확장하기

콤보

서버에서 lastSwing 옆에 플레이어별 휘두르기 카운터를 두세요. 직전 휘두르기가 최근이었다면 1을 더하고, 아니면 다시 1부터 시작합니다. 그런 다음 카운터에 따라 피해를 고르고(예: 세 번째 공격마다 피해 증가), 같은 방식으로 PlayerRemoving에서 카운터를 지우세요. 애니메이션은 타격을 결정하지 않으므로, 어떤 애니메이션을 재생할지 고르기 위해 클라이언트가 자체 카운트를 두어도 됩니다. 박스와 확인 과정은 그대로입니다.

넉백

TakeDamage 다음에 SwordService가 대상의 RootPart에 공격자의 rootPart.CFrame.LookVector 방향으로 ApplyImpulse를 써서 대상을 밀어낼 수 있습니다. Roblox 레퍼런스에 따르면 밀리는 정도는 대상의 질량에 따라 달라지며, 서버 Script는 서버가 소유한 파트나 클라이언트가 자동으로 소유한 파트에 이것을 호출할 수 있습니다. 각 플레이어의 기기가 자기 캐릭터를 시뮬레이션하므로, 넉백은 리그뿐 아니라 Server & Clients로 플레이어에게도 테스트하세요.

리더보드용 킬 집계

target:TakeDamage(DAMAGE) 바로 앞에서 target:SetAttribute("LastHitBy", player.UserId)로 마지막으로 때린 사람을 기록하세요. 서버 Script에서 각 캐릭터 Humanoid의 Died 이벤트를 연결하고, 이 특성을 읽어 Players:GetPlayerByUserId로 공격자를 찾은 다음, 그 leaderstats의 Kills IntValue에 1을 더하세요. 리더보드 가이드의 1단계처럼 Coins와 Wins 옆에 만들고, 2단계처럼 서버에서 바꾸세요.

막기

막기 버튼을 누르고 뗄 때 클라이언트가 호출하는 두 번째 RemoteEvent를 추가하고, 서버가 자체 빈도 제한을 두고 그 플레이어 캐릭터에 Blocking 특성을 설정하게 하세요. SwordService에서는 대상 캐릭터에 Blocking이 설정되어 있으면 피해를 줄이거나 건너뜁니다. 언제 막을지는 여전히 치터가 고르므로, 막기를 짧게 하거나 쿨다운을 주세요.

칼 판매나 라운드마다 지급

StarterPack은 스폰할 때마다 모든 플레이어에게 칼을 줍니다. 대신 판매하려면 상점 GUI 가이드의 ShopItems 폴더에 넣으세요. 그 가이드의 카탈로그는 이미 ClassicSword라는 Tool을 팔고 있으므로, 이 Tool의 이름을 ClassicSword로 하고 SWORD_NAME도 똑같이 설정하거나 카탈로그 항목을 바꾸세요. 라운드 동안에만 주려면 라운드 시스템 가이드의 GiveRoundTool 스크립트를 쓰세요. Sword를 StarterPack이 아니라 ServerStorage에 두고, 그 스크립트의 "RoundTool"을 "Sword"로 바꾸면 됩니다.

싸울 적과 원거리 무기

플레이어를 쫓는 NPC는 NPC 길찾기 가이드를 따르세요. 칼은 다른 Humanoid처럼 그 NPC에게도 피해를 줍니다. 같은 서버 규칙으로 멀리서 공격하는 무기는 총 가이드를 읽어 보세요.

자주 발생하는 오류와 해결 방법

Play를 누르기 전에 Output 창(Window 메뉴, 그다음 Output)을 여세요. 칼 문제는 대부분 그곳에 오류를 출력하거나, 이름이 맞지 않아서 생깁니다.

Infinite yield possible on 'ReplicatedStorage:WaitForChild("SwordSwing")'

SwordClient가 SwordService가 만드는 리모트를 기다리고 있다는 뜻이므로, SwordService가 동작하지 않는 것입니다. LocalScript가 아니라 Script인지, ServerScriptService 바로 아래에 있는지, 비활성화되지 않았는지, Output에 그 스크립트의 오류가 없는지 확인하세요.

휘둘러도 아무도 피해를 받지 않아요

순서대로 확인하세요. SwordClient가 Script가 아니라 LocalScript이고 Sword Tool 바로 아래에 있는지, Tool 이름이 정확히 Sword이거나 SWORD_NAME에 적힌 이름인지, 대상이 내 앞 6스터드 안에 있는지, 대상이 스폰한 지 10초가 넘어 ForceField가 사라졌는지, Teams를 쓴다면 FRIENDLY_FIRE가 false인 상태로 같은 팀에 있지 않은지 확인하세요.

칼이 플레이어는 맞히는데 내 NPC는 절대 못 맞혀요

GetPartBoundsInBox 같은 공간 쿼리는 CanQuery가 꺼진 파트를 절대 돌려주지 않습니다(CanQuery는 CanCollide도 꺼져 있을 때만 적용됩니다). NPC 몸 파트의 CanQuery를 다시 켜고, Humanoid가 NPC 모델의 직접 자식인지 확인하세요.

칼을 장착하면 캐릭터가 움직이지 않아요

칼의 어떤 파트가 고정(Anchored)되어 있습니다. Tool 안의 모든 파트를 선택하고 Anchored를 해제하세요.

같은 거리에서 어떤 휘두르기는 맞고 어떤 것은 빗나가요

타이밍 버전에서는 WINDUP_SECONDS 동안 박스 밖으로 나간 대상이 맞지 않고, 벽 확인은 벽이나 다른 플레이어 뒤에 있는 사람을 모두 건너뜁니다. 플레이 테스트에서 빗나감이 불공평하게 느껴지면 타이밍을 줄이거나 HIT_WIDTH를 늘리세요.

캐릭터가 칼날을 쥐고 있어요

Handle이라는 이름의 파트가 두 개 이상이라 Roblox가 엉뚱한 것을 골랐습니다. 손잡이 하나만 Handle로 남기고 나머지는 이름을 바꾸세요. 그래도 각도가 이상하면 Tool의 그립 속성을 조정하세요.

칼을 장착하면 칼날이 제자리에 남거나 떨어져요

칼날이 Handle에 용접되지 않았습니다. Part0이 Handle, Part1이 칼날인 WeldConstraint를 추가하세요.

내 화면에서는 피해가 보이는데 다른 플레이어의 체력은 그대로예요

내 게임 사본만 바꾸는 LocalScript에서 피해를 주고 있는 것입니다. 2단계처럼 SwordService에서만 피해를 주세요.

RoCode로 만들기

이 모든 것을 직접 만들기 싫다면 RoCode가 지금 열려 있는 플레이스에 만들어 줄 수 있습니다. RoCode는 Roblox가 아닌 독립적인 코딩 AI 에이전트입니다. 웹 채팅에서 기능을 설명하면 Roblox Studio 플러그인이 Explorer에 Tool, 파트, 스크립트를 만들어 주므로 채팅 창에서 코드를 복사할 필요가 없습니다.

입력하는 내용

칼을 만들어 줘: StarterPack에 Handle과 거기에 용접된 칼날이 있는 Sword라는 Tool, Activated에서 RemoteEvent를 호출하는 LocalScript, 그리고 0.6초 쿨다운을 확인하고 플레이어 앞 박스 안의 모든 Humanoid에게 20 피해를 주는 서버 Script.

RoCode가 하는 일
  • Create Instance로 Tool과 파트를 만들고 Set Property로 속성을 설정합니다
  • Create Script로 SwordService와 SwordClient를 작성하며, 먼저 Search Scripts로 기존 전투 스크립트를 찾아볼 수 있습니다
  • 작성한 스크립트마다 Check Script로 컴파일을 확인하도록 지시받습니다. Check Script는 실행하지 않고 Studio에서 코드를 컴파일합니다(타입은 검사하지 않습니다)
  • 변경 묶음마다 앞뒤로 실행 취소 지점을 두므로 Ctrl+Z로 한 묶음씩 되돌릴 수 있습니다

RoCode는 휘두르기 애니메이션을 만들거나 업로드할 수 없습니다. Animation Editor에서 만들고 ID를 넣으세요. 플러그인 3.9 이상이면 RoCode가 짧은 플레이 테스트를 돌리고 오류를 읽을 수 있고, 플러그인 3.9.11 이상이면 테스트 캐릭터를 조종할 수 있지만, 휘두르려고 3D 창을 클릭하지는 않으므로 휘두르기는 직접 테스트하세요. RoCode로 시스템 하나씩 Roblox 게임 전체를 만드는 방법 페이지에서 무기가 어디에 들어가는지 보여 줍니다. RoCode가 Studio에 연결되는 방법.

자주 묻는 질문

왜 내 칼은 한 번 휘두를 때 한 플레이어를 여러 번 때리나요?

Touched로 피해를 주기 때문입니다. Roblox debounce 페이지에 따르면 Touched는 한 번 닿을 때 여러 번 연달아 발생하고, 대상의 파트마다 칼날에 닿을 수 있습니다. 이 가이드는 휘두를 때마다 박스 쿼리 한 번으로 대상을 찾고 목록을 관리하므로, 각 Humanoid는 휘두르기당 한 번만 체력을 잃습니다.

칼 피해는 LocalScript에 둬야 하나요, Script에 둬야 하나요?

서버의 Script입니다. LocalScript에서 준 피해는 그 플레이어의 게임 사본만 바꾸고, 플레이어 기기에 있는 것은 무엇이든 치터가 바꿀 수 있습니다. LocalScript는 클릭을 듣고, 애니메이션을 재생하고, RemoteEvent를 호출하기만 해야 합니다.

칼에 휘두르기 애니메이션을 어떻게 넣나요?

Animation Editor에서 만들고, 우선순위를 Action으로 정하고, Roblox에 게시한 다음, 그 asset ID를 rbxassetid:// 뒤에 숫자를 붙인 형태로 SWING_ANIMATION_ID에 넣으세요. SwordClient는 캐릭터의 Animator로 재생합니다. 플레이어 기기가 그 플레이어 자신의 캐릭터에 재생한 애니메이션은 모두에게 보입니다.

칼 애니메이션이 왜 재생되지 않나요?

세 가지를 확인하세요. 우선순위: Action은 Movement, Idle, Core보다 높으므로 Action 휘두르기는 걷기와 서 있기 위에 재생되지만, 더 낮은 우선순위는 밀릴 수 있습니다. 소유자: 게임이 그룹 소유라면 그 그룹을 Creator로 골라 애니메이션을 게시하세요. ID: SWING_ANIMATION_ID는 빈 문자열이 아니라 rbxassetid://와 내 애니메이션 숫자를 합친 전체 텍스트여야 합니다.

Roblox 칼에 가장 좋은 히트박스는 무엇인가요?

대부분의 게임에는 이 가이드처럼 휘두를 때마다 서버에서 한 번 하는 박스 쿼리입니다. GetPartBoundsInBox 호출 한 번이면 되고, 클라이언트가 조작할 것이 없으며, 조정할 숫자는 세 개입니다. 무기의 공격 범위가 박스와 많이 다를 때만 알맞은 모양의 파트에 GetPartsInPart를 쓰거나 칼날을 따라 레이캐스트를 쓰세요. 네 가지 방법 비교.

칼이 벽을 통과해 맞히지 않게 하려면 어떻게 하나요?

피해를 주기 전에 공격자 캐릭터를 제외하고 공격자 루트 파트에서 대상 루트 파트로 광선을 쏘고, 광선이 처음 만나는 것이 대상의 것일 때만 공격을 인정하세요. SwordService 버전 2가 대상마다 이렇게 합니다.

왜 휘두르기 애니메이션이 대상에 닿기 전에 공격이 들어가나요?

클릭이 도착하는 바로 그 순간 서버가 히트박스를 확인하기 때문입니다. 먼저 task.delay로 0.15초처럼 짧은 타이밍을 기다리고, 공격자가 아직 살아 있고 칼을 들고 있는지 확인한 다음, 버전 2처럼 박스를 만드세요.

이 칼로도 익스플로이터가 핵을 쓸 수 있나요?

누가 맞을지, 공격 한 번의 피해량, 얼마나 자주 때릴지는 서버가 모두 정하므로 고를 수 없습니다. 얻을 수 있는 최대치는 쿨다운의 네트워크 여유 0.1초입니다. 다만 각 기기가 자기 캐릭터의 이동을 제어하므로, 예를 들어 누군가에게 바짝 붙도록 자기 캐릭터를 움직이는 것은 여전히 가능합니다. 다음 단계는 서버 쪽 이동 확인입니다.

콤보가 있는 전투 시스템은 어떻게 만드나요?

서버에 플레이어별 휘두르기 카운터를 두고, 짧은 정지 뒤에 초기화하며, 카운터에 따라 피해와 애니메이션을 고르세요. 타격 확인은 그대로입니다. 확장하기 섹션에서 넉백, 킬 집계, 막기도 다룹니다.

출처와 더 읽을거리

코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.

내 게임에서 RoCode를 사용해 보세요.

매일 무료 크레딧, 카드 등록 없이 시작합니다. 플러그인을 설치하고, 원하는 기능을 설명한 뒤, Studio에 만들어진 결과를 확인하세요.