튜토리얼 · 스크립팅 기초

Roblox Studio 스크립트 작성법: 초보자 가이드

Roblox Studio에서 스크립팅, 즉 프로그래밍은 Roblox가 만든 Lua 언어의 한 버전인 Luau로 플레이스에 추가한 스크립트를 작성하는 것을 말합니다. 이 가이드는 빈 Baseplate에서 시작합니다. Output 창을 열고, 첫 스크립트를 쓰고, 코드로 파트를 바꾸고, 발판을 밟은 플레이어에게 반응하고, LocalScript를 써 보면서 변수, 함수, 조건문, 반복문, 이벤트를 차근차근 익힙니다.

업데이트: 2026년 11월 20일읽는 데 15분작성:

요약

Roblox Studio에서 스크립트를 쓰려면 Explorer에서 ServerScriptService에 커서를 올리고 +를 눌러 Script를 넣으세요. Studio가 Script Editor에서 스크립트를 열어 줍니다. print("Hello") 같은 Luau 코드를 쓰고 Play(F5)를 누른 뒤 Output 창(Window 메뉴 또는 Script 탭)에서 결과를 읽으세요. Script는 서버에서 실행되어 모든 사람에게 적용되고, StarterPlayerScripts의 LocalScript는 한 플레이어의 기기에서 실행됩니다.

  • 먼저 네 가지 개념을 익히세요. 변수(local coins = 3), 함수(local function name() ... end), if 조건문, 이벤트(part.Touched:Connect(...))입니다. 이 가이드의 스크립트 네 개는 이것들에 반복문과 테이블을 더해 만들어집니다.
  • wait()가 아니라 task.wait()를 쓰세요. Roblox 레퍼런스는 전역 wait()를 지원 중단(deprecated)으로 표시하고 task.wait()로 대체되었다고 안내합니다.
  • Output 창의 표시 설정에서 Show Context를 켜면 각 줄이 Server에서 왔는지 Client에서 왔는지 표시됩니다.
이 페이지의 내용
  1. 시작하기 전에
  2. 1. 첫 스크립트
  3. 2. 파트 바꾸기
  4. 3. 이벤트
  5. 4. 첫 LocalScript
  6. 5. 테스트
  7. 스크립트 위치
  8. 오류 읽기
  9. 오래된 튜토리얼
  10. 연습
  11. 다음 단계
  12. Common errors
  13. RoCode와 함께
  14. 자주 묻는 질문
  15. 출처와 더 읽을거리

시작하기 전에: Studio, Baseplate, Output 창

일러스트한 번의 플레이테스트로 보는 스크립트 네 개: ColourChanger 파트는 1초마다 색이 바뀌고, Pad를 밟으면 모든 플레이어에게 2초 동안 노랗게 보이며 Output에 내 이름이 찍히고, E를 누르면 이 화면에서만 Pad가 더 투명해집니다.

Roblox Studio와 Roblox 계정만 있으면 됩니다. 코드 편집기도 플러그인도 필요 없습니다. 이 가이드의 모든 스크립트는 Studio에 내장된 Script Editor에서 입력합니다.

  1. Windows와 Mac용 Roblox 무료 앱인 Roblox Studio를 설치하고 Roblox 계정으로 로그인합니다.
  2. Studio를 엽니다. 시작 페이지에 템플릿이 있으니 Baseplate를 고르세요. 4x4 격자 텍스처가 있는 바닥과, 플레이할 때 아바타가 나타나는 위치인 SpawnLocation이 생깁니다.
  3. Explorer와 Properties 창이 보이지 않으면 Window 메뉴나 Home 탭에서 여세요. Explorer는 플레이스의 모든 오브젝트를 나열하고, Properties는 선택한 오브젝트의 설정을 보여 줍니다.
  4. Window 메뉴나 Script 탭에서 Output을 엽니다. 스크립트의 메시지와 오류가 여기에 나타납니다.
  5. Output 창의 표시 설정에서 각 메시지에 Client 또는 Server를 표시하는 Show Context와, 메시지가 나온 스크립트와 줄 번호를 보여 주는 Show Source를 켭니다.
직접 작성할 스크립트 네 개
스크립트종류위치배우는 것
FirstScriptScriptServerScriptService변수, 함수, if 조건문, 반복문, 테이블
ColourChangerScriptWorkspace의 Part 안속성 변경, script.Parent, 대기가 있는 반복문
TouchPadScriptPad라는 이름의 Part 안이벤트, 파트에 닿은 플레이어 찾기, 디바운스
MyFirstLocalScriptLocalScriptStarterPlayer 안의 StarterPlayerScripts한 플레이어의 기기에서 실행되는 코드, 키 입력, 그 기기에만 남는 것
마지막에 보이는 Explorer(이 가이드의 오브젝트만)
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

1단계: 첫 스크립트 작성하기

  1. Explorer에서 ServerScriptService에 커서를 올리고 +를 누른 뒤 Script를 고릅니다(단축키 Ctrl+I, Mac에서는 ⌘I). Studio가 스크립트를 만들고 Script Editor에서 엽니다.
  2. 새 스크립트를 오른쪽 클릭하고 Rename을 골라 이름을 FirstScript로 바꿉니다. 이름은 스크립트의 동작을 바꾸지 않지만, 어느 스크립트가 무엇을 출력했는지 알려 줍니다.
  3. 새 스크립트는 print("Hello world!") 한 줄로 시작합니다. 그 줄을 지우고 아래 코드를 붙여 넣으세요.
  4. 왼쪽 목록에서 Test를 고른 상태로 Play(F5)를 누릅니다. Studio가 플레이테스트를 시작하고 아바타를 SpawnLocation에 세웁니다.
  5. Output의 줄을 읽은 뒤 Stop(Shift+F5)을 누릅니다. Stop은 모든 오브젝트를 Play를 누르기 전 상태로 되돌리므로, 플레이 중에 옮기거나 색을 바꾼 것은 모두 원래대로 돌아갑니다.
Script 위치: ServerScriptService 이름: FirstScript
-- ServerScriptService에 있는 FirstScript라는 이름의 Script.
-- 첫 Luau: 변수, 함수, if 조건문, 반복문, 테이블.
-- Play(F5)를 누르고 Output 창에서 결과를 읽으세요.

-- 변수는 값을 담아 두는 이름입니다
local gameName = "Coin Run"
local coinsToWin = 3

-- 함수는 원하는 만큼 몇 번이든 실행할 수 있는 이름 붙은 코드 블록입니다.
-- name과 goal은 매개변수이고, return은 호출한 쪽에 값을 돌려줍니다.
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

-- if 조건문은 조건이 참일 때만 코드를 실행합니다
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

-- for 반복문은 정해진 횟수만큼 코드를 반복합니다
for count = 1, coinsToWin do
	print("Coin number", count)
end

-- 테이블은 값의 목록을 담습니다. 이 반복문은 값을 순서대로 하나씩 돕니다
local colours = { "Red", "Green", "Blue" }
for position, colour in colours do
	print(position, colour) --> 1 Red, 그다음 2 Green, 그다음 3 Blue
end

한 줄에서 -- 뒤의 모든 것은 주석입니다. Luau는 주석을 건너뛰므로 자신을 위한 메모를 남길 수 있습니다. --> 주석은 그 줄이 무엇을 출력하는지 보여 줍니다.

Output에는 Studio 자체 메시지 사이사이에 이 여덟 줄이 나와야 합니다. print에 값을 여러 개 넘기면 그 사이에 공백을 넣습니다. Show Context와 Show Source를 켰다면 각 줄에 Server와 FirstScript, 줄 번호도 표시됩니다.

Output(예상 결과)
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

각 줄을 그 줄을 출력한 코드와 짝지어 보세요. 나중에 오류 메시지에도 똑같이 하게 되니 이 습관이 도움이 됩니다.

FirstScript는 Roblox 오브젝트 없이 순수 Luau만 쓰므로 브라우저의 무료 Luau 플레이그라운드에서도 작동합니다. 거기서 값을 바꾸고 다시 실행해 무엇이 달라지는지 확인해 보세요.

FirstScript의 각 부분이 하는 일
코드개념뜻
local gameName = "Coin Run"변수값을 담아 두는 이름입니다. local은 이 스크립트나 그것이 놓인 블록만 이 이름을 쓸 수 있다는 뜻입니다. 따옴표 안의 텍스트는 문자열이고, 3은 숫자입니다. 이름은 대소문자를 구분하므로 coinsToWin과 CoinsToWin은 서로 다른 변수입니다.
local function describe(name: string, goal: number): string함수원하는 만큼 몇 번이든 실행할 수 있는 이름 붙은 코드 블록입니다. name과 goal은 매개변수로, 호출할 때마다 넘기는 값입니다. : string과 : number는 선택 사항인 타입 주석입니다. Luau는 이를 이용해 Script Editor에서 실수를 경고하며, 없어도 코드는 똑같이 작동합니다.
return반환값함수를 호출한 코드에 값을 돌려줍니다. print(describe(gameName, coinsToWin))는 describe가 반환한 것을 출력합니다.
`{name}: collect {goal} coins to win`문자열 보간백틱으로 감싼 텍스트에는 값을 넣을 수 있습니다. Luau가 {name}과 {goal}을 현재 값으로 바꿉니다.
if, elseif, else, endif 조건문Luau는 조건을 위에서 아래로 확인하고 처음으로 참인 것만 실행합니다. coinsToWin은 3이라 5보다 크지 않지만 1보다는 크므로 "That is a short game"만 출력됩니다.
for count = 1, coinsToWin do숫자 for 반복문1부터 coinsToWin까지 각 숫자마다 안쪽 코드를 한 번씩 실행하며, count는 1, 2, 3이 됩니다.
{ "Red", "Green", "Blue" }와 for position, colour in colours do테이블과 반복문목록 형태의 테이블로, Luau에서는 배열이라고 부릅니다. 위치는 0이 아니라 1부터 시작합니다. 반복문은 각 항목을 돌면서 위치와 값을 줍니다.

function, if, for, while로 여는 모든 블록은 end로 닫습니다. end가 하나만 빠져도 스크립트 전체가 실행되지 않습니다. 오류 읽기 섹션에서 어떤 메시지가 나오는지 보여 줍니다.

2단계: 스크립트로 파트 바꾸기

스크립트는 월드에 있는 무언가를 바꿀 때 쓸모가 생깁니다. Properties 창에서 보는 설정, 예를 들어 파트의 Color, Transparency, Anchored는 속성이며, 스크립트도 이 속성을 설정할 수 있습니다.

  1. Home 탭에서 Part를 누릅니다. Studio가 Workspace에 블록을 추가합니다. 이름은 상관없습니다.
  2. Explorer에서 새 파트에 커서를 올리고 +를 눌러 Script를 넣습니다. 이름을 ColourChanger로 바꾸고 내용을 아래 코드로 바꿉니다.
  3. Play를 누릅니다. 파트가 1초마다 빨강, 파랑, 초록으로 바뀌고 다시 처음부터 반복합니다.
Script 위치: Workspace의 아무 파트 이름: ColourChanger
-- Workspace의 Part 안에 있는 ColourChanger라는 이름의 Script.
-- 스크립트는 Properties 창에서 보이는 것과 같은 속성을 바꿉니다.
-- 이 스크립트는 모든 플레이어에게 보이도록 자기 파트의 색을 1초마다 바꿉니다.

local part = script.Parent :: BasePart -- 이 스크립트가 들어 있는 파트

local colours = {
	Color3.fromRGB(255, 85, 85), -- 빨강
	Color3.fromRGB(85, 170, 255), -- 파랑
	Color3.fromRGB(85, 255, 127), -- 초록
}

part.Anchored = true -- 고정된 파트는 놓아 둔 자리에 그대로 있습니다

local index = 1
while true do
	part.Color = colours[index]
	index = index % #colours + 1 -- 1, 2, 3, 그리고 다시 1
	task.wait(1) -- 1초 동안 멈춤(예전 wait()는 지원 중단됨)
end
  • script.Parent는 스크립트가 들어 있는 오브젝트로, 여기서는 파트입니다. 스크립트를 다른 파트로 끌어다 놓으면 그 파트를 바꿉니다.
  • :: BasePart는 타입 캐스트입니다. 부모가 파트라는 것을 Script Editor에 알려 주어 사용하는 속성을 검사하게 합니다. Luau는 타입을 경고와 힌트에만 쓰므로, 캐스트는 그 줄의 동작을 바꾸지 않습니다.
  • part.Color와 part.Anchored는 Properties 창의 속성과 같은 이름의 같은 속성입니다. Roblox는 미국식 철자를 쓰므로 스크립트 이름은 ColourChanger여도 속성 이름은 Color입니다.
  • Anchored = true는 파트를 제자리에 둡니다. Roblox 레퍼런스에 따르면 고정된 파트는 중력, 충돌, 그 밖의 물리 때문에 절대 움직이지 않습니다.
  • colours[index]는 목록의 항목 하나를 읽습니다. #colours는 목록의 길이인 3이고, %는 나눗셈의 나머지를 주므로 index % #colours + 1은 1, 2, 3, 1, 2, 3으로 셉니다.
  • while true do는 끝없이 반복되므로 안에 있는 task.wait(1)이 아주 중요합니다. Roblox 문서는 무한 반복문에는 항상 task.wait() 같은 지연을 넣으라고 말합니다. 지연이 없으면 게임이 멈추고 Studio가 다운됩니다.

ColourChanger는 Script이므로 서버에서 실행되고, 모든 플레이어가 같은 색을 동시에 봅니다. 4단계에서는 다른 종류의 스크립트를 보여 줍니다.

3단계: 이벤트로 플레이어에게 반응하기

게임 코드 대부분은 무언가 일어나기를 기다립니다. 플레이어가 들어오거나, 파트에 무언가 닿거나, 버튼이 눌리는 것이죠. Roblox는 이것을 이벤트라고 부릅니다. 이벤트가 발생할 때 코드를 실행하려면 이벤트에 함수를 연결합니다.

  1. Part를 하나 더 넣고 이름을 대문자 P로 정확히 Pad로 바꿉니다. 4단계의 LocalScript가 그곳에서 찾으므로 폴더나 모델 안이 아니라 Workspace 바로 아래에 두세요.
  2. 올라설 수 있는 납작한 발판으로 만드세요. 예를 들어 Properties 창에서 Size를 6, 1, 6으로 설정합니다. SpawnLocation 근처 바닥에 놓고 움직이지 않도록 Anchored를 체크합니다.
  3. Pad에 커서를 올리고 +를 눌러 Script를 넣은 뒤 이름을 TouchPad로 바꾸고 아래 코드를 붙여 넣습니다.
  4. Play를 누르고 발판 위에 올라서세요. 발판이 2초 동안 노랗게 변하고 Output에 내 이름이 나옵니다.
Script 위치: Workspace.Pad 이름: TouchPad
-- Workspace의 Pad라는 이름의 Part 안에 있는 TouchPad라는 이름의 Script.
-- 이벤트: 플레이어가 발판을 밟으면 발판이 노랗게 빛나고 Output에 누구였는지 씁니다.
-- 디바운스는 플레이어가 발판 위에 서 있는 동안 코드가 1초에 여러 번 실행되지 않게 막습니다.

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 -- 지난번 접촉의 쿨다운이 아직 진행 중입니다
	end
	-- 캐릭터는 발판에 닿은 신체 부위(또는 모자)가 들어 있는 Model입니다
	local character = otherPart:FindFirstAncestorOfClass("Model")
	local player = character and Players:GetPlayerFromCharacter(character)
	if not player then
		return -- 플레이어가 아니라 고정되지 않은 파트나 NPC가 닿았습니다
	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)
TouchPad가 접촉에서 플레이어까지 찾아가는 과정
코드하는 일
pad.Touched:Connect(onTouched)발판의 Touched 이벤트에 함수를 연결합니다. 그래서 무언가 발판에 닿을 때마다 Roblox가 onTouched를 실행하고 닿은 파트를 넘겨 줍니다.
otherPart발판에 닿은 파트입니다. 발, 다리, 모자의 손잡이, 플레이어가 손에 든 도구 등이죠. 절대 플레이어 자체가 아니므로 다음 두 줄에서 누구의 것인지 알아냅니다.
otherPart:FindFirstAncestorOfClass("Model")그 파트에서 위로 올라가며 클래스가 정확히 Model인 첫 번째 조상, 즉 캐릭터를 찾습니다. 클래스 이름이 정확히 일치해야 하므로 모자(Accessory 클래스)와 손에 든 도구(Tool 클래스)는 건너뜁니다.
Players:GetPlayerFromCharacter(character)그 캐릭터의 주인인 Player를 반환하고, NPC처럼 누구의 캐릭터도 아니면 nil을 반환합니다. 앞의 character and는 모델을 찾지 못했을 때 호출을 건너뛰며, 그러면 player는 nil로 남습니다.
if not player then return end플레이어가 아닌 모든 것은 여기서 멈춥니다. return은 함수를 일찍 빠져나갑니다.

발판에 디바운스가 필요한 이유

디바운스에 관한 Roblox 페이지는 파트들이 맞닿아 있는 동안 Touched가 연달아 여러 번 발생하며, 걸어가는 캐릭터에는 신체 부위가 여러 개 있다고 경고합니다. 확인이 없으면 발판을 한 번 밟는 것만으로 줄이 여러 개 출력되고 노란 빛이 계속 다시 시작될 수 있습니다.

busy 변수가 바로 디바운스입니다. 첫 접촉이 이 값을 true로 만들고, 그 뒤 2초 동안의 모든 접촉은 if busy then return end에서 멈춥니다. task.wait(COOLDOWN_SECONDS) 뒤에 발판은 색을 되돌리고 busy는 다시 false가 됩니다. COOLDOWN_SECONDS를 대문자로 쓴 이유는 게임 중에 바뀌지 않는 설정이기 때문이며, Roblox가 권하는 상수 이름 짓기 방식입니다.

이 발판은 모두가 디바운스 하나를 함께 쓰므로, 그 2초 안에 밟은 두 번째 플레이어는 무시됩니다. 빛나는 발판이라면 괜찮습니다. 보상을 주는 발판은 리더보드 가이드의 코인 발판처럼 플레이어마다 쿨다운을 따로 두어야 합니다.

4단계: 첫 LocalScript와 그 차이

실행 중인 게임은 서버 하나와 플레이어마다 하나씩인 클라이언트로 이루어집니다. 지금까지는 모두 서버에서 실행되는 Script였으므로 그 변경이 모든 플레이어에게 전달됩니다. LocalScript는 한 플레이어의 기기에서 실행됩니다. 키 입력, 카메라, 화면 메뉴는 그 기기만 알고 있으므로 그곳에서 처리합니다.

  1. Explorer에서 StarterPlayer를 펼치고 StarterPlayerScripts에 커서를 올린 뒤 +를 눌러 LocalScript를 넣습니다. 이름을 MyFirstLocalScript로 바꾸고 아래 코드를 붙여 넣습니다.
  2. Play를 누릅니다. Output에 Client 표시와 함께 Hello,와 내 이름이 나옵니다.
  3. 게임 창을 클릭하고 E를 누릅니다. 발판이 더 투명해집니다. E를 다시 누르면 원래대로 돌아옵니다.
  4. 플레이테스트가 진행되는 동안 Studio 테스트 컨트롤의 Client/Server 전환 버튼을 눌러 게임의 서버 쪽 사본으로 넘어가 보세요. 그곳에서 발판은 불투명합니다. 서버는 변경에 대해 아무것도 모릅니다.
LocalScript 위치: StarterPlayerScripts 이름: MyFirstLocalScript
-- StarterPlayer > StarterPlayerScripts에 있는 MyFirstLocalScript라는 이름의 LocalScript.
-- LocalScript는 한 플레이어의 기기에서 실행됩니다. E를 누르면 Pad가 내 화면에서만
-- 더 투명해집니다. 여기서 바꾼 파트는 서버에도 다른 사람에게도 전달되지 않기 때문입니다.

local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")

local player = Players.LocalPlayer
print(`Hello, {player.Name}`) -- Output에 Client 표시와 함께 나타납니다

UserInputService.InputBegan:Connect(function(input: InputObject, gameProcessed: boolean)
	if gameProcessed then
		return -- 키가 채팅 입력 같은 다른 곳에 쓰였습니다
	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는 스크립트가 실행되는 기기의 플레이어입니다. Roblox는 LocalScript와 그것이 불러오는 ModuleScript에서만 이 값을 정해 주므로 서버 코드에서는 쓸 수 없습니다.
  • UserInputService.InputBegan은 플레이어가 키 입력, 클릭, 터치를 시작할 때 발생합니다. 엔진이 이미 그 입력을 사용했다면, 예를 들어 버튼 클릭이나 채팅 창의 키 입력이라면 gameProcessed가 true이므로 스크립트는 그 입력을 무시합니다.
  • workspace:FindFirstChild("Pad")는 Pad라는 이름의 자식을 반환하고, 없으면 nil을 반환합니다. pad:IsA("BasePart")는 스크립트가 Transparency를 바꾸기 전에 그것이 정말 파트인지 확인합니다.
  • if pad.Transparency == 0 then 0.6 else 0은 if 표현식으로, 두 값 중 하나를 고릅니다. Transparency 0은 완전히 보이는 상태, 1은 보이지 않는 상태입니다.
  • Shift 달리기 스크립트는 두 번째 LocalScript로 좋습니다. 키 입력을 듣고 캐릭터의 WalkSpeed를 바꿉니다.
Script, LocalScript, ModuleScript
종류실행되는 곳변경이 전달되는 곳용도보통 두는 곳
Script서버모든 플레이어게임 규칙: 코인, 피해, 문, 라운드, 저장ServerScriptService, 또는 배우는 동안은 파트 안
LocalScript한 플레이어의 기기자기 캐릭터의 움직임을 빼면 그 기기에만입력, 카메라, 화면 메뉴, 한 플레이어를 위한 효과StarterPlayerScripts 또는 StarterGui
ModuleScriptrequire()로 불러오는 쪽불러온 스크립트와 같은 곳여러 스크립트가 함께 쓰는 코드양쪽 모두 쓰면 ReplicatedStorage, 서버만 쓰면 ServerScriptService

치터가 바꿀 수 있는 것

치터는 자기 기기의 모든 것을 제어한다고 생각하세요. 자기 LocalScript를 실행하고 내 LocalScript를 바꿀 수 있으므로 자기 화면에서 발판이든 무엇이든 투명하게 만들 수 있습니다. 여기서는 해가 없습니다. 투명도는 보이는 것일 뿐이고 그 사람의 기기에만 남기 때문입니다. 바로 그래서 중요한 것은 모두 서버의 Script가 결정합니다.

서버 Script도 자동으로 안전한 것은 아닙니다. TouchPad는 서버에서 실행되지만, 각 플레이어의 기기가 자기 캐릭터의 물리를 제어합니다. Roblox 보안 문서는 클라이언트가 자신이 제어하는 파트로 할 수 있는 일 중에 Touched가 발생하는 시점을 조작하거나 아예 막는 것을 꼽습니다. 빛나는 발판이라면 상관없습니다. 보상을 주는 발판이라면 오비 가이드의 규칙처럼 체크포인트를 순서대로만 인정하는 등, 서버가 직접 추적하는 것도 함께 확인하세요.

5단계: 스크립트 네 개를 함께 테스트하기

  1. Ctrl+K(Mac에서는 ⌘K)로 Output을 지우고 Play(F5)를 누릅니다. Output에 Server 표시가 붙은 FirstScript의 여덟 줄과 Client 표시가 붙은 Hello 줄이 나옵니다. ColourChanger 파트는 1초마다 색이 바뀝니다.
  2. 발판 위에 올라서세요. 발판이 2초 동안 노랗게 변하고 Output에 내 이름과 "stepped on the pad"가 한 번 나옵니다. 발판 위를 걸어 다녀 보세요. 새 줄은 Touched가 발생할 때마다가 아니라 최대 2초에 한 번만 나타납니다.
  3. E를 누릅니다. 발판이 반투명(Transparency 0.6)해집니다. E를 다시 누르면 불투명해집니다.
  4. Stop을 누릅니다. 테스트 목록에서 Server & Clients를 고르고 클라이언트를 2개로 설정한 뒤 Play(또는 F7)를 누릅니다. Studio가 서버 창 하나와 클라이언트 창 두 개를 엽니다. 한 클라이언트에서 E를 누르면 그곳에서만 발판이 더 투명해지고, 다른 클라이언트와 서버에서는 불투명하게 보입니다. 다 끝나면 End Session을 누르세요.
  5. 일부러 무언가를 고장 내 보세요. Pad의 이름을 Pad2로 바꾸고 게임을 실행합니다. TouchPad는 이름이 아니라 script.Parent로 자기 파트를 찾으므로 발판을 밟으면 여전히 노랗게 변합니다. 하지만 이제 E를 눌러도 아무 일도 일어나지 않고 오류도 없습니다. FindFirstChild("Pad")가 nil을 반환했고 if pad and ... 확인이 나머지를 조용히 건너뛰었기 때문입니다. FindFirstChild 다음 줄에 print(pad)를 넣고 실행한 뒤 E를 누르면 Output에 nil이 나옵니다. 이런 print가 스크립트가 아무것도 하지 않는 이유를 알아내는 가장 빠른 방법입니다. 게임을 멈추고 print 줄을 지운 뒤 파트 이름을 다시 Pad로 바꾸세요.

스크립트를 어디에 넣어야 할까

스크립트가 어디에 있느냐에 따라 실행 여부 자체가 달라지며, 절대 실행되지 않는 곳에 있어도 Studio는 경고하지 않습니다. 앞으로 만들 스크립트를 위해 정리하면 다음과 같습니다:

스크립트 종류별로 넣을 곳
컨테이너넣을 것이유
ServerScriptService대부분의 게임 규칙을 담은 스크립트: 보상, 라운드, 저장서버에서 실행되며, ServerScriptService의 어떤 것도 플레이어에게 전송되지 않습니다.
Workspace의 파트 안ColourChanger와 TouchPad처럼 파트 하나에 속한 Script배우는 동안은 괜찮습니다. 파트가 곧 script.Parent입니다. 실제 프로젝트에서는 Roblox가 대신 파트에 태그를 붙이라고 권합니다(아래 참고).
StarterPlayer 안의 StarterPlayerScripts대부분의 LocalScript: 입력, 카메라, 한 플레이어를 위한 효과각 플레이어가 입장할 때 자기 사본을 받습니다.
StarterGui화면 메뉴를 제어하는 ScreenGui 안의 LocalScript각 플레이어가 자기 UI 사본을 받습니다.
ReplicatedStorage서버 코드와 클라이언트 코드가 모두 불러오는 ModuleScript양쪽 모두 볼 수 있습니다. 기본 설정의 LocalScript나 Script는 여기서 절대 실행되지 않습니다.

스크립트 위치에 관한 Roblox 페이지는 Workspace의 파트 안에 스크립트를 직접 넣지 말라고 권합니다. 파트에 태그를 붙이고 CollectionService로 ModuleScript 하나에서 다루라는 것이죠. 그래도 파트 안의 스크립트가 가장 쉬운 시작이며, 배우는 동안 오브젝트 한두 개에 쓰는 것은 괜찮습니다. 문 가이드는 스크립트 하나로 모든 문을 다루는 태그 패턴을 보여 주고, 클라이언트와 서버 가이드에는 어떤 컨테이너가 어떤 스크립트를 실행하는지 정리한 전체 표가 있습니다.

무언가 잘못됐을 때: Output 읽기

오류는 Output에 빨간색으로 표시됩니다. 각 오류는 발생한 위치, 즉 스크립트의 전체 이름과 줄 번호로 시작하고, 그다음 무엇이 잘못됐는지 알려 줍니다. 오류를 클릭하면 Studio가 그 줄에서 스크립트를 엽니다. 예를 들어 TouchPad에서 if not player 확인을 지우고 고정되지 않은 파트가 발판에 떨어지면 Output에 이렇게 나옵니다:

Output(예시)
Workspace.Pad.TouchPad:22: attempt to index nil with 'Name'

end가 빠진 것처럼 코드를 쓴 방식의 오류는 Play를 누르기 전부터 보입니다. Script Editor가 빨간 밑줄을 긋고, Script Analysis 창(Script 탭의 Analysis 버튼)이 목록으로 보여 줍니다. 이런 오류가 있는 스크립트는 오류보다 위에 있는 줄까지 포함해 아예 실행되지 않습니다.

알아 두면 좋은 오류 세 가지
메시지뜻해결 방법
Colour is not a valid member of Part "Workspace.Part"이 오브젝트에는 정확히 그 이름을 가진 것이 없습니다. 여기서 속성 이름은 Color입니다.철자와 대소문자를 Properties 창이나 Explorer와 비교하세요. 이 오류 자세히 보기.
attempt to index nil with 'Name'코드가 nil 값에서 무언가(여기서는 .Name)를 읽었습니다. 위 예시에서는 고정되지 않은 파트가 발판에 닿았기 때문에 player가 nil이었습니다.값이 왜 nil인지 알아내고 쓰기 전에 if로 확인하세요. 이 오류 자세히 보기.
Expected 'end' (to close 'then' at line 2), got <eof>2번 줄의 if에 짝이 되는 end가 없습니다. 함수라면 메시지에 to close 'function'이라고 나오며, <eof>는 파일의 끝을 뜻합니다.마지막 줄이 아니라 괄호 안의 줄을 기준으로 빠진 end를 추가하세요. 메시지가 "did you forget to close ... at line N?"이라는 문구로 끝날 때도 있습니다. 이것은 들여쓰기를 보고 Luau가 추측한 것이라 엉뚱한 블록을 가리킬 수 있으니 먼저 괄호 안의 줄을 확인하세요. 문법 오류 자세히 보기.

스크립트가 아무것도 하지 않고 Output도 비어 있다면, 대개 스크립트가 절대 실행되지 않는 곳에 있거나 발생하지 않는 이벤트를 기다리고 있는 것입니다. 오류 가이드에 조용한 스크립트를 위한 체크리스트와 Output 읽기에 대한 자세한 설명이 있습니다.

오래된 스크립팅 튜토리얼이 다르게 하는 것

영상이나 포럼 글로도 공부한다면 오래된 패턴을 만나게 됩니다. 중요한 것들을, 각각이 왜 문제인지와 함께 정리했습니다.

오래된 튜토리얼의 패턴과 이 가이드가 대신 하는 것
튜토리얼문제이 가이드
wait(1)로 멈춤Roblox 레퍼런스는 전역 wait()를 지원 중단으로 표시하고 task.wait()로 대체되었다고 말합니다.task.wait(1)
Roblox의 용암 강좌처럼 otherPart.Parent로 캐릭터를 찾음모자나 손에 든 도구가 파트에 닿으면 otherPart.Parent는 캐릭터가 아니라 Accessory나 Tool이므로 Humanoid를 찾지 못하고 접촉을 놓칩니다.FindFirstAncestorOfClass("Model"), 그다음 GetPlayerFromCharacter
디바운스 없이 Touched를 씀Touched는 한 걸음에 연달아 여러 번 발생하므로 코드가 계속 다시 실행됩니다.busy 플래그와 쿨다운
Workspace의 파트 안에 LocalScript를 넣음LocalScript는 그곳에서 절대 실행되지 않습니다. 한 플레이어에게 속한 곳에서만 실행됩니다.StarterPlayerScripts의 LocalScript(이유)
part.Touched:connect(...)나 table.getn(list)를 씀Roblox의 이름 짓기 가이드는 camelCase API가 대부분 지원 중단되었다고 말하며, 레퍼런스에는 Connect만 나옵니다. table.getn은 #list로 대체되어 지원 중단되었습니다.:Connect(...)와 #list
LocalScript에서 코인을 바꾸거나 피해를 줌변경이 그 플레이어의 기기에만 남으므로 다른 누구도 보지 못하고 서버도 반영하지 않습니다.게임 규칙은 서버의 Script에

연습: 직접 해 볼 만한 변경 세 가지

코드를 바꿔 보는 것이 읽는 것보다 더 많이 배우게 해 줍니다. 내 플레이스에서 하나씩 해 보고 매번 Play를 누르세요.

  • 발판이 점수를 주게 하기. 리더보드 가이드 1단계의 Leaderstats 스크립트를 추가하세요. 그런 다음 TouchPad에서 busy = true 뒤에 플레이어의 leaderstats 폴더를 찾아 Coins 값에 1을 더합니다. 힌트: player:FindFirstChild("leaderstats"), 그다음 leaderstats:FindFirstChild("Coins"), 그다음 coins.Value += 1. 리더보드 가이드의 코인 발판이 플레이어별 쿨다운까지 갖춘 완성 버전입니다.
  • ColourChanger가 투명도도 바꾸게 하기. ColourChanger가 1초마다 파트의 Transparency도 바꾸게 만드세요. 힌트: { 0, 0.3, 0.6 }처럼 0부터 1 사이 숫자로 된 두 번째 테이블을 추가하고, part.Color 다음 줄에서 같은 index로 그 테이블의 값을 part.Transparency에 설정합니다.
  • 발판의 색 출력하기. E를 누르면 MyFirstLocalScript가 발판의 Color를 출력하게 하세요. 힌트: if pad and pad:IsA("BasePart") 블록 안에 print(pad.Color). 발판이 노란 동안 E를 눌러 보세요. 서버의 변경은 모든 클라이언트에 전달되므로 클라이언트는 서버가 설정한 색을 봅니다.

다음에 배울 것

이제 대부분의 게임 스크립트를 이루는 부품을 써 봤습니다. 다음은 이런 순서가 좋습니다:

  1. LocalScript vs Script vs ModuleScript: 스크립트 종류마다 어디서 실행되고 무엇을 바꿀 수 있는지, 4단계보다 깊이 다룹니다.
  2. RemoteEvents: LocalScript가 서버에 무언가를 요청하는 방법과 서버가 그 요청을 검사하는 방법.
  3. 리더보드: 서버에서 만들고 바꾸는 첫 번째 스탯.
  4. 첫 게임: 서버 스크립트 두 개로 용암, 코인, 결승 발판이 있는 짧은 코스를 만들고 퍼블리시합니다.
  5. 그다음 시스템을 하나 고르세요: 상점 GUI, 라운드 시스템, 오비 체크포인트, 로딩 화면, 키를 누르면 재생되는 애니메이션. 무언가 고장 나면 스크립트 오류 가이드가 메시지 읽는 법을 도와줍니다. 체크포인트 가이드는 아직 영어로만 제공됩니다.

Roblox 자체 튜토리얼 Coding fundamentals(영어)는 이 가이드를 잘 보완합니다. 변수와 함수에서 시작해 조건문, 반복문, 배열, 딕셔너리를 거쳐 ModuleScript로 코드를 정리하는 것까지 여섯 개 시리즈로 구성되며, Studio에서 하는 작은 프로젝트가 함께 있습니다.

자주 발생하는 오류와 해결 방법

첫 스크립트에서 생기는 문제 대부분은 이름이 맞지 않거나, 스크립트가 엉뚱한 곳에 있거나, 대기 없는 반복문입니다. 테스트하는 동안 Output을 열어 두세요.

Play를 누르면 Studio가 멈추거나 응답하지 않아요

while true do 반복문에 대기가 없어서 다른 어떤 것도 실행될 수 없습니다. Roblox 문서에 따르면 task.wait() 같은 지연이 없는 무한 반복문은 게임을 멈추게 하고 Studio를 다운시킵니다. ColourChanger처럼 모든 무한 반복문에 task.wait()를 넣으세요.

발판 위에 올라서도 아무 일도 일어나지 않아요

TouchPad가 LocalScript가 아니라 Script인지, Pad 파트 바로 안에 있는지, 꺼져 있지 않은지, 그리고 발판의 CanTouch 속성이 체크되어 있는지 확인하세요. 그런 다음 onTouched 안의 첫 줄에 print("touched", otherPart.Name)를 넣으세요. 출력되지 않으면 이벤트가 발생하지 않는 것이고, 출력된다면 문제는 그 아래에 있습니다.

E를 눌러도 아무 일도 일어나지 않아요

MyFirstLocalScript는 StarterPlayerScripts 안의 LocalScript여야 합니다. Workspace나 ServerScriptService의 LocalScript는 절대 실행되지 않습니다. 파트 이름은 정확히 Pad여야 하고 Workspace 바로 아래에 있어야 합니다. 스크립트는 게임이 이미 사용한 키를 무시하므로, 먼저 게임 창을 클릭하고 채팅에 입력하고 있지 않은지 확인하세요.

파트가 내 화면에서는 바뀌는데 다른 플레이어에게는 바뀌지 않아요

LocalScript가 변경했기 때문에 내 기기에만 남은 것입니다. 서버 Script에서 바꾸거나, LocalScript가 RemoteEvent로 서버에 요청하게 하세요.

ColourChanger가 파트 안에서는 작동하는데 ServerScriptService에서는 고장 나요

이 스크립트는 script.Parent를 자기 파트로 씁니다. ServerScriptService에서는 부모가 ServerScriptService이고 거기에는 Anchored나 Color가 없으므로 Output에 "not a valid member" 오류가 나옵니다. 파트 안에 두거나, 파트에 이름을 붙이고 local part = workspace:WaitForChild("ColourPart") :: BasePart처럼 이름으로 찾으세요.

Output에 아무것도 나오지 않아요

Output 창이 열려 있는지(Window 메뉴 또는 Script 탭), 필터가 걸려 있지 않은지 확인하세요. Output은 메시지 종류, Client 또는 Server, 텍스트로 필터링할 수 있습니다. 열려 있는데도 비어 있다면 스크립트가 실행되지 않았을 가능성이 큽니다. 아무것도 하지 않는 스크립트를 위한 체크리스트를 보세요.

막혔을 때: RoCode

내 플레이스의 스크립트에서 막혔다면 RoCode가 함께 분석해 줄 수 있습니다. RoCode는 Roblox와 무관한 독립 AI 에이전트로, Roblox Studio용입니다. 웹 채팅에 쓰면 Studio 플러그인이 내 Explorer에서 스크립트를 만들고 수정합니다.

배우는 동안에는 Ask 모드가 유용합니다. 스크립트는 직접 쓰고, RoCode는 이미 있는 것을 읽고 질문에 답합니다.

입력하는 내용

Pad 파트 안에 있는 TouchPad 스크립트가 무엇을 하는지 한 줄씩 설명해 주고, 왜 디바운스를 쓰는지도 알려 줘.

RoCode가 하는 일
  • Ask 모드에서는 Search Scripts와 Read Script 같은 읽기 도구만 쓰고 플레이스에서 아무것도 바꾸지 않습니다
  • 고칠 것이 있으면 무엇을 어디서 바꿀지 알려 주고 Build로 전환하라고 제안합니다
  • Build 모드에서는 스크립트를 그 자리에서 수정한 뒤 Check Script로 하나씩 검사합니다. 이것은 컴파일 검사이며, 타입 검사나 플레이테스트가 아닙니다
  • Check Output 도구로 Studio의 Output을 읽습니다. 마지막 플레이테스트의 Server와 Client 줄도 포함되며, Stop을 누른 뒤에도 읽을 수 있습니다

Build 모드에서 플러그인 3.9 이상이면 RoCode가 짧은 플레이테스트를 실행해 오류를 읽을 수 있고, 3.9.11 이상이면 테스트 캐릭터를 조작할 수 있습니다. 하지만 플레이 중에는 스크린샷을 찍지 않으므로 발판 위에는 여전히 직접 올라서 봐야 합니다. RoCode가 Studio에 연결되는 방식.

자주 묻는 질문

Roblox Studio에서 스크립트는 어디에 쓰나요?

Explorer에서 ServerScriptService 같은 컨테이너에 커서를 올리고 +를 눌러 Script를 고르세요. Studio가 Script Editor에서 열어 주며, 그곳에 Luau를 씁니다. 서버 스크립트는 보통 ServerScriptService에, LocalScript는 StarterPlayerScripts나 StarterGui에 둡니다.

Roblox Studio에서 스크립트를 실행하려면 어떻게 하나요?

Play(F5)를 누르세요. Studio가 플레이테스트를 시작하고, ServerScriptService나 Workspace에 있는 켜진 Script는 게임이 시작되자마자 실행됩니다. StarterPlayerScripts의 LocalScript는 플레이테스트에 입장할 때 실행됩니다. Run(Play 옆 목록에서 고르거나 F8)은 아바타 없이 게임을 실행하므로 이 가이드에서는 Play를 쓰세요. Stop(Shift+F5)으로 테스트를 끝냅니다. 기존 스크립트를 열려면 Explorer에서 더블 클릭하세요.

Roblox는 어떤 프로그래밍 언어를 쓰나요?

Luau입니다. Roblox는 Luau를 Lua 5.1에서 파생된, 빠르고 작고 안전하며 점진적 타입을 지원하는 스크립트 언어라고 설명합니다. 그래서 Lua 튜토리얼 대부분이 여전히 쓸모 있습니다. Luau는 백틱 문자열 보간이나 선택적 타입 주석 같은 기능을 더하고, Roblox는 task.wait 같은 자체 라이브러리와 오브젝트를 더합니다.

Script와 LocalScript는 무엇이 다른가요?

Script는 서버에서 실행되고 그 변경이 모든 플레이어에게 전달됩니다. LocalScript는 한 플레이어의 기기에서 입력, 카메라, 화면 메뉴를 위해 실행되며, 파트, 값, UI에 대한 변경은 그 기기에만 남습니다. 클라이언트와 서버 가이드(영어)가 둘 다, 그리고 ModuleScript까지 설명합니다.

휴대폰이나 iPad로 Roblox Studio에서 스크립트를 쓸 수 있나요?

Roblox 설치 페이지는 Studio를 Windows와 Mac용 무료 앱으로 소개하며 휴대폰이나 태블릿용 버전은 언급하지 않습니다. 따라서 스크립트를 쓰려면 컴퓨터가 필요합니다.

스크립트가 아무것도 하지 않고 오류도 안 나는 이유는 무엇인가요?

대개 그런 스크립트가 실행되지 않는 곳에 있거나(Workspace의 LocalScript, StarterPlayerScripts의 Script), 꺼져 있거나, 기다리는 이벤트가 발생하지 않는 경우입니다. 오류 가이드에 체크리스트가 있습니다.

Roblox 스크립팅을 배우는 데 얼마나 걸리나요?

솔직한 숫자를 말할 수 있는 사람은 없습니다. 얼마나 많이 만들어 보느냐에 달려 있습니다. 가장 도움이 되는 것은 내 플레이스에서 작은 스크립트를 자주 써 보는 것입니다. 여기 나온 스크립트 네 개를 바꿔 보고, 연습 과제를 해 본 다음, 첫 게임 가이드를 따라 하면서 시스템을 하나씩 추가하세요.

출처와 더 읽을거리

코드 검증 방법: 이 페이지의 모든 스크립트는 Roblox API 정의를 적용한 Luau의 엄격한 타입 검사기(luau-lsp, 2026년 11월 20일)를 통과합니다. 타입 검사는 잘못 쓴 API 이름과 잘못된 타입을 찾아내지만 게임 로직의 오류는 찾지 못하므로, 게시하기 전에 Studio에서 직접 테스트하세요.

내 게임에서 RoCode를 사용해 보세요.

매일 무료 크레딧, 카드 등록 없이 시작합니다. 플러그인을 설치하고, 원하는 기능을 설명한 뒤, Studio에 만들어진 결과를 확인하세요.