요약
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는 서버와 각 플레이어의 기기에 나뉘어 있습니다. 기기는 창과 버튼을 그립니다. 유일하게 믿을 수 있는 쪽인 서버는 각 플레이어가 어느 대사를 읽고 있는지 알고, 각 답변이 무엇을 할지 정합니다. 대화의 한 차례는 이렇게 진행됩니다.
- 플레이어가 NPC에게 다가가 Talk 프롬프트에서 E를 누릅니다. 프롬프트의
Triggered이벤트가 그 플레이어와 함께 서버에서 발생합니다. - 서버 스크립트는 플레이어가 충분히 가까운지 확인하고, 그 플레이어가
start라는 대사에 있다고 기억한 뒤, 그 대사의 텍스트와 선택지 문구를 그 플레이어에게만 보냅니다. - LocalScript가 대화창에 대사를 한 글자씩 표시하고, NPC 위에 말풍선을 띄운 다음, 선택지마다 버튼을 하나씩 추가합니다.
- 플레이어가 선택지를 클릭하거나, 탭하거나, 고릅니다. 서버로는 그 번호만 돌아갑니다.
- 서버는 플레이어가 읽고 있다고 알고 있는 대사에서 그 번호를 찾고, 선택지에 동작(회복, 아이템)이 있으면 실행한 뒤, 다음 대사를 보내거나 창을 닫습니다.
| 요소 | 위치 | 하는 일 |
|---|---|---|
Guide 리그 | Workspace, NPCs라는 폴더 안 | NPC 자체입니다. 이 이름으로 대화가 정해지고 프롬프트에 표시됩니다. |
ModuleScript DialogueData | ReplicatedStorage | NPC가 할 수 있는 모든 대사, 대사마다 달린 선택지, 각 선택지가 이어지는 곳. |
Script DialogueService | ServerScriptService | Talk 프롬프트를 붙이고, 각 플레이어가 어느 대사에 있는지 기억하고, 모든 클릭을 검사하고, 동작을 실행합니다. |
RemoteEvent DialogueEvent | ReplicatedStorage (DialogueService가 만듦) | 각 대사를 플레이어에게 전달하고, 고른 선택지 번호를 서버로 돌려보냅니다. |
LocalScript DialogueClient | StarterPlayer, StarterPlayerScripts | 창을 그리고, 대사를 한 글자씩 표시하고, 말풍선과 선택지 버튼을 보여 줍니다. |
Tool Torch (선택) | ServerStorage, DialogueItems라는 폴더 안 | 선택지 하나가 주는 아이템입니다. 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을 넣고, Tool 안에 고정되지 않은Handle이라는 Part 하나를 넣으세요. 캐릭터가 손에 드는 파트입니다. Handle 안에 PointLight를 넣으면 빛이 납니다.
이름은 대소문자를 구분하므로 NPCs, Guide, DialogueItems, Torch를 표시된 그대로 입력하세요. Humanoid와 HumanoidRootPart가 있는 모델이라면 Toolbox의 모델을 포함해 어떤 모델이든 NPC가 될 수 있습니다. NPCs 폴더 바로 아래에 있기만 하면 됩니다.
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는 플레이어의 버튼이며 순서대로 표시됩니다. 창에는 네 개까지 들어갑니다.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 -- 버린 뒤 하나 더 달라고 할 수 없게 합니다
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 | 서버가 받아들이는 두 클릭 사이의 최소 시간. 더 빠른 클릭에는 응답 대신 같은 대사를 다시 보냅니다. |
HEAL_COOLDOWN_SECONDS | 30 | Heal 동작으로 회복한 뒤 각 플레이어가 다음 회복까지 기다리는 시간. |
서버는 conversations에 플레이어마다 기록 하나를 둡니다. 어느 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초에 두 번 열려 있는 모든 대화를 확인하고, 플레이어가 16스터드보다 멀어지거나 캐릭터가 죽으면 대화를 닫습니다. 그래서 대화 도중 죽은 플레이어가 창이 열린 채로 리스폰되지 않습니다. 누군가 나가면 PlayerRemoving이 두 테이블을 모두 정리합니다.
4단계: 대화창 추가하기
StarterPlayer를 열고 StarterPlayerScripts에 마우스를 올려 DialogueClient라는 LocalScript를 넣은 다음 이 코드를 붙여 넣으세요. 대화창을 코드로 만들기 때문에 GUI를 손으로 그릴 필요가 없습니다.
-- StarterPlayer > StarterPlayerScripts에 있는 DialogueClient라는 LocalScript.
-- 서버가 보낸 대화를 그립니다. NPC 이름, 한 글자씩 나타나는
-- 대사, 머리 위 말풍선, 선택지마다 버튼 하나. 선택지를 클릭하면
-- 번호만 보냅니다. 다음에 무엇이 일어날지는 서버가 정합니다.
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) -- Roblox 도구 모음이 선택지를 가리지 않도록 84픽셀 위로 올립니다
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
-- 대사를 한 글자씩 표시합니다. 글자 수는 흐른 시간으로 계산하므로
-- 프레임 속도와 상관없이 속도가 같습니다.
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
-- 선택지마다 버튼 하나. 서버는 버튼 번호만 받습니다
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 -- 대사 하나에 클릭 한 번
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는 마음대로 바꿔도 됩니다. 마지막 두 핸들러는 그대로 두세요. 창이 서버와 소통하는 유일한 방법입니다.
DialogueClient의 각 부분이 하는 일:
- 창. 화면 아래쪽 가운데에 고정된 Frame이 있는 ScreenGui로, 화면 너비의 60%와 높이의 34%를 차지하며, 넓은 모니터 전체로 늘어나지 않도록
UISizeConstraint로 720 x 300픽셀까지 제한합니다. NPC 대사는TextScaled를 써서 작은 휴대폰 화면에서는 레이블에 맞게 텍스트가 줄어들고,UITextSizeConstraint가 큰 화면에서 20픽셀보다 커지지 않게 막습니다.UIGridLayout은 선택지를 2 x 2로 배치합니다.ResetOnSpawn이 false인 이유는 이 LocalScript가 세션당 한 번만 실행되기 때문입니다. 리스폰할 때 지워진 창은 다시 돌아오지 않습니다. - 타자기 효과. 대사 전체가 한 번에 TextLabel에 들어가고,
MaxVisibleGraphemes가 몇 글자를 보여 줄지 정합니다. Roblox의 타자기 예제가utf8.graphemes와 함께 쓰는 바로 그 속성입니다. Roblox는 모든 글자가 보이는 것처럼 텍스트를 배치하므로, 글자가 나타나는 동안 단어가 다음 줄로 넘어가거나 크기가 바뀌지 않습니다. 스크립트는 흐른 시간으로 보여 줄 글자 수를 계산해 1초에 45글자씩 보여 주므로 프레임 속도와 상관없이 속도가 같고, 마지막에 속성을 -1로 설정해 전부 보여 줍니다. - 버튼. 대사가 다 나오면 나타납니다. 각 버튼은 자기 번호만 한 번 보냅니다.
lineNumber검사가 더블 클릭으로 두 번 보내는 것을 막고, 그 뒤 창은 서버의 다음 대사를 기다립니다. - 말풍선 대사.
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를 누르고 그 선택지를 두 번 고르세요. 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가 만든 변경은 그 기기 하나에만 남고(무엇이 복제되는지 참고), 치터는 같은 코드를 언제든 실행할 수 있습니다. | 모든 동작은 DialogueService에 있습니다. |
game:GetService("Chat"):Chat(head, text)로 NPC가 말하게 함 | Chat 서비스는 더 이상 권장되지 않으며 TextChatService로 대체되었습니다. | LocalScript에서 TextChatService:DisplayBubble. |
| 클라이언트에서 보상 이름이나 다음 대사 id를 보냄 | 치터가 아무 아이템 이름이나 보내거나, 보상을 주는 대사로 바로 건너뛸 수 있습니다. | 클라이언트는 선택지 번호만 보냅니다. 서버는 플레이어가 읽고 있다고 알고 있는 대사에서 그 번호를 찾습니다. |
| 프롬프트가 발동한 뒤 아무것도 확인하지 않음 | Roblox 보안 가이드는 ProximityPrompt를 리모트와 함께 클라이언트가 악용할 수 있는 대상으로 꼽고, 동작 전에 플레이어가 충분히 가까운지 확인하라고 조언합니다. | 거리는 대화를 시작할 때, 클릭할 때마다, 그리고 대화가 열려 있는 동안 1초에 두 번 확인합니다. |
반복문에서 wait()로 텍스트를 표시 | 전역 wait는 더 이상 권장되지 않으며 task.wait로 대체되었습니다. | os.clock()으로 보이는 글자 수를 계산하고 task.wait()로 기다립니다. |
플레이어가 조작할 수 있는 것과 없는 것
치터가 자기 기기의 모든 것을 제어한다고 가정하세요. Roblox 보안 가이드가 경고하듯, 치터는 여러분의 LocalScript와 ReplicatedStorage의 모든 것을 읽고, 원하는 인수로 DialogueEvent를 몇 번이고 호출하고, 코드로 Talk 프롬프트를 발동할 수 있습니다. DialogueService는 RemoteEvent 인수 검증 섹션에서 다루는 것과 같은 종류의 서버 검사로 대응합니다. 치터가 이걸로 얻는 결과는 다음과 같습니다.
| 치터의 시도 | 결과 | 이유 |
|---|---|---|
| 맵 반대편에서 Talk 프롬프트 발동 | 아무 일도 일어나지 않음 | startConversation이 16스터드(12 더하기 4) 안에 있는지 확인합니다. |
| 선택지 99, 문자열, 소수, NaN 보내기 | 무시됨 | 정수가 아니거나, 읽고 있는 대사에 그런 선택지가 없습니다. |
| 보상 이름이나 대사 id 보내기 | 절대 읽히지 않음 | 서버는 선택지 번호만 읽습니다. 보상은 서버 쪽 대사 사본의 item과 action 필드에서 가져옵니다. |
| 네트워크가 허용하는 한 최대한 빨리 클릭 | 대화당 0.3초에 클릭 한 번 | 더 빠른 클릭에는 그 대사가 그대로 돌아옵니다. 대화를 끝냈다가 다시 시작하면 이 대기를 우회할 수 있으므로, Heal과 GiveItem은 자체 제한을 둡니다. |
| 대화 없이 횃불 요청 | 불가능 | 아이템은 서버가 플레이어가 있다고 알고 있는 대사의 선택지로만 지급됩니다. |
| 횃불을 잔뜩 모으기 | 한 번에 하나 | 서버는 먼저 Backpack과 캐릭터에서 Torch를 찾고, 지급한 횃불은 버릴 수 없으므로 버렸다가 다시 달라고 해서 모을 수 없습니다. |
| 회복 대사 연타 | 30초에 한 번 회복 | 쿨다운은 서버에 플레이어별로 저장되고, NPC가 healTooSoon 대사로 알려 줍니다. |
| 멀리 가서 창을 열어 두기 | 0.5초 안에 닫힘 | 서버가 1초에 두 번 열려 있는 모든 대화를 확인합니다. |
| 아직 도달하지 않은 대사를 포함해 대화 전체 읽기 | 가능 | DialogueData는 모든 기기에 복사되는 ReplicatedStorage에 있습니다. 중요하다면 ServerStorage로 옮기세요(2단계 참고). |
한 가지 한계는 분명히 말해 둘 필요가 있습니다. Guide에게 다가가 선택지를 고르는 치터는 정직한 플레이어와 정확히 같은 것을 얻습니다. 서버는 얼마나 자주, 어디서인지는 통제하지만, 누구인지는 통제하지 않습니다. 플레이어마다 한 번만 받을 수 있는 보상처럼 드문 것에는, 받았을 때 설정하는 속성이나 데이터 저장소에 저장한 플래그처럼 서버가 소유하는 검사가 필요합니다.
5단계: 테스트하기
- Play(F5)를 누르고 Guide에게 다가가세요. 12스터드 안에 들어가면 Guide 이름이 적힌 Talk 프롬프트가 나타납니다. E를 누르세요.
- 창에 "Guide"가 표시되고, 환영 대사가 한 글자씩 나온 뒤 버튼 네 개가 나타납니다. 같은 대사가 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를 눌러도 손에 그대로 남아 있습니다. 다시 달라고 하면 두 번째 횃불은 없고, Guide가 이미 가지고 있다고 말합니다.
- 대화를 시작하고 멀어지세요. Guide에게서 16스터드쯤 멀어지면 창이 닫힙니다.
- 테스트 모드 드롭다운에서 Server & Clients를 고르고 클라이언트를 2로 설정한 뒤 Play를 누르세요. 두 플레이어가 동시에 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 폴더에 자기 이름을 가진 리그를 하나 더 넣고, DialogueData에 같은 이름과 start 대사가 있는 테이블을 추가하세요. DialogueService는 게임 중에 추가된 것을 포함해 폴더 안에서 HumanoidRootPart가 있는 모든 모델에 Talk 프롬프트를 붙이며, NPC 복사본은 복사해 온 프롬프트 대신 새 프롬프트를 받습니다. 이름이 같은 NPC 두 개는 같은 테이블을 씁니다. 대사는 어떤 순서로든 연결할 수 있고, "Anything else?"처럼 선택지가 앞쪽 대사로 돌아갈 수도 있습니다. 창이 선택지를 2 x 2로 배치하므로 대사당 선택지는 네 개 이하로 두세요.
진행 상황에 따라 달라지는 대사
돌아온 플레이어를 다르게 맞이하려면, 서버가 소유한 정보로 첫 대사를 고르세요. startConversation에서 local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start"로 고르고, 스크립트가 lines.start를 확인하듯 그 대사가 있는지 확인한 다음, 대화를 만들 때 "start" 대신 firstLine을 쓰세요. 속성은 동작에서 설정하고, Guide 테이블에 welcomeBack 대사를 추가하세요. 속성은 한 세션 동안만 유지됩니다. 방문 사이에도 플레이어를 기억하려면 DataStore 튜토리얼처럼 플래그를 데이터 저장소에 저장하세요.
상점 NPC
상점 GUI 가이드로 상점을 만든 다음, 그 플레이어에게 RemoteEvent를 보내고 true를 돌려주는 OpenShop 동작을 추가하고, 그 이벤트가 오면 상점 LocalScript가 자기 창을 열게 하세요. 구매는 여전히 상점 자체의 서버 검사를 거칩니다. NPC 근처에서만 살 수 있게 하려면 구매 핸들러 안에서도 거리를 확인하세요. 클라이언트는 어디서든 상점 리모트를 호출할 수 있기 때문입니다.
걸어 다니는 NPC
Guide가 돌아다니거나 플레이어를 따라가게 하려면 NPC pathfinding 가이드를 참고하고, 움직일 수 있도록 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가 만든 것이 아닌, Roblox Studio용 독립 AI 에이전트입니다. 웹 채팅에 입력하면 Studio 플러그인이 Explorer 안에서 스크립트를 만들고 수정합니다.
Workspace.NPCs의 Guide 모델이 말하게 만들어 줘: Talk 프롬프트, 한 글자씩 나오는 대사와 선택지 버튼이 있는 대화창, 머리 위 말풍선, 쿨다운 30초인 회복 선택지, 그리고 ServerStorage의 Torch 도구를 한 번 주는 선택지. 대화는 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는 여러 시스템 중 하나일 뿐입니다. AI로 Roblox 게임을 만드는 방법, 프롬프트 하나에 시스템 하나씩 페이지에서 이것들이 어떻게 합쳐지는지 보여 줍니다. RoCode가 Studio에 연결되는 방식.
자주 묻는 질문
Roblox Studio에서 말하는 NPC는 어떻게 만드나요?
NPC에 ProximityPrompt를 붙이고, 플레이어가 그것을 발동하면 NPC의 대사를 대화창이나 말풍선, 또는 둘 다에 보여 주세요. 이 가이드의 스크립트 세 개가 둘 다 하고 답변 선택지도 추가합니다. 말풍선만 필요하다면 Roblox의 bubble chat 페이지에 있는 NPC 예제처럼, 프롬프트가 발동할 때 LocalScript에서 TextChatService:DisplayBubble(npc.Head, "Hello!")를 호출하세요.
Dialog 오브젝트와 직접 만든 대화 GUI 중 무엇을 골라야 하나요?
Dialog 오브젝트는 코드가 필요 없고 클릭할 수 있는 말풍선을 보여 주므로, 장식용 텍스트에는 충분합니다. 하지만 선택 이벤트가 플레이어 기기에서만 발생하므로 보상을 안전하게 지급할 수 없고, 기본값으로는 한 번에 한 플레이어만 대화할 수 있습니다. 이 가이드처럼 직접 만든 창은 서버가 모든 보상을 지급하게 하고, 플레이어마다 자기 대화를 줍니다.
NPC가 플레이어에게 아이템을 주게 하려면 어떻게 하나요?
Tool을 ServerStorage에 두고, 플레이어가 그 선택지를 고르면 서버 Script가 플레이어의 Backpack으로 복제하게 하세요. GiveItem 동작이 그렇게 합니다. 플레이어가 이미 가지고 있지 않은지 확인하고, 복사본의 CanBeDropped를 꺼서 버렸다가 다시 달라고 할 수 없게 하세요. 어떤 아이템을 줄지 플레이어 기기가 알려 주게 해서는 절대 안 됩니다.
타자기 효과가 있는 대화창은 어떻게 만드나요?
대사 전체를 TextLabel에 넣고, MaxVisibleGraphemes를 0부터 몇 글자씩 늘린 다음, 마지막에 -1로 설정해 전부 보여 주세요. Roblox의 UI 애니메이션 페이지도 같은 속성을 utf8.graphemes와 함께 씁니다. DialogueClient는 흐른 시간으로 보여 줄 글자 수를 계산해 1초에 45글자씩 보여 주므로, 속도가 프레임 속도에 좌우되지 않습니다.
두 플레이어가 같은 NPC와 동시에 대화할 수 있나요?
이 가이드의 스크립트라면 가능합니다. 서버가 플레이어마다 대화 하나씩을 진행하고, 각 플레이어는 자기 창만 봅니다. 기본 제공 Dialog 오브젝트는 다릅니다. 기본 BehaviorType인 SinglePlayer에서는 한 번에 한 플레이어만 말하고, 나머지는 그 플레이어의 선택지를 봅니다.
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의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.