要点
StarterPack に、Sword という名前で Handle という名前のパーツを持つ Tool を置きます。Tool の中の LocalScript が Tool.Activated を受け取り、振るアニメーションを再生して、引数なしで RemoteEvent を呼びます。ServerScriptService の Script がクールダウンと、プレイヤーが生きていて剣を持っていることを確認し、workspace:GetPartBoundsInBox で正面のボックス内の Humanoid を見つけて、ターゲットごとに1回 Humanoid:TakeDamage を呼びます。
- 刃の
Touchedイベントでダメージを与えないでください。プレイヤーの端末は自分のキャラクターを制御していてどこからでも Touched を発火できます。Roblox の network ownership のページでも、まさに剣が例として挙げられています。 - クライアントはターゲットもダメージも送りません。クールダウン、ヒットボックス、ダメージ量はサーバーが管理します。
- ターゲットに ForceField がある間、たとえば SpawnLocation でスポーンしてから最初の10秒間は、
TakeDamageは何もしません。 - 攻撃が壁を貫通する、または振りが見た目で届く前に当たる? 振りかぶりと壁のチェック付きのサーバースクリプトを使ってください。
このページの内容
動く剣の仕組み
実際のゲームで動く剣は、プレイヤーの端末とサーバーに分かれています。Roblox のツールのページには、ツールの入力は LocalScript に置くべきだとあります。入力がいつ起きたかを知っているのはプレイヤーの端末だけだからです。また、ほとんどのツールには LocalScript、サーバーの Script、その間の RemoteEvent が必要だともあります。このガイドはまさにその分け方を使います。1回の振りは次のように進みます。
- プレイヤーが Sword を装備した状態でクリック、タップ、またはゲームパッドのトリガーを押します。LocalScript で
Tool.Activatedが発火します。 - LocalScript は、アニメーションがあれば振るアニメーションを再生し、RemoteEvent
SwordSwingを呼びます。それ以外は何も送りません。 - サーバーの Script がクールダウンと、プレイヤーが生きていて Sword を手に持っていることをチェックします。
- サーバーがプレイヤーのキャラクターの正面に自分のヒットボックスを作り、その中のすべての Humanoid を見つけます。
- それらの Humanoid はそれぞれ1回、
TakeDamageで体力を失います。
| 要素 | 場所 | 役割 |
|---|---|---|
Tool Sword | StarterPack | プレイヤーが持つものです。Roblox は、キャラクターがスポーンするたびに StarterPack の中身をすべてプレイヤーの Backpack にコピーします。 |
Part Handle | Tool の中 | キャラクターが握るパーツです。刃はこれに溶接されています。 |
LocalScript SwordClient | Tool の中 | クリックを受け取り、振るアニメーションを再生し、リモートを呼びます。 |
RemoteEvent SwordSwing | ReplicatedStorage(SwordService が作成) | 「振った」という合図を引数なしでプレイヤーの端末からサーバーへ運びます。 |
Script SwordService | ServerScriptService | 振りを毎回チェックし、プレイヤーの正面に誰がいるかを見つけて、ダメージを与えます。攻撃が起こりうる唯一の場所です。 |
ServerScriptService
SwordService Script new
StarterPack
Sword Tool new
Handle Part new
Blade Part new
WeldConstraint WeldConstraint new
SwordClient LocalScript new
ステップ1: 剣の Tool を組み立てる
- Explorer で Workspace にカーソルを合わせ、+ ボタンを押して Tool を挿入します。名前を
Swordに変えます。サーバーのスクリプトはまさにこの名前を探します。Roblox のツールのページがすすめるとおり、剣は Workspace で組み立てます。そこならパーツが見え、動かしたりサイズを変えたりできるからです。最後のステップで StarterPack に移します。 - Tool に Part を挿入し、名前を
Handleにします。キャラクターが剣を握る柄です。Tool の直接の子で、その名前を持つ唯一のパーツでなければなりません。Handle が2つあると Roblox はどちらかをランダムに選び、キャラクターが刃のほうを握ってしまうことがあります。 - Tool に2つ目の Part を挿入して名前を
Bladeにし、形を整えて Handle の上から突き出るように置きます。 - Blade に WeldConstraint を挿入します。Properties ウィンドウでその
Part0を Handle に、Part1を Blade にして、プレイヤーが持っている間も剣がばらばらにならないようにします。 - 両方のパーツを選択し、Anchored がオフになっていることを確認します。ツールの中に Anchored のパーツがあると、装備したキャラクターがその場に固定されてしまいます。振ったときに刃がプレイヤーや壁にぶつからないよう、両方の CanCollide もオフにします。
- Tool を選択し、CanBeDropped のチェックを外します。チェックが入っていると、Backspace を押したときに剣が Workspace に捨てられます。
- 完成した Sword を Workspace から StarterPack にドラッグします。Workspace に置いたままの Tool は1人のプレイヤーが拾う落とし物であり、最初から全員の Backpack に入っている剣にはなりません。
1つの MeshPart でできた剣でもかまいません。その MeshPart の名前を Handle にして、Weld は飛ばしてください。テストでキャラクターが剣をおかしな角度で持っている場合は、Tool を選択して、Properties ウィンドウで握りのプロパティ(GripPos、GripForward、GripRight、GripUp)を調整します。
ステップ2: サーバースクリプトを追加する
ServerScriptService にカーソルを合わせ、SwordService という名前の Script を挿入して、下のコードを貼り付けます。剣の攻撃が起こりうる唯一の場所です。先頭の設定は、あなたが変えてよい行です。
-- ServerScriptService の Script、名前は SwordService。
-- 剣の攻撃が起こりうる唯一の場所: 振りをチェックし、攻撃者の正面のターゲットを
-- 自分のヒットボックスで見つけて、ダメージを与える。
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. リモートがどれだけ頻繁に呼ばれても、クールダウンごとに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 は、中にパーツがいくつあっても1回だけダメージを受ける
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 がそちらを見つけてしまう可能性があり、サーバーでは誰もそれを受け取っていません。
| 設定 | ここでの値 | 変わるもの |
|---|---|---|
SWORD_NAME | "Sword" | サーバーがプレイヤーの手にあると想定する Tool の名前です。Tool の名前が違う場合は変えてください。 |
DAMAGE | 20 | 1回の攻撃で減る体力です。Humanoid の体力は 100 から始まるので、5回の攻撃でテスト用リグが倒れます。プレイヤーのキャラクターは初期設定で毎秒 MaxHealth の 1% を回復するので、最大の速さで攻撃されたプレイヤーは5回目の攻撃を耐え、6回目が必要になります。 |
COOLDOWN_SECONDS | 0.6 | 振りと振りの間の時間です。SwordClient にも同じ値を設定してください。 |
HIT_RANGE、HIT_WIDTH、HIT_HEIGHT | 6, 5, 6 | スタッド単位のヒットボックスです。プレイヤーの正面にどこまで届くか、幅と高さはどれだけか。 |
FRIENDLY_FIRE | false | false なら同じチームのプレイヤーは互いに傷つけられません。チームのないプレイヤーは常に互いに攻撃でき、NPC はいつでも攻撃できます。 |
NETWORK_SLACK | 0.1 | クールダウンよりどれだけ早くても、サーバーが振りを受け付けるかです。0.6 秒間隔の2回のクリックは、ネットワークの遅延のあとで少し間隔が詰まって届くことがあり、この余裕がないと、プレイヤーがもう見ている本当の振りをサーバーが捨ててしまいます。 |
ステップ3: Tool に LocalScript を追加する
Tool の Sword に LocalScript を挿入し、名前を SwordClient にして、このコードを貼り付けます。
-- Tool の Sword の中の LocalScript、名前は SwordClient。
-- 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
-- アニメーションはキャラクターごとに1回読み込む。自分の端末から自分の
-- キャラクターで再生したアニメーションは、すべてのプレイヤーに表示される。
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 のガイドで、LocalScript が何を変えられて何を変えられないかは Script vs LocalScript vs ModuleScript(英語)で説明しています。
サーバーが誰に当たったかを決める方法
SwordSwing が届いても、SwordService はクライアントに何も尋ねません。サーバーから見える位置で攻撃者のキャラクターの正面にボックスを作り、workspace:GetPartBoundsInBox で中にどのパーツがあるかをエンジンに問い合わせます。このメソッドは、Roblox が非推奨としている古い FindPartsInRegion3 に代わるものです。
ボックスの中心は、攻撃者のルートパーツの 3 スタッド正面にあります。これが CFrame.new(0, 0, -HIT_RANGE / 2) のオフセットです。CFrame は自分の負の Z 軸の方向を向いていて、それが LookVector です。そのため、ボックスはキャラクターの中心から 6 スタッド前方まで伸び、幅は 5 スタッド、高さは 6 スタッドです。この問い合わせは各パーツのバウンディングボックス(bounding box)、つまり体積を箱の形で手早く近似したものを比べるので、丸いパーツやメッシュは見た目より少し大きく扱われます。剣にとってはこの小さな余裕が役に立ちます。
| ステップ | コード | 理由 |
|---|---|---|
| 攻撃者を除外 | Exclude と攻撃者のキャラクターを指定した OverlapParams | 攻撃者自身の腕、脚、剣もボックスの中にあります。 |
| キャラクターを見つける | part:FindFirstAncestorOfClass("Model") | ボックス内のパーツは手足、帽子、手に持ったツールかもしれません。FindFirstAncestorOfClass はクラス名が完全に一致するかを比べるので、帽子(Accessory クラス)や手に持ったツール(Tool クラス。Tool は Model の一種ですが)を通り過ぎて、キャラクターのモデルで止まります。 |
| Humanoid を見つける | model:FindFirstChildOfClass("Humanoid") | Humanoid を持つものなら、プレイヤー、NPC、テスト用のダミーなど何でも攻撃できます。壁や床は飛ばされます。 |
| Humanoid ごとに1回 | alreadyHit テーブル | ボックスにはたいてい同じキャラクターのパーツが複数入ります。テーブルがないと、それぞれがあらためてダメージを与えてしまいます。 |
| 生きているターゲットだけ | target.Health > 0 | すでに倒れたキャラクターは再び攻撃されません。 |
| チーム | isTeammate | FRIENDLY_FIRE が false なら、同じチームのプレイヤーは飛ばされます。Neutral プロパティが true のプレイヤーにはチームがありません。 |
| ダメージ | target:TakeDamage(DAMAGE) | ForceField に守られていなければ Health を減らします。 |
alreadyHit テーブルは振るたびに新しく作られるので、クールダウンが過ぎれば、次の振りで同じプレイヤーをもう一度攻撃できます。これが「1回の振りでターゲットごとに1回」というルールで、Touched を使う剣はこれでいつも苦労しています。
このスクリプトは Health への代入ではなく TakeDamage を使っています。Roblox のリファレンスには、TakeDamage は ForceField に守られている間は Humanoid に触れず、Health への直接の代入は ForceField を無視するとあります。SpawnLocation でスポーンしたプレイヤーは初期設定で10秒間の ForceField を受け取る(SpawnLocation の Duration)ので、出現した瞬間の新しいプレイヤーは攻撃できません。
剣のヒットボックスを作る4つの方法: 比較
剣のチュートリアルが分かれるのは主に1点、刃が何に当たったかをどう知るかです。よくある答えは4つあります。刃をどれだけ正確に追うか、サーバーにどれだけ負荷がかかるか、チーターが結果を偽装できるかが違います。
| 方法 | 仕組み | 誰が決めるか | 精度 | 向いている用途 |
|---|---|---|---|---|
刃の Touched | 刃のパーツがキャラクターに触れるたびにダメージ | 自分のキャラクターと剣を所有する攻撃者の端末 | 刃を追うが、1回の接触で何度も発火する | ほかのプレイヤーがいるゲームでは何にも向かない: 攻撃者の端末がどこからでも発火させられる |
| プレイヤーの正面のボックス(このガイド) | 1回の振りにつきサーバーで GetPartBoundsInBox を1回問い合わせ | サーバー | 刃の軌道ではなく固定のボックス。メッシュはバウンディングボックスで扱われるので少し甘め | ほとんどのゲーム: シンプル、軽い、偽装するものがない |
ヒットボックス用パーツでの GetPartsInPart | 振っている間、刃の弧の形をしたパーツでサーバーが問い合わせ | サーバー | 正確な形: Roblox のドキュメントには完全な幾何チェックをするとあり、精度が低くてよいならより軽いボックスや球の問い合わせがすすめられている | 鎌の弧のような、変わった形の大きな武器 |
| 刃に沿ったレイキャスト | 振りの各フレームで、刃の上の点から前のフレームの位置へ短い光線を飛ばす | 光線を飛ばす側。サーバーでやるには刃がどこにあるかをサーバー側で把握する必要がある | アニメーションをよく追う | 振りの正確な軌道が大事なゲーム。コミュニティのヒットボックスモジュールはこの方式 |
最初に選ぶべきはボックスです。1回の振りにつき問い合わせ1回で、チーターが変えられるアニメーションに頼ることもなく、3つの数字で簡単に調整できます。攻撃範囲がボックスとかけ離れた武器で、当たりがおかしいとプレイヤーから苦情が出たら、形を合わせたパーツや刃に沿った光線に切り替え、同じルールを守ってください。問い合わせを行い、ダメージを与えるのはサーバーです。
剣のプリセット: 短剣から両手剣まで
同じ SwordService が、5つの設定でまったく違う武器になります。この表は、Health 100 の Rig Generator のダミーを想定して計算した出発点です。「倒すまでの時間」は、クールダウンが許すかぎりすぐに毎回の振りが当たるとして、最初の攻撃から数えています。
| 武器 | DAMAGE | COOLDOWN_SECONDS | HIT_RANGE | HIT_WIDTH | 攻撃回数(時間) | 毎秒のダメージ |
|---|---|---|---|---|---|---|
| 短剣 | 12 | 0.35 | 4 | 4 | 9(2.8 秒) | 約 34 |
| 剣(このガイド) | 20 | 0.6 | 6 | 5 | 5(2.4 秒) | 約 33 |
| 両手剣 | 35 | 1.1 | 7 | 7 | 3(2.2 秒) | 約 32 |
| 槍 | 18 | 0.8 | 9 | 3 | 6(4 秒) | 約 23 |
- プレイヤーは回復し、ダミーは回復しません。プレイヤーのキャラクターは初期設定で毎秒 MaxHealth の 1% を回復します。5回の攻撃でちょうど 100 ダメージだと、最大の速さで攻撃されたプレイヤーは5回目を耐え、6回目が必要になります。攻撃回数をきっちり合わせたいなら、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: 振りかぶりと、壁を貫通しない攻撃
基本の剣が動くようになると、2つの苦情が出てきます。プレイヤーがクリックした瞬間、振るアニメーションがターゲットに届く前に攻撃が当たること、そしてボックスは壁を考慮しないので、薄い壁の向こうにいる人にも振りが届くことです。このバージョンの SwordService は両方を直します。ステップ2のスクリプトと置き換えるもので、同じ名前、同じリモート、同じ設定なので、SwordClient を変える必要はありません。
-- ServerScriptService の Script、名前は SwordService(振りかぶりと壁のチェック付きのバージョン)。
-- ステップ2のスクリプトと置き換える: 同じ設定とリモートに、ルールを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が攻撃者のルートパーツからターゲットのルートパーツへ、攻撃者自身のキャラクターを除外して光線を飛ばします。最初に当たったものがターゲットのものか、何にも当たらなければ、攻撃が成立します。間にある壁、ドア、ほかのプレイヤーはそれをさえぎります。 - コスト。1回の振りでターゲットごとに光線が1本増えるだけで、ボックスの問い合わせそのものに比べればわずかです。
振りかぶりは、誰かのところへテレポートした瞬間に攻撃するチーターに対しても剣を公平にします。サーバーは少しあとに、その時点でキャラクターが見えている位置でターゲットを探すからです。テレポートそのものはこれでは止まりません。それには、エクスプロイターにできることとできないことで説明する移動のチェックが必要です。
振るアニメーションを追加する(任意)
SwordClient は、ID を渡せばすぐにアニメーションを再生します。アニメーションは、Studio の Animation Editor で一度だけ作ります。
- アニメーション用のリグを挿入します。Avatar タブか Home タブで Character を押して Rig Generator を開き、ゲームのアバターに合ったリグ、たとえば R15、次に Block Avatar を選びます。
- Avatar タブで Clip Editor を押して Animation Editor を開き、リグを選択して、右腕で短く振るポーズを付けます。
- 優先度を Action にします。エディターの再生コントロールにある … ボタンを押し、Set Animation Priority にカーソルを合わせて Action を選びます。Action は Movement、Idle、Core より上なので、振りは歩きや立ちのアニメーションに負けず、その上に重なって再生されます。
- 同じ … メニューで Publish to Roblox を選びます。ゲームがグループのものなら、送信する前に Creator の欄でそのグループを選んでください。
- 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 は1回の接触で何度も続けて発火します(Roblox の debounce のページ)。 | サーバーが自分のボックスでターゲットを見つけ、1回の振りで Humanoid ごとに1回だけ。 |
| LocalScript で Health を減らす | LocalScript がほかの人のキャラクターに加えた変更は、その1台の端末にしか残りません。 | ダメージはすべて SwordService で与えます。 |
クールダウンに wait(0.5) を使う | Roblox はグローバルの wait() を非推奨とし、代わりに task.wait() を使います。そもそもクライアントにしかないクールダウンでは誰も止められません。 | サーバーで os.clock() の時刻を比べます。何も待ちません。 |
Humanoid:LoadAnimation で振りを再生する | 非推奨で、代わりに Animator:LoadAnimation を使います。 | Animator で振りを読み込みます。 |
Region3 と FindPartsInRegion3 でターゲットを探す | 非推奨です。Roblox は新しいプロジェクトでは OverlapParams 付きの GetPartBoundsInBox を使うようすすめています。 | GetPartBoundsInBox を使います。 |
Tool の中にサーバーの Script を入れ、Activated を受け取る | 各プレイヤーの剣がそれぞれサーバーのコードのコピーを動かし、そうしたスクリプトはよく Touched でダメージを与えます(1行目)。初期設定では Script は Workspace か ServerScriptService でしか動かないので、Tool の中の Script は剣が最初に装備されるまで動きません。Roblox のツールのページは、ほとんどのツールを入力用の LocalScript、効果用のサーバーの Script、その間の RemoteEvent として説明しています。 | ServerScriptService の1つの SwordService が、ゲーム内のすべての剣を担当します。 |
エクスプロイターにできることとできないこと
チーターは自分の端末上のすべてを操れると考えてください。LocalScript を読んで書き換えられ、Roblox のセキュリティのガイドには、RemoteEvent を好きな頻度と任意の引数で呼べるとあります。この剣にとってそれが何を意味するかは次のとおりです。
| チーターの試み | 結果 | 理由 |
|---|---|---|
コードが出せる最高の速さで SwordSwing を呼ぶ、またはオートクリッカーを使う | 採用されるのは 0.5 秒に1回の振りまで | サーバーのクールダウンは 0.6 秒からネットワークの余裕 0.1 秒を引いたものです。この余裕が、チーターが得られる最大のものです。 |
| リモートと一緒にターゲット、ダメージの数値、位置を送る | 無視される | onSwing が読むのは、Roblox 自身が渡すプレイヤーだけです。リモートと一緒に送られたほかのものは決して読まれません。 |
| SwordClient を書き換える、たとえばクールダウンを外す | サーバーには影響しない | SwordService は設定を ServerScriptService に持っていて、それはプレイヤーに送られることがありません。 |
| 死んだ状態や剣を持たずに攻撃する | 無視される | SwordService は、その Humanoid が生きていることと、装備時に Roblox がツールを移すキャラクターの中に Sword という名前の Tool があることをチェックします。 |
| マップの反対側から誰かを攻撃する | 何も起きない | ボックスはサーバーから見える位置で攻撃者のキャラクターのまわりに作られ、前方 6 スタッドまでしか届きません。 |
| プレイヤーのところへテレポートしてから攻撃する | 可能 | 各端末は自分のキャラクターの移動を制御しており、Roblox はクライアントが自分のキャラクターでできることとして、どこへでもテレポートすることを挙げています。サーバーの移動チェックで検出できます。 |
| 薄い壁越しに攻撃する | 6 スタッドのボックスの範囲内なら可能 | ステップ2のボックスの問い合わせは壁を探しません。バージョン2で壁のチェックを追加します。 |
| 好きなアニメーションを再生する、または何も再生しない | 当たりには影響しない | 当たりはアニメーションに決して左右されません。Roblox は、チーターが自分のキャラクターで任意のアニメーションを再生できると指摘しています。 |
2つの行に「可能」とありますが、これは正直な結果です。この剣は、チーターに誰を、どれだけ強く、どれだけ頻繁に攻撃するかを選ばせません。自分のキャラクターを動かすことは止められません。Roblox のセキュリティのドキュメントには、クライアントは自分のキャラクターの移動と物理を制御しており、移動のチェックはゲームごとに調整する必要があるとあります。対戦ゲームなら、次の層はサーバーの移動チェック(スプリントのガイドで作っています。あからさまなスピードハックや長距離のテレポートを警告します)か、Roblox の server authority です。server authority は、2026年10月13日に確認した時点ではドキュメントでベータとされていました。
ステップ4: テストする
- 攻撃する相手を追加します。Avatar タブか Home タブで Character を押して Rig Generator を開き、リグ(たとえば R15、次に Block Avatar)を選ぶと Workspace に挿入されます。SpawnLocation から数スタッド離してください。
- Play を押し、ホットバーから Sword を装備して、リグに近づいてクリックします。初期設定の Humanoid は Health が MaxHealth より低いときだけ体力バーを表示するので、最初の攻撃のあとでリグの上に体力バーが現れます。Humanoid の体力は 100 から始まるので、5回目の攻撃で倒れます。
- できるだけ速くクリックします。何かが起きるのは 0.6 秒に1回の振りだけです。
- リグから 8 スタッドほど離れるか、背中を向けて振ります。リグのパーツがボックスに入っていないので、何も起きません。
- 実際のプレイヤーでテストします。テストモードのドロップダウンで Server & Clients を選び、クライアントを 2 に設定して Play を押します。別のプレイヤーをスポーンから10秒以内に攻撃しても、スポーン時の ForceField のせいで何も起きません。そのあとは攻撃ごとに 20 減ります。プレイヤーのキャラクターは初期設定で毎秒 MaxHealth の 1% を回復するので、戦いの合間に体力が少しずつ戻ります。
- ゲームに Teams があるなら、テストの2人のプレイヤーを同じチームに入れます。
FRIENDLY_FIREが false なら、互いの振りは何もしません。
その間ずっと Output ウィンドウを開いておいてください(Window メニュー、次に Output)。これらのスクリプトは動いているときは何も出力しないので、SwordService や SwordClient から赤いエラーが出たら、それは本当の問題です。よくあるエラーを見てください。
剣を戦闘システムに広げる方法
コンボ
サーバーで、lastSwing の隣にプレイヤーごとの振りのカウンターを持ちます。直前の振りが最近なら 1 を足し、そうでなければ 1 からやり直します。そしてカウンターに応じてダメージを選び、たとえば3回目ごとにダメージを増やし、同じやり方で 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のようにサーバーで変更してください。
ガード
ガードのボタンが押されたときと離されたときにクライアントが呼ぶ2つ目の RemoteEvent を追加し、サーバーが独自の頻度制限付きで、そのプレイヤーのキャラクターに Blocking 属性を設定するようにします。SwordService では、ターゲットのキャラクターに Blocking が設定されていたらダメージを減らすか飛ばします。それでもいつガードするかはチーターが自分で選べるので、ガードは短くするか、クールダウンを付けてください。
剣を売る、またはラウンドごとに配る
StarterPack は、スポーンのたびに全プレイヤーに剣を渡します。代わりに売りたい場合は、ショップの GUI のガイドの ShopItems フォルダに入れてください。そのガイドのカタログはすでに ClassicSword という名前の Tool を売っているので、この Tool の名前を ClassicSword にして SWORD_NAME も同じにするか、カタログの項目を変えてください。ラウンドの間だけ配るには、ラウンドシステムのガイドの GiveRoundTool スクリプトを使います。Sword を StarterPack ではなく ServerStorage に置き、そのスクリプトの "RoundTool" を "Sword" に置き換えてください。
戦う敵と遠距離武器
プレイヤーを追いかける NPC は、NPC の Pathfinding のガイドに従って作ってください。剣はほかの Humanoid と同じように NPC にもダメージを与えます。同じサーバーのルールで離れた相手に当たる武器については、銃のガイドを読んでください。
よくあるエラーと対処法
Play を押す前に Output ウィンドウを開いてください(Window メニュー、次に Output)。剣の問題のほとんどは、そこにエラーが出るか、名前が一致しないことが原因です。
Infinite yield possible on 'ReplicatedStorage:WaitForChild("SwordSwing")'
SwordClient は SwordService が作るリモートを待っているので、SwordService が動いていません。LocalScript ではなく Script であること、ServerScriptService の直下にあること、無効になっていないこと、Output にそのエラーが出ていないことを確認してください。
振っても誰にもダメージが入らない
順番に確認してください。SwordClient が Script ではなく LocalScript で、Tool の Sword の直下にあること。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 という名前のパーツが2つ以上あり、Roblox が違うほうを選んでいます。Handle は柄の1つだけにして、残りの名前を変えてください。それでも角度がおかしければ、Tool の握りのプロパティを調整します。
剣を装備すると刃がその場に残る、または落ちる
刃が Handle に溶接されていません。Part0 が Handle、Part1 が刃の WeldConstraint を追加してください。
自分の画面ではダメージが見えるのに、相手のプレイヤーの体力が変わらない
ダメージを LocalScript から与えていて、自分のゲームのコピーしか変わっていません。ステップ2のように、ダメージは SwordService でだけ与えてください。
RoCode で作る
これを全部手で組み立てたくない場合は、RoCode が開いているプレイスに作れます。RoCode は Roblox 製ではない独立したコーディング用の AI エージェントです。ウェブチャットで機能を説明すると、Roblox Studio プラグインがあなたの Explorer に Tool、パーツ、スクリプトを作るので、チャット画面からコードをコピーする必要はありません。
剣を作って: StarterPack に Sword という名前の Tool、Handle と、それに溶接した刃、Activated で RemoteEvent を呼ぶ LocalScript、それにクールダウン 0.6 秒をチェックしてプレイヤーの正面のボックス内の全 Humanoid に 20 ダメージを与えるサーバーの Script。
- Create Instance で Tool とそのパーツを作り、Set Property でプロパティを設定します
- Create Script で SwordService と SwordClient を書き、先に Search Scripts で既存の戦闘スクリプトを探すこともあります
- 書いた各スクリプトのコンパイルを Check Script で確認するよう指示されています。Check Script はコードを実行せずに Studio でコンパイルします(型はチェックしません)
- 変更のまとまりごとに前後に取り消しポイントを置くので、Ctrl+Z で1まとまりずつ元に戻せます
RoCode は振るアニメーションを作ることもアップロードすることもできません。Animation Editor で作り、その ID を貼り付けてください。プラグイン 3.9 以降なら RoCode は短いプレイテストを実行してエラーを読め、プラグイン 3.9.11 以降ならテスト用のキャラクターを操作できますが、振るために 3D ウィンドウでクリックすることはしないので、振りは自分で確認してください。RoCode で Roblox のゲーム全体をシステムごとに作る方法のページで、武器がどこに入るかを紹介しています。RoCode が Studio に接続する仕組み。
よくある質問
1回の振りで同じプレイヤーに何度も当たるのはなぜですか?
Touched でダメージを与えているからです。Roblox の debounce のページには、Touched は1回の接触で何度も続けて発火するとあり、ターゲットのどのパーツも刃に触れる可能性があります。このガイドは1回の振りにつき1回のボックスの問い合わせでターゲットを見つけ、リストを持つので、各 Humanoid は1回の振りで1回だけ体力を失います。
剣のダメージは LocalScript と Script のどちらに書くべきですか?
サーバーの Script です。LocalScript から与えたダメージはそのプレイヤーのゲームのコピーしか変えず、プレイヤーの端末にあるものはすべてチーターが変更できます。LocalScript はクリックを受け取り、アニメーションを再生し、RemoteEvent を呼ぶだけにしてください。
剣に振るアニメーションを付けるには?
Animation Editor で作り、優先度を Action にして Roblox に公開し、その asset ID を rbxassetid:// のあとに数字を付けた形で SWING_ANIMATION_ID に書きます。SwordClient はそれをキャラクターの Animator で再生します。プレイヤーの端末がそのプレイヤー自身のキャラクターで再生したアニメーションは全員に表示されます。
剣のアニメーションが再生されないのはなぜですか?
3つ確認してください。優先度: Action は Movement、Idle、Core より上なので、Action の振りは歩きや立ちの上に重なって再生されますが、それより低い優先度だと負けることがあります。所有者: ゲームがグループのものなら、そのグループを Creator に選んでアニメーションを公開してください。ID: SWING_ANIMATION_ID は空の文字列ではなく、rbxassetid:// とアニメーションの数字を合わせた完全なテキストである必要があります。
Roblox の剣にいちばん良いヒットボックスは?
ほとんどのゲームでは、このガイドのように1回の振りにつきサーバーでボックスを1回問い合わせる方法です。GetPartBoundsInBox を1回呼ぶだけで、クライアントには偽装するものがなく、調整する数字は3つです。形を合わせたパーツでの GetPartsInPart や刃に沿ったレイキャストは、武器の攻撃範囲がボックスとかけ離れているときだけ使ってください。4つの方法の比較。
剣が壁越しに当たらないようにするには?
ダメージを与える前に、攻撃者のキャラクターを除外して、攻撃者のルートパーツからターゲットのルートパーツへ光線を飛ばし、光線が最初に当たったものがターゲットのものだった場合だけ攻撃を成立させます。SwordService のバージョン2は、これをターゲットごとに行います。
振るアニメーションがターゲットに届く前に攻撃が当たるのはなぜですか?
サーバーはクリックが届いた瞬間にヒットボックスをチェックしています。まず task.delay で 0.15 秒などの短い振りかぶりを待ち、それから攻撃者がまだ生きていて剣を持っていることを確認して、バージョン2のようにボックスを作ってください。
この剣でもエクスプロイターはチートできますか?
誰に当たるか、1回の攻撃のダメージ、攻撃の頻度は、3つともサーバーが決めるので選べません。得られるのはせいぜいクールダウンのネットワークの余裕 0.1 秒です。ただし、各端末は自分のキャラクターの移動を制御しているので、誰かのすぐそばへ移動するなど、自分のキャラクターを動かすことは今でもできます。次の層はサーバーの移動チェックです。
コンボのある戦闘システムを作るには?
サーバーでプレイヤーごとの振りのカウンターを持ち、少し間が空いたらリセットして、カウンターに応じてダメージとアニメーションを選びます。当たりのチェックは同じままです。拡張の方法の項目では、ノックバック、キル数、ガードも扱っています。
参考資料
- Roblox Creator Docs: In-game tools(英語). Workspace でのツールの組み立て、Handle、Weld、Grip、Anchored、ほとんどのツールが LocalScript、Script、RemoteEvent を使う理由
- Roblox Creator Docs: WorldRoot:GetPartBoundsInBox(英語). ボックスの問い合わせ、OverlapParams、非推奨の FindPartsInRegion3
- Roblox Creator Docs: Humanoid:TakeDamage(英語). ForceField の保護、体力バー、体力の回復
- Roblox Creator Docs: Network ownership(英語). Touched を使う剣のエクスプロイト
- Roblox Creator Docs: Security tactics and cheat mitigation(英語). クライアントを決して信用しない
- Roblox Creator Docs: Network ownership, movement validation and physics exploits(英語). クライアントが自分のキャラクターでできることと移動のチェック
- Roblox Creator Docs: Animation Editor(英語). アニメーションの優先度と公開
- Roblox Creator Docs: Animator:LoadAnimation(英語). どのアニメーションがクライアントから複製されるか
- Roblox Creator Docs: Debounce patterns(英語). Touched が1回の接触で何度も発火する理由
コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。