チュートリアル · ゲームのシステム

Roblox Studio で NPC との会話を作る方法

Roblox の NPC との会話は3つの部分でできています。会話を始めるためのプロンプト、NPC のセリフとプレイヤーの返答ボタンを表示するウィンドウ、そして各返答が何につながるかを決めるスクリプトです。このガイドでは3つすべてを作ります。会話はシンプルな表として書き、プレイヤーは E を押して話しかけ、返答によって得られるもの(回復、アイテム)はプレイヤーの端末ではなくサーバーが渡します。

更新日 2026年11月20日読了時間 約5分執筆

要点

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 のルールでは、プレイヤーが入力したものなど、自分で直接管理していない表示テキストをフィルタリングします。
このページの内容
  1. 仕組み
  2. 1. NPC を追加
  3. 2. 会話
  4. 3. サーバースクリプト
  5. 4. 会話ウィンドウ
  6. 独自のアクション
  7. ほかのチュートリアル
  8. 防御の限界
  9. 5. テスト
  10. 拡張
  11. Common errors
  12. RoCode で作る
  13. よくある質問
  14. 参考資料

NPC との会話の仕組み

イメージ各セリフは、吹き出しに全文が表示されている間にウィンドウで1文字ずつ表示され、表示し終わると選択肢が現れます。"Got anything for the cave?" を選ぶと、サーバーが Torch を渡します。

実際のゲームで動く話す NPC は、サーバーと各プレイヤーの端末に分かれています。端末はウィンドウとボタンを描きます。信頼できる唯一の側であるサーバーは、各プレイヤーがどのセリフを読んでいるかを知っていて、各返答が何をするかを決めます。会話の1ターンは次のように進みます。

  1. プレイヤーが NPC に近づき、Talk プロンプトで E を押します。プロンプトの Triggered イベントが、そのプレイヤーとともにサーバーで発火します。
  2. サーバースクリプトはプレイヤーが十分近いことを確認し、start という名前のセリフにいることを記録して、そのセリフのテキストと選択肢のラベルをそのプレイヤーだけに送ります。
  3. LocalScript が会話ウィンドウにセリフを1文字ずつ表示し、NPC の上に吹き出しを出してから、選択肢ごとにボタンを追加します。
  4. プレイヤーが選択肢をクリック、タップ、または選択します。サーバーに戻るのはその番号だけです。
  5. サーバーは、プレイヤーが読んでいると分かっているセリフでその番号を探し、選択肢にアクション(回復、アイテム)があれば実行して、次のセリフを送るかウィンドウを閉じます。
話す NPC の構成
要素場所役割
リグ GuideWorkspace の NPCs という名前のフォルダNPC そのもの。名前で会話が選ばれ、プロンプトにも表示されます。
ModuleScript DialogueDataReplicatedStorageNPC が話せるすべてのセリフ、各セリフの下の選択肢、そして各選択肢がどこにつながるか。
Script DialogueServiceServerScriptServiceTalk プロンプトを追加し、各プレイヤーがどのセリフにいるかを覚え、すべてのクリックをチェックし、アクションを実行します。
RemoteEvent DialogueEventReplicatedStorage(DialogueService が作成)各セリフをプレイヤーに運び、選んだ選択肢の番号をサーバーに戻します。
LocalScript DialogueClientStarterPlayer、StarterPlayerScriptsウィンドウを描き、セリフを1文字ずつ表示し、吹き出しと選択肢のボタンを表示します。
Tool Torch(任意)ServerStorage の DialogueItems という名前のフォルダ選択肢の1つが渡すアイテム。ServerStorage の中身はプレイヤーに送られません。
NPC が完成したときの Explorer。ゲームが動いている間、DialogueService が ReplicatedStorage に DialogueEvent という名前の RemoteEvent を、各 NPC の HumanoidRootPart に TalkPrompt という名前の Talk の ProximityPrompt を追加します。
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 を追加する

  1. Avatar タブか Home タブで Character をクリックして Rig Generator を開きます。R15、体型、スタイルを選びます。Workspace に Rig という名前のリグが現れます。R6 のリグでも同じスクリプトで動きます。
  2. 名前を Guide に変えます。名前は重要です。DialogueService はモデルの名前で会話を探し、プロンプトはその名前をプレイヤーに表示します。
  3. リグを展開し、HumanoidRootPart を選択して、Properties ウィンドウで Anchored にチェックを入れます。アンカーしたパーツは物理で動かないので、NPC は置いた場所に立ったままになり、プレイヤーに押されることもありません。
  4. Explorer で Workspace にカーソルを合わせ、+ ボタンを押して、NPCs という名前の Folder を挿入します。Guide をその中にドラッグし、プレイヤーが近づける場所にリグを置きます。
  5. 任意(アイテムの選択肢用): ServerStorage にカーソルを合わせ、DialogueItems という名前の Folder を挿入します。その中に Torch という名前の Tool を入れ、Handle という名前のアンカーしていない Part を1つ入れます。これがキャラクターが手に持つパーツです。Handle の中に PointLight を入れると光ります。

名前は大文字と小文字を区別するので、NPCs、Guide、DialogueItems、Torch は表示どおり正確に入力してください。NPC は Humanoid と HumanoidRootPart を持つモデルなら何でもよく、NPCs フォルダの直下にあれば Toolbox のモデルでもかまいません。

ステップ2: 会話を書く

ReplicatedStorage にカーソルを合わせ、DialogueData という名前の ModuleScript を挿入して、このコードを貼り付けます。ロジックはなく、言葉とそのつながりだけなので、いちばんよく編集するのはこのファイルになります。

ModuleScript 場所: ReplicatedStorage 名前: DialogueData
-- 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 の会話(セリフごと)
セリフ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 を挿入して、下のコードを貼り付けます。会話が先に進むのはここだけで、報酬が渡されるのもここだけです。

Script 場所: ServerScriptService 名前: DialogueService
-- 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 があなたの作ったほうを見つけてしまうかもしれず、それはサーバーで誰も聞いていません。

DialogueService の先頭にある設定
設定ここでの値変わること
TALK_DISTANCE12Talk プロンプトが表示されるために、プレイヤーがどれだけ近く(スタッド単位)にいる必要があるか。プレイヤーの位置は少し遅れてサーバーに届くので、サーバーはウィンドウを閉じる前にさらに 4 スタッド離れることを許します。
MIN_SECONDS_BETWEEN_CHOICES0.3サーバーが受け付ける2回のクリックの最短間隔。それより速いクリックには、返答の代わりに同じセリフがもう一度送られます。
HEAL_COOLDOWN_SECONDS30各プレイヤーが Heal アクションによる回復と回復の間に待つ時間。

サーバーは conversations にプレイヤーごとに1つの記録を持ちます。どの NPC と話しているか、どのセリフを読んでいるか、最後のクリックがいつ受け付けられたかです。Talk プロンプトが発火すると、startConversation は、プレイヤーがまだ会話中でなく、NPC に start のセリフがあり、プレイヤーが生きていて範囲内にいる場合にだけ、この記録を作ります。そのあと、すべてのクリックは次のチェックを通ります。

DialogueService がクリックのたびにチェックすること
チェックコード通らなかった場合
プレイヤーが会話中である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 を手で描く必要はありません。

LocalScript 場所: StarterPlayer > StarterPlayerScripts 名前: DialogueClient
-- 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 がクエストを渡すような独自のアクションを追加するには:

  1. ACTIONS に StartQuest という名前のエントリを追加します。チェックが先で、変更はあとです。player:GetAttribute("Quest") がすでに設定されていれば false を返し、そうでなければ player:SetAttribute("Quest", "Cave") を呼んで true を返します。
  2. DialogueData で、選択肢に action = "StartQuest"、成功したときの next のセリフ、失敗したときの failNext のセリフ(たとえば "You are already on a quest.")を設定します。
  3. Play を押して、その選択肢を2回選びます。DialogueData の名前が ACTIONS のキーと一致しない(大文字と小文字は区別されます)と、Output に DialogueService: no action named StartQuest と出て、会話は failNext のセリフに進みます。

アクションを書くときのルール:

  • チェックと変更はアクションの中、つまりサーバーで行います。プレイヤーの端末が送るのは選択肢の番号だけです。
  • アクションに必要なものは、選択肢(item のように)かサーバー自身の状態から読み、決してリモートからは読まないでください。
  • 価値のあるものはすべて、アクション自体の中で制限してください。Heal が lastHeal に独自の 30 秒のクールダウンを持っているのと同じです。クリックごとの 0.3 秒の制限はクリックを遅くするだけで、プレイヤーが同じ選択肢を何度も繰り返すのを防ぐわけではありません。
  • ショップのような別のウィンドウを開くには、アクションがそのプレイヤーに RemoteEvent を送って true を返せます。そのウィンドウで起きることには、ショップの NPC のセクションのように、やはり独自のサーバーチェックが必要です。

ほかの 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 の引数のチェックのセクションで解説しているのと同じ種類のサーバーチェックで対応します。チーターが得られるものは次のとおりです。

チーターが試しうることと、DialogueService の対応
チーターの試み結果理由
マップの反対側から 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: テストする

  1. Play(F5)を押して Guide に近づきます。12 スタッド以内で、Guide の名前が付いた Talk プロンプトが表示されます。E を押します。
  2. ウィンドウに "Guide" と表示され、あいさつのセリフが1文字ずつ表示されてから、4つのボタンが出ます。同じセリフが NPC の頭の上の吹き出しにも出ます。
  3. "Any tips?" を選び、次に "Anything else?" を選ぶと、最初のセリフに戻ります。"Bye!" を選ぶとウィンドウが閉じ、Talk プロンプトが戻ってきます。
  4. まず自分にダメージを与えます。Client/Server の切り替えボタンを押して Server に切り替え、Workspace で自分のキャラクターの Humanoid を選択し、Properties ウィンドウで Health を 50 にしてから、Client に戻します。プレイヤーのキャラクターは毎秒 MaxHealth の 1% ずつ回復するので、すぐに Guide に話しかけて "I'm hurt. Can you help?" を選びます。体力が満タンまで戻ります。30 秒以内にもう一度話しかけて同じものを選ぶと、回復はされず、Guide は少し前に回復したと言います。
  5. "Got anything for the cave?" を選ぶと、Torch がホットバーに入ります。装備して Backspace を押しても、手に持ったままです。もう一度頼むと、2本目のたいまつはもらえず、Guide はもう持っていると言います。
  6. 会話を始めてから離れます。Guide から 16 スタッドほど離れたところでウィンドウが閉じます。
  7. テストモードのドロップダウンで Server & Clients を選び、クライアントを 2 にして Play を押します。2人のプレイヤーが同時に Guide と話せ、それぞれ自分のセリフにいます。
  8. プレイテスト中に Controller Emulator(Emulation タブの Controller)でゲームパッドをテストします。エミュレートしたゲームパッドで近づき、プロンプトのボタン(デフォルトは ButtonX)を押します。選択肢が現れたときには最初のものがすでに選ばれていて、A で押せます。
  9. 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 に保存し、報酬はすべてサーバーで渡して。

RoCode の作業
  • まず 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 API の型定義(luau-lsp、2026年11月20日)を使った Luau の strict 型チェックを通っています。型チェックで見つかるのは API 名の誤りや型の不一致であり、ゲームロジックの誤りは見つかりません。公開する前に必ず Studio でテストしてください。

RoCode を自分のゲームで試してみましょう。

毎日無料のクレジット付き、カード不要です。プラグインを入れて、作りたい機能を説明し、Studio に反映された内容を確認してください。