# 루아 기초 가이드

## 개요

Luau는 Lua를 기반으로 확장된 가볍고 빠른 스크립팅 언어로, 초심자도 쉽게 학습하고 사용할 수 있습니다. OVERDARE Studio에서 Luau는 높은 창작 자유도를 제공하며 다양한 기능 구현에 최적화된 도구로 사용됩니다.

## 주석

주석은 코드의 기능을 설명하거나, 코드를 실행되지 않게 설정하기 위해 사용합니다.

```lua
-- 한줄 주석
local Num1 = 1

--[[
local Num2 = 2
여러줄에 대한 주석
]]--

local Num3 = 3
```

## 코드 실행 순서

코드는 위에서 아래로 실행되며, 위쪽에서 아래에 선언된 함수나 변수를 호출할 수 없습니다.

```lua
SomeFunc() -- 오류 발생

local function SomeFunc()
    print("SomeFunc")
end
SomeFunc() -- 정상 작동
```

## 변수

루아에서는 변수를 선언할때 정수/실수/문자열 등 **자료형을 명시하지 않으며**, 변수의 범위는 해당 스크립트에서만 접근 가능한 **local**과 다른 스크립트에서도 접근 가능한 **global**로 지정할 수 있습니다.

<pre class="language-lua"><code class="lang-lua">-- 로컬 변수 (선언한 해당 스크립트에서만 접근 가능)
local Num1 = 5
local Num2 = 1.66


-- 전역 변수 (다른 스크립트에서도 접근 가능)
<strong>_G.SomeVar = 50
</strong>print(_G.SomeVar) -- 50 출력


-- 변수 다중 할당 가능
local Text1, Text2 = "A", "B"


-- 변수에 함수를 할당하고 변수로 호출 가능
local function SomeFunction()
    print("SomeFunction")
end

local Func = SomeFunction
Func()
</code></pre>

## 함수

함수의 범위는 변수와 마찬가지로 해당 스크립트에서만 접근 가능한 **local**과 다른 스크립트에서도 접근 가능한 **global**로 지정할 수 있습니다.

```lua
-- 함수 인자나 반환값은 정해진 것보다 많으면 버려지고 적으면 nil로 처리된다.
local function GetVector(x, y, z) 
    print("GetVector X", x, "Y", y, "Z", z)
end
GetVector(1, 0)       -- z는 nil
GetVector(1, 0, 5, 3) -- 마지막 값은 버려짐


-- 여러 값을 반환하거나, 변수 다중 할당도 가능
local function GetVector(x, y, z) 
    return x, y, z
end
local x, y, z = GetVecor(1, 0, 1) 


-- 함수의 가변 인자는 ...로 표시
local function Sum(...) 
    local a, b, c = ... -- 부족한 인자는 nil로 처리된다.
end
Sum(1, 2)


-- 가변 인자는 고정 매개변수와 함께 사용하는 것도 가능
local function Sum(value, ...) 

end


-- 반환 값도 가변 인자로 처리 가능
local function Sum(...)
   return ...
end
```

## local과 global

**local 키워드**를 사용하여 선언된 변수/함수는 해당 변수/함수가 선언된 스크립트에서만 유효하며, 외부에서는 접근할 수 없습니다. 따라서, 동일한 이름의 local 변수/함수가 여러 스크립트에서 사용되더라도 서로 영향을 미치지 않습니다.

**글로벌 테이블(\_G)**&#xC5D0; 선언된 변수/함수는 모든 스크립트에서 접근할 수 있습니다. 단, 같은 이름의 global 변수/함수는 하나만 존재할 수 있습니다.

## 제어문

제어문은 코드의 흐름(실행 순서)을 제어하기 위해 사용됩니다.

### if

```lua
if SomeNumber > 0 then 
    print("Positive Number")
    
elseif SomeNumber > 0 then
    print("Negative Number")
    
else
    print("Zero")
end
```

### goto

goto문은 지원되지 않습니다.

### do

```lua
local number = 10

do
    local number = 5
    print("number (in do) : ", number)
end

print("number (out do) : ", number)
```

## 반복문

반복문은 특정 조건이 충족될 때까지 동일한 코드 블록을 반복 실행하기 위해 사용됩니다.

### for

```lua
-- 시작값, 조건값, 증가값
for i = 1, 10, 1 do 
    print(i) 
    break
end 

-- for문의 증가값은 생략 가능하며 생략시 1로 처리된다.
for i = 1, 20 do 
    print(i)
end
```

### while

```lua
local ConditionValue = 0

while ConditionValue < 5 do 
    ConditionValue = ConditionValue + 1
    print(ConditionValue)
    
    if ConditionValue > 3 then
    	break
    end
end
```

### repeat

```lua
-- 조건이 true가 될때까지 코드 반복
repeat wait(0.1) until SomeCondition
```

## 논리 연산자

논리 연산자는 조건문이나 제어문에서 조건을 결합하거나 판단하기 위해 사용됩니다.

```lua
-- if문 안에서 논리 연산자 사용
if isMonster == true and isBoss == true then 
    print("Monster")
end

if isWalk == true or isRun == true then
    print("On the move")
end

if not isCharacter then 
    print("Not Character")
end


-- 조건에 따른 인자 반환
local resultA = a and b -- 첫번째 인자가 거짓이면 첫인자, 진짜면 두번째 인자 반환
local resultB = a or b  -- 첫번째 인자가 진짜면 첫인자, 거짓이면 두번째 인자 반환
local resultC = not a   -- nil과 false는 true로 반환
```

## 테이블

키-값 쌍으로 데이터를 저장할 수 있는 복합 데이터 구조로, 배열과 같은 데이터도 관리할 수 있습니다.

```lua
local NumberList = { 1, 2, 3 }
print(#NumberList) -- 테이블의 크기 반환


-- 배열 구현
local MatrixData = {}
for x = 1, 5 do
    MatrixData[x] = {}
    for y = 1, 2 do
        MatrixData[x][y] = "Coordinate_" .. x .. "x" .. y
        print(MatrixData[x][y])
    end
end


-- Key(Name)와 Index(EquipItemIDList)로 구성된 테이블
local MonsterData =
{
    Name = "Orc",
    EquipItemIDList = 
    {
        1, 5, 4
    }	
}
print(MonsterData.Name)
print(MonsterData["Name"])
for i = 1, #MonsterData.EquipItemIDList do
    print(MonsterData.EquipItemIDList[i])
end
```

## 코루틴

코루틴(Coroutine)은 실행을 일시 중단하고 필요한 시점에 다시 재개할 수 있는 기능을 제공합니다. 일반 함수와 달리, 코루틴은 멈췄던 상태를 유지한 채 이어서 실행할 수 있으므로, 비동기 작업이나 복잡한 흐름 제어에 유용합니다.

```lua
print("1")

local printCoroutine = coroutine.create(function()
    wait(2)
    print("2")
end)
coroutine.resume(printCoroutine)

print("3") -- 코루틴은 비동기처럼 실행되므로 1->3->2 순으로 출력된다.
```

## Luau 심화 학습

Luau는 일반 Lua에 비해 다양한 고급 기능을 추가로 제공합니다. 이에 대한 심화 학습이 필요하다면 아래 문서를 참고하세요.

{% content-ref url="/pages/Ku0fgHbw1sQbjSAE0vMT" %}
[루아우 가이드](/korean/manual/script-manual/get-started/luau-guide.md)
{% endcontent-ref %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.overdare.com/korean/manual/script-manual/get-started/basic-guide-to-lua.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.