Ringkasnya
Untuk menulis skrip dalam Roblox Studio, halakan tetikus pada ServerScriptService dalam Explorer, klik + dan masukkan Script. Studio membukanya dalam Script Editor. Tulis Luau, contohnya print("Hello"), tekan Play (F5) dan baca hasilnya dalam tetingkap Output (menu Window atau tab Script). Script berjalan pada pelayan dan mengubah segala-galanya untuk semua orang; LocalScript dalam StarterPlayerScripts berjalan pada peranti seorang pemain.
- Pelajari empat idea dahulu: pemboleh ubah (
local coins = 3), fungsi (local function name() ... end), syarat if dan event (part.Touched:Connect(...)). Empat skrip dalam panduan ini dibina daripadanya, ditambah gelung dan jadual. - Gunakan
task.wait(), bukanwait(). Rujukan Roblox menandakanwait()global sebagai lapuk dan digantikan olehtask.wait(). - Dalam tetapan paparan tetingkap Output, hidupkan Show Context supaya setiap baris menunjukkan sama ada ia datang daripada Server atau Client.
Di halaman ini
Sebelum bermula: Studio, Baseplate dan tetingkap Output
Anda perlukan Roblox Studio dan akaun Roblox, tidak lebih: tiada editor kod, tiada plugin. Setiap skrip dalam panduan ini ditaip dalam Script Editor Studio sendiri.
- Pasang Roblox Studio, aplikasi percuma Roblox untuk Windows dan Mac, dan log masuk dengan akaun Roblox.
- Buka Studio. Halaman permulaan ada templat: pilih Baseplate. Anda dapat lantai bertekstur grid 4x4 dan SpawnLocation, tempat avatar anda muncul semasa bermain.
- Jika tetingkap Explorer dan Properties tidak kelihatan, bukanya daripada menu Window atau tab Home. Explorer menyenaraikan semua objek dalam place; Properties menunjukkan tetapan objek yang dipilih.
- Buka Output daripada menu Window atau tab Script. Di sinilah mesej dan ralat skrip anda muncul.
- Dalam tetapan paparan tetingkap Output, hidupkan Show Context, yang melabelkan setiap mesej sebagai Client atau Server, dan Show Source, yang menunjukkan skrip dan nombor baris asalnya.
| Skrip | Jenis | Di mana letaknya | Apa yang diajar |
|---|---|---|---|
FirstScript | Script | ServerScriptService | Pemboleh ubah, fungsi, syarat if, gelung dan jadual |
ColourChanger | Script | Di dalam Part dalam Workspace | Mengubah sifat, script.Parent dan gelung dengan menunggu |
TouchPad | Script | Di dalam Part bernama Pad | Event, mencari pemain yang menyentuh part, dan debounce |
MyFirstLocalScript | LocalScript | StarterPlayerScripts, di dalam StarterPlayer | Kod pada peranti seorang pemain, tekanan kekunci dan apa yang kekal pada peranti itu |
Workspace
Baseplate Part
SpawnLocation SpawnLocation
Part Part new
ColourChanger Script new
Pad Part new
TouchPad Script new
ServerScriptService
FirstScript Script new
StarterPlayer
StarterPlayerScripts
MyFirstLocalScript LocalScript new
Langkah 1: tulis skrip pertama anda
- Dalam Explorer, halakan tetikus pada ServerScriptService, klik + dan pilih Script (pintasan Ctrl+I atau ⌘I pada Mac). Studio mencipta skrip dan membukanya dalam Script Editor.
- Klik kanan skrip baharu itu, pilih Rename dan namakannya
FirstScript. Nama tidak mengubah apa yang dibuat oleh skrip, tetapi ia memberitahu skrip mana yang mencetak apa. - Skrip baharu bermula dengan satu baris,
print("Hello world!"). Padamkannya dan tampal kod di bawah. - Tekan Play (F5), dengan Test dipilih dalam senarai di sebelah kirinya. Studio memulakan playtest dan meletakkan avatar pada SpawnLocation.
- Baca baris dalam Output, kemudian tekan Stop (Shift+F5). Stop juga mengembalikan semua objek kepada keadaan sebelum Play ditekan, jadi apa sahaja yang anda alihkan atau warnakan semasa bermain akan kembali.
-- Script dalam ServerScriptService bernama FirstScript.
-- Luau pertama anda: pemboleh ubah, fungsi, syarat if, gelung dan jadual.
-- Tekan Play (F5) dan baca hasilnya dalam tetingkap Output.
-- Pemboleh ubah ialah nama yang menyimpan nilai
local gameName = "Coin Run"
local coinsToWin = 3
-- Fungsi ialah blok kod bernama yang boleh dijalankan seberapa kerap yang anda mahu.
-- name dan goal ialah parameternya; return memulangkan nilai kepada pemanggilnya.
local function describe(name: string, goal: number): string
return `{name}: collect {goal} coins to win`
end
print(describe(gameName, coinsToWin)) --> Coin Run: collect 3 coins to win
-- Syarat if menjalankan kod hanya apabila syaratnya benar
if coinsToWin > 5 then
print("That is a long game")
elseif coinsToWin > 1 then
print("That is a short game")
else
print("One coin and you win")
end
-- Gelung for mengulang kod sebanyak bilangan kali yang ditetapkan
for count = 1, coinsToWin do
print("Coin number", count)
end
-- Jadual menyimpan senarai nilai; gelung ini melaluinya mengikut urutan
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
print(position, colour) --> 1 Red, kemudian 2 Green, kemudian 3 Blue
end
Semua selepas -- dalam satu baris ialah komen: Luau melangkaunya, jadi anda boleh meninggalkan nota untuk diri sendiri. Komen --> menunjukkan apa yang dicetak oleh baris itu.
Output sepatutnya menunjukkan lapan baris ini bercampur dengan mesej Studio sendiri. Apabila print menerima beberapa nilai, ia meletakkan ruang di antaranya. Dengan Show Context dan Show Source dihidupkan, setiap baris juga dilabel Server dan FirstScript dengan nombor baris.
Coin Run: collect 3 coins to win
That is a short game
Coin number 1
Coin number 2
Coin number 3
1 Red
2 Green
3 Blue
Padankan setiap baris dengan kod yang mencetaknya. Nanti anda akan melakukan perkara yang sama dengan mesej ralat, jadi tabiat ini berguna.
FirstScript hanya menggunakan Luau tulen tanpa objek Roblox, jadi ia juga berfungsi dalam Luau playground percuma dalam pelayar. Tukar satu nilai di sana dan jalankan semula untuk melihat apa yang berubah.
| Kod | Idea | Maksudnya |
|---|---|---|
local gameName = "Coin Run" | Pemboleh ubah | Nama yang menyimpan nilai. local bermaksud hanya skrip ini atau blok tempat ia berada boleh menggunakannya. Teks dalam tanda petik ialah string; 3 ialah nombor. Nama peka huruf besar kecil, jadi coinsToWin dan CoinsToWin ialah dua pemboleh ubah berbeza. |
local function describe(name: string, goal: number): string | Fungsi | Blok kod bernama yang boleh dijalankan seberapa kerap yang anda mahu. name dan goal ialah parameternya: nilai yang dihantar setiap kali ia dipanggil. : string dan : number ialah anotasi jenis pilihan. Luau menggunakannya untuk memberi amaran tentang kesilapan dalam Script Editor; tanpanya kod berfungsi sama. |
return | Nilai pulangan | Memberi nilai kepada kod yang memanggil fungsi. print(describe(gameName, coinsToWin)) mencetak apa yang dipulangkan oleh describe. |
`{name}: collect {goal} coins to win` | Interpolasi string | Teks dalam tanda backtick boleh mengandungi nilai: Luau menggantikan {name} dan {goal} dengan nilai semasanya. |
if, elseif, else, end | Syarat if | Luau menyemak syarat dari atas ke bawah dan hanya menjalankan yang pertama benar. coinsToWin ialah 3, tidak lebih daripada 5 tetapi lebih daripada 1, jadi hanya "That is a short game" dicetak. |
for count = 1, coinsToWin do | Gelung for berangka | Menjalankan kod di dalamnya sekali untuk setiap nombor dari 1 hingga coinsToWin, dengan count bernilai 1, kemudian 2, kemudian 3. |
{ "Red", "Green", "Blue" } dan for position, colour in colours do | Jadual dan gelung | Jadual seperti senarai, Luau memanggilnya array. Kedudukan bermula dari 1, bukan 0. Gelung melalui setiap elemen dan memberi kedudukan serta nilainya. |
Setiap blok yang dibuka dengan perkataan function, if, for atau while ditutup dengan perkataan end. Satu end yang tertinggal menghalang seluruh skrip daripada berjalan; bahagian membaca ralat menunjukkan mesej yang akan anda dapat.
Langkah 2: ubah part daripada skrip
Skrip menjadi berguna apabila ia mengubah sesuatu dalam dunia. Tetapan yang anda lihat dalam tetingkap Properties, contohnya Color, Transparency atau Anchored pada part, ialah sifat (property), dan skrip juga boleh menetapkannya.
- Pada tab Home, klik Part. Studio menambah blok ke dalam Workspace. Namanya tidak penting.
- Dalam Explorer, halakan tetikus pada part baharu itu, klik + dan masukkan Script. Namakan semula kepada
ColourChangerdan gantikan kandungannya dengan kod di bawah. - Tekan Play. Part bertukar merah, kemudian biru, kemudian hijau, berubah sekali setiap saat, dan bermula semula.
-- Script di dalam Part dalam Workspace, bernama ColourChanger.
-- Skrip mengubah sifat yang sama seperti yang kelihatan dalam tetingkap Properties.
-- Yang ini memberi part-nya warna baharu setiap saat, untuk semua pemain.
local part = script.Parent :: BasePart -- part tempat skrip ini berada
local colours = {
Color3.fromRGB(255, 85, 85), -- merah
Color3.fromRGB(85, 170, 255), -- biru
Color3.fromRGB(85, 255, 127), -- hijau
}
part.Anchored = true -- part yang di-anchor kekal di tempat anda meletakkannya
local index = 1
while true do
part.Color = colours[index]
index = index % #colours + 1 -- 1, 2, 3, kemudian 1 semula
task.wait(1) -- berhenti seketika selama satu saat (wait() lama sudah lapuk)
end
script.Parentialah objek tempat skrip berada, di sini part. Seret skrip ke part lain, dan ia akan mengubah part itu.:: BasePartialah type cast. Ia memberitahu Script Editor bahawa induknya ialah part, supaya sifat yang digunakan disemak. Luau menggunakan jenis hanya untuk amaran dan cadangan, jadi cast ini tidak mengubah apa yang dibuat oleh baris itu.part.Colordanpart.Anchoredialah sifat yang sama seperti dalam tetingkap Properties, dengan nama yang sama. Roblox menggunakan ejaan Amerika, jadi sifat itu dipanggilColor, walaupun skrip dipanggil ColourChanger.Anchored = truemengekalkan part di tempatnya: rujukan Roblox mengatakan part yang di-anchor tidak pernah bergerak kerana graviti, perlanggaran atau fizik lain.colours[index]membaca satu elemen senarai.#coloursialah panjang senarai, 3, dan%memberi baki pembahagian, jadiindex % #colours + 1mengira 1, 2, 3, 1, 2, 3.while true doberulang tanpa henti, sebab itutask.wait(1)di dalamnya sangat penting. Dokumentasi Roblox mengatakan sentiasa letakkan kelewatan sepertitask.wait()dalam gelung tanpa henti: tanpanya game tergantung dan Studio ranap.
ColourChanger ialah Script, jadi ia berjalan pada pelayan, dan semua pemain nampak warna yang sama pada masa yang sama. Langkah 4 menunjukkan jenis skrip yang lain.
Langkah 3: bertindak balas kepada pemain melalui event
Kebanyakan kod game menunggu sesuatu berlaku: pemain masuk, part disentuh, butang ditekan. Roblox memanggilnya event. Untuk menjalankan kod apabila event berlaku, anda sambungkan fungsi kepadanya.
- Masukkan satu lagi Part dan namakan semula tepat kepada
Pad, dengan P huruf besar. Biarkan ia terus dalam Workspace, bukan dalam folder atau model, kerana LocalScript dalam langkah 4 mencarinya di situ. - Jadikannya pad rata yang boleh dipijak, contohnya tetapkan
Sizekepada6, 1, 6dalam tetingkap Properties. Letakkannya di atas lantai berhampiran SpawnLocation dan tandakan Anchored supaya ia tidak bergerak. - Halakan tetikus pada Pad, klik +, masukkan Script, namakan semula kepada
TouchPaddan tampal kod di bawah. - Tekan Play dan berdiri di atas pad. Ia menjadi kuning selama 2 saat, dan Output menyebut nama anda.
-- Script di dalam Part dalam Workspace bernama Pad, skrip bernama TouchPad.
-- Event: apabila pemain memijak pad, ia menyala kuning, dan Output menulis siapa orangnya.
-- Debounce menghalang kod daripada berjalan banyak kali sesaat semasa pemain berdiri di atasnya.
local Players = game:GetService("Players")
local pad = script.Parent :: BasePart
local COOLDOWN_SECONDS = 2
local normalColour = pad.Color
local busy = false
local function onTouched(otherPart: BasePart)
if busy then
return -- masih dalam cooldown selepas sentuhan sebelumnya
end
-- Watak ialah Model yang mengandungi bahagian badan (atau topi) yang menyentuh pad
local character = otherPart:FindFirstAncestorOfClass("Model")
local player = character and Players:GetPlayerFromCharacter(character)
if not player then
return -- yang menyentuh ialah part lepas atau NPC, bukan pemain
end
busy = true
print(`{player.Name} stepped on the pad`)
pad.Color = Color3.fromRGB(255, 220, 0)
task.wait(COOLDOWN_SECONDS)
pad.Color = normalColour
busy = false
end
pad.Touched:Connect(onTouched)
| Kod | Apa yang dibuat |
|---|---|
pad.Touched:Connect(onTouched) | Menyambungkan fungsi kepada event Touched pad, jadi Roblox menjalankan onTouched setiap kali sesuatu menyentuh pad, dan menghantar part yang menyentuh. |
otherPart | Part yang menyentuh pad: kaki, tungkai, pemegang topi atau alat di tangan pemain. Ia tidak pernah pemain itu sendiri, jadi dua baris seterusnya mencari siapa pemiliknya. |
otherPart:FindFirstAncestorOfClass("Model") | Naik daripada part itu ke leluhur pertama yang kelasnya tepat Model, iaitu watak. Oleh kerana nama kelas mesti sepadan tepat, ia melangkau topi (kelas Accessory) dan alat di tangan (kelas Tool). |
Players:GetPlayerFromCharacter(character) | Memulangkan Player yang memiliki watak itu, atau nil jika ia watak tanpa pemilik, contohnya NPC. character and di hadapan melangkau panggilan jika model tidak dijumpai, dan player kekal nil. |
if not player then return end | Berhenti di sini untuk apa sahaja yang bukan pemain. return keluar daripada fungsi lebih awal. |
Kenapa pad perlukan debounce
Halaman Roblox tentang debounce memberi amaran bahawa Touched berlaku beberapa kali berturut-turut semasa part bersentuhan, dan watak yang berjalan ada beberapa bahagian badan. Tanpa semakan, satu langkah ke atas pad boleh mencetak banyak baris dan memulakan semula cahaya kuning berulang kali.
Pemboleh ubah busy itulah debounce. Sentuhan pertama menetapkannya kepada true, dan setiap sentuhan dalam 2 saat berikutnya sampai ke if busy then return end dan berhenti. Selepas task.wait(COOLDOWN_SECONDS) pad kembali kepada warnanya, dan busy menjadi false semula. COOLDOWN_SECONDS ditulis dengan huruf besar kerana ia tetapan yang tidak berubah semasa bermain: begitulah Roblox menasihatkan penamaan pemalar.
Pad ini ada satu debounce untuk semua orang, jadi pemain kedua yang memijak dalam 2 saat itu diabaikan. Untuk pad yang menyala, itu tidak mengapa. Pad yang memberi ganjaran perlu menyimpan cooldown untuk setiap pemain, seperti pad syiling dalam panduan leaderboard.
Langkah 4: LocalScript pertama dan apa bezanya
Game yang sedang berjalan ialah satu pelayan ditambah satu client untuk setiap pemain. Semua setakat ini ialah Script, yang berjalan pada pelayan, jadi perubahannya sampai kepada semua pemain. LocalScript berjalan pada peranti seorang pemain. Tekanan kekunci, kamera dan menu skrin dikendalikan di situ, kerana hanya peranti itu yang mengetahuinya.
- Dalam Explorer, kembangkan StarterPlayer, halakan tetikus pada StarterPlayerScripts, klik + dan masukkan LocalScript. Namakan semula kepada
MyFirstLocalScriptdan tampal kod di bawah. - Tekan Play. Output menunjukkan
Hello,dan nama anda dengan label Client. - Klik pada tetingkap game dan tekan E. Pad menjadi lebih lut sinar. Tekan E sekali lagi untuk mengembalikannya.
- Semasa playtest berjalan, klik suis Client/Server dalam kawalan ujian Studio untuk beralih ke salinan pelayan game. Di sana pad tidak lut sinar: pelayan tidak tahu apa-apa tentang perubahan itu.
-- LocalScript dalam StarterPlayer > StarterPlayerScripts bernama MyFirstLocalScript.
-- LocalScript berjalan pada peranti seorang pemain. Tekan E: Pad menjadi lebih lut sinar hanya
-- pada skrin anda, kerana perubahan part dari sini tidak sampai ke pelayan atau orang lain.
local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")
local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- muncul dalam Output dengan label Client
UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
if gameProcessed then
return -- kekunci digunakan untuk perkara lain, contohnya menaip dalam chat
end
if input.KeyCode == Enum.KeyCode.E then
local pad = workspace:FindFirstChild("Pad")
if pad and pad:IsA("BasePart") then
pad.Transparency = if pad.Transparency == 0 then 0.6 else 0
end
end
end)
Players.LocalPlayerialah pemain yang perantinya menjalankan skrip itu. Roblox menetapkannya hanya untuk LocalScript dan ModuleScript yang dimuatkannya, jadi kod pelayan tidak boleh menggunakannya.UserInputService.InputBeganberlaku apabila pemain mula menekan kekunci, mengklik atau menyentuh.gameProcessedbernilaitrueapabila enjin sudah menggunakan input itu, contohnya klik pada butang atau kekunci dalam baris chat, jadi skrip mengabaikannya.workspace:FindFirstChild("Pad")memulangkan anak bernama Pad atauniljika tiada.pad:IsA("BasePart")menyemak bahawa ia benar-benar part sebelum skrip mengubahTransparencynya.if pad.Transparency == 0 then 0.6 else 0ialah ungkapan if: ia memilih salah satu daripada dua nilai. Transparency 0 bermaksud kelihatan sepenuhnya, 1 tidak kelihatan.- Skrip lari dengan Shift bagus sebagai LocalScript kedua: ia mendengar kekunci dan mengubah WalkSpeed watak.
| Jenis | Di mana berjalan | Ke mana perubahan sampai | Untuk apa | Biasanya diletakkan dalam |
|---|---|---|---|---|
| Script | Pada pelayan | Kepada semua pemain | Peraturan game: syiling, kerosakan, pintu, pusingan, simpanan | ServerScriptService atau di dalam part semasa belajar |
| LocalScript | Pada peranti seorang pemain | Hanya ke peranti itu, kecuali pergerakan watak sendiri | Input, kamera, menu skrin, kesan untuk seorang pemain | StarterPlayerScripts atau StarterGui |
| ModuleScript | Pada pihak yang memanggil require() untuknya | Ke tempat yang sama seperti skrip yang memuatkannya | Kod yang dikongsi oleh beberapa skrip | ReplicatedStorage untuk kedua-dua pihak, ServerScriptService untuk pelayan sahaja |
Apa yang boleh diubah oleh penipu
Anggaplah penipu (exploiter) mengawal segala-galanya pada perantinya. Dia boleh menjalankan LocalScript sendiri dan mengubah LocalScript anda, jadi dia boleh menjadikan pad atau apa sahaja lut sinar pada skrinnya. Di sini ia tidak berbahaya: ketelusan hanya untuk rupa dan kekal pada perantinya. Sebab itulah semua perkara penting diputuskan oleh Script pada pelayan.
Script pelayan juga tidak selamat secara automatik. TouchPad berjalan pada pelayan, tetapi peranti setiap pemain mengawal fizik wataknya, dan dokumentasi keselamatan Roblox menyenaraikan, antara perkara yang boleh dibuat oleh client dengan part yang dikawalnya, mengawal bila Touched berlaku atau menyekatnya sepenuhnya. Untuk pad yang menyala, ini tidak penting. Untuk pad yang membayar, semak juga perkara yang dijejaki oleh pelayan sendiri, seperti peraturan dalam panduan obby bahawa checkpoint hanya dikira mengikut urutan.
Langkah 5: uji keempat-empat skrip bersama
- Kosongkan Output dengan Ctrl+K (⌘K pada Mac) dan tekan Play (F5). Output menunjukkan lapan baris FirstScript dengan label Server dan baris Hello anda dengan label Client. Part ColourChanger bertukar warna setiap saat.
- Berdiri di atas pad. Ia menjadi kuning selama 2 saat, dan Output menunjukkan nama anda dan "stepped on the pad" sekali. Berjalan di atasnya: baris baharu muncul tidak lebih kerap daripada sekali setiap 2 saat, bukan pada setiap kali Touched berlaku.
- Tekan E. Pad menjadi separa lut sinar (Transparency 0.6). Tekan E sekali lagi, dan ia tidak lut sinar.
- Tekan Stop. Dalam senarai ujian, pilih Server & Clients, tetapkan 2 client dan tekan Play (atau F7). Studio membuka tetingkap pelayan dan dua tetingkap client. Dalam satu client tekan E: pad menjadi lebih lut sinar di situ, manakala client lain dan pelayan menunjukkannya tidak lut sinar. Klik End Session apabila selesai.
- Rosakkan sesuatu dengan sengaja. Namakan semula Pad kepada
Pad2dan jalankan game. Memijak pad masih menjadikannya kuning, kerana TouchPad mencari part-nya melaluiscript.Parent, bukan mengikut nama. Menekan E kini tidak berbuat apa-apa, dan tiada ralat:FindFirstChild("Pad")memulangkannil, dan semakanif pad and ...melangkau selebihnya secara senyap. Tambahprint(pad)pada baris selepasFindFirstChild, jalankan dan tekan E: Output menunjukkannil. Print sebegini ialah cara paling pantas untuk memahami kenapa skrip tidak berbuat apa-apa. Hentikan game, padam baris print dan kembalikan nama part kepada Pad.
Di mana letak skrip
Tempat skrip diletakkan menentukan sama ada ia berjalan langsung, dan Studio tidak memberi amaran jika ia tidak akan pernah berjalan. Untuk skrip anda yang seterusnya:
| Bekas | Apa yang diletakkan | Kenapa |
|---|---|---|
| ServerScriptService | Skrip dengan kebanyakan peraturan game: ganjaran, pusingan, simpanan | Ia berjalan pada pelayan, dan tiada apa-apa daripada ServerScriptService dihantar kepada pemain. |
| Di dalam part dalam Workspace | Script yang berkaitan dengan satu part, seperti ColourChanger dan TouchPad | Tidak mengapa semasa belajar: part itu ialah script.Parent. Untuk projek sebenar, Roblox menasihatkan supaya menanda part dengan tag sebaliknya (lihat di bawah). |
| StarterPlayerScripts, di dalam StarterPlayer | Kebanyakan LocalScript: input, kamera, kesan untuk seorang pemain | Setiap pemain mendapat salinan sendiri semasa masuk. |
| StarterGui | LocalScript di dalam ScreenGui yang mengawal menu skrin | Setiap pemain mendapat salinan antara muka sendiri. |
| ReplicatedStorage | ModuleScript yang dimuatkan oleh kod pelayan dan client | Kedua-dua pihak boleh melihatnya. LocalScript atau Script dengan tetapan lalai tidak akan pernah berjalan di sini. |
Halaman Roblox tentang lokasi skrip menasihatkan supaya tidak meletakkan skrip terus dalam part di Workspace langsung: tandakan part dengan tag dan kendalikannya daripada satu ModuleScript melalui CollectionService. Skrip di dalam part tetap permulaan paling mudah, dan untuk satu dua objek semasa anda belajar, itu tidak mengapa. Panduan pintu menunjukkan corak dengan tag, dengan satu skrip untuk semua pintu, dan panduan client dan pelayan ada jadual penuh tentang bekas mana yang menjalankan skrip mana.
Apabila sesuatu tidak kena: baca Output
Ralat ditunjukkan dalam Output dengan warna merah. Setiap satu bermula dengan tempat ia berlaku, nama penuh skrip dan nombor baris, kemudian memberitahu apa yang salah. Klik pada ralat, dan Studio membuka skrip pada baris itu. Contohnya, jika anda membuang semakan if not player daripada TouchPad dan part lepas jatuh ke atas pad, Output menunjukkan:
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'
Kesilapan dalam cara kod ditulis, contohnya end yang tertinggal, kelihatan sebelum Play ditekan lagi: Script Editor menggariskannya dengan merah, dan tetingkap Script Analysis (butang Analysis pada tab Script) menyenaraikannya. Skrip dengan kesilapan sebegini tidak berjalan langsung, walaupun baris di atasnya.
| Mesej | Maksudnya | Cara membaiki |
|---|---|---|
Colour is not a valid member of Part "Workspace.Part" | Objek ini tiada apa-apa dengan nama tepat itu. Di sini sifatnya dieja Color. | Bandingkan ejaan dan huruf besar dengan tetingkap Properties atau Explorer. Lebih lanjut tentang ralat ini. |
attempt to index nil with 'Name' | Kod membaca sesuatu, di sini .Name, daripada nilai nil. Dalam contoh di atas player ialah nil kerana part lepas menyentuh pad. | Ketahui kenapa nilai itu nil, dan semak dengan if sebelum menggunakannya. Lebih lanjut tentang ralat ini. |
Expected 'end' (to close 'then' at line 2), got <eof> | if pada baris 2 tiada end pasangannya. Untuk fungsi, mesej mengatakan to close 'function', dan <eof> bermaksud penghujung fail. | Tambah end yang tertinggal, berpandukan baris dalam kurungan, bukan baris terakhir. Kadangkala mesej berakhir dengan frasa "did you forget to close ... at line N?". Itu tekaan Luau berdasarkan inden, dan ia mungkin menunjuk ke blok yang salah, jadi semak baris dalam kurungan dahulu. Lebih lanjut tentang ralat sintaks. |
Jika skrip tidak berbuat apa-apa dan Output juga kosong, biasanya skrip berada di tempat yang tidak pernah dijalankan, atau menunggu event yang tidak berlaku. Panduan ralat ada senarai semak untuk skrip yang senyap dan maklumat lanjut tentang membaca Output.
Apa yang tutorial skrip lama buat secara berbeza
Jika anda juga belajar daripada video dan hantaran forum, anda akan berjumpa corak lama. Berikut yang penting, dengan sebab setiap satunya menjadi masalah.
| Tutorial | Masalah | Panduan ini |
|---|---|---|
Berhenti seketika dengan wait(1) | Rujukan Roblox menandakan wait() global sebagai lapuk dan mengatakan ia digantikan oleh task.wait(). | task.wait(1) |
Mencari watak melalui otherPart.Parent, seperti dalam pelajaran Roblox tentang lava | Apabila topi atau alat di tangan menyentuh part, otherPart.Parent ialah Accessory atau Tool, bukan watak, jadi Humanoid tidak dijumpai dan sentuhan itu hilang. | FindFirstAncestorOfClass("Model"), kemudian GetPlayerFromCharacter |
Menggunakan Touched tanpa debounce | Touched berlaku beberapa kali berturut-turut untuk satu langkah, jadi kod berjalan berulang kali. | Bendera busy dan cooldown |
| Meletakkan LocalScript di dalam part dalam Workspace | LocalScript tidak pernah berjalan di situ. Ia hanya berjalan dari tempat yang dimiliki oleh seorang pemain. | LocalScript dalam StarterPlayerScripts (kenapa) |
Menulis part.Touched:connect(...) atau table.getn(list) | Panduan penamaan Roblox mengatakan API camelCase kebanyakannya lapuk, dan rujukan hanya menyenaraikan Connect. table.getn lapuk dan digantikan oleh #list. | :Connect(...) dan #list |
| Mengubah syiling atau memberi kerosakan dalam LocalScript | Perubahan kekal pada peranti pemain itu, jadi tiada orang lain nampak dan pelayan tidak mengiranya. | Peraturan game dalam Script pada pelayan |
Latihan: tiga perubahan untuk dicuba
Mengubah kod mengajar lebih banyak daripada membacanya. Cuba ini dalam place anda satu demi satu dan tekan Play selepas setiap satu.
- Jadikan pad memberi satu mata. Tambah skrip Leaderstats daripada langkah 1 panduan leaderboard. Kemudian dalam TouchPad, selepas
busy = true, cari folderleaderstatspemain dan tambah 1 kepada nilaiCoins. Petunjuk:player:FindFirstChild("leaderstats"), kemudianleaderstats:FindFirstChild("Coins"), kemudiancoins.Value += 1. Pad syiling dalam panduan leaderboard ialah versi siapnya, dengan cooldown untuk setiap pemain. - Jadikan ColourChanger juga mengubah ketelusan. Buat ColourChanger turut mengubah
Transparencypart setiap saat. Petunjuk: tambah jadual kedua berisi nombor dari 0 hingga 1, contohnya{ 0, 0.3, 0.6 }, dan tetapkanpart.Transparencydaripadanya pada baris selepaspart.Color, denganindexyang sama. - Cetak warna pad. Buat MyFirstLocalScript mencetak
Colorpad apabila E ditekan. Petunjuk:print(pad.Color)di dalam blokif pad and pad:IsA("BasePart"). Tekan E semasa pad kuning: client nampak warna yang ditetapkan oleh pelayan, kerana perubahan pada pelayan sampai kepada semua client.
Apa yang perlu dipelajari seterusnya
Kini anda telah menggunakan bahagian-bahagian yang membina kebanyakan skrip game. Urutan yang baik seterusnya:
- LocalScript vs Script vs ModuleScript: di mana setiap jenis skrip berjalan dan apa yang boleh diubahnya, lebih mendalam daripada langkah 4.
- RemoteEvents: cara LocalScript meminta pelayan melakukan sesuatu dan cara pelayan menyemak permintaan itu.
- Leaderboard: statistik pertama anda, dicipta dan diubah pada pelayan.
- Game pertama anda: laluan pendek dengan lava, syiling dan pad penamat menggunakan dua skrip pelayan, kemudian penerbitan.
- Kemudian pilih satu sistem: GUI kedai, sistem pusingan, checkpoint obby, skrin loading atau animasi apabila kekunci ditekan. Apabila sesuatu rosak, panduan ralat skrip membantu membaca mesejnya. Panduan checkpoint buat masa ini dalam bahasa Inggeris.
Tutorial Roblox sendiri, Coding fundamentals (dalam bahasa Inggeris), melengkapi panduan ini dengan baik: enam siri daripada pemboleh ubah dan fungsi, melalui syarat, gelung, array dan kamus, hingga menyusun kod dalam ModuleScript, dengan projek kecil dalam Studio.
Ralat biasa dan cara membaikinya
Kebanyakan masalah dengan skrip pertama ialah nama yang tidak sepadan, skrip di tempat yang salah atau gelung tanpa menunggu. Biarkan Output terbuka semasa ujian.
Studio tergantung atau berhenti bertindak balas apabila Play ditekan
Gelung while true do tiada penantian, jadi tiada perkara lain boleh berjalan. Dokumentasi Roblox mengatakan gelung tanpa henti tanpa kelewatan seperti task.wait() menggantungkan game dan meranapkan Studio. Letakkan task.wait() dalam setiap gelung tanpa henti, seperti dalam ColourChanger.
Tiada apa berlaku apabila saya berdiri di atas pad
Semak bahawa TouchPad ialah Script, bukan LocalScript, berada terus di dalam part Pad, tidak dimatikan, dan sifat CanTouch pad ditandakan. Kemudian letakkan print("touched", otherPart.Name) sebagai baris pertama di dalam onTouched. Jika ia tidak dicetak, event tidak berlaku; jika dicetak, masalahnya di bawah.
Menekan E tidak berbuat apa-apa
MyFirstLocalScript mesti LocalScript di dalam StarterPlayerScripts: LocalScript dalam Workspace atau ServerScriptService tidak pernah berjalan. Part mesti dinamakan tepat Pad dan berada terus dalam Workspace. Klik tetingkap game dahulu dan pastikan anda tidak menaip dalam chat, kerana skrip mengabaikan kekunci yang sudah digunakan oleh game.
Part berubah pada skrin saya tetapi tidak pada pemain lain
Perubahan dibuat oleh LocalScript, jadi ia kekal pada peranti anda. Buat perubahan dalam Script pelayan atau biarkan LocalScript meminta pelayan melalui RemoteEvent.
ColourChanger berfungsi di dalam part tetapi rosak dalam ServerScriptService
Ia menggunakan script.Parent sebagai part-nya. Dalam ServerScriptService, induknya ialah ServerScriptService, yang tiada Anchored atau Color, jadi Output menunjukkan ralat "not a valid member". Simpan ia di dalam part atau beri part itu nama dan cari mengikut nama, contohnya local part = workspace:WaitForChild("ColourPart") :: BasePart.
Output tidak menunjukkan apa-apa langsung
Semak bahawa tetingkap Output terbuka (menu Window atau tab Script) dan tiada penapis: Output boleh ditapis mengikut jenis mesej, mengikut Client atau Server dan mengikut teks. Jika ia terbuka dan masih kosong, skrip mungkin tidak berjalan. Lihat senarai semak untuk skrip yang tidak berbuat apa-apa.
Jika anda tersekat: RoCode
Jika anda tersekat pada skrip dalam place anda, RoCode boleh menelitinya bersama anda. RoCode ialah ejen AI bebas untuk Roblox Studio, bukan daripada Roblox: anda menulis dalam chat web, dan plugin Studionya mencipta serta menyunting skrip dalam Explorer anda.
Semasa anda belajar, mod Ask berguna: anda menulis skrip sendiri, dan RoCode membaca apa yang sudah ada dan menjawab soalan.
Terangkan baris demi baris apa yang dibuat oleh skrip TouchPad di dalam part Pad, dan kenapa ia menggunakan debounce.
- Dalam mod Ask hanya menggunakan alat membaca, contohnya Search Scripts dan Read Script, dan tidak mengubah apa-apa dalam place
- Jika sesuatu perlu dibaiki, ia memberitahu apa dan di mana ia akan ubah dan mencadangkan beralih ke Build
- Dalam mod Build menyunting skrip di tempatnya, kemudian menyemak setiap satu dengan Check Script. Ini semakan kompilasi, bukan semakan jenis dan bukan playtest
- Membaca Output Studio dengan alat Check Output, termasuk baris Server dan Client daripada playtest terakhir anda, walaupun selepas Stop ditekan
Dalam mod Build dengan plugin 3.9 atau lebih baharu, RoCode boleh menjalankan playtest pendek dan membaca ralat, dan dengan 3.9.11 atau lebih baharu mengawal watak ujian, tetapi ia tidak mengambil tangkapan skrin semasa bermain, jadi anda tetap perlu memijak pad sendiri. Cara RoCode bersambung dengan Studio.
Soalan lazim
Di mana menulis skrip dalam Roblox Studio?
Dalam Explorer, halakan tetikus pada bekas, contohnya ServerScriptService, klik + dan pilih Script. Studio membukanya dalam Script Editor, tempat anda menulis Luau. Skrip pelayan biasanya diletakkan dalam ServerScriptService; LocalScript dalam StarterPlayerScripts atau StarterGui.
Bagaimana menjalankan skrip dalam Roblox Studio?
Tekan Play (F5). Studio memulakan playtest, dan setiap Script yang dihidupkan dalam ServerScriptService atau Workspace berjalan sebaik game bermula; LocalScript dalam StarterPlayerScripts berjalan apabila anda masuk ke playtest. Run (pilih dalam senarai di sebelah Play atau tekan F8) menjalankan game tanpa avatar, jadi gunakan Play untuk panduan ini. Stop (Shift+F5) menamatkan ujian. Untuk membuka skrip sedia ada, klik dua kali padanya dalam Explorer.
Bahasa pengaturcaraan apa yang digunakan oleh Roblox?
Luau. Roblox menerangkannya sebagai bahasa skrip yang pantas, kecil, selamat dengan penjenisan beransur (gradual typing), berasal daripada Lua 5.1, jadi kebanyakan tutorial Lua masih berguna. Luau menambah ciri seperti interpolasi string dalam tanda backtick dan anotasi jenis pilihan, dan Roblox menambah pustaka dan objeknya sendiri, contohnya task.wait.
Apa beza Script dengan LocalScript?
Script berjalan pada pelayan, dan perubahannya sampai kepada semua pemain. LocalScript berjalan pada peranti seorang pemain, untuk input, kamera dan menu skrin, dan perubahannya pada part, nilai dan antara muka kekal pada peranti itu. Panduan client dan pelayan (dalam bahasa Inggeris) menerangkan kedua-duanya, ditambah ModuleScript.
Bolehkah saya menulis skrip dalam Roblox Studio pada telefon atau iPad?
Halaman pemasangan Roblox menerangkan Studio sebagai aplikasi percuma untuk Windows dan Mac dan tidak menyebut versi untuk telefon atau tablet, jadi anda perlukan komputer untuk menulis skrip.
Kenapa skrip saya tidak berbuat apa-apa dan tidak menunjukkan ralat?
Biasanya ia berada di tempat skrip jenis itu tidak berjalan (LocalScript dalam Workspace atau Script dalam StarterPlayerScripts), ia dimatikan, atau event yang ditunggunya tidak berlaku. Panduan ralat ada senarai semak.
Berapa lama masa untuk belajar skrip Roblox?
Tiada siapa boleh memberi angka yang jujur: ia bergantung pada berapa banyak yang anda bina. Yang paling membantu ialah kerap menulis skrip kecil dalam place anda sendiri. Ubah empat skrip di sini, cuba tugasan latihan, kemudian ikuti panduan game pertama dan tambah satu sistem pada satu masa.
Sumber dan bacaan lanjut
- Roblox Creator Docs: Luau (dalam bahasa Inggeris). apa itu Luau dan dari mana asalnya
- Roblox Creator Docs: Roblox Studio setup (dalam bahasa Inggeris). Windows dan Mac, keperluan sistem
- Roblox Creator Docs: Output (dalam bahasa Inggeris). membuka Output, penapis, Show Context dan Show Source
- Roblox Creator Docs: Studio testing modes (dalam bahasa Inggeris). Play, Run, Stop, suis Client/Server dan Server & Clients
- Roblox Creator Docs: Script Editor (dalam bahasa Inggeris). tempat skrip baharu dibuka dan Script Analysis
- Roblox Creator Docs: Script types and locations (dalam bahasa Inggeris). di mana setiap jenis skrip berjalan dan tag sebagai ganti skrip dalam part
- Roblox Creator Docs: Script (dalam bahasa Inggeris). bila Script mula berjalan
- Roblox Creator Docs: Control structures (dalam bahasa Inggeris). syarat, gelung dan kenapa gelung tanpa henti perlukan penantian
- Roblox Creator Docs: Events (dalam bahasa Inggeris). Connect dan apa yang Touched hantar kepada fungsi
- Roblox Creator Docs: Debounce patterns (dalam bahasa Inggeris). kenapa Touched berlaku beberapa kali untuk satu sentuhan
- Roblox Creator Docs: wait (dalam bahasa Inggeris). wait() global dan task.wait()
- Roblox Creator Docs: Network ownership, movement validation and physics exploits (dalam bahasa Inggeris). apa yang client boleh buat dengan wataknya sendiri
- Roblox Creator Docs: Coding fundamentals (dalam bahasa Inggeris). siri Roblox untuk pemula
Cara kod disemak: setiap skrip di halaman ini lulus semakan jenis Luau yang ketat dengan definisi API Roblox (luau-lsp, 20 November 2026). Semakan jenis mengesan kesilapan nama API dan jenis yang salah, tetapi bukan kesilapan logik permainan, jadi uji semuanya dalam Studio sebelum anda menerbitkannya.