Singkatnya
Taruh model NPC kamu di folder bernama NPCs di Workspace dan tulis percakapannya di ModuleScript di ReplicatedStorage: setiap baris punya teks NPC dan daftar pilihan yang mengarah ke baris lain. Sebuah Script di ServerScriptService menambahkan ProximityPrompt ("Talk") ke setiap NPC, mengingat baris mana yang sedang dibaca tiap pemain dan mengirimnya dengan RemoteEvent. Sebuah LocalScript menampilkan teksnya dan satu tombol per pilihan, dan hanya mengirim balik nomor tombol yang ditekan.
- Berikan hadiah di server. Event
DialogChoiceSelectedmilik objek Dialog bawaan hanya terjadi di client, jadi Script server tidak pernah mendengarnya, dan heal atau item yang diberikan di LocalScript hanya mengubah salinan game milik pemain itu sendiri. - Tampilkan speech bubble dengan
TextChatService:DisplayBubble(npc.Head, text)dari LocalScript. ServiceChatyang lama sudah deprecated dan digantikan TextChatService. - Baris yang kamu tulis sendiri tidak perlu difilter. Aturan Roblox adalah memfilter teks tampil apa pun yang tidak kamu kendalikan secara eksplisit, seperti yang diketik pemain.
Di halaman ini
Cara kerja dialog NPC
NPC berbicara yang berfungsi di game live dibagi antara server dan perangkat setiap pemain. Perangkat menggambar kotak dan tombolnya. Server, satu-satunya sisi yang bisa kamu percaya, tahu baris mana yang sedang dibaca tiap pemain dan memutuskan apa yang dilakukan setiap jawaban. Satu giliran percakapan berjalan seperti ini:
- Pemain berjalan mendekati NPC dan menekan E pada prompt Talk-nya. Event
Triggeredmilik prompt terjadi di server dengan pemain itu. - Script server mengecek bahwa pemain cukup dekat, mencatat bahwa mereka ada di baris bernama
start, dan mengirim teks baris itu beserta label pilihannya hanya ke pemain itu. - LocalScript mengetik barisnya ke kotak dialog, menampilkan speech bubble di atas NPC, lalu menambahkan satu tombol per pilihan.
- Pemain mengklik, mengetuk atau memilih sebuah pilihan. Hanya nomornya yang kembali ke server.
- Server mencari nomor itu di baris yang diketahuinya sedang dibaca pemain, menjalankan aksi pilihan itu kalau ada (heal, item), dan mengirim baris berikutnya atau menutup kotaknya.
| Bagian | Tempatnya | Fungsinya |
|---|---|---|
Rig Guide | Workspace, di folder bernama NPCs | NPC-nya. Namanya menentukan percakapannya dan ditampilkan di prompt. |
ModuleScript DialogueData | ReplicatedStorage | Setiap baris yang bisa diucapkan NPC, pilihan di bawah setiap baris dan ke mana setiap pilihan mengarah. |
Script DialogueService | ServerScriptService | Menambahkan prompt Talk, mengingat baris mana yang sedang dibaca tiap pemain, mengecek setiap klik dan menjalankan aksinya. |
RemoteEvent DialogueEvent | ReplicatedStorage (dibuat DialogueService) | Membawa setiap baris ke pemain, dan nomor pilihan yang diklik kembali ke server. |
LocalScript DialogueClient | StarterPlayer, StarterPlayerScripts | Menggambar kotaknya, mengetik barisnya, menampilkan speech bubble dan tombol pilihan. |
Tool Torch (opsional) | ServerStorage, di folder bernama DialogueItems | Item yang diberikan salah satu pilihan. Tidak ada isi ServerStorage yang dikirim ke pemain. |
Workspace
NPCs Folder new
Guide Model new
Humanoid Humanoid
HumanoidRootPart Part
Head, UpperTorso, LowerTorso ... (bagian tubuh)
ReplicatedStorage
DialogueData ModuleScript new
ServerScriptService
DialogueService Script new
ServerStorage
DialogueItems Folder new
Torch Tool new
Handle Part new
StarterPlayer
StarterPlayerScripts
DialogueClient LocalScript new
Langkah 1: Tambahkan NPC
- Di tab Avatar atau Home, klik Character untuk membuka Rig Generator. Pilih R15, bentuk tubuh dan gayanya. Rig bernama
Rigmuncul di Workspace. Rig R6 berfungsi dengan script yang sama. - Ganti namanya menjadi
Guide. Namanya penting: DialogueService mencari percakapan berdasarkan nama model, dan prompt menampilkannya ke pemain. - Buka isi rig, pilih HumanoidRootPart-nya dan centang Anchored di jendela Properties. Part yang di-anchor tidak pernah bergerak karena fisika, jadi NPC berdiri di tempat kamu menaruhnya dan pemain tidak bisa mendorongnya.
- Arahkan kursor ke Workspace di Explorer, klik tombol + dan sisipkan Folder bernama
NPCs. Seret Guide ke dalamnya, dan taruh rig di tempat yang bisa didatangi pemain. - Opsional, untuk pilihan item: arahkan kursor ke ServerStorage dan sisipkan Folder bernama
DialogueItems. Taruh Tool bernamaTorchdi dalamnya, dengan satu Part yang tidak di-anchor bernamaHandle, yaitu part yang dipegang karakter. PointLight di dalam Handle membuatnya menyala.
Nama membedakan huruf besar dan kecil, jadi ketik NPCs, Guide, DialogueItems dan Torch persis seperti yang ditunjukkan. Model apa pun dengan Humanoid dan HumanoidRootPart bisa menjadi NPC, termasuk yang dari Toolbox, selama berada langsung di dalam folder NPCs.
Langkah 2: Tulis percakapannya
Arahkan kursor ke ReplicatedStorage, sisipkan ModuleScript bernama DialogueData dan tempel ini. Module ini tidak berisi logika, hanya kata-kata dan cara mereka terhubung, jadi inilah file yang paling sering kamu edit.
-- ModuleScript di ReplicatedStorage bernama DialogueData.
-- Setiap percakapan, dengan key nama NPC di Workspace.NPCs. Setiap baris punya
-- teks NPC dan pilihan pemain. Sebuah pilihan bisa mengarah ke baris lain (next),
-- mengakhiri pembicaraan (tanpa next) dan meminta server melakukan sesuatu (action). Kalau server
-- tidak bisa melakukan aksinya, yang ditampilkan adalah baris failNext, bukan next.
export type Choice = {
text: string,
next: string?, -- baris yang ditampilkan setelah pilihan ini; nil mengakhiri percakapan
action: string?, -- aksi server dari table ACTIONS milik DialogueService
item: string?, -- untuk aksi GiveItem: nama Tool di ServerStorage.DialogueItems
failNext: string?, -- baris yang ditampilkan sebagai ganti next saat aksinya tidak bisa dilakukan
}
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
Baris export type di bagian atas menjelaskan seperti apa bentuk sebuah baris dan sebuah pilihan. Baris itu tidak mengubah apa pun saat game berjalan; isinya menjelaskan datamu supaya type checker bisa mengeceknya.
Cara bagian-bagiannya terhubung:
- Setiap NPC punya table yang dinamai sesuai modelnya di folder NPCs, di sini
Guide. Setiap percakapan mulai di baris bernamastart. textadalah ucapan NPC.choicesadalah tombol pemain, secara berurutan. Kotaknya muat empat.nextmenyebut baris yang ditampilkan setelah pilihan itu. Pilihan tanpanext, seperti "Bye!", mengakhiri percakapan.nextataufailNextyang menyebut baris yang tidak ada di table juga mengakhirinya, dengan peringatan di Output.actionmenyebut sesuatu yang dilakukan server, dari tableACTIONSdi DialogueService: di siniHealatauGiveItem.itemdipakai GiveItem: nama sebuah Tool di ServerStorage, DialogueItems.failNextadalah baris yang ditampilkan sebagai gantinextsaat aksinya tidak bisa dilakukan, jadi NPC tidak pernah mengaku memberi heal atau hadiah yang tidak terjadi.
| Baris | Guide berkata | Pilihan, dan ke mana arahnya |
|---|---|---|
start | "Welcome to the village! What can I do for you?" | "Any tips?" mengarah ke tips. "I'm hurt. Can you help?" memberi heal, lalu healed (atau healTooSoon). "Got anything for the cave?" memberi Torch, lalu torch (atau hasTorch). "Bye!" mengakhiri. |
tips | "Stay off the red bricks, and come back if you get hurt." | "Anything else?" kembali ke start. "Thanks!" mengakhiri. |
healed | "There you go, good as new." | "Thank you!" mengakhiri. |
torch | "Take this torch. The cave is dark." | "Thanks!" mengakhiri. |
healTooSoon | "I healed you a moment ago. Come back in a little while." | "OK" mengakhiri. |
hasTorch | "You already have my torch. Keep it lit!" | "Will do!" mengakhiri. |
Hanya server yang membaca module ini. LocalScript tidak pernah me-require-nya: server mengirim setiap baris saat pemain sampai ke baris itu. Namun module di ReplicatedStorage tetap disalin ke perangkat setiap pemain, jadi kalau sebuah percakapan berisi spoiler (jawaban teka-teki, misalnya), pindahkan DialogueData ke ServerStorage. Lalu, di baris require milik DialogueService, ganti ReplicatedStorage dengan ServerStorage, sehingga seluruh barisnya berbunyi local DialogueData = require(ServerStorage:WaitForChild("DialogueData")) :: { [string]: { [string]: Line } }.
Langkah 3: Tambahkan script server
Arahkan kursor ke ServerScriptService, sisipkan Script bernama DialogueService dan tempel kode di bawah. Inilah satu-satunya tempat percakapan bergerak maju dan satu-satunya tempat hadiah diberikan.
-- Script di ServerScriptService bernama DialogueService.
-- Menambahkan prompt Talk ke setiap NPC di Workspace.NPCs dan menjalankan setiap percakapan.
-- Perangkat pemain hanya menampilkan teksnya dan mengirim balik nomor pilihan
-- yang mereka klik. Server tahu baris mana yang sedang dibaca tiap pemain, mengecek pilihannya
-- dan jaraknya, dan merupakan satu-satunya sisi yang memberi heal atau item.
local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local ServerStorage = game:GetService("ServerStorage")
-- Bentuk yang sama seperti di DialogueData, supaya type checker Studio juga mengenalnya di sini
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 -- stud: jangkauan prompt, dan seberapa dekat pemain harus tetap berada
local MIN_SECONDS_BETWEEN_CHOICES = 0.3
local HEAL_COOLDOWN_SECONDS = 30
local npcFolder = workspace:WaitForChild("NPCs")
local itemFolder = ServerStorage:FindFirstChild("DialogueItems")
-- Script ini membuat DialogueEvent sendiri, jadi jangan menambahkannya secara manual
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 -- tidak ada karakter, karakternya mati, atau NPC-nya sudah tidak ada
end
-- sedikit ruang tambahan, karena posisi pemain sampai ke server agak terlambat
return (playerRoot.Position - npcRoot.Position).Magnitude <= TALK_DISTANCE + 4
end
-- Yang dilakukan server saat sebuah pilihan punya aksi. Masing-masing mengembalikan true kalau berhasil.
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 -- baru saja di-heal
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 -- belum ada backpack, atau mereka sudah punya satu
end
local item = template:Clone() :: Tool
item.CanBeDropped = false -- supaya tidak ada yang bisa menjatuhkannya lalu minta lagi
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 -- sudah berbicara, tidak ada baris "start" untuk NPC ini, mati atau terlalu jauh
end
local conversation = { npc = npc, npcName = npcName, lineId = "start", lastChoice = 0 }
conversations[player] = conversation
showLine(player, conversation)
end
-- Pemain mengklik pilihan nomor choiceIndex (0 berarti mereka menutup kotaknya)
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
-- Terlalu cepat. Kirim baris yang sama lagi, karena kotaknya sudah mengunci
-- tombolnya setelah klik dan kalau tidak akan menunggu jawaban selamanya.
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 -- tidak ada pilihan seperti itu di baris yang sedang dibaca pemain ini
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 -- misalnya "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)
-- Prompt Talk di setiap NPC
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() -- salinan NPC membawa prompt lama, yang tidak didengarkan apa pun
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)
-- Tutup kotaknya untuk siapa pun yang berjalan pergi atau mati di tengah percakapan
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 sendiri yang membuat RemoteEvent DialogueEvent saat game dimulai, jadi tidak ada yang perlu disisipkan ke ReplicatedStorage secara manual. Kalau kamu sudah membuat RemoteEvent dengan nama itu, hapus: LocalScript bisa menemukan milikmu, yang tidak didengarkan apa pun di server.
| Pengaturan | Nilai di sini | Yang diubahnya |
|---|---|---|
TALK_DISTANCE | 12 | Seberapa dekat, dalam stud, pemain harus berada supaya prompt Talk muncul. Server membiarkan mereka menjauh 4 stud lagi sebelum menutup kotaknya, karena posisi mereka sampai ke server agak terlambat. |
MIN_SECONDS_BETWEEN_CHOICES | 0.3 | Waktu terpendek antara dua klik yang diterima server. Klik yang lebih cepat mendapat baris yang sama dikirim lagi, bukan jawaban. |
HEAL_COOLDOWN_SECONDS | 30 | Lama setiap pemain menunggu di antara heal dari aksi Heal. |
Server menyimpan satu entri per pemain di conversations: NPC mana yang sedang mereka ajak bicara, baris mana yang sedang mereka baca dan kapan klik terakhir mereka diterima. Saat prompt Talk terpicu, startConversation membuat entri itu hanya kalau pemain belum sedang berbicara, NPC-nya punya baris start dan pemain hidup serta dalam jangkauan. Setelah itu, setiap klik melewati pengecekan ini:
| Pengecekan | Kode | Kalau gagal |
|---|---|---|
| Pemain sedang dalam percakapan | conversations[player] | Kliknya diabaikan. |
| Pilihannya bilangan bulat | typeof dan math.floor | Diabaikan. String, table, pecahan dan NaN semuanya berhenti di sini. |
| 0 berarti pemain menekan X | choiceIndex == 0 | Percakapan berakhir. |
| Hidup dan masih dalam 16 stud (12 ditambah 4) | isClose | Percakapan berakhir dan kotaknya tertutup. |
| Sedikitnya 0,3 detik sejak klik terakhir yang diterima | conversation.lastChoice | Baris yang sama dikirim lagi, jadi kotaknya mendapat tombol baru dan tidak menunggu selamanya. |
| Pilihannya ada di baris yang sedang dibaca pemain ini | line.choices[choiceIndex] | Diabaikan. |
| Aksinya berhasil | setiap aksi mengembalikan true atau false | Baris failNext ditampilkan sebagai ganti next. |
Prompt ditaruh di HumanoidRootPart NPC, karena ProximityPrompt berfungsi saat berada di dalam part (atau attachment, atau model dengan PrimaryPart) di Workspace. RequiresLineOfSight-nya menyala secara default, yang menyembunyikan prompt setiap kali ada yang menghalangi pandangan dari kamera ke part itu. Roblox mengecualikan part milik prompt sendiri dari pengecekan itu, tapi tidak bagian tubuh lainnya, dan HumanoidRootPart berada di dalam torso, jadi script mematikan line of sight. Prompt-nya bernama TalkPrompt, dan script menghapus TalkPrompt yang sudah ada di part itu sebelum menambahkan miliknya: salinan NPC yang dibuat saat game berjalan datang dengan prompt aslinya, dan tidak ada yang mendengarkan prompt salinan. Kalau DialogueData tidak punya percakapan dengan baris start untuk nama NPC itu, Output menampilkan peringatan yang menyebut nama NPC-nya.
Sebuah loop mengecek setiap percakapan yang terbuka dua kali per detik dan menutupnya saat pemain berada lebih dari 16 stud jauhnya atau karakternya mati, jadi pemain yang mati di tengah percakapan tidak respawn dengan kotak yang masih terbuka. PlayerRemoving membersihkan kedua table saat seseorang keluar.
Langkah 4: Tambahkan kotak dialog
Buka StarterPlayer, arahkan kursor ke StarterPlayerScripts, sisipkan LocalScript bernama DialogueClient dan tempel ini. Script ini membuat kotak dialog dengan kode, jadi tidak ada GUI yang perlu digambar secara manual.
-- LocalScript di StarterPlayer > StarterPlayerScripts bernama DialogueClient.
-- Menggambar percakapan yang dikirim server: nama NPC, barisnya yang diketik huruf
-- demi huruf, speech bubble di atas kepalanya dan satu tombol per pilihan. Mengklik sebuah
-- pilihan hanya mengirim nomornya; server yang memutuskan apa yang terjadi berikutnya.
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)
-- Kotak dialognya, dibuat dengan kode
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 piksel ke atas, supaya tool bar Roblox tidak pernah menutupi pilihannya
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 -- baris panjang mengecil supaya muat di layar ponsel yang kecil
lineLabel.TextWrapped = true
lineLabel.TextYAlignment = Enum.TextYAlignment.Top
lineLabel.FontFace = REGULAR
lineLabel.Parent = box
local lineTextLimit = Instance.new("UITextSizeConstraint")
lineTextLimit.MaxTextSize = 20 -- dan tidak pernah membesar melewati 20 piksel di layar besar
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 -- naik di setiap baris baru, supaya loop pengetikan lama berhenti
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 -- diubah hanya di perangkat ini
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()
-- Speech bubble di atas NPC (DisplayBubble hanya berfungsi di LocalScript)
local head = npc:FindFirstChild("Head")
if head then
TextChatService:DisplayBubble(head, text)
end
-- Ketik barisnya, huruf demi huruf. Hitungannya berasal dari waktu yang berlalu,
-- jadi kecepatannya sama di frame rate berapa pun.
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 -- baris yang lebih baru atau penutupan menggantikan yang ini
end
shown = math.min(letters, math.floor((os.clock() - startTime) * LETTERS_PER_SECOND))
lineLabel.MaxVisibleGraphemes = shown
end
lineLabel.MaxVisibleGraphemes = -1
-- Satu tombol per pilihan; server hanya pernah menerima nomor tombolnya
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 -- satu klik per baris
dialogueEvent:FireServer(index)
end
end)
if index == 1 and UserInputService.PreferredInput == Enum.PreferredInput.Gamepad then
GuiService.SelectedObject = button -- supaya controller bisa memilih sebuah pilihan
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)
Warna, ukuran dan LETTERS_PER_SECOND bebas kamu ubah. Biarkan dua handler terakhir apa adanya: itulah satu-satunya cara kotak berkomunikasi dengan server.
Fungsi setiap bagian DialogueClient:
- Kotaknya. Sebuah ScreenGui dengan Frame yang ditambatkan di tengah bawah layar, 60% lebarnya dan 34% tingginya, dibatasi 720 kali 300 piksel oleh
UISizeConstraintsupaya tidak melebar di monitor lebar. Baris NPC memakaiTextScaled, yang mengecilkan teks supaya muat di dalam label-nya di layar ponsel yang kecil, danUITextSizeConstraintmencegahnya membesar melewati 20 piksel di layar besar.UIGridLayoutmenata pilihannya dua kali dua.ResetOnSpawnbernilai false karena LocalScript ini berjalan sekali per sesi: kotak yang terhapus saat respawn tidak akan pernah kembali. - Efek mesin tik. Seluruh baris masuk ke TextLabel sekaligus, dan
MaxVisibleGraphemesmenentukan berapa karakter yang tampil, properti yang sama yang dipakai contoh typewriter Roblox sendiri denganutf8.graphemes. Roblox menata teksnya seolah setiap karakter terlihat, jadi kata-kata tidak melompat ke baris baru atau berubah ukuran saat muncul. Script menghitung berapa yang ditampilkan dari waktu yang sudah berlalu, 45 per detik, jadi kecepatannya sama di frame rate berapa pun, lalu mengatur propertinya ke -1, yang menampilkan semuanya. - Tombolnya. Tombol muncul begitu baris selesai diketik. Masing-masing hanya mengirim nomornya, sekali: pengecekan
lineNumbermencegah klik ganda mengirim dua kali, dan kotaknya lalu menunggu baris berikutnya dari server. - Speech bubble.
TextChatService:DisplayBubble(head, text)menaruh barisnya di chat bubble di atas Head NPC. Roblox hanya mengizinkannya di script client, dan bubble chat menyala secara default. Karena perangkat pemain ini yang menggambarnya, bubble itu hanya milik mereka. - Prompt-nya. Selagi pemain berbicara, salinan prompt Talk milik mereka (dicari lewat namanya, TalkPrompt) dimatikan, supaya tidak menumpuk di atas percakapan. Pemain lain masih melihat milik mereka.
- Setiap perangkat.
Activatedterjadi untuk klik mouse, ketukan di ponsel dan tombol A di controller. Controller hanya bisa menekan tombol yang sedang terpilih, jadi saatPreferredInputmenyatakan pemain memakai gamepad, script memilih pilihan pertama denganGuiService.SelectedObject. - Tombol X. Tombol ini mengirim 0, yang dianggap server sebagai "akhiri percakapan", dan langsung menutup kotaknya.
Tambahkan aksimu sendiri
Aksi adalah function di table ACTIONS di dekat bagian atas DialogueService. Function itu menerima pemain dan pilihannya, dan mengembalikan true kalau tugasnya berhasil. Untuk menambah satu, misalnya quest yang diberikan NPC:
- Tambahkan entri ke
ACTIONSbernamaStartQuest. Cek dulu, baru ubah: kalauplayer:GetAttribute("Quest")sudah terisi, kembalikanfalse; kalau belum, panggilplayer:SetAttribute("Quest", "Cave")dan kembalikantrue. - Di DialogueData, beri sebuah pilihan
action = "StartQuest", barisnextuntuk saat berhasil dan barisfailNextuntuk saat tidak, misalnya "You are already on a quest." - Tekan Play dan ambil pilihan itu dua kali. Kalau nama di DialogueData tidak cocok dengan key di
ACTIONS(huruf kapital dihitung), Output menampilkanDialogueService: no action named StartQuestdan percakapan pindah ke barisfailNext.
Aturan menulis aksi:
- Lakukan pengecekan dan perubahannya di dalam aksi, di server. Satu-satunya yang dikirim perangkat pemain adalah nomor pilihan.
- Baca apa yang dibutuhkan aksi dari pilihannya (seperti
item) atau dari state milik server sendiri, jangan pernah dari remote. - Batasi apa pun yang berharga di dalam aksi itu sendiri, seperti Heal yang menyimpan cooldown 30 detiknya sendiri di
lastHeal. Batas klik 0,3 detik hanya memperlambat klik; itu tidak mencegah pemain melewati pilihan yang sama berulang-ulang. - Untuk membuka jendela lain, misalnya toko, sebuah aksi bisa memicu RemoteEvent ke pemain itu dan mengembalikan
true. Apa pun yang terjadi di jendela itu tetap butuh pengecekan servernya sendiri, seperti di NPC penjaga toko.
Kesalahan di tutorial dialog NPC lain
Kalau kamu membandingkan panduan ini dengan video atau postingan forum, inilah perbedaan yang penting, beserta alasan tiap pola bermasalah.
| Tutorialnya | Masalahnya | Panduan ini |
|---|---|---|
Memakai objek Dialog, dengan Script server yang mendengarkan DialogChoiceSelected untuk memberi hadiah | Referensi Roblox menyebut event itu hanya di sisi client dan tidak akan terjadi di server, jadi hadiahnya tidak pernah datang. | Pilihannya sampai ke server sebagai angka, dan server yang menjalankan hadiahnya. |
| Memberi hadiah dari LocalScript | Perubahan yang dibuat LocalScript tetap di satu perangkat itu (lihat apa yang direplikasi, dalam bahasa Inggris), dan cheater bisa menjalankan kode yang sama kapan pun mereka mau. | Setiap aksi ada di DialogueService. |
Membuat NPC berbicara dengan game:GetService("Chat"):Chat(head, text) | Service Chat sudah deprecated dan digantikan TextChatService. | TextChatService:DisplayBubble di LocalScript. |
| Mengirim nama hadiah atau id baris berikutnya dari client | Cheater bisa mengirim nama item apa pun, atau langsung melompat ke baris yang memberi hadiah. | Client hanya mengirim nomor pilihan. Server mencarinya di baris yang diketahuinya sedang dibaca pemain. |
| Tidak mengecek apa pun setelah prompt terpicu | Panduan keamanan Roblox mencantumkan ProximityPrompt di samping remote sebagai sesuatu yang bisa disalahgunakan client, dan meminta pengecekan apakah pemain cukup dekat sebelum bertindak. | Jaraknya dicek saat percakapan dimulai, pada setiap klik dan dua kali per detik selama terbuka. |
Mengetik teksnya dengan wait() dalam loop | wait global sudah deprecated dan digantikan task.wait. | Menghitung huruf yang ditampilkan dari os.clock(), menunggu dengan task.wait(). |
Apa yang bisa dan tidak bisa dipalsukan pemain
Anggap cheater mengendalikan segala sesuatu di perangkatnya sendiri. Mereka bisa membaca LocalScript kamu dan apa pun di ReplicatedStorage, memicu DialogueEvent dengan argumen apa pun sesering yang mereka mau, dan memicu prompt Talk dari kode, yang diperingatkan panduan keamanan Roblox. DialogueService menjawabnya dengan pengecekan server sejenis yang dibahas di validasi argumen RemoteEvent. Inilah yang mereka dapatkan dari semua itu.
| Cheater mencoba | Hasil | Alasannya |
|---|---|---|
| Memicu prompt Talk dari seberang map | Tidak terjadi apa-apa | startConversation mengecek bahwa mereka berada dalam 16 stud (12 ditambah 4). |
| Mengirim pilihan 99, string, pecahan atau NaN | Diabaikan | Itu bukan bilangan bulat, atau tidak ada pilihan seperti itu di baris yang sedang mereka baca. |
| Mengirim nama hadiah atau id baris | Tidak pernah dibaca | Server hanya membaca nomor pilihan. Hadiah berasal dari field item dan action di salinan baris milik server. |
| Mengklik secepat yang diizinkan jaringan | Satu klik per 0,3 detik per percakapan | Klik yang lebih cepat mendapat barisnya sendiri dikirim balik. Mengakhiri dan memulai lagi pembicaraan melewati jeda itu, dan itulah sebabnya Heal dan GiveItem menyimpan batasnya sendiri. |
| Meminta torch tanpa berbicara | Mustahil | Item hanya datang dari pilihan di baris yang diketahui server sedang mereka baca. |
| Mengumpulkan setumpuk torch | Satu per satu | Server lebih dulu mengecek Backpack dan karakter mereka untuk Torch, dan torch yang diberikannya tidak bisa dijatuhkan, jadi tidak bisa di-farm dengan menjatuhkannya lalu meminta lagi. |
| Men-spam baris heal | Satu heal setiap 30 detik | Cooldown-nya disimpan per pemain di server, dan NPC mengatakannya dengan baris healTooSoon. |
| Berjalan pergi dan membiarkan kotaknya terbuka | Tertutup dalam setengah detik | Server mengecek setiap percakapan yang terbuka dua kali per detik. |
| Membaca seluruh percakapan, termasuk baris yang belum mereka capai | Mungkin | DialogueData ada di ReplicatedStorage, yang disalin ke setiap perangkat. Pindahkan ke ServerStorage kalau itu penting (lihat Langkah 2). |
Satu batasan layak dijawab terus terang: cheater yang berjalan mendekati Guide dan mengambil pilihannya mendapat persis apa yang didapat pemain jujur. Server mengendalikan seberapa sering dan dari mana, bukan siapa. Apa pun yang langka, seperti hadiah yang hanya boleh diklaim sekali oleh tiap pemain, butuh pengecekan yang dimiliki server, seperti atribut yang diatur saat diklaim atau flag yang disimpan dengan data store.
Langkah 5: Tes
- Tekan Play (F5) dan berjalanlah ke Guide. Dalam jarak 12 stud, muncul prompt Talk dengan nama Guide. Tekan E.
- Kotaknya menampilkan "Guide", mengetik baris sambutan lalu menampilkan empat tombol. Baris yang sama muncul di speech bubble di atas kepala NPC.
- Pilih "Any tips?", lalu "Anything else?": kamu kembali ke baris pertama. Pilih "Bye!": kotaknya tertutup dan prompt Talk kembali.
- Lukai dirimu dulu: klik toggle Client/Server untuk pindah ke Server, pilih Humanoid karaktermu di Workspace, atur Health ke 50 di jendela Properties dan pindah kembali ke Client. Karakter pemain memulihkan 1% MaxHealth-nya setiap detik, jadi langsung bicara dengan Guide dan pilih "I'm hurt. Can you help?": health kamu langsung penuh. Bicara lagi dalam 30 detik dan pilih itu lagi: tidak ada heal, dan Guide bilang baru saja memberimu heal.
- Pilih "Got anything for the cave?": Torch muncul di hotbar kamu. Pegang dan tekan Backspace: Torch tetap di tanganmu. Minta lagi: tidak ada torch kedua, dan Guide bilang kamu sudah memilikinya.
- Mulai bicara, lalu berjalan pergi. Kotaknya tertutup kira-kira begitu kamu berada 16 stud dari Guide.
- Pilih Server & Clients di dropdown mode tes, atur 2 client dan tekan Play. Kedua pemain bisa berbicara dengan Guide pada saat yang sama, masing-masing di barisnya sendiri.
- Cek controller dengan Controller Emulator (Controller, di tab Emulation) saat playtest. Pakai pad yang diemulasikan untuk berjalan mendekat dan menekan tombol prompt (ButtonX secara default): saat pilihannya muncul, yang pertama sudah terpilih, dan A mengambilnya.
- Cek layar ponsel dengan Device Simulator milik Studio (masih beta saat panduan ini ditulis: nyalakan New Device Simulator di File, Beta Features, dan restart Studio). Pilih sebuah ponsel, klik Rotate sampai posisinya landscape, tekan Play, berjalanlah ke Guide dan ketuk prompt Talk. Pilih "Any tips?": seluruh barisnya tampil di atas tombol pilihan, dengan teks lebih kecil kalau perlu, tanpa menabrak tombolnya.
Biarkan jendela Output terbuka (menu Window, lalu Output) sepanjang waktu. Script-script ini tidak mencetak apa pun saat berfungsi, jadi error merah atau peringatan yang diawali DialogueService: adalah masalah sungguhan. Lihat Error umum.
Mengembangkannya
Lebih banyak NPC dan percakapan yang lebih panjang
Tambahkan rig lain ke folder NPCs dengan namanya sendiri, dan table dengan nama yang sama di DialogueData yang punya baris start. DialogueService menambahkan prompt Talk ke setiap model di folder yang punya HumanoidRootPart, termasuk yang ditambahkan saat game berjalan; salinan NPC mendapat prompt baru sebagai ganti prompt yang ikut tersalin. Dua NPC dengan nama yang sama memakai table yang sama. Baris bisa terhubung dalam urutan apa pun, dan sebuah pilihan bisa mengarah kembali ke baris sebelumnya, seperti "Anything else?". Jaga setiap baris paling banyak empat pilihan, karena kotaknya menata pilihan dua kali dua.
Baris yang bergantung pada progres
Untuk menyapa pemain yang kembali dengan cara berbeda, pilih baris pertama dari sesuatu yang dimiliki server. Di startConversation, pilih dengan local firstLine = if player:GetAttribute("MetGuide") then "welcomeBack" else "start", cek bahwa barisnya ada seperti cara script mengecek lines.start, dan pakai firstLine sebagai ganti "start" saat percakapan dibuat. Atur atributnya di sebuah aksi, dan tambahkan baris welcomeBack ke table milik Guide. Atribut bertahan satu sesi; untuk mengingat pemain lintas kunjungan, simpan flag-nya dengan data store seperti di tutorial DataStore.
NPC penjaga toko
Buat tokonya dari panduan shop GUI, lalu tambahkan aksi OpenShop yang memicu RemoteEvent ke pemain itu dan mengembalikan true, dan buat LocalScript toko membuka jendelanya saat event itu tiba. Pembelian tetap melewati pengecekan server milik toko sendiri. Kalau membeli hanya boleh berfungsi di dekat NPC, cek juga jaraknya di dalam handler pembelian, karena client bisa memanggil remote toko dari mana saja.
NPC yang berjalan
Untuk membuat Guide berkeliling atau mengikuti pemain, pakai panduan pathfinding NPC dan hilangkan centang Anchored di HumanoidRootPart supaya bisa bergerak. Prompt Talk berada di part itu, jadi ikut bergerak bersama NPC, dan pengecekan jarak memakai part yang sama. Jeda jalannya selagi percakapan terbuka, kalau tidak kotaknya tertutup begitu NPC berjalan lebih dari 16 stud dari pemain.
Kunci, quest dan hadiah lain
GiveItem memberikan Tool apa pun di DialogueItems, jadi NPC bisa memberi kunci yang dicek pintu terkunci, seperti di panduan pintu. Untuk item yang berbuat sesuatu saat dipakai, seperti makanan yang memberi heal, lihat panduan inventory.
Suara dan kamera
Untuk klip suara atau bunyi pendek di setiap baris, taruh Sound di Head NPC dan putar dari show di DialogueClient. Untuk mengarahkan kamera ke NPC selagi berbicara, panduan cutscene menunjukkan cara LocalScript mengambil alih kamera dan mengembalikannya.
Error umum dan cara memperbaikinya
Buka jendela Output (menu Window, lalu Output) sebelum kamu menekan Play. Sebagian besar masalah dialog mencetak peringatan di sana atau berasal dari nama yang tidak cocok.
Infinite yield possible on 'ReplicatedStorage:WaitForChild("DialogueEvent")'
DialogueClient sedang menunggu remote yang dibuat DialogueService, jadi DialogueService belum sampai ke sana. Cek bahwa itu Script, bukan LocalScript, langsung di dalam ServerScriptService, dan tidak dinonaktifkan. DialogueService lebih dulu menunggu DialogueData di ReplicatedStorage dan folder NPCs di Workspace, jadi kalau salah satunya tidak ada atau salah eja, script juga berhenti; Output lalu menampilkan peringatan infinite yield dari DialogueService yang menyebut namanya.
Tidak ada prompt Talk yang muncul di NPC
DialogueService hanya menambahkan prompt ke model yang berada langsung di dalam Workspace, NPCs dan punya part bernama HumanoidRootPart. Cek keduanya, dan berjalanlah sampai jarak 12 stud. Rig dari Toolbox mungkin tidak punya part itu, atau mungkin objek jenis lain yang dibungkus folder.
Prompt muncul, tapi menekan E tidak berbuat apa-apa
Server tidak menemukan percakapan untuk NPC itu, dan saat game dimulai Output menampilkan DialogueService: no conversation with a start line for Guide in DialogueData, dengan nama NPC kamu. Table di DialogueData harus punya nama model yang persis sama, termasuk huruf kapitalnya, dan baris bernama start.
Sebuah pilihan menutup kotaknya, bukan pindah ke baris berikutnya
Output menampilkan DialogueService: no line named tip for Guide in DialogueData, dengan nama-nama milikmu: next (atau failNext) pilihan itu menyebut baris yang tidak ada di table NPC itu. Nama baris membedakan huruf besar dan kecil, jadi cek ejaannya dengan table, di sini tips.
Kotaknya berfungsi, tapi tidak ada speech bubble
Bubble butuh part bernama Head langsung di dalam model NPC, dan bubble chat yang menyala: di Explorer, pilih BubbleChatConfiguration di bawah TextChatService dan cek bahwa Enabled dicentang. Secara default sudah menyala.
Output menampilkan DialogueService: no Tool named Torch in ServerStorage.DialogueItems
Server tidak bisa menemukan itemnya. Cek bahwa folder di ServerStorage bernama DialogueItems dan berisi Tool (bukan Model atau Part) dengan nama yang persis sama dengan item pilihan itu. Sampai kamu memperbaikinya, Guide menjawab dengan baris hasTorch, karena aksinya gagal.
Output menampilkan DialogueService: no action named ...
action sebuah pilihan tidak cocok dengan key mana pun di table ACTIONS. Namanya membedakan huruf besar dan kecil: heal bukan Heal.
Buat dengan RoCode
Kalau kamu lebih suka menjelaskan NPC-nya daripada merangkainya secara manual, RoCode bisa menulis script-script ini ke place yang sedang kamu buka. RoCode adalah agen AI independen untuk Roblox Studio, bukan buatan Roblox: kamu mengetik di web chat, dan plugin Studio-nya membuat dan mengedit script di Explorer kamu.
Buat model Guide di Workspace.NPCs berbicara: prompt Talk, kotak dialog dengan baris yang diketik dan tombol pilihan, speech bubble, pilihan heal dengan cooldown 30 detik dan pilihan yang memberi tool Torch dari ServerStorage satu kali. Simpan percakapannya di ModuleScript dan berikan setiap hadiah di server.
- Bisa memeriksa model itu lebih dulu, memakai Get Properties untuk membaca nilai penting seperti Anchored di part-nya dan WalkSpeed di Humanoid-nya. Ketik / di chat untuk melampirkan path persis model itu
- Menulis ModuleScript DialogueData, Script DialogueService dan LocalScript DialogueClient dengan Create Script
- Diperintahkan untuk mengecek compile setiap script yang ditulisnya dengan Check Script, yang meng-compile-nya di Studio tanpa menjalankannya
- Mengirim perubahannya dalam batch, dan setiap batch adalah satu titik undo di history Studio
Dengan plugin 3.9 atau lebih baru RoCode bisa menjalankan playtest singkat dan membaca error-nya, dan dengan plugin 3.9.11 atau lebih baru RoCode bisa mengendalikan karakter tes untuk mengecek game-nya berfungsi, tapi tidak mengambil screenshot selagi game berjalan, jadi datangi sendiri NPC-nya dan ajak bicara. Kalau ada yang tidak beres, ceritakan ke RoCode apa yang kamu lihat: Check Output bisa membaca baris Server dan Client dari playtest terakhirmu. NPC yang berbicara adalah satu sistem di antara banyak sistem; membuat game Roblox dengan AI, satu sistem per prompt menunjukkan cara semuanya saling terhubung. Cara RoCode tersambung ke Studio.
Pertanyaan umum
Bagaimana cara membuat NPC berbicara di Roblox Studio?
Tambahkan ProximityPrompt ke NPC dan, saat pemain memicunya, tampilkan baris NPC di kotak dialog, speech bubble atau keduanya. Tiga script di panduan ini melakukan keduanya dan menambahkan pilihan. Untuk bubble saja, panggil TextChatService:DisplayBubble(npc.Head, "Hello!") dari LocalScript saat prompt terpicu, seperti contoh NPC di halaman bubble chat Roblox.
Sebaiknya pakai objek Dialog atau GUI dialog custom?
Objek Dialog tidak butuh kode dan menampilkan speech bubble yang bisa diklik, yang cukup untuk teks pemanis. Event pilihannya hanya terjadi di perangkat pemain, jadi tidak bisa memberi hadiah dengan aman, dan secara default hanya satu pemain yang bisa berbicara dengannya pada satu waktu. Kotak custom seperti di panduan ini membiarkan server menjalankan setiap hadiah dan memberi tiap pemain percakapannya sendiri.
Bagaimana cara memberi pemain item dari NPC?
Simpan Tool-nya di ServerStorage dan buat Script server meng-clone-nya ke Backpack pemain saat mereka mengambil pilihan itu, seperti yang dilakukan aksi GiveItem. Cek bahwa mereka belum punya, dan matikan CanBeDropped di salinannya supaya tidak bisa dijatuhkan lalu diminta lagi. Jangan pernah biarkan perangkat pemain menentukan item mana yang diberikan.
Bagaimana cara membuat kotak dialog dengan efek mesin tik?
Taruh seluruh baris di TextLabel, naikkan MaxVisibleGraphemes-nya dari 0 beberapa karakter setiap kali, dan atur ke -1 di akhir untuk menampilkan semuanya. Halaman UI animation Roblox memakai properti yang sama dengan utf8.graphemes. DialogueClient menghitung berapa karakter yang ditampilkan dari waktu yang sudah berlalu, 45 per detik, jadi kecepatannya tidak bergantung pada frame rate.
Bisakah dua pemain berbicara dengan NPC yang sama sekaligus?
Dengan script di panduan ini, bisa: server menyimpan satu percakapan per pemain, dan tiap pemain hanya melihat kotaknya sendiri. Objek Dialog bawaan berbeda: dengan BehaviorType default-nya, SinglePlayer, satu pemain berbicara pada satu waktu dan yang lain melihat pilihan pemain itu.
Apakah teks dialog NPC perlu difilter?
Tidak untuk baris yang kamu tulis sendiri. Roblox membuatmu bertanggung jawab memfilter teks tampil yang tidak kamu kendalikan secara eksplisit, seperti yang diketik pemain, kata yang dihasilkan dari karakter acak, atau teks yang diambil dari situs luar. Kalau NPC mengulang sesuatu yang diketik pemain, filter bagian itu.
Sumber dan bacaan lanjutan
- Roblox Creator Docs: Proximity prompts (dalam bahasa Inggris). membuat prompt, MaxActivationDistance dan RequiresLineOfSight
- Roblox Engine API: ProximityPrompt (dalam bahasa Inggris). di mana prompt berfungsi, teks dan tombol default-nya, Triggered dan pengecekan line of sight
- Roblox Creator Docs: Securing the client-server boundary (dalam bahasa Inggris). ProximityPrompt sebagai celah serangan, dan pengecekan jarak dan izin
- Roblox Engine API: Dialog (dalam bahasa Inggris). BehaviorType dan event DialogChoiceSelected yang hanya di client
- Roblox Engine API: TextChatService:DisplayBubble (dalam bahasa Inggris). speech bubble untuk NPC dari script client
- Roblox Creator Docs: Customize bubble chat (dalam bahasa Inggris). bubble NPC dan BubbleChatConfiguration
- Roblox Creator Docs: Text filtering (dalam bahasa Inggris). teks tampil mana yang wajib kamu filter
- Roblox Creator Docs: UI animation and tweens (dalam bahasa Inggris). efek mesin tik dengan MaxVisibleGraphemes
- Roblox Engine API: Tool.CanBeDropped (dalam bahasa Inggris). apa yang dilakukan Backspace pada tool
- Roblox Engine API: UserInputService.PreferredInput (dalam bahasa Inggris). mendeteksi pemain yang memakai controller
- Roblox Creator Docs: Rig Generator (dalam bahasa Inggris). menyisipkan rig R15 atau R6
Cara kode ini dicek: setiap skrip di halaman ini lolos pemeriksa tipe strict Luau dengan definisi API Roblox (luau-lsp, 12 November 2026). Pemeriksaan tipe menangkap nama API yang salah ketik dan tipe yang keliru, bukan logika game, jadi uji dulu di Studio sebelum dipublikasikan.