要点
NPC のモデルを Workspace の NPCs フォルダに入れ、会話を ReplicatedStorage の ModuleScript に書きます。各セリフには NPC のテキストと、別のセリフにつながる選択肢のリストがあります。ServerScriptService の Script が各 NPC に ProximityPrompt("Talk")を追加し、各プレイヤーがどのセリフにいるかを覚えて、RemoteEvent でそれを送ります。LocalScript がテキストと選択肢ごとのボタンを表示し、押されたボタンの番号だけを送り返します。
- 報酬はサーバーで渡してください。組み込みの Dialog オブジェクトの
DialogChoiceSelectedイベントはクライアントでしか発火しないので、サーバーの Script には決して届きません。また、LocalScript で渡した回復やアイテムは、そのプレイヤーのゲームのコピーしか変えません。 - セリフの吹き出しは、LocalScript から
TextChatService:DisplayBubble(npc.Head, text)で表示します。古いChatサービスは非推奨で、代わりに TextChatService を使います。 - 自分で書いたセリフはフィルタリングする必要はありません。Roblox のルールでは、プレイヤーが入力したものなど、自分で直接管理していない表示テキストをフィルタリングします。
このページの内容
NPC との会話の仕組み
実際のゲームで動く話す NPC は、サーバーと各プレイヤーの端末に分かれています。端末はウィンドウとボタンを描きます。信頼できる唯一の側であるサーバーは、各プレイヤーがどのセリフを読んでいるかを知っていて、各返答が何をするかを決めます。会話の1ターンは次のように進みます。
- プレイヤーが NPC に近づき、Talk プロンプトで E を押します。プロンプトの
Triggeredイベントが、そのプレイヤーとともにサーバーで発火します。 - サーバースクリプトはプレイヤーが十分近いことを確認し、
startという名前のセリフにいることを記録して、そのセリフのテキストと選択肢のラベルをそのプレイヤーだけに送ります。 - LocalScript が会話ウィンドウにセリフを1文字ずつ表示し、NPC の上に吹き出しを出してから、選択肢ごとにボタンを追加します。
- プレイヤーが選択肢をクリック、タップ、または選択します。サーバーに戻るのはその番号だけです。
- サーバーは、プレイヤーが読んでいると分かっているセリフでその番号を探し、選択肢にアクション(回復、アイテム)があれば実行して、次のセリフを送るかウィンドウを閉じます。
| 要素 | 場所 | 役割 |
|---|---|---|
リグ Guide | Workspace の NPCs という名前のフォルダ | NPC そのもの。名前で会話が選ばれ、プロンプトにも表示されます。 |
ModuleScript DialogueData | ReplicatedStorage | NPC が話せるすべてのセリフ、各セリフの下の選択肢、そして各選択肢がどこにつながるか。 |
Script DialogueService | ServerScriptService | Talk プロンプトを追加し、各プレイヤーがどのセリフにいるかを覚え、すべてのクリックをチェックし、アクションを実行します。 |
RemoteEvent DialogueEvent | ReplicatedStorage(DialogueService が作成) | 各セリフをプレイヤーに運び、選んだ選択肢の番号をサーバーに戻します。 |
LocalScript DialogueClient | StarterPlayer、StarterPlayerScripts | ウィンドウを描き、セリフを1文字ずつ表示し、吹き出しと選択肢のボタンを表示します。 |
Tool Torch(任意) | ServerStorage の DialogueItems という名前のフォルダ | 選択肢の1つが渡すアイテム。ServerStorage の中身はプレイヤーに送られません。 |
Workspace
NPCs Folder new
Guide Model new
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (体のパーツ)
ReplicatedStorage
DialogueData ModuleScript new
ServerScriptService
DialogueService Script new
ServerStorage
DialogueItems Folder new
Torch Tool new
Handle Part new
StarterPlayer
StarterPlayerScripts
DialogueClient LocalScript new
ステップ1: NPC を追加する
- Avatar タブか Home タブで Character をクリックして Rig Generator を開きます。R15、体型、スタイルを選びます。Workspace に
Rigという名前のリグが現れます。R6 のリグでも同じスクリプトで動きます。 - 名前を
Guideに変えます。名前は重要です。DialogueService はモデルの名前で会話を探し、プロンプトはその名前をプレイヤーに表示します。 - リグを展開し、HumanoidRootPart を選択して、Properties ウィンドウで Anchored にチェックを入れます。アンカーしたパーツは物理で動かないので、NPC は置いた場所に立ったままになり、プレイヤーに押されることもありません。
- Explorer で Workspace にカーソルを合わせ、+ ボタンを押して、
NPCsという名前の Folder を挿入します。Guide をその中にドラッグし、プレイヤーが近づける場所にリグを置きます。 - 任意(アイテムの選択肢用): ServerStorage にカーソルを合わせ、
DialogueItemsという名前の Folder を挿入します。その中にTorchという名前の Tool を入れ、Handleという名前のアンカーしていない Part を1つ入れます。これがキャラクターが手に持つパーツです。Handle の中に PointLight を入れると光ります。
名前は大文字と小文字を区別するので、NPCs、Guide、DialogueItems、Torch は表示どおり正確に入力してください。NPC は Humanoid と HumanoidRootPart を持つモデルなら何でもよく、NPCs フォルダの直下にあれば Toolbox のモデルでもかまいません。
ステップ2: 会話を書く
ReplicatedStorage にカーソルを合わせ、DialogueData という名前の ModuleScript を挿入して、このコードを貼り付けます。ロジックはなく、言葉とそのつながりだけなので、いちばんよく編集するのはこのファイルになります。
-- ReplicatedStorage の中にある DialogueData という名前の ModuleScript。
-- すべての会話を、Workspace.NPCs の NPC の名前ごとにまとめています。各セリフには
-- NPC のテキストとプレイヤーの返答の選択肢があります。選択肢は別のセリフにつながる(next)ことも、
-- 会話を終わらせる(next なし)ことも、サーバーに何かを頼む(action)こともできます。サーバーが
-- アクションを実行できないときは、next の代わりに failNext のセリフを表示します。
export type Choice = {
text: string,
next: string?, -- この選択肢のあとに表示するセリフ。nil なら会話が終わります
action: string?, -- DialogueService の ACTIONS テーブルにあるサーバーのアクション
item: string?, -- GiveItem アクション用: ServerStorage.DialogueItems にある Tool の名前
failNext: string?, -- アクションを実行できなかったときに next の代わりに表示するセリフ
}
export type Line = {
text: string,
choices: { Choice },
}
local DialogueData: { [string]: { [string]: Line } } = {
Guide = {
start = {
text = "Welcome to the village! What can I do for you?",
choices = {
{ text = "Any tips?", next = "tips" },
{ text = "I'm hurt. Can you help?", next = "healed", action = "Heal", failNext = "healTooSoon" },
{ text = "Got anything for the cave?", next = "torch", action = "GiveItem", item = "Torch", failNext = "hasTorch" },
{ text = "Bye!" },
},
},
tips = {
text = "Stay off the red bricks, and come back if you get hurt.",
choices = {
{ text = "Anything else?", next = "start" },
{ text = "Thanks!" },
},
},
healed = {
text = "There you go, good as new.",
choices = {
{ text = "Thank you!" },
},
},
torch = {
text = "Take this torch. The cave is dark.",
choices = {
{ text = "Thanks!" },
},
},
healTooSoon = {
text = "I healed you a moment ago. Come back in a little while.",
choices = {
{ text = "OK" },
},
},
hasTorch = {
text = "You already have my torch. Keep it lit!",
choices = {
{ text = "Will do!" },
},
},
},
}
return DialogueData
先頭の export type の行は、セリフと選択肢の形を表しています。ゲーム中には何も変えませんが、データの形を示すので、型チェックで確認できるようになります。
各部分のつながり:
- NPC ごとに、NPCs フォルダ内のモデル名と同じ名前のテーブルがあります。ここでは
Guideです。すべての会話はstartのセリフから始まります。 textは NPC が話す内容です。choicesはプレイヤーのボタンで、順番どおりに並びます。ウィンドウには4つ分の場所があります。nextは、この選択肢のあとに表示するセリフの名前です。"Bye!" のようにnextのない選択肢は会話を終わらせます。テーブルにないセリフの名前を指すnextやfailNextも、Output に警告を出して会話を終わらせます。actionは、DialogueService のACTIONSテーブルからサーバーが行うことの名前を指定します。ここではHealかGiveItemです。itemは GiveItem 用で、ServerStorage、DialogueItems にある Tool の名前です。failNextは、アクションを実行できなかったときにnextの代わりに表示するセリフです。これで NPC が、実際にはしていない回復や贈り物をしたと言うことはなくなります。
| セリフ | Guide のセリフ | 選択肢とつながる先 |
|---|---|---|
start | "Welcome to the village! What can I do for you?" | "Any tips?" は tips へ。"I'm hurt. Can you help?" は回復してから healed(または healTooSoon)へ。"Got anything for the cave?" は Torch を渡してから torch(または hasTorch)へ。"Bye!" で会話が終わります。 |
tips | "Stay off the red bricks, and come back if you get hurt." | "Anything else?" は start に戻ります。"Thanks!" で会話が終わります。 |
healed | "There you go, good as new." | "Thank you!" で会話が終わります。 |
torch | "Take this torch. The cave is dark." | "Thanks!" で会話が終わります。 |
healTooSoon | "I healed you a moment ago. Come back in a little while." | "OK" で会話が終わります。 |
hasTorch | "You already have my torch. Keep it lit!" | "Will do!" で会話が終わります。 |
このモジュールを読むのはサーバーだけです。LocalScript がこれを require することはなく、プレイヤーがセリフにたどり着くたびにサーバーがそのセリフを送ります。ただし、ReplicatedStorage のモジュールは各プレイヤーの端末にもコピーされるので、会話にネタバレ(たとえばなぞなぞの答え)があるなら、DialogueData を ServerStorage に移してください。そのうえで DialogueService の require の行で ReplicatedStorage を ServerStorage に置き換え、行全体を次のようにします: local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }。
ステップ3: サーバースクリプトを追加する
ServerScriptService にカーソルを合わせ、DialogueService という名前の Script を挿入して、下のコードを貼り付けます。会話が先に進むのはここだけで、報酬が渡されるのもここだけです。
-- ServerScriptService の中にある DialogueService という名前の Script。
-- Workspace.NPCs の各 NPC に Talk プロンプトを追加し、すべての会話を進めます。
-- プレイヤーの端末はテキストを表示し、クリックした選択肢の番号を送り返すだけです。
-- サーバーは各プレイヤーがどのセリフにいるかを知っていて、選択肢と距離をチェックし、
-- 回復やアイテムの受け渡しを行うのはサーバーだけです。
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- DialogueData と同じ形。これで Studio の型チェックがここでもそれを理解できます
type Choice = { text: string, next: string?, action: string?, item: string?, failNext: string? }
type Line = { text: string, choices: { Choice } }
local DialogueData = require(ReplicatedStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }
local TALK_DISTANCE = 12 -- スタッド単位: プロンプトの半径と、プレイヤーがどれだけ近くにいなければならないか
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30
local npcFolder = workspace:WaitForChild("NPCs")
local itemFolder = ServerStorage:FindFirstChild("DialogueItems")
-- このスクリプトが DialogueEvent を自分で作るので、手動で追加しないでください
local dialogueEvent = Instance.new("RemoteEvent")
dialogueEvent.Name = "DialogueEvent"
dialogueEvent.Parent = ReplicatedStorage
type Conversation = { npc: Model, npcName: string, lineId: string, lastChoice: number }
local conversations: { [Player]: Conversation } = {}
local lastHeal: { [Player]: number } = {}
local function rootOf(model: Model?): BasePart?
local root = model and model:FindFirstChild("HumanoidRootPart")
return if root and root:IsA("BasePart") then root else nil
end
local function isClose(player: Player, npc: Model): boolean
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
local playerRoot = rootOf(character)
local npcRoot = rootOf(npc)
if not (humanoid and humanoid.Health > 0 and playerRoot and npcRoot) then
return false -- キャラクターがいない、死んでいる、または NPC が消えた
end
-- プレイヤーの位置は少し遅れてサーバーに届くので、少し余裕を持たせます
return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end
-- 選択肢にアクションがあるときにサーバーが行うこと。それぞれ、実行できたら true を返します。
local ACTIONS: { [string]: (player: Player, choice: Choice) -> boolean } = {
Heal = function(player)
local now = os.clock()
if now - (lastHeal[player] or -math.huge) < HEAL_COOLDOWN_SECONDS then
return false -- 回復したばかり
end
local character = player.Character
local humanoid = character and character:FindFirstChildOfClass("Humanoid")
if not (humanoid and humanoid.Health > 0) then
return false
end
lastHeal[player] = now
humanoid.Health = humanoid.MaxHealth
return true
end,
GiveItem = function(player, choice)
local itemName = choice.item
local template = itemFolder and itemName and itemFolder:FindFirstChild(itemName)
if not (itemName and template and template:IsA("Tool")) then
warn(`DialogueService: no Tool named {itemName} in ServerStorage.DialogueItems`)
return false
end
local backpack = player:FindFirstChildOfClass("Backpack")
local character = player.Character
if not backpack or backpack:FindFirstChild(itemName) or (character and character:FindFirstChild(itemName)) then
return false -- まだバックパックがないか、すでにアイテムを持っている
end
local item = template:Clone() :: Tool
item.CanBeDropped = false -- 捨ててもう1つ頼むことができないように
item.Parent = backpack
return true
end,
}
local function showLine(player: Player, conversation: Conversation)
local line = DialogueData[conversation.npcName][conversation.lineId]
local choiceTexts = {}
for _, choice in line.choices do
table.insert(choiceTexts, choice.text)
end
dialogueEvent:FireClient(player, "show", conversation.npc, line.text, choiceTexts)
end
local function endConversation(player: Player)
if conversations[player] then
conversations[player] = nil
dialogueEvent:FireClient(player, "close")
end
end
local function startConversation(player: Player, npc: Model)
local npcName = npc.Name
local lines = DialogueData[npcName]
if conversations[player] or not (lines and lines.start) or not isClose(player, npc) then
return -- すでに会話中、この NPC に "start" のセリフがない、死んでいる、または遠すぎる
end
local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
conversations[player] = conversation
showLine(player, conversation)
end
-- プレイヤーが choiceIndex 番の選択肢をクリックしました(0 はウィンドウを閉じたことを表します)
dialogueEvent.OnServerEvent:Connect(function(player: Player, choiceIndex: unknown)
local conversation = conversations[player]
if not conversation then
return
end
if typeof(choiceIndex) ~= "number" or choiceIndex ~= math.floor(choiceIndex) then
return
end
if choiceIndex == 0 or not isClose(player, conversation.npc) then
endConversation(player)
return
end
local now = os.clock()
if now - conversation.lastChoice < MIN_SECONDS_BETWEEN_CHOICES then
-- 速すぎます。同じセリフをもう一度送ります。ウィンドウはクリック後にすでにボタンを
-- ロックしているので、そうしないと返事をいつまでも待ち続けてしまいます。
showLine(player, conversation)
return
end
conversation.lastChoice = now
local line = DialogueData[conversation.npcName][conversation.lineId]
local choice = line.choices[choiceIndex]
if not choice then
return -- このプレイヤーが読んでいるセリフに、そのような選択肢はありません
end
local nextLine = choice.next
if choice.action then
local action = ACTIONS[choice.action]
local done = false
if action then
done = action(player, choice)
else
warn(`DialogueService: no action named {choice.action}`)
end
if not done and choice.failNext then
nextLine = choice.failNext -- たとえば "I healed you a moment ago"
end
end
if nextLine and not DialogueData[conversation.npcName][nextLine] then
warn(`DialogueService: no line named {nextLine} for {conversation.npcName} in DialogueData`)
nextLine = nil
end
if nextLine then
conversation.lineId = nextLine
showLine(player, conversation)
else
endConversation(player)
end
end)
-- 各 NPC の Talk プロンプト
local function setUpNpc(npc: Instance)
local root = if npc:IsA("Model") then rootOf(npc) else nil
if not (npc:IsA("Model") and root) then
return
end
if not (DialogueData[npc.Name] and DialogueData[npc.Name].start) then
warn(`DialogueService: no conversation with a start line for {npc.Name} in DialogueData`)
end
local leftover = root:FindFirstChild("TalkPrompt")
if leftover then
leftover:Destroy() -- NPC のコピーには、誰も聞いていない古いプロンプトが付いてきます
end
local prompt = Instance.new("ProximityPrompt")
prompt.Name = "TalkPrompt"
prompt.ActionText = "Talk"
prompt.ObjectText = npc.Name
prompt.MaxActivationDistance = TALK_DISTANCE
prompt.RequiresLineOfSight = false
prompt.Parent = root
prompt.Triggered:Connect(function(player: Player)
startConversation(player, npc)
end)
end
for _, npc in npcFolder:GetChildren() do
setUpNpc(npc)
end
npcFolder.ChildAdded:Connect(setUpNpc)
-- 会話の途中で離れたり死んだりした人のウィンドウを閉じます
task.spawn(function()
while true do
task.wait(0.5)
for player, conversation in conversations do
if not isClose(player, conversation.npc) then
endConversation(player)
end
end
end
end)
Players.PlayerRemoving:Connect(function(player: Player)
conversations[player] = nil
lastHeal[player] = nil
end)
DialogueService はゲームの開始時に RemoteEvent DialogueEvent を自分で作るので、ReplicatedStorage に手動で何かを挿入する必要はありません。同じ名前の RemoteEvent をすでに作っている場合は削除してください。LocalScript があなたの作ったほうを見つけてしまうかもしれず、それはサーバーで誰も聞いていません。
| 設定 | ここでの値 | 変わること |
|---|---|---|
TALK_DISTANCE | 12 | Talk プロンプトが表示されるために、プレイヤーがどれだけ近く(スタッド単位)にいる必要があるか。プレイヤーの位置は少し遅れてサーバーに届くので、サーバーはウィンドウを閉じる前にさらに 4 スタッド離れることを許します。 |
MIN_SECONDS_BETWEEN_CHOICES | 0.3 | サーバーが受け付ける2回のクリックの最短間隔。それより速いクリックには、返答の代わりに同じセリフがもう一度送られます。 |
HEAL_COOLDOWN_SECONDS | 30 | 各プレイヤーが Heal アクションによる回復と回復の間に待つ時間。 |
サーバーは conversations にプレイヤーごとに1つの記録を持ちます。どの NPC と話しているか、どのセリフを読んでいるか、最後のクリックがいつ受け付けられたかです。Talk プロンプトが発火すると、startConversation は、プレイヤーがまだ会話中でなく、NPC に start のセリフがあり、プレイヤーが生きていて範囲内にいる場合にだけ、この記録を作ります。そのあと、すべてのクリックは次のチェックを通ります。
| チェック | コード | 通らなかった場合 |
|---|---|---|
| プレイヤーが会話中である | conversations[player] | クリックは無視されます。 |
| 選択肢が整数である | typeof と math.floor | 無視されます。文字列、テーブル、小数、NaN はここで止まります。 |
| 0 はプレイヤーが X を押したことを表す | choiceIndex == 0 | 会話が終わります。 |
| 生きていて、まだ 16 スタッド(12 + 4)以内にいる | isClose | 会話が終わり、ウィンドウが閉じます。 |
| 最後に受け付けたクリックから 0.3 秒以上たっている | conversation.lastChoice | 同じセリフがもう一度送られるので、ウィンドウはいつまでも待つのではなく新しいボタンを受け取ります。 |
| このプレイヤーが読んでいるセリフにその選択肢がある | line.choices[choiceIndex] | 無視されます。 |
| アクションが成功した | 各アクションが true か false を返す | next の代わりに failNext のセリフが表示されます。 |
プロンプトは NPC の HumanoidRootPart に付けます。ProximityPrompt は、Workspace 内のパーツ(または Attachment、PrimaryPart を持つモデル)の中にあるときに動くからです。RequiresLineOfSight はデフォルトでオンになっていて、カメラからそのパーツまでの視界を何かがさえぎるたびにプロンプトを隠します。Roblox はプロンプト自身のパーツをこのチェックから除外しますが、体のほかの部分は除外しません。HumanoidRootPart は胴体の中にあるので、スクリプトは視線のチェックをオフにしています。プロンプトの名前は TalkPrompt で、スクリプトは自分のプロンプトを追加する前に、パーツにすでにある TalkPrompt を削除します。ゲーム中に作った NPC のコピーは元のプロンプトを持ったまま現れますが、コピーされたプロンプトは誰も聞いていないからです。DialogueData に NPC の名前で start のセリフを持つ会話がなければ、Output にその NPC の名前付きで警告が出ます。
ループが1秒に2回、開いている会話をすべてチェックし、プレイヤーが 16 スタッドより遠くに離れたか、キャラクターが死んだときに会話を閉じます。これで、会話の途中で死んだプレイヤーがウィンドウを開いたままリスポーンすることはありません。誰かが退出すると、PlayerRemoving が両方のテーブルを片付けます。
ステップ4: 会話ウィンドウを追加する
StarterPlayer を開き、StarterPlayerScripts にカーソルを合わせ、DialogueClient という名前の LocalScript を挿入して、このコードを貼り付けます。会話ウィンドウはコードで組み立てるので、GUI を手で描く必要はありません。
-- StarterPlayer > StarterPlayerScripts の中にある DialogueClient という名前の LocalScript。
-- サーバーから届いた会話を描きます: NPC の名前、1文字ずつ表示されるセリフ、
-- 頭の上の吹き出し、選択肢ごとのボタン。選択肢をクリックすると
-- その番号だけが送られます。次に何が起きるかはサーバーが決めます。
local GuiService = game:GetService("GuiService")
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local TextChatService = game:GetService("TextChatService")
local UserInputService = game:GetService("UserInputService")
local dialogueEvent = ReplicatedStorage:WaitForChild("DialogueEvent") :: RemoteEvent
local player = Players.LocalPlayer
local LETTERS_PER_SECOND = 45
local REGULAR = Font.fromEnum(Enum.Font.BuilderSans)
local BOLD = Font.fromEnum(Enum.Font.BuilderSansBold)
-- コードで組み立てた会話ウィンドウ
local gui = Instance.new("ScreenGui")
gui.Name = "Dialogue"
gui.ResetOnSpawn = false
gui.Enabled = false
local box = Instance.new("Frame")
box.AnchorPoint = Vector2.new(0.5, 1)
box.Position = UDim2.new(0.5, 0, 1, -84) -- 84 ピクセル上げて、Roblox のツールバーが選択肢を隠さないようにします
box.Size = UDim2.fromScale(0.6, 0.34)
box.BackgroundColor3 = Color3.fromRGB(24, 24, 32)
box.BackgroundTransparency = 0.1
box.Parent = gui
local corner = Instance.new("UICorner")
corner.CornerRadius = UDim.new(0, 12)
corner.Parent = box
local sizeLimit = Instance.new("UISizeConstraint")
sizeLimit.MaxSize = Vector2.new(720, 300)
sizeLimit.Parent = box
local nameLabel = Instance.new("TextLabel")
nameLabel.Position = UDim2.fromScale(0.04, 0.04)
nameLabel.Size = UDim2.fromScale(0.8, 0.14)
nameLabel.BackgroundTransparency = 1
nameLabel.TextXAlignment = Enum.TextXAlignment.Left
nameLabel.TextColor3 = Color3.fromRGB(190, 160, 255)
nameLabel.TextScaled = true
nameLabel.FontFace = BOLD
nameLabel.Parent = box
local lineLabel = nameLabel:Clone()
lineLabel.Position = UDim2.fromScale(0.04, 0.2)
lineLabel.Size = UDim2.fromScale(0.92, 0.3)
lineLabel.TextColor3 = Color3.new(1, 1, 1)
lineLabel.TextScaled = true -- 長いセリフは、スマホの小さな画面に収まるように縮みます
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- そして大きな画面でも 20 ピクセルより大きくはなりません
lineTextLimit.Parent = lineLabel
local closeButton = Instance.new("TextButton")
closeButton.AnchorPoint = Vector2.new(1, 0)
closeButton.Position = UDim2.new(1, -8, 0, 8)
closeButton.Size = UDim2.fromOffset(32, 32)
closeButton.BackgroundTransparency = 1
closeButton.Text = "X"
closeButton.TextColor3 = Color3.new(1, 1, 1)
closeButton.TextSize = 20
closeButton.FontFace = BOLD
closeButton.Parent = box
local choiceList = Instance.new("Frame")
choiceList.Position = UDim2.fromScale(0.04, 0.52)
choiceList.Size = UDim2.fromScale(0.92, 0.44)
choiceList.BackgroundTransparency = 1
choiceList.Parent = box
local layout = Instance.new("UIGridLayout")
layout.CellSize = UDim2.new(0.5, -6, 0.5, -6)
layout.CellPadding = UDim2.fromOffset(6, 6)
layout.SortOrder = Enum.SortOrder.LayoutOrder
layout.Parent = choiceList
gui.Parent = player:WaitForChild("PlayerGui")
local talkingTo: Model? = nil
local lineNumber = 0 -- 新しいセリフのたびに増え、古い表示ループを止めます
local function setPromptVisible(npc: Model?, visible: boolean)
local root = npc and npc:FindFirstChild("HumanoidRootPart")
local prompt = root and root:FindFirstChild("TalkPrompt")
if prompt and prompt:IsA("ProximityPrompt") then
prompt.Enabled = visible -- 変わるのはこの端末の上だけです
end
end
local function clearChoices()
for _, child in choiceList:GetChildren() do
if child:IsA("TextButton") then
child:Destroy()
end
end
end
local function close()
lineNumber += 1
clearChoices()
gui.Enabled = false
setPromptVisible(talkingTo, true)
talkingTo = nil
GuiService.SelectedObject = nil
end
local function show(npc: Model, text: string, choices: { string })
lineNumber += 1
local thisLine = lineNumber
if talkingTo ~= npc then
setPromptVisible(talkingTo, true)
talkingTo = npc
setPromptVisible(npc, false)
end
gui.Enabled = true
nameLabel.Text = npc.Name
clearChoices()
-- NPC の上の吹き出し(DisplayBubble は LocalScript でしか動きません)
local head = npc:FindFirstChild("Head")
if head then
TextChatService:DisplayBubble(head, text)
end
-- セリフを1文字ずつ表示します。文字数は経過時間から計算するので、
-- どのフレームレートでも速さは同じです。
lineLabel.Text = text
lineLabel.MaxVisibleGraphemes = 0
local letters = 0
for _ in utf8.graphemes(text) do
letters += 1
end
local startTime = os.clock()
local shown = 0
while shown < letters do
task.wait()
if lineNumber ~= thisLine then
return -- このセリフは、より新しいセリフか、ウィンドウを閉じる処理に置き換えられました
end
shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
lineLabel.MaxVisibleGraphemes = shown
end
lineLabel.MaxVisibleGraphemes = -1
-- 選択肢ごとに1つのボタン。サーバーが受け取るのはボタンの番号だけです
for index, choiceText in choices do
local button = Instance.new("TextButton")
button.LayoutOrder = index
button.BackgroundColor3 = Color3.fromRGB(124, 77, 255)
button.TextColor3 = Color3.new(1, 1, 1)
button.TextScaled = true
button.FontFace = BOLD
button.Text = choiceText
local buttonCorner = Instance.new("UICorner")
buttonCorner.CornerRadius = UDim.new(0, 8)
buttonCorner.Parent = button
button.Parent = choiceList
button.Activated:Connect(function()
if lineNumber == thisLine then
lineNumber += 1 -- 1つのセリフにつき1回のクリック
dialogueEvent:FireServer(index)
end
end)
if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
GuiService.SelectedObject = button -- ゲームパッドで選択肢を選べるように
end
end
end
closeButton.Activated:Connect(function()
dialogueEvent:FireServer(0)
close()
end)
dialogueEvent.OnClientEvent:Connect(function(kind: string, npc: Model?, text: string?, choices: { string }?)
if kind == "show" and npc and text and choices then
show(npc, text, choices)
elseif kind == "close" then
close()
end
end)
色、サイズ、LETTERS_PER_SECOND は自由に変えてかまいません。最後の2つのハンドラーはそのままにしてください。ウィンドウがサーバーとやり取りする唯一の手段です。
DialogueClient の各部分の役割:
- ウィンドウ。画面の下中央に固定した Frame を持つ ScreenGui で、画面の幅の 60%、高さの 34% を占め、
UISizeConstraintで 720 × 300 ピクセルに制限しているので、ワイドモニターいっぱいに広がりません。NPC のセリフはTextScaledを使っていて、スマホの小さな画面ではラベルに収まるようにテキストを縮め、UITextSizeConstraintによって大きな画面でも 20 ピクセルより大きくなりません。UIGridLayoutが選択肢を 2 × 2 に並べます。ResetOnSpawnは false です。この LocalScript はセッションにつき1回しか実行されないので、リスポーン時に削除されたウィンドウは二度と戻ってこないからです。 - タイプライター効果。セリフ全体は一度に TextLabel に入り、何文字が見えるかは
MaxVisibleGraphemesが決めます。これは Roblox 自身のタイプライターの例がutf8.graphemesと一緒に使っているのと同じプロパティです。Roblox はすべての文字が見えているものとしてテキストをレイアウトするので、文字が現れるにつれて単語が次の行に飛んだりサイズが変わったりしません。スクリプトは表示する文字数を経過時間から毎秒 45 文字で計算するので、どのフレームレートでも速さは同じです。最後にプロパティを -1 にすると、すべてが表示されます。 - ボタン。セリフが表示し終わると現れます。どのボタンも自分の番号だけを1回だけ送ります。
lineNumberのチェックがダブルクリックで2回送られるのを防ぎ、そのあとウィンドウはサーバーからの次のセリフを待ちます。 - セリフの吹き出し。
TextChatService:DisplayBubble(head, text)は、NPC の Head の上のチャットの吹き出しにセリフを表示します。Roblox はこれをクライアントのスクリプトでしか許可しておらず、bubble chat はデフォルトでオンです。吹き出しを描くのはそのプレイヤーの端末なので、見えるのはそのプレイヤーだけです。 - プロンプト。プレイヤーが話している間は、そのプレイヤーの Talk プロンプトのコピー(TalkPrompt という名前で見つけます)がオフになり、会話の上に重ならないようにします。ほかのプレイヤーには自分のプロンプトがそのまま見えます。
- どの端末でも。
Activatedは、マウスのクリック、スマホのタップ、ゲームパッドの A ボタンで発火します。ゲームパッドで押せるのは選択中のボタンだけなので、PreferredInputがプレイヤーはゲームパッドを使っていると示したら、スクリプトはGuiService.SelectedObjectで最初の選択肢を選びます。 - X ボタン。0 を送り(サーバーはこれを「会話を終える」と解釈します)、すぐにウィンドウを閉じます。
独自のアクションを追加する
アクションは、DialogueService の先頭にある ACTIONS テーブルの関数です。プレイヤーと選択肢を受け取り、役目を果たしたら true を返します。たとえば NPC がクエストを渡すような独自のアクションを追加するには:
ACTIONSにStartQuestという名前のエントリを追加します。チェックが先で、変更はあとです。player:GetAttribute("Quest")がすでに設定されていればfalseを返し、そうでなければplayer:SetAttribute("Quest", "Cave")を呼んでtrueを返します。- DialogueData で、選択肢に
action = "StartQuest"、成功したときのnextのセリフ、失敗したときのfailNextのセリフ(たとえば "You are already on a quest.")を設定します。 - Play を押して、その選択肢を2回選びます。DialogueData の名前が
ACTIONSのキーと一致しない(大文字と小文字は区別されます)と、Output にDialogueService: no action named StartQuestと出て、会話はfailNextのセリフに進みます。
アクションを書くときのルール:
- チェックと変更はアクションの中、つまりサーバーで行います。プレイヤーの端末が送るのは選択肢の番号だけです。
- アクションに必要なものは、選択肢(
itemのように)かサーバー自身の状態から読み、決してリモートからは読まないでください。 - 価値のあるものはすべて、アクション自体の中で制限してください。Heal が
lastHealに独自の 30 秒のクールダウンを持っているのと同じです。クリックごとの 0.3 秒の制限はクリックを遅くするだけで、プレイヤーが同じ選択肢を何度も繰り返すのを防ぐわけではありません。 - ショップのような別のウィンドウを開くには、アクションがそのプレイヤーに RemoteEvent を送って
trueを返せます。そのウィンドウで起きることには、ショップの NPC のセクションのように、やはり独自のサーバーチェックが必要です。
ほかの NPC の会話チュートリアルが間違えていること
このガイドを動画やフォーラムの投稿と比べているなら、重要な違いと、それぞれのやり方が問題を生む理由を以下にまとめます。
| チュートリアル | 問題 | このガイド |
|---|---|---|
Dialog オブジェクトを使い、サーバーの Script で DialogChoiceSelected を聞いて報酬を渡す | Roblox のリファレンスには、このイベントはクライアント側でしか動かず、サーバーでは発火しないと書かれているので、報酬は届きません。 | 選択肢は数値としてサーバーに届き、サーバーが自分で報酬を渡します。 |
| LocalScript から報酬を渡す | LocalScript による変更はその1台の端末に残るだけで(何がレプリケートされるかを参照)、チーターは同じコードをいつでも実行できます。 | すべてのアクションは DialogueService にあります。 |
game:GetService("Chat"):Chat(head, text) で NPC を話させる | Chat サービスは非推奨で、代わりに TextChatService を使います。 | LocalScript での TextChatService:DisplayBubble。 |
| クライアントから報酬の名前や次のセリフの id を送る | チーターはどんなアイテム名でも送れますし、報酬がもらえるセリフに直接飛ぶこともできます。 | クライアントは選択肢の番号だけを送ります。サーバーは、プレイヤーが読んでいると分かっているセリフでその番号を探します。 |
| プロンプトが発火したあと何もチェックしない | Roblox のセキュリティガイドは、ProximityPrompt をリモートと並んでクライアントが悪用しうるものに挙げ、アクションの前にプレイヤーが十分近いかを確認するよう勧めています。 | 距離は会話の開始時、クリックのたび、そして会話が開いている間は1秒に2回チェックされます。 |
ループ内の wait() でテキストを表示する | グローバルの wait は非推奨で、代わりに task.wait を使います。 | 見える文字数を os.clock() から計算し、task.wait() で待ちます。 |
プレイヤーが偽装できること、できないこと
チーターは自分の端末上のすべてを操作できると考えてください。LocalScript や ReplicatedStorage の中身をすべて読めますし、Roblox のセキュリティガイドが警告しているとおり、DialogueEvent を好きな引数で何回でも呼び出せ、Talk プロンプトをコードから発火させることもできます。DialogueService は、RemoteEvent の引数のチェックのセクションで解説しているのと同じ種類のサーバーチェックで対応します。チーターが得られるものは次のとおりです。
| チーターの試み | 結果 | 理由 |
|---|---|---|
| マップの反対側から Talk プロンプトを発火させる | 何も起きない | startConversation が 16 スタッド(12 + 4)以内にいることを確認します。 |
| 選択肢 99、文字列、小数、NaN を送る | 無視される | 整数ではないか、読んでいるセリフにそのような選択肢がありません。 |
| 報酬の名前やセリフの id を送る | 読まれることはない | サーバーが読むのは選択肢の番号だけです。報酬は、サーバー側のセリフのコピーにある item と action のフィールドから決まります。 |
| ネットワークが許すかぎり速くクリックする | 会話ごとに 0.3 秒に1回のクリック | それより速いクリックには、そのセリフがそのまま返されます。会話を終えて始め直せばこの待ち時間は回避できるので、Heal と GiveItem は独自の制限を持っています。 |
| 会話せずにたいまつを要求する | 不可能 | アイテムは、サーバーが分かっているプレイヤーの現在のセリフにある選択肢によってのみ渡されます。 |
| たいまつをたくさん集める | 一度に1本だけ | サーバーはまずプレイヤーの Backpack とキャラクターに Torch がないか探します。渡したたいまつは捨てられないので、捨ててはもう一度頼むという方法でためることはできません。 |
| 回復のセリフを連打する | 30 秒に1回の回復 | クールダウンはプレイヤーごとにサーバーに保存され、NPC は healTooSoon のセリフでそれを伝えます。 |
| 離れてウィンドウを開いたままにする | 0.5 秒以内に閉じる | サーバーは開いている会話をすべて1秒に2回チェックします。 |
| まだたどり着いていないセリフも含め、会話全体を読む | 可能 | DialogueData は ReplicatedStorage にあり、すべての端末にコピーされます。それが問題になるなら ServerStorage に移してください(ステップ2を参照)。 |
1つの制限ははっきり言っておく価値があります。Guide に近づいて選択肢を選ぶチーターは、正直なプレイヤーとまったく同じものを得ます。サーバーが管理しているのは、どれくらいの頻度で、どこからかであって、誰がかではありません。各プレイヤーが1回だけもらえる報酬のような珍しいものには、受け取ったときに設定する属性や、データストアに保存するフラグのように、サーバーが管理するチェックが必要です。
ステップ5: テストする
- Play(F5)を押して Guide に近づきます。12 スタッド以内で、Guide の名前が付いた Talk プロンプトが表示されます。E を押します。
- ウィンドウに "Guide" と表示され、あいさつのセリフが1文字ずつ表示されてから、4つのボタンが出ます。同じセリフが NPC の頭の上の吹き出しにも出ます。
- "Any tips?" を選び、次に "Anything else?" を選ぶと、最初のセリフに戻ります。"Bye!" を選ぶとウィンドウが閉じ、Talk プロンプトが戻ってきます。
- まず自分にダメージを与えます。Client/Server の切り替えボタンを押して Server に切り替え、Workspace で自分のキャラクターの Humanoid を選択し、Properties ウィンドウで Health を 50 にしてから、Client に戻します。プレイヤーのキャラクターは毎秒 MaxHealth の 1% ずつ回復するので、すぐに Guide に話しかけて "I'm hurt. Can you help?" を選びます。体力が満タンまで戻ります。30 秒以内にもう一度話しかけて同じものを選ぶと、回復はされず、Guide は少し前に回復したと言います。
- "Got anything for the cave?" を選ぶと、Torch がホットバーに入ります。装備して Backspace を押しても、手に持ったままです。もう一度頼むと、2本目のたいまつはもらえず、Guide はもう持っていると言います。
- 会話を始めてから離れます。Guide から 16 スタッドほど離れたところでウィンドウが閉じます。
- テストモードのドロップダウンで Server & Clients を選び、クライアントを 2 にして Play を押します。2人のプレイヤーが同時に Guide と話せ、それぞれ自分のセリフにいます。
- プレイテスト中に Controller Emulator(Emulation タブの Controller)でゲームパッドをテストします。エミュレートしたゲームパッドで近づき、プロンプトのボタン(デフォルトは ButtonX)を押します。選択肢が現れたときには最初のものがすでに選ばれていて、A で押せます。
- Studio の Device Simulator でスマホの画面を確認します(執筆時点ではベータ版です。File、Beta Features で New Device Simulator をオンにし、Studio を再起動してください)。スマホを選び、横向きになるまで Rotate を押し、Play を押して Guide に近づき、Talk プロンプトをタップします。"Any tips?" を選ぶと、セリフ全体が選択肢のボタンの上に表示され(必要なら小さめの文字で)、ボタンに重なりません。
その間ずっと Output ウィンドウを開いておいてください(Window メニュー、次に Output)。これらのスクリプトは正常に動いているときは何も出力しないので、赤いエラーや DialogueService: で始まる警告が出たら、それは本当の問題です。よくあるエラーを参照してください。
拡張する方法
NPC を増やす、会話を長くする
NPCs フォルダに別の名前のリグをもう1体追加し、DialogueData に同じ名前で start のセリフを持つテーブルを追加します。DialogueService は、フォルダ内の HumanoidRootPart を持つすべてのモデルに Talk プロンプトを追加し、ゲーム中に追加されたものも対象です。NPC のコピーは、コピー元のプロンプトではなく新しいプロンプトを受け取ります。同じ名前の NPC が2体いると、同じテーブルを使います。セリフはどんな順番でもつなげられ、"Anything else?" のように前のセリフに戻る選択肢も作れます。ウィンドウは選択肢を 2 × 2 に並べるので、1つのセリフの選択肢は4つまでにしてください。
進行状況によって変わるセリフ
戻ってきたプレイヤーに別のあいさつをするには、サーバーが管理しているものをもとに最初のセリフを選びます。startConversation の中で local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start" で選び、スクリプトが lines.start を確認するのと同じようにそのセリフが存在するか確認して、会話を作るときに "start" の代わりに firstLine を使います。属性はアクションで設定し、Guide のテーブルに welcomeBack のセリフを追加します。属性は1セッションしか残りません。訪問をまたいでプレイヤーを覚えておくには、DataStore のチュートリアルのようにフラグをデータストアに保存してください。
ショップの NPC
ショップの GUI のガイドに沿ってショップを作り、そのプレイヤーに RemoteEvent を送って true を返す OpenShop アクションを追加して、そのイベントが届いたらショップの LocalScript が自分のウィンドウを開くようにします。購入は引き続きショップ自身のサーバーチェックを通ります。NPC の近くでしか買えないようにしたいなら、購入のハンドラーの中でも距離をチェックしてください。クライアントはどこからでもショップのリモートを呼び出せるからです。
歩く NPC
Guide を歩き回らせたりプレイヤーについてこさせたりするには、NPC の経路探索のガイドを使い、HumanoidRootPart の Anchored を外して動けるようにします。Talk プロンプトはこのパーツに付いているので NPC と一緒に動き、距離のチェックも同じパーツを使います。会話が開いている間は歩くのを一時停止してください。そうしないと、NPC がプレイヤーから 16 スタッドより遠くに離れたとたんにウィンドウが閉じてしまいます。
鍵、クエスト、そのほかの報酬
GiveItem は DialogueItems にある Tool なら何でも渡せるので、ドアのガイドのように、鍵のかかったドアがチェックする鍵を NPC に渡させることもできます。回復する食べ物のように、使ったときに何かをするアイテムについては、インベントリのガイドを読んでください。
音とカメラ
セリフごとにボイスや短い効果音を鳴らすには、NPC の Head に Sound を入れて、DialogueClient の show から再生します。NPC が話している間にカメラを NPC に向けたいなら、カットシーンのガイドで、LocalScript がカメラの操作を引き継いで元に戻す方法を紹介しています。
よくあるエラーと対処法
Play を押す前に Output ウィンドウ(Window メニュー、次に Output)を開いておいてください。会話の問題の多くは、そこに警告が出るか、名前が一致しないことが原因です。
Infinite yield possible on 'ReplicatedStorage:WaitForChild("DialogueEvent")'
DialogueClient は DialogueService が作るリモートを待っているので、DialogueService がそこまで進んでいないということです。それが LocalScript ではなく Script であること、ServerScriptService の直下にあること、無効になっていないことを確認してください。DialogueService はまず ReplicatedStorage の DialogueData と Workspace の NPCs フォルダを待つので、それらがなかったり名前を打ち間違えたりしていても止まります。その場合、Output にはその名前付きで DialogueService からの infinite yield の警告が出ます。
NPC の上に Talk プロンプトが出ない
DialogueService がプロンプトを追加するのは、Workspace、NPCs の直下にあり、HumanoidRootPart という名前のパーツを持つモデルだけです。両方の条件を確認し、12 スタッドより近くまで近づいてください。Toolbox のリグにはこのパーツがなかったり、フォルダに包まれた別の種類のオブジェクトだったりすることがあります。
プロンプトは出るが、E を押しても何も起きない
サーバーがこの NPC の会話を見つけられず、ゲームの開始時に Output に、あなたの NPC の名前付きで DialogueService: no conversation with a start line for Guide in DialogueData と表示されています。DialogueData のテーブルは、大文字も含めてモデルとまったく同じ名前にし、start のセリフを含める必要があります。
選択肢を選ぶと、次のセリフに進まずにウィンドウが閉じる
Output に、あなたの名前付きで DialogueService: no line named tip for Guide in DialogueData と表示されています。選択肢の next(または failNext)が、この NPC のテーブルにないセリフの名前を指しています。セリフの名前は大文字と小文字を区別するので、つづりをテーブルと照らし合わせてください。ここでは tips です。
ウィンドウは動くが、セリフの吹き出しが出ない
吹き出しには、NPC のモデルの直下にある Head という名前のパーツと、オンになった bubble chat が必要です。Explorer で TextChatService の下の BubbleChatConfiguration を選択し、Enabled にチェックが入っているか確認してください。デフォルトではオンです。
Output に DialogueService: no Tool named Torch in ServerStorage.DialogueItems と出る
サーバーがアイテムを見つけられませんでした。ServerStorage のフォルダの名前が DialogueItems であること、そしてその中に選択肢の item とまったく同じ名前の Tool(Model や Part ではなく)が入っていることを確認してください。直すまでは、アクションが失敗するので Guide は hasTorch のセリフで答えます。
Output に DialogueService: no action named ... と出る
選択肢の action が、ACTIONS テーブルのどのキーとも一致していません。名前は大文字と小文字を区別します。heal は Heal ではありません。
RoCode で作る
NPC を手で組み立てるより説明するほうが楽なら、RoCode がこれらのスクリプトをあなたが開いているプレイスに直接書けます。RoCode は Roblox Studio 向けの独立した AI エージェントで、Roblox の製品ではありません。ウェブチャットに書くと、Studio プラグインがあなたの Explorer にスクリプトを作成し、編集します。
Workspace.NPCs の Guide モデルが話せるようにして。Talk プロンプト、セリフが1文字ずつ表示されて選択肢のボタンがある会話ウィンドウ、頭の上の吹き出し、クールダウン 30 秒の回復の選択肢、そして ServerStorage の Torch ツールを1回だけ渡す選択肢。会話は ModuleScript に保存し、報酬はすべてサーバーで渡して。
- まず Get Properties でモデルを調べ、パーツの Anchored や Humanoid の WalkSpeed などの主な値を読めます。チャットで / を入力すると、モデルの正確なパスを添付できます
- Create Script で、ModuleScript の DialogueData、Script の DialogueService、LocalScript の DialogueClient を書きます
- 書いたスクリプトはどれも Check Script でコンパイルできるか確認するよう指示されています。Check Script は Studio でスクリプトを実行せずにコンパイルします
- 変更をまとめて送り、まとまりごとに Studio の履歴に取り消しポイントができます
プラグイン 3.9 以降なら RoCode は短いプレイテストを実行してエラーを読め、プラグイン 3.9.11 以降ならテスト用のキャラクターを操作してゲームが動くか確かめられますが、プレイ中にスクリーンショットは撮らないので、NPC に近づいて自分で話しかけてみてください。思ったとおりに動かないところがあれば、見たことを RoCode に伝えてください。Check Output で直近のプレイテストの Server と Client の行を読めます。話す NPC は数あるシステムの1つにすぎません。AI で Roblox のゲームを作る方法(プロンプト1つにつき1システム)のページで、それらがどう組み合わさるかを紹介しています。RoCode が Studio に接続する仕組み。
よくある質問
Roblox Studio で話す NPC を作るには?
NPC に ProximityPrompt を追加し、プレイヤーがそれを発火させたら、NPC のセリフを会話ウィンドウか吹き出し、またはその両方に表示します。このガイドの3つのスクリプトはその両方を行い、返答の選択肢も追加します。吹き出しだけでよければ、Roblox の bubble chat のページにある NPC の例のように、プロンプトが発火したときに LocalScript から TextChatService:DisplayBubble(npc.Head, "Hello!") を呼んでください。
Dialog オブジェクトと独自の会話 GUI、どちらを選ぶべきですか?
Dialog オブジェクトはコードが不要で、クリックできる吹き出しを表示するので、飾りのテキストには十分です。選択のイベントはプレイヤーの端末でしか発火しないので安全に報酬を渡すことはできず、デフォルトでは一度に1人のプレイヤーしか話しかけられません。このガイドのような独自のウィンドウなら、すべての報酬をサーバーが渡し、プレイヤーごとに別々の会話にできます。
NPC からプレイヤーにアイテムを渡すには?
Tool を ServerStorage に保存しておき、プレイヤーがその選択肢を選んだら、GiveItem アクションのように、サーバーの Script でそれをプレイヤーの Backpack に複製します。プレイヤーがまだそれを持っていないことを確認し、コピーの CanBeDropped をオフにして、捨ててはもう一度頼むことができないようにします。どのアイテムを渡すかをプレイヤーの端末に決めさせてはいけません。
タイプライター効果のある会話ウィンドウを作るには?
セリフ全体を TextLabel に入れ、その MaxVisibleGraphemes を 0 から数文字ずつ増やし、最後に -1 にしてすべてを表示します。Roblox の UI アニメーションのページも、utf8.graphemes と一緒に同じプロパティを使っています。DialogueClient は表示する文字数を経過時間から毎秒 45 文字で計算するので、速さはフレームレートに左右されません。
2人のプレイヤーが同じ NPC と同時に話せますか?
このガイドのスクリプトなら話せます。サーバーはプレイヤーごとに1つの会話を管理し、各プレイヤーには自分のウィンドウしか見えません。組み込みの Dialog オブジェクトは違います。デフォルトの BehaviorType である SinglePlayer では一度に1人のプレイヤーしか話せず、ほかのプレイヤーにはその人の選択肢が見えます。
NPC の会話のテキストはフィルタリングする必要がありますか?
自分で書いたセリフなら必要ありません。Roblox は、プレイヤーが入力したもの、ランダムな文字から作った単語、外部サイトから読み込んだテキストなど、自分で直接管理していない表示テキストのフィルタリングをあなたの責任としています。NPC がプレイヤーの入力したものを繰り返すなら、その部分をフィルタリングしてください。
参考資料
- Roblox Creator Docs: Proximity prompts(英語). プロンプトの作成、MaxActivationDistance と RequiresLineOfSight
- Roblox Engine API: ProximityPrompt(英語). プロンプトが動く場所、テキストとデフォルトのキー、Triggered と視線のチェック
- Roblox Creator Docs: Securing the client-server boundary(英語). 攻撃面としての ProximityPrompt、距離と権限のチェック
- Roblox Engine API: Dialog(英語). BehaviorType と、クライアント専用の DialogChoiceSelected イベント
- Roblox Engine API: TextChatService:DisplayBubble(英語). クライアントのスクリプトからの NPC のセリフの吹き出し
- Roblox Creator Docs: Customize bubble chat(英語). NPC の吹き出しと BubbleChatConfiguration
- Roblox Creator Docs: Text filtering(英語). どの表示テキストをフィルタリングする必要があるか
- Roblox Creator Docs: UI animation and tweens(英語). MaxVisibleGraphemes によるタイプライター効果
- Roblox Engine API: Tool.CanBeDropped(英語). Backspace でツールがどうなるか
- Roblox Engine API: UserInputService.PreferredInput(英語). ゲームパッドのプレイヤーを判定する方法
- Roblox Creator Docs: Rig Generator(英語). R15 または R6 のリグの挿入
コードの検証方法: このページのスクリプトはすべて、Roblox API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。