Tutorial · Asas skrip

Cara menulis skrip dalam Roblox Studio: panduan untuk pemula

Menulis skrip, atau pengaturcaraan, dalam Roblox Studio bermaksud menulis Luau, versi bahasa Lua daripada Roblox, dalam skrip yang anda tambah ke dalam place. Panduan ini bermula daripada Baseplate kosong: anda akan membuka tetingkap Output, menulis skrip pertama, mengubah part daripada kod, bertindak balas apabila pemain memijak pad dan mencuba LocalScript, dan sepanjang jalan anda akan memahami pemboleh ubah, fungsi, syarat, gelung dan event.

Dikemas kini 20 November 202619 minit bacaanDitulis oleh

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(), bukan wait(). Rujukan Roblox menandakan wait() global sebagai lapuk dan digantikan oleh task.wait().
  • Dalam tetapan paparan tetingkap Output, hidupkan Show Context supaya setiap baris menunjukkan sama ada ia datang daripada Server atau Client.
Di halaman ini
  1. Sebelum bermula
  2. 1. Skrip pertama
  3. 2. Ubah part
  4. 3. Event
  5. 4. LocalScript pertama
  6. 5. Ujian
  7. Di mana letak skrip
  8. Membaca ralat
  9. Tutorial lama
  10. Latihan
  11. Seterusnya
  12. Common errors
  13. Dengan RoCode
  14. Soalan lazim
  15. Sumber dan bacaan lanjut

Sebelum bermula: Studio, Baseplate dan tetingkap Output

IlustrasiEmpat skrip dalam satu playtest: part ColourChanger bertukar warna setiap saat, memijak Pad menjadikannya kuning selama 2 saat untuk semua pemain dan menulis nama anda dalam Output, dan E menjadikan Pad lebih lut sinar pada skrin ini sahaja.

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.

  1. Pasang Roblox Studio, aplikasi percuma Roblox untuk Windows dan Mac, dan log masuk dengan akaun Roblox.
  2. Buka Studio. Halaman permulaan ada templat: pilih Baseplate. Anda dapat lantai bertekstur grid 4x4 dan SpawnLocation, tempat avatar anda muncul semasa bermain.
  3. 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.
  4. Buka Output daripada menu Window atau tab Script. Di sinilah mesej dan ralat skrip anda muncul.
  5. 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.
Empat skrip yang akan anda tulis
SkripJenisDi mana letaknyaApa yang diajar
FirstScriptScriptServerScriptServicePemboleh ubah, fungsi, syarat if, gelung dan jadual
ColourChangerScriptDi dalam Part dalam WorkspaceMengubah sifat, script.Parent dan gelung dengan menunggu
TouchPadScriptDi dalam Part bernama PadEvent, mencari pemain yang menyentuh part, dan debounce
MyFirstLocalScriptLocalScriptStarterPlayerScripts, di dalam StarterPlayerKod pada peranti seorang pemain, tekanan kekunci dan apa yang kekal pada peranti itu
Explorer pada akhirnya (hanya objek panduan ini)
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

  1. 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.
  2. 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.
  3. Skrip baharu bermula dengan satu baris, print("Hello world!"). Padamkannya dan tampal kod di bawah.
  4. Tekan Play (F5), dengan Test dipilih dalam senarai di sebelah kirinya. Studio memulakan playtest dan meletakkan avatar pada SpawnLocation.
  5. 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
-- 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.

Output (dijangka)
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.

Apa yang dibuat oleh setiap bahagian FirstScript
KodIdeaMaksudnya
local gameName = "Coin Run"Pemboleh ubahNama 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): stringFungsiBlok 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.
returnNilai pulanganMemberi nilai kepada kod yang memanggil fungsi. print(describe(gameName, coinsToWin)) mencetak apa yang dipulangkan oleh describe.
`{name}: collect {goal} coins to win`Interpolasi stringTeks dalam tanda backtick boleh mengandungi nilai: Luau menggantikan {name} dan {goal} dengan nilai semasanya.
if, elseif, else, endSyarat ifLuau 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 doGelung for berangkaMenjalankan 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 doJadual dan gelungJadual 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.

  1. Pada tab Home, klik Part. Studio menambah blok ke dalam Workspace. Namanya tidak penting.
  2. Dalam Explorer, halakan tetikus pada part baharu itu, klik + dan masukkan Script. Namakan semula kepada ColourChanger dan gantikan kandungannya dengan kod di bawah.
  3. Tekan Play. Part bertukar merah, kemudian biru, kemudian hijau, berubah sekali setiap saat, dan bermula semula.
Script dalam mana-mana part dalam Workspace bernama ColourChanger
-- 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.Parent ialah objek tempat skrip berada, di sini part. Seret skrip ke part lain, dan ia akan mengubah part itu.
  • :: BasePart ialah 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.Color dan part.Anchored ialah sifat yang sama seperti dalam tetingkap Properties, dengan nama yang sama. Roblox menggunakan ejaan Amerika, jadi sifat itu dipanggil Color, walaupun skrip dipanggil ColourChanger.
  • Anchored = true mengekalkan 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. #colours ialah panjang senarai, 3, dan % memberi baki pembahagian, jadi index % #colours + 1 mengira 1, 2, 3, 1, 2, 3.
  • while true do berulang tanpa henti, sebab itu task.wait(1) di dalamnya sangat penting. Dokumentasi Roblox mengatakan sentiasa letakkan kelewatan seperti task.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.

  1. 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.
  2. Jadikannya pad rata yang boleh dipijak, contohnya tetapkan Size kepada 6, 1, 6 dalam tetingkap Properties. Letakkannya di atas lantai berhampiran SpawnLocation dan tandakan Anchored supaya ia tidak bergerak.
  3. Halakan tetikus pada Pad, klik +, masukkan Script, namakan semula kepada TouchPad dan tampal kod di bawah.
  4. Tekan Play dan berdiri di atas pad. Ia menjadi kuning selama 2 saat, dan Output menyebut nama anda.
Script dalam Workspace.Pad bernama TouchPad
-- 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)
Bagaimana TouchPad pergi daripada sentuhan kepada pemain
KodApa 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.
otherPartPart 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 endBerhenti 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.

  1. Dalam Explorer, kembangkan StarterPlayer, halakan tetikus pada StarterPlayerScripts, klik + dan masukkan LocalScript. Namakan semula kepada MyFirstLocalScript dan tampal kod di bawah.
  2. Tekan Play. Output menunjukkan Hello, dan nama anda dengan label Client.
  3. Klik pada tetingkap game dan tekan E. Pad menjadi lebih lut sinar. Tekan E sekali lagi untuk mengembalikannya.
  4. 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 StarterPlayerScripts bernama MyFirstLocalScript
-- 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.LocalPlayer ialah pemain yang perantinya menjalankan skrip itu. Roblox menetapkannya hanya untuk LocalScript dan ModuleScript yang dimuatkannya, jadi kod pelayan tidak boleh menggunakannya.
  • UserInputService.InputBegan berlaku apabila pemain mula menekan kekunci, mengklik atau menyentuh. gameProcessed bernilai true apabila enjin sudah menggunakan input itu, contohnya klik pada butang atau kekunci dalam baris chat, jadi skrip mengabaikannya.
  • workspace:FindFirstChild("Pad") memulangkan anak bernama Pad atau nil jika tiada. pad:IsA("BasePart") menyemak bahawa ia benar-benar part sebelum skrip mengubah Transparencynya.
  • if pad.Transparency == 0 then 0.6 else 0 ialah 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.
Script, LocalScript dan ModuleScript
JenisDi mana berjalanKe mana perubahan sampaiUntuk apaBiasanya diletakkan dalam
ScriptPada pelayanKepada semua pemainPeraturan game: syiling, kerosakan, pintu, pusingan, simpananServerScriptService atau di dalam part semasa belajar
LocalScriptPada peranti seorang pemainHanya ke peranti itu, kecuali pergerakan watak sendiriInput, kamera, menu skrin, kesan untuk seorang pemainStarterPlayerScripts atau StarterGui
ModuleScriptPada pihak yang memanggil require() untuknyaKe tempat yang sama seperti skrip yang memuatkannyaKod yang dikongsi oleh beberapa skripReplicatedStorage 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

  1. 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.
  2. 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.
  3. Tekan E. Pad menjadi separa lut sinar (Transparency 0.6). Tekan E sekali lagi, dan ia tidak lut sinar.
  4. 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.
  5. Rosakkan sesuatu dengan sengaja. Namakan semula Pad kepada Pad2 dan jalankan game. Memijak pad masih menjadikannya kuning, kerana TouchPad mencari part-nya melalui script.Parent, bukan mengikut nama. Menekan E kini tidak berbuat apa-apa, dan tiada ralat: FindFirstChild("Pad") memulangkan nil, dan semakan if pad and ... melangkau selebihnya secara senyap. Tambah print(pad) pada baris selepas FindFirstChild, jalankan dan tekan E: Output menunjukkan nil. 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:

Di mana letak setiap jenis skrip
BekasApa yang diletakkanKenapa
ServerScriptServiceSkrip dengan kebanyakan peraturan game: ganjaran, pusingan, simpananIa berjalan pada pelayan, dan tiada apa-apa daripada ServerScriptService dihantar kepada pemain.
Di dalam part dalam WorkspaceScript yang berkaitan dengan satu part, seperti ColourChanger dan TouchPadTidak 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 StarterPlayerKebanyakan LocalScript: input, kamera, kesan untuk seorang pemainSetiap pemain mendapat salinan sendiri semasa masuk.
StarterGuiLocalScript di dalam ScreenGui yang mengawal menu skrinSetiap pemain mendapat salinan antara muka sendiri.
ReplicatedStorageModuleScript yang dimuatkan oleh kod pelayan dan clientKedua-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:

Output (contoh)
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.

Tiga ralat yang patut anda kenali
MesejMaksudnyaCara 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.

Corak daripada tutorial lama dan apa yang panduan ini buat sebaliknya
TutorialMasalahPanduan 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 lavaApabila 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 debounceTouched berlaku beberapa kali berturut-turut untuk satu langkah, jadi kod berjalan berulang kali.Bendera busy dan cooldown
Meletakkan LocalScript di dalam part dalam WorkspaceLocalScript 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 LocalScriptPerubahan 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 folder leaderstats pemain dan tambah 1 kepada nilai Coins. Petunjuk: player:FindFirstChild("leaderstats"), kemudian leaderstats:FindFirstChild("Coins"), kemudian coins.Value += 1. Pad syiling dalam panduan leaderboard ialah versi siapnya, dengan cooldown untuk setiap pemain.
  • Jadikan ColourChanger juga mengubah ketelusan. Buat ColourChanger turut mengubah Transparency part setiap saat. Petunjuk: tambah jadual kedua berisi nombor dari 0 hingga 1, contohnya { 0, 0.3, 0.6 }, dan tetapkan part.Transparency daripadanya pada baris selepas part.Color, dengan index yang sama.
  • Cetak warna pad. Buat MyFirstLocalScript mencetak Color pad apabila E ditekan. Petunjuk: print(pad.Color) di dalam blok if 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:

  1. LocalScript vs Script vs ModuleScript: di mana setiap jenis skrip berjalan dan apa yang boleh diubahnya, lebih mendalam daripada langkah 4.
  2. RemoteEvents: cara LocalScript meminta pelayan melakukan sesuatu dan cara pelayan menyemak permintaan itu.
  3. Leaderboard: statistik pertama anda, dicipta dan diubah pada pelayan.
  4. Game pertama anda: laluan pendek dengan lava, syiling dan pad penamat menggunakan dua skrip pelayan, kemudian penerbitan.
  5. 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.

Anda tulis

Terangkan baris demi baris apa yang dibuat oleh skrip TouchPad di dalam part Pad, dan kenapa ia menggunakan debounce.

RoCode buat
  • 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

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.

Cuba RoCode dalam permainan anda.

Kredit percuma setiap hari, tanpa kad. Pasang plugin, terangkan ciri yang anda mahu dan semak hasilnya dalam Studio.