教學 · 遊戲系統

如何在 Roblox Studio 製作劍

Roblox 的劍是一個 Tool,有三項工作分給兩個 Script:玩家的裝置偵測點擊並播放揮劍動作,伺服器決定誰被打中、失去多少生命值。這篇教學把兩個 Script 都做出來,加上玩家無法偽造的冷卻時間與判定範圍,並說明動畫要放在哪裡。

更新日期 2026年11月20日閱讀約 5 分鐘作者

重點摘要

在 StarterPack 中放一個名為 Sword 的 Tool,裡面有一個名為 Handle 的零件。Tool 中的 LocalScript 監聽 Tool.Activated,播放揮劍動畫,並在不帶引數的情況下觸發 RemoteEvent。ServerScriptService 中的 Script 檢查冷卻時間,以及玩家是否活著並拿著劍,用 workspace:GetPartBoundsInBox 找出他前方方框中的 Humanoid,並對每個目標呼叫一次 Humanoid:TakeDamage。

  • 不要在劍刃的 Touched 事件中造成傷害:玩家的裝置控制自己的角色,可以從任何地方觸發 Touched,Roblox 關於 network ownership 的頁面舉的例子正是劍。
  • 用戶端既不傳送目標也不傳送傷害。冷卻時間、判定範圍與傷害數值都由伺服器掌握。
  • 目標身上有 ForceField 時 TakeDamage 不會有作用,例如在 SpawnLocation 生成後的前 10 秒。
  • 攻擊穿過牆壁,或在揮劍動作看起來還沒碰到目標前就命中?請使用有揮劍前搖與牆壁檢查的伺服器 Script 版本。
本頁內容
  1. 組成方式
  2. 1. 製作 Tool
  3. 2. 伺服器 Script
  4. 3. LocalScript
  5. 判定範圍
  6. 判定範圍類型
  7. 前搖與牆壁檢查
  8. 揮劍動畫
  9. 舊的教學
  10. 防護的極限
  11. 4. 測試
  12. 擴充
  13. Common errors
  14. 用 RoCode
  15. 常見問題
  16. 來源與延伸閱讀

能用的劍是怎麼組成的

示意畫面相隔至少 0.6 秒的揮劍每次扣 20 生命值,冷卻中的點擊沒有作用,第五下把 rig 擊倒。

能在真正遊戲中運作的劍,分成玩家的裝置與伺服器兩邊。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 裡面偵測點擊、播放揮劍動畫並觸發 remote。
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。伺服器 Script 找的就是這個名稱。照 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 是關閉的。工具中 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:加入伺服器 Script

把游標移到 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 -- 攻擊者前方的 stud 數
local HIT_WIDTH = 5
local HIT_HEIGHT = 6
local FRIENDLY_FIRE = false -- false:同一隊的玩家無法傷害彼此
-- 剛好相隔 COOLDOWN_SECONDS 送出的揮劍,經過網路延遲後抵達時
-- 可能稍微靠近一點,所以伺服器保留這個餘裕,不丟棄真正的揮劍
local NETWORK_SLACK = 0.1

-- 劍的 LocalScript 觸發的 remote。它不帶引數:誰會被打中
-- 由伺服器決定,所以用戶端沒有東西可以偽造。
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. 每個冷卻時間只能揮一次,不管 remote 被觸發得多頻繁
	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 生命值開始,所以五下就能擊倒測試 rig。玩家角色預設每秒回復 MaxHealth 的 1%,所以以最快速度被攻擊的玩家會撐過第五下,需要第六下。
COOLDOWN_SECONDS0.6兩次揮劍之間的時間。在 SwordClient 中設定相同的值。
HIT_RANGE, HIT_WIDTH, HIT_HEIGHT6, 5, 6以 stud 計的判定範圍:它在玩家前方伸多遠、多寬、多高。
FRIENDLY_FIREfalse設為 false 時,同一隊的玩家無法傷害彼此。沒有隊伍的玩家永遠可以互相攻擊,NPC 則永遠可以被攻擊。
NETWORK_SLACK0.1伺服器在冷卻結束前多早仍會接受揮劍。兩次相隔 0.6 秒的點擊經過網路延遲後抵達時可能稍微靠近一點,少了這個餘裕,伺服器會丟棄玩家已經看到的真正揮劍。

步驟 3:在 Tool 中加入 LocalScript

在 Tool Sword 中插入一個 LocalScript,命名為 SwordClient,並貼上這段程式碼:

LocalScript 位於 StarterPack 中的 Tool Sword 名稱為 SwordClient
-- 放在 Tool Sword 中、名為 SwordClient 的 LocalScript。
-- Tool.Activated 在玩家的裝置上觸發,所以這個 Script 監聽點擊、
-- 觸控或扳機,播放揮劍動畫,並請伺服器執行揮劍。

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 會在滑鼠點擊、手機觸控與手把扳機時觸發,所以同一個 Script 在任何裝置上都能用。玩家角色生成時,Roblox 會把 Tool 和裡面的 LocalScript 複製到每位玩家的 Backpack,所以每位玩家執行的是自己那一份。

LocalScript 保留自己的冷卻時間,只是為了不送出伺服器反正會忽略的請求。這不是安全檢查:作弊者可以刪除它、修改它,或從自己的程式碼觸發 SwordSwing。RemoteEvent 教學說明為什麼每個 remote 都要在伺服器上檢查,Script vs LocalScript vs ModuleScript(英文)則說明 LocalScript 能改變什麼、不能改變什麼。

伺服器如何決定誰被打中

SwordSwing 傳來時,SwordService 不會問用戶端任何事。它在伺服器看到的攻擊者角色位置前方建立一個方框,並透過 workspace:GetPartBoundsInBox 詢問引擎有哪些零件在裡面。這個方法取代了 Roblox 標為已淘汰的舊版 FindPartsInRegion3。

方框的中心在攻擊者根零件前方 3 stud。這就是 CFrame.new(0, 0, -HIT_RANGE / 2) 這個偏移:CFrame 面向自己的負 Z 軸,也就是它的 LookVector。所以方框從角色中心向前延伸 6 stud,寬 5 stud、高 6 stud。查詢比較的是每個零件的邊界框(bounding box),這是用盒子形狀快速近似零件體積的方式,所以圓形零件和網格會被算得比看起來大一點。對劍來說,這一點餘裕是有幫助的。

SwordService 如何處理方框中的零件
步驟程式碼原因
略過攻擊者使用 Exclude 並帶入攻擊者角色的 OverlapParams攻擊者自己的手、腳和劍也在方框裡。
找出角色part:FindFirstAncestorOfClass("Model")方框中的零件可能是肢體、帽子或手上的工具。FindFirstAncestorOfClass 比對的是精確的類別名稱,所以會跳過帽子(Accessory 類別)和手上的工具(Tool 類別,雖然 Tool 是 Model 的一種),停在角色模型上。
找出 Humanoidmodel:FindFirstChildOfClass("Humanoid")任何有 Humanoid 的東西都能被攻擊:玩家、NPC 與測試假人。牆壁和地板會被略過。
每個 Humanoid 一次alreadyHit 表方框中通常會有同一個角色的好幾個零件。少了這張表,每一個零件都會再造成一次傷害。
只攻擊活著的目標target.Health > 0已經被擊倒的角色不會再被攻擊。
隊伍isTeammateFRIENDLY_FIRE 為 false 時,同一隊的玩家會被略過。Neutral 屬性為 true 的玩家沒有隊伍。
傷害target:TakeDamage(DAMAGE)降低 Health,除非目標受到 ForceField 保護。

alreadyHit 表在每次揮劍時都會重新建立,所以冷卻過後,下一次揮劍可以再次打中同一位玩家。這就是「每次揮劍每個目標一次」的規則,也是用 Touched 做的劍一直很難做到的事。

Script 使用 TakeDamage,而不是直接設定 Health。Roblox 參考文件說,Humanoid 受到 ForceField 保護時 TakeDamage 不會影響它,而直接設定 Health 會無視 ForceField。在 SpawnLocation 生成的玩家預設會得到 10 秒的 ForceField(SpawnLocation 的 Duration),所以剛進來的玩家在出現的那一刻無法被攻擊。

劍的四種判定範圍做法:比較

劍的教學主要差在一件事:要怎麼知道劍刃打中了什麼。常見的答案有四種。它們的差別在於跟著劍刃有多準確、讓伺服器做多少工作,以及作弊者能不能偽造結果。

劍的判定範圍做法。「由誰決定」是指結果被採計的那一方
做法運作方式由誰決定準確度最適合
劍刃上的 Touched劍刃零件碰到角色時就造成傷害攻擊者的裝置,它擁有自己的角色和劍跟著劍刃,但一次碰觸會觸發好幾次有其他玩家的遊戲都不適合:攻擊者的裝置可以從任何地方觸發它
玩家前方的方框(本教學)每次揮劍在伺服器上做一次 GetPartBoundsInBox 查詢伺服器固定的方框,而不是劍刃的路徑。網格以邊界框計算,所以稍微寬鬆大多數遊戲:簡單、成本低,而且沒有東西可以偽造
判定零件上的 GetPartsInPart揮劍期間用劍刃弧形的零件做伺服器查詢伺服器精確的形狀:Roblox 文件說它會做完整的幾何檢查,並建議在不需要那麼精確時改用方框或球形查詢,因為比較便宜形狀特殊的大型武器,例如鐮刀的弧形
沿著劍刃的 raycast揮劍的每一幀,都從劍刃上的點向它們上一幀的位置發射短射線發射射線的那一方。在伺服器上需要伺服器自己知道劍刃在哪裡緊密跟著動畫揮劍路徑很重要的遊戲。社群的判定範圍模組就是這樣運作的

方框是正確的第一選擇。每次揮劍只要一次查詢,永遠不依賴作弊者可能修改的動畫,而且只用三個數字就能輕鬆調整。當玩家抱怨攻擊範圍和方框差很多的武器命中感覺不對時,再改用特定形狀的零件或沿著劍刃的射線,並保持同樣的規則:由伺服器執行查詢並造成傷害。

劍的預設值:從匕首到雙手劍

同一個 SwordService 只靠五項設定就能做出很不一樣的武器。這張表是起點,以 Rig Generator 產生、有 100 Health 的假人計算。「擊倒所需時間」從第一次命中開始算,假設每次揮劍都在冷卻允許時立刻命中。

常見近戰武器的 SwordService 設定,附上擊倒 100 Health 假人所需的命中次數與時間。為計算值,不是實測值
武器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 傷害時,以最快速度被攻擊的玩家會撐過第五下,需要第六下。如果確切的命中次數很重要,請保留一點餘裕,例如用 21 傷害而不是 20。
  • NETWORK_SLACK 要跟著冷卻時間調整。教學中的 0.1 秒是 0.6 的六分之一。如果冷卻 0.35 秒的匕首還用 0.1,作弊者就能每 0.25 秒攻擊一次,快了 40%。請用大約 COOLDOWN_SECONDS 的六分之一:匕首用 0.06。
  • 讓 SwordClient 保持一致。在那裡設定相同的 COOLDOWN_SECONDS,否則用戶端會送出伺服器會忽略的揮劍。

第 2 版:揮劍前搖,而且不會穿牆攻擊

基本的劍能用之後,會出現兩種抱怨。命中發生在玩家點擊的同一瞬間,比揮劍動畫碰到目標還早,而且揮劍可能打到站在薄牆另一邊的人,因為方框不考慮牆壁。這個版本的 SwordService 兩個問題都修好了。它取代步驟 2 的 Script:同樣的名稱、同樣的 remote、同樣的設定,所以 SwordClient 不需要修改。

Script 位於 ServerScriptService 名稱為 SwordService
-- 放在 ServerScriptService 中、名為 SwordService 的 Script(有前搖與牆壁檢查的版本)。
-- 取代步驟 2 的 Script:同樣的設定與 remote,再加兩條規則。命中發生在
-- 點擊後 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,否則兩個 Script 都會各建立一個 SwordSwing remote。把 WINDUP_SECONDS 設為你的揮劍動畫中劍刃掃過角色前方的時間點;快速揮劍用 0.15 就很合適。

  • 前搖。冷卻時間以及「活著並拿著劍」的檢查在點擊傳來時執行,接著 task.delay 在 WINDUP_SECONDS 後執行 strike。strike 會再檢查一次攻擊者,因為這段時間他可能已經死了或收起了劍,之後才建立方框。在前搖期間離開攻擊範圍的目標不會被打中,這正是玩家看到揮劍時所預期的。
  • 牆壁檢查。對方框中的每個目標,hasClearLine 從攻擊者的根零件向目標的根零件發射一條射線,並略過攻擊者自己的角色。如果它碰到的第一個東西屬於目標,或什麼都沒碰到,命中就成立。中間有牆壁、門或其他玩家就會擋住它。
  • 成本多少。每次揮劍每個目標多一條射線,和方框查詢本身相比並不多。

前搖也讓劍對那些傳送到別人身邊的同一瞬間就攻擊的作弊者更公平:伺服器在稍後一刻、依它當下看到的角色位置尋找目標。傳送本身並不會因此被阻止;那需要移動檢查,說明在外掛使用者能做什麼、不能做什麼一節。

加入揮劍動畫(選用)

只要你給 SwordClient 一個 ID,它就會播放動畫。動畫只需要在 Studio 的 Animation Editor 中做一次:

  1. 插入一個用來做動畫的 rig。在 Avatar 或 Home 分頁上按 Character 打開 Rig Generator,選擇符合你遊戲虛擬人偶的 rig,例如 R15,再選 Block Avatar。
  2. 在 Avatar 分頁上按 Clip Editor 打開 Animation Editor,選取 rig,擺出右手短揮的姿勢。
  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 透過角色的 Animator 載入揮劍動畫,而不是 Roblox 標為已淘汰的舊版 Humanoid:LoadAnimation。Roblox 的 Animator 參考文件說,玩家裝置在這位玩家自己角色上播放的動畫,會複寫到伺服器和其他所有玩家,所以 LocalScript 可以播放揮劍動畫,所有人都看得到。那裡也說 Animator 必須在伺服器上建立,所以絕對不要在 LocalScript 中建立它。玩家角色的 Animator 通常在 Humanoid 裡面,Roblox 自己的動畫範例也是在那裡找它。

動畫只是為了外觀。命中與否不依賴它,所以緩慢、缺少或被修改的動畫,永遠不會改變誰被打中。

要在按鍵時、循環播放或在 NPC 上播放動畫,請閱讀動畫 Script 教學。

舊的劍教學錯在哪裡

如果你在拿本教學和影片或論壇文章比較,以下是重要的差異,以及每種做法會造成問題的原因。

劍的教學中常見的做法,以及本教學改用的做法
教學問題本教學
在劍刃的 Touched 事件中造成傷害攻擊者的裝置可以從任何地方觸發自己劍上的 Touched(Roblox 關於 network ownership 的頁面),而且一次碰觸 Touched 會連續觸發好幾次(Roblox 關於 debounce 的頁面)。伺服器用自己的方框找出目標,每次揮劍每個 Humanoid 一次。
在 LocalScript 中降低 HealthLocalScript 對別人角色做的變更,只會留在這一台裝置上。所有傷害都在 SwordService 中造成。
用 wait(0.5) 做冷卻Roblox 把全域的 wait() 標為已淘汰,改用 task.wait(),而且只存在用戶端的冷卻擋不住任何人。在伺服器上比較 os.clock() 時間。沒有任何東西在等待。
用 Humanoid:LoadAnimation 播放揮劍動畫已淘汰,改用 Animator:LoadAnimation。透過 Animator 載入揮劍動畫。
用 Region3 與 FindPartsInRegion3 尋找目標已淘汰。Roblox 建議新專案使用 GetPartBoundsInBox 搭配 OverlapParams。使用 GetPartBoundsInBox。
把伺服器 Script 放在 Tool 裡面,監聽 Activated每位玩家的劍都執行一份自己的伺服器程式碼,而這類 Script 常常在 Touched 中造成傷害(第一列)。以預設設定,Script 只會在 Workspace 或 ServerScriptService 中執行,所以 Tool 中的 Script 要等劍第一次被裝備後才會執行。Roblox 的工具頁面把大多數工具描述為負責輸入的 LocalScript、負責效果的伺服器 Script,以及兩者之間的 RemoteEvent。ServerScriptService 中的一個 SwordService 處理遊戲中所有的劍。

外掛使用者能做什麼、不能做什麼

假設作弊者控制自己裝置上的一切。他可以讀取並修改你的 LocalScript,而 Roblox 的安全指南說,他可以用任何頻率和任意引數觸發 RemoteEvent。以下是這對這把劍代表什麼。

作弊者可能嘗試什麼,以及 SwordService 怎麼處理
作弊者嘗試結果原因
用他的程式碼以最快速度觸發 SwordSwing,或使用連點器每 0.5 秒最多採計一次揮劍伺服器冷卻是 0.6 秒減去 0.1 秒的網路餘裕。這段餘裕就是作弊者最多能賺到的。
隨 remote 一起傳送目標、傷害數值或位置被忽略onSwing 只讀取 Roblox 自己帶入的玩家。隨 remote 傳來的其他東西永遠不會被讀取。
修改 SwordClient,例如拿掉它的冷卻不影響伺服器SwordService 把設定放在 ServerScriptService,這裡的東西永遠不會傳給玩家。
死掉或手上沒有劍時攻擊被忽略SwordService 會檢查他的 Humanoid 是否活著,以及名為 Sword 的 Tool 是否在他的角色裡面,裝備時 Roblox 會把工具移到那裡。
從地圖另一頭攻擊某人什麼都不會發生方框是在伺服器看到的攻擊者角色位置周圍建立的,只往前延伸 6 stud。
傳送到玩家身邊再攻擊有可能每台裝置控制自己角色的移動,Roblox 把傳送到任何位置列為用戶端可以對自己角色做的事情之一。伺服器的移動檢查可以抓到這種行為。
隔著薄牆攻擊在 6 stud 的方框範圍內有可能步驟 2 的方框查詢不會尋找牆壁。第 2 版加入了牆壁檢查。
播放任何動畫或完全不播放不影響命中命中永遠不依賴動畫。Roblox 提到,作弊者可以在自己的角色上播放任意動畫。

有兩列寫著「有可能」,這是老實的說法。這把劍不讓作弊者選擇要打誰、打多重、多常打。它無法阻止他移動自己的角色。Roblox 的安全文件說,用戶端控制自己角色的移動與物理,而移動檢查需要針對每款遊戲調整。競技類遊戲的下一層防護是伺服器移動檢查(跑步教學做了一個,會對粗糙的加速外掛與遠距離傳送發出警告),或 Roblox 的 server authority,我們在 2026 年 10 月 13 日查看時,文件把它描述為 beta。

步驟 4:測試

  1. 加入可以攻擊的東西。在 Avatar 或 Home 分頁上按 Character 打開 Rig Generator,選一個 rig(例如 R15,再選 Block Avatar),它就會插入 Workspace。把它移到離你的 SpawnLocation 幾 stud 遠的地方。
  2. 按 Play,從快捷列裝備 Sword,走到 rig 旁邊並點擊。第一次命中後它頭上會出現生命條,因為 Humanoid 預設只在 Health 低於 MaxHealth 時顯示生命條。Humanoid 從 100 生命值開始,所以第五下會擊倒它。
  3. 用你最快的速度點擊。每 0.6 秒只有一次揮劍會有作用。
  4. 離開 rig 大約 8 stud,或背對它揮劍。什麼都不會發生,因為它沒有任何零件在方框裡。
  5. 用真正的玩家測試。在測試模式下拉選單中選擇 Server & Clients,設定 2 個用戶端並按 Play。在另一位玩家生成後 10 秒內攻擊他:因為生成時的 ForceField,什麼都不會發生。之後每次命中扣 20。玩家角色預設還會每秒回復 MaxHealth 的 1%,所以在兩場戰鬥之間,他們的生命值會慢慢回來。
  6. 如果你的遊戲有 Teams,把兩位測試玩家放進同一隊。FRIENDLY_FIRE 為 false 時,他們的揮劍對彼此沒有作用。

整個過程都保持 Output 視窗開著(Window 選單,然後 Output)。這些 Script 正常運作時什麼都不會印出,所以任何來自 SwordService 或 SwordClient 的紅色錯誤都是真正的問題。請見常見錯誤。

如何把劍擴充成戰鬥系統

連擊

在伺服器上替每位玩家保存一個揮劍計數器,放在 lastSwing 旁邊。如果上一次揮劍是不久前,就加 1;否則從 1 重新開始。接著依計數器選擇傷害,例如每第三下造成更多傷害,並用同樣的方式在 PlayerRemoving 時清除計數器。用戶端可以自己計數來選擇要播放哪個動畫,因為動畫永遠不決定命中。方框和檢查都完全不變。

擊退

在 TakeDamage 之後,SwordService 可以對目標的 RootPart 使用 ApplyImpulse,沿著攻擊者的 rootPart.CFrame.LookVector 方向把目標推開。Roblox 參考文件說,推力取決於目標的質量,而伺服器 Script 可以對伺服器擁有的零件,或自動由用戶端擁有的零件呼叫它。每位玩家的裝置會模擬自己的角色,所以請透過 Server & Clients 在玩家身上測試擊退,而不只是在 rig 上。

為排行榜記錄擊殺

在 target:TakeDamage(DAMAGE) 前面,用 target:SetAttribute("LastHitBy", player.UserId) 記錄最後一個攻擊的人。在伺服器 Script 中連接每個角色 Humanoid 的 Died 事件,讀取這個屬性,用 Players:GetPlayerByUserId 找出攻擊者,並把他 leaderstats 中的 IntValue Kills 加 1。像排行榜教學的步驟 1那樣,把它建立在 Coins 與 Wins 旁邊,並像步驟 2那樣在伺服器上修改它。

格擋

加入第二個 RemoteEvent,在格擋鍵按下與放開時由用戶端觸發,並讓伺服器在這位玩家的角色上設定 Blocking 屬性,而且有自己的頻率限制。在 SwordService 中,當目標角色設定了 Blocking 時,降低或略過傷害。作弊者還是能自己選擇何時格擋,所以請讓格擋很短,或給它冷卻時間。

販售劍,或在每個回合發放

StarterPack 會在每次生成時把劍發給每位玩家。如果想改為販售,請把它放進商店 GUI 教學中的 ShopItems 資料夾。那篇教學的目錄已經在販售名為 ClassicSword 的 Tool,所以請把這個 Tool 命名為 ClassicSword 並設定相同的 SWORD_NAME,或者修改目錄中的項目。如果只想在回合期間發放,請使用回合系統教學中的 GiveRoundTool Script:把 Sword 放在 ServerStorage 而不是 StarterPack,並把那個 Script 中的 "RoundTool" 換成 "Sword"。

戰鬥用的敵人與遠程武器

會追逐玩家的 NPC,請照著NPC 尋路教學做。劍對它造成傷害的方式和其他任何 Humanoid 一樣。用同樣的伺服器規則進行遠距離攻擊的武器,請閱讀槍的教學。

常見錯誤與解法

按 Play 之前先打開 Output 視窗(Window 選單,然後 Output)。劍的大多數問題不是在那裡印出錯誤,就是因為名稱對不上。

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

SwordClient 在等 SwordService 建立的 remote,代表 SwordService 沒有在執行。確認它是 Script 而不是 LocalScript,直接放在 ServerScriptService 中,沒有被停用,而且 Output 中沒有它的錯誤。

我揮了劍,但沒有人受到傷害

依序檢查:SwordClient 是 LocalScript 而不是 Script,而且直接放在 Tool Sword 中;Tool 的名稱完全是 Sword,或和 SWORD_NAME 中寫的一樣;目標在你前方 6 stud 以內;目標生成已經超過 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 上。加入一個 WeldConstraint,Part0 設為 Handle,Part1 設為劍刃。

我的畫面上看得到傷害,但另一位玩家的生命值沒有改變

傷害是從 LocalScript 造成的,它只會改變你那份遊戲副本。請像步驟 2 那樣,只在 SwordService 中造成傷害。

用 RoCode 來做

如果不想手動組裝這一切,RoCode 可以在你開啟的場景中完成。它是獨立的程式設計 AI 代理,不是 Roblox 官方的:你在它的網頁聊天中描述功能,它的 Roblox Studio 外掛程式就會在你的 Explorer 中建立 Tool、零件與 Script,所以不需要從聊天視窗複製程式碼。

你輸入

做一把劍:StarterPack 中名為 Sword 的 Tool,有 Handle 和焊接在上面的劍刃,一個在 Activated 時觸發 RemoteEvent 的 LocalScript,以及一個檢查 0.6 秒冷卻、對玩家前方方框中所有 Humanoid 造成 20 傷害的伺服器 Script。

RoCode 會做
  • 透過 Create Instance 建立 Tool 與它的零件,並透過 Set Property 設定它們的屬性
  • 透過 Create Script 寫出 SwordService 與 SwordClient,也可以先透過 Search Scripts 尋找已經有的戰鬥 Script
  • 它被要求用 Check Script 檢查寫出的每個 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,或沿著劍刃的 raycast。四種做法的比較。

要怎麼讓劍不會穿牆攻擊?

造成傷害之前,從攻擊者的根零件向目標的根零件發射一條射線,略過攻擊者的角色,只有在射線碰到的第一個東西屬於目標時才算命中。SwordService 第 2 版會對每個目標這麼做。

為什麼命中比揮劍動畫碰到目標還早?

伺服器在點擊傳來的同一瞬間就檢查判定範圍。請先等待一段短暫的前搖,例如用 task.delay 等 0.15 秒,接著確認攻擊者仍然活著並拿著劍,再建立方框,就像第 2 版那樣。

外掛使用者還是能用這把劍作弊嗎?

他們無法選擇誰被打中、一次命中造成多少傷害,以及多常攻擊,因為這三件事都由伺服器決定;他們最多能賺到冷卻上 0.1 秒的網路餘裕。他們仍然可以移動自己的角色,例如貼到某人身邊,因為每台裝置控制自己角色的移動。下一層防護是伺服器移動檢查。

要怎麼做有連擊的戰鬥系統?

在伺服器上替每位玩家保存揮劍計數器,短暫停頓後重設,並依計數器選擇傷害與動畫。命中檢查維持不變。如何擴充一節還說明了擊退、擊殺記錄與格擋。

來源與延伸閱讀

程式碼如何驗證:本頁每一段 Script 都通過 Luau 嚴格型別檢查,並使用 Roblox API 定義(luau-lsp,2026年11月20日)。型別檢查能找出拼錯的 API 與錯誤的型別,但無法檢查遊戲邏輯,所以發布前請先在 Studio 中測試。

在你自己的遊戲裡試試 RoCode。

每天都有免費點數,不需要信用卡。安裝外掛程式,描述你要的功能,再看看 Studio 裡出現了什麼。