要点
ドアを Part または Model として作り、Anchored にチェックを入れ、pivot を蝶番側の端に移し(Model タブの Pivot)、Properties ウィンドウで Door タグを追加します。ServerScriptService の Script 1つが CollectionService でタグの付いたドアをすべて見つけ、ProximityPrompt("Open"、E キー長押し)を追加し、Triggered イベントで NumberValue を 0 から 1 へトゥイーンし、door:PivotTo(closedPivot:Lerp(openPivot, alpha)) でドアを動かします。各ドアの属性で、開き戸か引き戸か、角度、時間、自動で閉まるか、鍵を設定します。
- Model の位置は直接トゥイーンできません。Model には CFrame や Position プロパティがなく、
WorldPivotは pivot の場所を決めるだけです。NumberValue をトゥイーンし、PivotToでドアを動かしてください。Roblox はこれを、スクリプトからモデルを動かす主な方法としています。 - ドアはサーバーで開いてください。LocalScript で開いたドアは、そのプレイヤーの画面でしか動きません。
- 鍵と距離はサーバーで確認してください。Roblox のセキュリティガイドには、ProximityPrompt も RemoteEvent と同じように悪用できると書かれており、同じページに、サーバーが必ず行うべき確認の例として、ドアを開けるのに必要な鍵をプレイヤーが持っているかどうかが挙げられています。
スクリプトで動くドアの仕組み
本物のゲームで動くドアは、サーバーが動かす必要があります。LocalScript で動かすと、ドアは1人のプレイヤーの画面で開き、ほかの全員には閉じたままです。クライアントが行った変更はその端末にとどまるからです(何がレプリケートされ、何がされないかを参照)。そのためこのガイドでは、プレイヤーの端末はプロンプトを表示してキーが押されたことを伝えるだけで、それ以外はすべて1つのサーバー Script が行います。ドアを1回使う流れは次のとおりです。
- プレイヤーがドアから 8 スタッド以内に近づくと、アクション Open、オブジェクト名 Door、キーボードの E キーが表示されたプロンプトが現れます。ゲームパッドやタッチ画面では、Roblox が対応するボタンを表示します。
- プレイヤーが E を 0.2 秒長押しします。プロンプトの
Triggeredイベントが、そのプレイヤーを引数にサーバーで発火します。 - DoorService がプレイヤーを確認します。生きているか、十分に近いか、プロンプトを連打していないか、ドアが鍵を必要とする場合は鍵を持っているか。
- スクリプトが数値を 0(閉)から 1(開)へトゥイーンします。数値が変わるたびに、
PivotToでドアを閉じた位置から開いた位置までのその割合の場所へ動かします。 - 完全に開いてから4秒後、ドアは同じ方法で閉まります。動いている途中で押すと、ドアはその場所から逆向きに戻ります。
| 要素 | 場所 | 役割 |
|---|---|---|
Script DoorService | ServerScriptService | すべてのドアを見つけ、それぞれにプロンプトを追加し、毎回の使用を確認してドアを動かします。このガイドで使う唯一のスクリプトです。 |
タグ Door | ドアの各 Part または Model | どれがドアかを示します。タグは Properties ウィンドウで追加し、プレイスと一緒に保存されます。 |
属性(Style や KeyName など) | 各ドア(任意) | 1つのドアの設定です。開き戸か引き戸か、角度、速さ、自動で閉まるか、鍵。 |
ProximityPrompt DoorPrompt | ドアの中(DoorService が追加) | "Open" または "Close" を表示し、プレイヤーが E を長押しすると Triggered を発火します。 |
NumberValue DoorProgress | ドアの中(DoorService が追加) | トゥイーンが 0 と 1 の間で動かす数値です。変わるたびにドアが動きます。 |
Tool RedKey(任意) | StarterPack(テスト用) | 鍵付きドアの鍵です。名前がドアの KeyName と一致すれば、どの Tool でも使えます。 |
Workspace
FrontDoor Part new
VaultDoor Model new
Panel Part new
Knob Part new
ServerScriptService
DoorService Script new
StarterPack
RedKey Tool new
Handle Part new
ステップ1: ドアを作って蝶番の位置を決める
- Explorer で Workspace にカーソルを合わせ、+ ボタンを押して Part を挿入します。名前を
FrontDoorにし、Sizeをだいたい4, 7, 0.5(幅 4 スタッド、高さ 7、厚さ半スタッド)にして、出入口に置きます。複数のパーツでできたドアでもかまいません。それらを選択して Ctrl+G を押し、Model にまとめてください。 - ドアのすべてのパーツで Anchored にチェックを入れ、CanCollide はオンのままにします。アンカーされたパーツは重力や衝突で動くことはありませんが、スクリプトからは動かせます。DoorService が行うのはまさにそれです。
- 蝶番の位置を決めます。ドアを選択し、Model タブを開いて Pivot をオンにします。Pivot ボタンの角にある小さな矢印を押し続け、Snap にチェックを入れると、pivot が角、辺、中心の基準点に吸着します。pivot を、蝶番があるはずのドアの端へドラッグします。引き戸なら pivot は中心のままでかまいません。
- タグを追加します。ドアを選択したまま、Properties ウィンドウを Tags までスクロールし、+ を押して、大文字の D で
Doorと入力します。ドアが Model の場合は、中のパーツではなく Model 自体にタグを付けてください。 - 2つ目のドアを作ります。引き戸と鍵のセクションで使います。Workspace に Part をさらに2つ挿入します。サイズがだいたい
4, 7, 0.5のPanelと、だいたい0.5, 0.5, 0.5のKnobで、Knob は Panel のどれかの面にくっつけます。両方を選択して Ctrl+G を押し、新しい Model の名前をVaultDoorに変えます。両方のパーツをアンカーし、モデルを2つ目の出入口に置き、Model にDoorタグを付けます。このドアは引き戸にするので、pivot は中心のままでかまいません。
pivot が重要なのは、開き戸がその周りを回転するからです。中心のままにすると、ドアはお店の回転ドアのようにその場で回ってしまいます。パーツの場合、設定した pivot は PivotOffset として保存され、GetPivot はそれを考慮するので、スクリプトは選んだ点を正確に軸としてドアを回転させます。Model に PrimaryPart がある場合、モデルの pivot はそのパーツの pivot になり、DoorService もプロンプトをそこに付けます。PrimaryPart がなければ、プロンプトはモデルの中で最初に見つかったパーツに付きます。PrimaryPart を設定するなら、pivot を動かす前にしてください。Roblox の Pivot tools のページにあるとおり、PrimaryPart を設定すると、モデルの pivot はそのパーツの pivot に移ります。
ドアの設定(属性)
どのドアも、下の表の初期値で動きます。1つのドアを変えるには、そのドアを選択し、Properties ウィンドウを Attributes までスクロールして + を押し、名前を入力し、型を選んで Save を押してから値を設定します。DoorService はドアを設定するときに一度だけ属性を読むので、ゲームを止めている間に変更してください。
| 属性 | 型 | 初期値 | 役割 |
|---|---|---|---|
Style | string | Swing | Swing はドアを pivot を軸に回転させます。Slide は幅の方向に横へスライドさせます。 |
OpenAngle | number | 90 | 開き戸が何度回転するか。負の数にすると反対側に開きます。値は -179 から 179 の間にしてください。ドアは常に短い方の弧を通るので、DoorService は角度をこの範囲に制限します。 |
SlideDistance | number | ドアの幅 | 引き戸が幅の方向に何スタッド動くか。負の数にすると反対側に動きます。 |
OpenSeconds | number | 0.6 | 完全に開く、または閉じるのにかかる時間。0.05 から 10 の範囲です。 |
AutoCloseSeconds | number | 4 | 完全に開いた状態で何秒待ってから自動で閉まるか。0 にすると、誰かが閉めるまで開いたままです。 |
KeyName | string | なし | ドアを開けるためにプレイヤーが持っている必要がある Tool の名前。たとえば RedKey。誰でも開けられるドアには設定しないでください。 |
ステップ2: ドアのスクリプトを追加する
ServerScriptService にカーソルを合わせ、DoorService という名前の Script を挿入して、下のコードを貼り付けます。タグを付けたドアがいくつあっても、プレイス内のすべてのドアをこれ1つで動かします。先頭の3つの設定はすべてのドアに適用され、ステップ1の属性は1つのドアを変えます。
-- ServerScriptService の Script、名前は DoorService。
-- "Door" タグの付いた各 Part または Model を、E 長押しのプロンプトで開け閉めします。
-- ドアはサーバーが動かすので全プレイヤーに同じドアが見え、距離と鍵も
-- サーバーが確認するので、鍵付きのドアを遠くから開けることは誰にもできません。
--
-- 各ドアの任意の属性(Properties ウィンドウで設定):
-- Style string "Swing"(初期値)または "Slide"
-- OpenAngle number 開き戸が pivot を軸に何度回転するか(初期値 90、-179 から 179)
-- SlideDistance number 引き戸が幅の方向に何スタッド動くか(初期値: ドアの幅)
-- OpenSeconds number 開くのにかかる時間(初期値 0.6)
-- AutoCloseSeconds number この秒数後に再び閉める。0 なら開いたまま(初期値 4)
-- KeyName string プレイヤーが持っている必要がある Tool の名前。例 "RedKey"
local CollectionService = game:GetService("CollectionService")
local TweenService = game:GetService("TweenService")
local DOOR_TAG = "Door"
local PROMPT_DISTANCE = 8 -- スタッド
local MIN_SECONDS_BETWEEN_USES = 0.3 -- ドアごと、プロンプトの連打対策
local doorsSetUp: { [Instance]: boolean } = {}
local function attribute(door: Instance, name: string, default: any): any
local value = door:GetAttribute(name)
if value == nil or typeof(value) ~= typeof(default) then
return default
end
if typeof(value) == "number" and (value ~= value or math.abs(value) == math.huge) then
return default -- Properties ウィンドウで入力された NaN または無限大
end
return value
end
local function hasKey(player: Player, keyName: string): boolean
local backpack = player:FindFirstChildOfClass("Backpack")
local character = player.Character
local inBackpack = backpack and backpack:FindFirstChild(keyName)
local held = character and character:FindFirstChild(keyName)
return (inBackpack ~= nil and inBackpack:IsA("Tool")) or (held ~= nil and held:IsA("Tool"))
end
local function setUpDoor(door: Instance)
if doorsSetUp[door] or not (door:IsA("BasePart") or door:IsA("Model")) then
return -- すでに動いているドアか、パーツでもモデルでもない
end
local promptPart = if door:IsA("Model") then (door.PrimaryPart or door:FindFirstChildWhichIsA("BasePart", true)) else door
if not (promptPart and promptPart:IsA("BasePart")) then
warn(`DoorService: {door:GetFullName()} has no part to put the prompt on`)
return
end
doorsSetUp[door] = true
door.Destroying:Connect(function()
doorsSetUp[door] = nil
end)
-- 動いているドアのコピーは古いプロンプトと値を持ってくるので、削除する
for _, leftover in door:GetDescendants() do
if leftover.Name == "DoorPrompt" or leftover.Name == "DoorProgress" then
leftover:Destroy()
end
end
-- 閉じた位置と開いた位置は、いまドアがある場所から一度だけ計算する
local closedPivot = door:GetPivot()
local openPivot: CFrame
if attribute(door, "Style", "Swing") == "Slide" then
-- ドアの長い方の水平な辺、つまり幅に沿って動く。Model は pivot の辺に沿って、
-- Part は自身の Size で測るので、引き戸のパーツの pivot は回転させないこと
local size = if door:IsA("Model") then door:GetExtentsSize() else (door :: BasePart).Size
local alongX = size.X >= size.Z
local width = if alongX then size.X else size.Z
local direction = if alongX then Vector3.xAxis else Vector3.zAxis
openPivot = closedPivot * CFrame.new(direction * attribute(door, "SlideDistance", width))
else
-- Lerp は常に短い方の弧で回転するので、これより大きな角度だとドアが逆向きに開いてしまう
local angle = math.clamp(attribute(door, "OpenAngle", 90), -179, 179)
openPivot = closedPivot * CFrame.Angles(0, math.rad(angle), 0)
end
local openSeconds = math.clamp(attribute(door, "OpenSeconds", 0.6), 0.05, 10)
local autoClose = math.max(attribute(door, "AutoCloseSeconds", 4), 0)
local keyName = attribute(door, "KeyName", "")
-- 数値を 0(閉)から 1(開)へトゥイーンし、それに合わせてドアを動かす。
-- PivotTo は1つのパーツやモデル全体を pivot を基準に動かす。
local progress = Instance.new("NumberValue")
progress.Name = "DoorProgress"
progress.Parent = door
progress.Changed:Connect(function(alpha: number)
door:PivotTo(closedPivot:Lerp(openPivot, alpha))
end)
local prompt = Instance.new("ProximityPrompt")
prompt.Name = "DoorPrompt"
prompt.ActionText = "Open"
prompt.ObjectText = if keyName ~= "" then `Needs {keyName}` else "Door"
prompt.HoldDuration = 0.2
prompt.MaxActivationDistance = PROMPT_DISTANCE
prompt.RequiresLineOfSight = false
prompt.Parent = promptPart
local isOpen = false
local lastUse = 0
local moveCount = 0
local function move(open: boolean)
isOpen = open
moveCount += 1
door:SetAttribute("Open", open) -- ほかのスクリプトがこれを読める
prompt.ActionText = if open then "Close" else "Open"
-- 同じ値に新しいトゥイーンをかけると古いものは取り消されるので、ドアは途中で引き返せる。
-- 時間は、残りの移動量に合わせて調整する。
local target = if open then 1 else 0
local seconds = openSeconds * math.abs(target - progress.Value)
TweenService:Create(progress, TweenInfo.new(seconds, Enum.EasingStyle.Quad, Enum.EasingDirection.Out), { Value = target }):Play()
if open and autoClose > 0 then
local thisMove = moveCount
task.delay(openSeconds + autoClose, function()
if moveCount == thisMove and isOpen then
move(false)
end
end)
end
end
prompt.Triggered:Connect(function(player: Player)
local now = os.clock()
if now - lastUse < MIN_SECONDS_BETWEEN_USES then
return
end
-- Roblox のセキュリティガイドにはプロンプトもリモートと同じく悪用できるとあるので、ここで再確認する
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
local rootPart = humanoid and humanoid.RootPart
if not (humanoid and rootPart) or humanoid.Health <= 0 then
return
end
if (rootPart.Position - promptPart.Position).Magnitude > PROMPT_DISTANCE + 6 then
return -- 正当にプロンプトを使うには遠すぎる
end
if keyName ~= "" and not isOpen and not hasKey(player, keyName) then
return -- ロックされていて、このプレイヤーは鍵を持っていない
end
lastUse = now
move(not isOpen)
end)
end
-- いまタグが付いているすべてのドアと、あとからタグが付くすべてのドア(スクリプトで複製したドアも含む)
for _, door in CollectionService:GetTagged(DOOR_TAG) do
setUpDoor(door)
end
CollectionService:GetInstanceAddedSignal(DOOR_TAG):Connect(setUpDoor)
DoorService はゲーム開始時に各ドアへ DoorPrompt と DoorProgress を自動で追加するので、手で挿入するものはありません。スクリプトのコピーは1つだけにしてください。それだけでタグの付いたすべてのドアを処理します。
| スクリプトの部分 | 役割 | 理由 |
|---|---|---|
attribute() | 属性を1つ読み、属性がない、型が違う、または本当の数値でない(NaN や無限大)場合は初期値を返します。 | Properties ウィンドウで打ち間違えても、ドアが壊れるのではなく初期設定のドアになります。 |
doorsSetUp と leftover のループ | 各ドアを一度だけ設定し、ほかのドアからコピーされた DoorPrompt や DoorProgress を先に削除します。 | そうしないと、動いているドアのコピーにプロンプトが2つでき、片方は動きません。 |
closedPivot と openPivot | 設定した時点でドアがある場所から一度だけ計算します。開き戸は pivot をそれ自身の垂直軸で回転させ、引き戸はドアの長い方の辺に沿って pivot をずらします。 | 閉じた pivot から開いた pivot へ Lerp すると、ドアが回転する間 pivot はその場にとどまるので、回転の間ずっと蝶番側の端がずれません。 |
DoorProgress と PivotTo | トゥイーンが数値を変え、変わるたびにドアを closedPivot:Lerp(openPivot, alpha) に置きます。 | TweenService は NumberValue をトゥイーンでき、PivotTo はパーツやモデルを、中のすべてのパーツごと、pivot がその CFrame に来るように動かします。 |
| プロンプト | HoldDuration 0.2、MaxActivationDistance 8、RequiresLineOfSight はオフ。鍵付きのドアは "Needs RedKey" と表示します。 | 視線の確認がオンだと、何かがパーツをさえぎったときにプロンプトが隠れます。オフなら、枠やドアモデルのほかの部分がプロンプトを隠しません。 |
move() | 1 または 0 へのトゥイーンを開始し、時間はドアの残りの移動量に合わせて調整します。 | 同じ値に新しいトゥイーンをかけると古いものは取り消されるので、途中で引き返したドアはなめらかに戻り、半分の時間で済みます。 |
| 自動で閉まる | 開く時間と AutoCloseSeconds を足した分だけ待ち、moveCount が変わっていない場合だけドアを閉めます。 | その間に誰かが閉めてまた開けたドアを、古いタイマーがばたんと閉めることはありません。 |
Triggered での確認 | ドアの使用は 0.3 秒に1回まで、生きているキャラクター、プロンプトのパーツから 14 スタッド以内、そして鍵(開けるときだけ)。 | クライアントが発火できるものはすべて悪用できるので、サーバーが確認を繰り返します。14 スタッドは、プロンプトの 8 スタッドに、E を長押ししている間に動いたプレイヤーのための余裕 6 を足したものです。 |
Open 属性 | 動くたびにドアに設定します。 | サーバーで設定した属性は全プレイヤーにレプリケートされるので、LocalScript を含むほかのスクリプトが GetAttributeChangedSignal("Open") で監視できます。 |
すべてのドアにタグを付けて1つのスクリプトで動かすのは、Roblox 自身がすすめる方法です。CollectionService のリファレンスには、同じスクリプトを多くのオブジェクトに追加しているなら、CollectionService を使うスクリプトの方がよい場合があると書かれています。GetTagged はスクリプト開始時に存在するドアを返し、GetInstanceAddedSignal はあとからタグが付いたり追加されたりしたドアを受け取ります。このようなプレイスの整理方法は、クライアントとサーバーのスクリプトのガイドで解説しています。
引き戸の作り方
VaultDoor を選択し、Style という名前の string 型の属性を追加して、値を Slide にします。これでドアは回転せず、横にスライドします。動く距離はドア自身の幅か、設定していれば SlideDistance スタッドです。反対側に動かすには負の距離を設定します。たとえば幅 4 スタッドのドアなら -4 です。FrontDoor を含むほかのどのドアも、この属性を付ければ同じように引き戸になります。
DoorService はドアの2つの水平方向のサイズ、幅と厚さを測り、大きい方に沿って動かします。Model は GetExtentsSize で測ります。そのボックスはモデルの pivot の向きに従うので、グループ化したあとに 90 度回転させたドアでも、厚さではなく幅に沿って動きます。Part はパーツ自身の Size で測るので、引き戸のパーツの pivot は回転させないでください。pivot を移動するのはかまいません。
- 両開きのドア: タグを付けた2枚を並べ、どちらも
Styleを Slide にし、片方のSlideDistanceを負にすると、中央から左右に分かれて開きます。両開きの開き戸なら、各扉の pivot を外側の端に置き、片方の扉に負のOpenAngleを設定します。各扉にはそれぞれプロンプトがあり、別々に開きます。扉どうしがぶつかる方向に動く場合は、マイナスをもう片方の扉に移してください。 - 上に上がるゲート: このスクリプトはドアを幅の方向にしか動かしません。ドアを上に上げるには、スクリプトの
directionをVector3.yAxisにし(するとすべての引き戸が上に動きます)、各ドアのSlideDistanceをその高さにしてください。 - 物理演算のドア: 動くオブジェクトについての Roblox のチュートリアルでは、PrismaticConstraint でパーツを1つの軸に沿って動かします。蝶番のドアと同じく物理演算なので、自分で書かない限りプロンプトもロックもありません。
ドアに鍵をかける方法
鍵付きのドアは、正しい名前の Tool を持っているプレイヤーにだけ開きます。鍵を作ってから、その名前をドアに教えます。
- StarterPack にカーソルを合わせ、+ を押して、
RedKeyという名前の Tool を挿入します。その中にHandleという名前の Part を1つ入れます。これはキャラクターが手に持つパーツで、アンカーされていないことを確認してください。ツールの中のアンカーされたパーツは、キャラクターをその場に固定してしまいます。プレイヤーにほかの人のために鍵を落とさせたくない場合は、Tool のCanBeDroppedのチェックを外してください。チェックが入っている間は、Backspace で装備中のツールが Workspace に落ちます。 - VaultDoor を選択し、
KeyNameという名前の string 型の属性を追加して、値をRedKeyにします。これでプロンプトのオブジェクト名に Needs RedKey と表示されます。
DoorService は鍵を2か所で探します。Tool は装備されるまでプレイヤーの Backpack にあり、装備するとキャラクターの中に移るので、鍵がホットバーにあっても手に持っていてもドアは開きます。確認をサーバーで行うのは、Roblox のセキュリティガイドが、まさにこのケース(ドアの鍵をプレイヤーが持っているか)を、サーバーが必ず確認すべき権限として挙げているからです。鍵が必要なのは開けるときだけです。開いているドアは誰でも閉められ、AutoCloseSeconds 後には自動で閉まります。
StarterPack はスポーンのたびに全員に鍵を渡すので、テストにはちょうどよいです。本物のゲームでは別の方法で渡してください。
- ショップから: ショップ GUI のガイドでは、ServerStorage の Tool を購入者の Backpack と StarterGear に渡します。
- キャラクターから: NPC 会話のガイドでは、プレイヤーが
GiveItemアクションの選択肢を選ぶと、ServerStorage.DialogueItemsの Tool を渡します。このフォルダに RedKey という名前の Tool を入れ、DialogueData の選択肢にaction = "GiveItem"とitem = "RedKey"を設定すれば、会話の中で鍵が渡されます。 - インベントリのアイテムとして: インベントリシステムでは、プレイヤーが装備した時点で鍵のアイテムが使えるようになります。装備すると、その Tool のコピーが Backpack と手に入るからです。
Backpack の鍵はキャラクターが死ぬとなくなります。Roblox はスポーンのたびに StarterPack と StarterGear から Backpack を詰め直すからです。残したい場合は、ショップのガイドと同じように、プレイヤーの StarterGear にもコピーを入れてください。逆に鍵を使い切りにしたい場合は、Triggered ハンドラーの中で、鍵の確認が成功した直後に、プレイヤーの Backpack またはキャラクターから鍵の Tool を見つけて破棄してください。
古いドアのチュートリアルの間違い
このガイドを動画やフォーラムの投稿と比べているなら、「ドアが動かない」という話題のほとんどの原因になっているやり方と、このガイドがその代わりに行うことを以下にまとめます。
| チュートリアル | 問題 | このガイド |
|---|---|---|
ドアの Model の CFrame をトゥイーンする | Model のリファレンスには CFrame や Position プロパティがありません。WorldPivot はモデルの pivot の場所を決めるだけなので、それをトゥイーンしても pivot の点が動くだけで、パーツはその場に残ります。 | NumberValue をトゥイーンし、PivotTo でモデル全体を動かします。 |
SetPrimaryPartCFrame でモデルを動かす | 非推奨です。Roblox は新しいプロジェクトでは PivotTo を使うようすすめています。 | Roblox が、スクリプトから Model を動かす主な関数としている PivotTo を使います。 |
| すべてのパーツを1つの蝶番パーツに溶接し、蝶番だけをトゥイーンする | すべての Weld がそろっていれば動きますが、溶接されていないパーツは蝶番が動いても取り残されます。 | Weld なしで、すべてのパーツをアンカーしたままにします。PivotTo がドアとその中のすべてを動かします。 |
| 同じスクリプトを各ドアにコピーする | 修正のたびに、すべてのコピーで同じことを繰り返す必要があります。Roblox は、オブジェクトにタグを付けて CollectionService で1つのスクリプトから処理することをすすめています。 | DoorService 1つと Door タグ。 |
| LocalScript でドアを開ける | ドアはそのプレイヤーの画面でしか開かず、ほかの全員には閉じたままに見えます。 | ドアはサーバーが動かすので、全プレイヤーに同じドアが見えます。 |
Touched でドアを開ける | Touched は1回触れただけで何度も続けて発火します(Roblox のデバウンスのページ)。また、プレイヤーの端末は自分のキャラクターについて Touched がいつ発火するかを操作できます(Roblox のセキュリティのドキュメント)。 | サーバーが確認するプロンプト。 |
wait() のループでドアを少しずつ動かす | Roblox は wait() を task.wait() に置き換えられたものとしており、ループでは誰かがもう一度押したときに途中で引き返せません。 | 1回の動きに1つのトゥイーン。同じ値に新しいトゥイーンをかけると古いものは取り消されるので、ドアはいる場所から引き返します。 |
| LocalScript で鍵を確認する、またはまったく確認しない | チーターは自分の端末のすべてを操作できるので、クライアントでの確認では誰も止められません。 | サーバーがプレイヤーの Backpack とキャラクターの中で Tool を探します。 |
| プロンプトにクールダウンがない | Roblox のセキュリティガイドには、プロンプトもリモートと同じく悪用されやすいとあり、何度も繰り返し発火させるのを止めるものがありません。 | ドアの使用は 0.3 秒に1回まで。 |
チーターにできること、できないこと
チーターは自分のキャラクターを含め、自分の端末のすべてを操作できると考えてください。これらのドアにとって、それが何を意味するかは次のとおりです。
| チーターが試すこと | 結果 | 理由 |
|---|---|---|
| マップの反対側からプロンプトを発火する | キャラクターがドアのそばにいなければ無視されます | DoorService はキャラクターのルートパーツからプロンプトのパーツまでの距離を測り、14 スタッドより遠いものは無視します。チーターはまずキャラクターをドアのそばへテレポートさせることができる(最後の行を参照)ので、距離の確認は遠くからの使用を防ぐものであり、テレポートを防ぐものではありません。 |
| 1秒に何度も発火する | ドアの使用は 0.3 秒に1回まで | サーバーが各ドアの最後の使用時刻を記録しています。 |
| 鍵なしで鍵付きのドアを開ける | 拒否されます | サーバーは、チーターの画面ではなく、サーバー自身が見ている Backpack とキャラクターの中で Tool を探します。 |
| キャラクターが死んでいる間にドアを使う | 無視されます | DoorService は、体力が 0 より大きい Humanoid とルートパーツがあることを確認します。 |
| それでも閉じたドアをすり抜ける | 可能です | Roblox のセキュリティのドキュメントは、クライアントが自分のキャラクターでできることとして、物理的な障害物を回避することや自分の衝突判定を変えることを挙げています。 |
| ドアの向こうへテレポートする | 可能です | 同じドキュメントに、自分のキャラクターを任意の場所へテレポートさせることも書かれています。 |
ステップ3: テストする
- Play(F5)を押します。FrontDoor に近づくと、8 スタッド以内でアクション Open、オブジェクト名 Door のプロンプトが現れます。E を長押しします。0.2 秒後、ドアは蝶番側の端を軸に 0.6 秒で 90 度開き、プロンプトの表示が Close になります。
- ドアを通り抜けて待ちます。完全に開いてから4秒後、ドアは自動で閉まります。閉まっている途中で E を長押しすると、ドアはその場所から引き返して開きます。
- ロックをテストします。RedKey が StarterPack にある場合は、いったん ServerStorage に移し、Play を押して VaultDoor のそばで E を長押しします。プロンプトには Needs RedKey と表示され、何も動きません。ゲームを止め、RedKey を StarterPack に戻してもう一度実行します。鍵がホットバーにあっても手に持っていても、VaultDoor は開きます。
- 引き戸をテストします。
Styleが Slide の Model である VaultDoor は、開くと幅の分だけ横に動きます。ゲームを止め、VaultDoor を選択して Rotate ツールで 90 度回転させ、もう一度実行します。それでも厚さではなく幅に沿って動くはずです。終わったら元に戻してください。 - テストモードのドロップダウンで Server & Clients を選び、クライアントを 2 にして Play を押します。片方のクライアントのウィンドウでドアを開けると、もう片方のウィンドウでも開いていて、両方で閉まります。
- ゲームを止め、ドアを選択して Ctrl+D で複製し、コピーを別の出入口へ移します。コピーの Tags に Door が残っていることを確認して Play を押します。追加のスクリプトなしでコピーも動きます。
Output ウィンドウを開いたままにしてください(Window メニューの Output)。すべて正しく動いていれば、DoorService は何も出力しません。ドアが "has no part to put the prompt on" という警告は、タグの付いた Model の中にパーツがないという意味です。それ以外は よくあるエラー を見てください。
拡張する
自動ドア
誰かが近づいたらドアが開くようにするには、プロンプトを待たずに setUpDoor の中から move(true) を呼びます。setUpDoor の最後で task.spawn を使ってループを開始してください。普通のループをそこに置くと終わらないので、DoorService が最初のドアから先に進めません。ループはドアがゲームにある間だけ動かします: task.spawn(function() while door.Parent do ... task.wait(0.5) end end)。ループの中では workspace:GetPartBoundsInBox で出入口の周りのボックスにキャラクターがいるかを確認し、いてドアが閉じていれば move(true) を呼びます。そのあとは、これまでどおり自動で閉まる仕組みが閉めます。ドアを自動でだけ開けたい場合は、プロンプトの Enabled を false にしてください。
VIP ドア
ゲームパスのガイドでは、すでに衝突グループを使って、パスの所有者がそのまま通り抜けられる VIP ドアを作っています。E で開く VIP ドアにするには、Triggered ハンドラーの鍵の確認の隣にもう1つ確認を追加します。player:GetAttribute("OwnsPass_VIP") == true が成り立たなければ return してください。これはゲームパスのガイドのサーバースクリプトが設定する属性です。読むのはサーバーだけにしてください。
キーパッド
入力したコードで開くドアの場合、コードはプレイヤーが受け取ることのないサーバー Script か ServerStorage に保存し、チーターが読める LocalScript には絶対に置かないでください。キーパッドの LocalScript は、入力された数字だけを RemoteEvent で送ります。サーバーで、プレイヤーがドアのそばにいることを確認し、試行回数を制限し、数字を比べてから move(true) を呼んでください。RemoteEvent のガイドで、リモートが受け取るものを確認する方法を紹介しています。
効果音
ドアのパーツの中に Sound を入れるとそのパーツの位置から鳴るので、move の最初でその Play メソッドを呼びます。あるいは、ドアの Open 属性を GetAttributeChangedSignal("Open") で監視する LocalScript から鳴らしてもかまいません。サーバーは動くたびにこの属性を設定するからです。
ゲーム中に追加されるドア
新しいドアは、ServerStorage にある閉じた状態のテンプレートから複製してください。DoorService はドアが現れた時点で閉じた位置を読むので、その時点で開いていたドアのコピーは、開いた位置を閉じた位置とみなしてしまいます。コピーの Parent を Workspace にする前に、PivotTo で出入口に置いてください。そうすれば DoorService はその場所を閉じた位置として覚えます。コピーに付いてきた古いプロンプトと値は自動で削除されます。プレイヤーを別のエリアや別のプレイスへ運ぶドアについては、テレポートのガイドを読んでください。
よくあるエラーと対処法
Play を押す前に Output ウィンドウを開いてください(Window メニューの Output)。ドアの問題のほとんどは、タグ、pivot、属性がスクリプトの期待とほんの少し違うことが原因です。
ドアにプロンプトが表示されない
順番に確認してください。DoorService が LocalScript ではなく Script で、ServerScriptService の直下にあるか。ドアに大文字の D の Door タグがあるか(モデルのドアなら Model 自体に)。ドアがパーツ(Part、MeshPart、またはほかの BasePart)か Model か。そして、プロンプトが付いているパーツから 8 スタッド以内に立っているか。Output にドアが "has no part to put the prompt on" という警告が出ている場合は、タグの付いた Model の中にパーツがありません。
ゲーム開始時にドアが落ちる、流れる、押される
どれかのパーツがアンカーされていません。ドアのすべてのパーツを選択して Anchored にチェックを入れてください。アンカーされたパーツは物理演算で動くことはありませんが、DoorService からは動かせます。
属性を変えたのに、ドアが無視する
3つのことを確認してください。型: OpenAngle、SlideDistance、OpenSeconds、AutoCloseSeconds は number 型、Style と KeyName は string 型の属性である必要があります。型が違うと DoorService は初期値を使います。つづり: 名前は完全一致で比べるので、openAngle は別の属性です。値も完全一致で比べます。Style は大文字の S で、空白なしの Slide である必要があります。タイミング: DoorService はドアを設定するときに一度だけ属性を読むので、プレイテスト中に変えても、ゲームを再実行するまで何も変わりません。
ドアが逆向きに開く、または横に倒れる
反対側に開かせるには、OpenAngle を負にしてください。たとえば -90 です。垂直な蝶番ではなく水平な軸で回転する場合は、pivot 自体が回転しています。Model タブで Pivot をオンにし、pivot を回転させて垂直に戻してください。
引き戸が壁にめり込む、またはほんの少ししか動かない
負の SlideDistance を設定して、反対側に動かしてください。動きが少なすぎる、または大きすぎる場合は、測った幅に頼らず、SlideDistance に必要なスタッド数を設定してください。
鍵を持っているのにドアが開かない
鍵は Part や Model ではなく Tool である必要があり、名前は大文字も含めて KeyName と完全に一致している必要があります。Backpack にあるか、手に持っている必要があります。ドアの KeyName が string 型の属性であることも確認してください。
RoCode で作る
これを全部手で設定したくなければ、RoCode が開いているプレイスの中に作れます。RoCode は Roblox 公式ではない、独立した Roblox Studio 向け AI エージェントです。Web チャットで変更内容を説明すると、Studio プラグインが Explorer にスクリプトとオブジェクトを作るので、コードを貼り付ける必要はありません。
Door タグの付いたドアを、E 長押しのプロンプトで開くようにして: pivot を軸に 0.6 秒で 90 度回転、4 秒後に閉まる、Style 属性が Slide なら回転の代わりにスライド、プレイヤーが KeyName の名前の Tool を持っていなければドアは閉じたまま。すべてサーバーで、距離の確認付きで。
- ステップに必要なときは、Search Game と Search Scripts でプレイスを確認し、2つ目のシステムを追加するのではなく、すでにあるアイテム、リモート、保存のコードを土台にできます
- Create Script で ServerScriptService に Script を書き、Create Instance でドアのパーツを作り、Style や KeyName などの属性を設定できます
- 書いたスクリプトはすべて Check Script でコンパイルを確認するよう指示されています。Check Script は実行せずに Studio でコンパイルします
- 変更のまとまりごとに前後へ取り消しポイントを置くので、Ctrl+Z で1まとまりずつ元に戻せます
テストの前に、Studio の Pivot ツールで各ドアの pivot を確認してください。ドアはその周りを回転します。プラグイン 3.9 以降では RoCode が短いプレイテストを実行してエラーを読めます。プラグイン 3.9.15 以降では歩いたりキーを押したりするテスト用キャラクターを操作できますが、確認するのは自分でテストすると決めたことだけなので、各ドアに近づいて E を長押しするのはご自身で行ってください。RoCode が Studio に接続する仕組み。
よくある質問
Roblox Studio で E キーで開くドアを作るには?
ドアに ProximityPrompt を入れ、ドアを動かすサーバー Script でその Triggered イベントに接続します。DoorService は Door タグの付いたすべてのドアについて両方を行います。E はプロンプトの初期キーで、Roblox はキーボード、ゲームパッド、タッチ画面に合った入力を表示します。
ドアが真ん中を軸に回ってしまうのはなぜ?
pivot がまだ中心にあります。Model タブで Pivot をオンにし、pivot を蝶番側の端へドラッグしてください。スクリプトはドアを pivot を軸に回転させます。
引き戸を作るには?
ドアの Style 属性を Slide にします。ドアは幅の分、または SlideDistance スタッドだけ横に動きます。負の距離にすると反対側に動きます。
スクリプトなしでドアを作れますか?
はい。Roblox の蝶番のドアのチュートリアルでは、アンカーされていないドアを制限付きの HingeConstraint で枠に取り付け、プレイヤーは体で押して開けます。このドアにはプロンプトもロックも自動で閉まる仕組みもありません。
VIP だけが開けられるドアを作るには?
パスの所有者が通り抜けられる ゲームパスのガイドの VIP ドアを使うか、DoorService の Triggered ハンドラーに、開ける前にプレイヤーがパスを持っているかをサーバーで読む確認を追加してください。たとえば、そのガイドが設定する OwnsPass_VIP 属性です。
自分には開くのに、ほかのプレイヤーには開かないのはなぜ?
LocalScript が開けていて、LocalScript による変更はそのプレイヤーの端末にとどまるからです。DoorService のように、開けるコードをサーバー Script に移せば、変更が全員に届きます。
参考資料
- Roblox Creator Docs: PVInstance:PivotTo(英語). パーツやモデル全体を pivot で動かす
- Roblox Creator Docs: Pivot tools(英語). pivot の移動、Snap と基準点、PrimaryPart がある場合の pivot
- Roblox Creator Docs: Model(英語). WorldPivot、GetExtentsSize は pivot に従う、SetPrimaryPartCFrame は非推奨
- Roblox Creator Docs: CFrame:Lerp(英語). 回転は最短の弧で補間される
- Roblox Creator Docs: TweenService(英語). トゥイーンできるものと、同じプロパティへの2つ目のトゥイーンが1つ目を取り消す仕組み
- Roblox Creator Docs: Proximity prompts(英語). プロンプトの作成と設定、どの端末でも使える入力、視線の確認
- Roblox Creator Docs: ProximityPrompt(英語). 初期のキーとボタン、HoldDuration、MaxActivationDistance、Triggered
- Roblox Creator Docs: CollectionService(英語). タグ、GetTagged、GetInstanceAddedSignal
- Roblox Creator Docs: Properties window(英語). Studio でのタグと属性の追加
- Roblox Creator Docs: Securing the client-server boundary(英語). 攻撃面としての ProximityPrompt と、「鍵とドア」の権限確認
- Roblox Creator Docs: Network ownership, movement validation, and physics(英語). クライアントが自分のキャラクターでできること
- Roblox Creator Docs: Build a hinged door(英語). コードなしの HingeConstraint のドア
- Roblox Creator Docs: In-game tools(英語). Handle、アンカー、StarterPack
- Roblox Creator Docs: Tool.CanBeDropped(英語). 装備中のツールに対して Backspace が行うこと
コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。