腳本

*此內容是使用 AI(Beta 測試版)翻譯,可能含有錯誤。若要以英文檢視此頁面,請按一下這裡。

腳本是純文本文件,讓您可以為遊戲添加自定義的動態行為。您可以使用腳本來觸發遊戲內事件、響應玩家輸入、保存玩家數據、創建排行榜、生成敵人、控制 NPC 行為等等。

Luau

Roblox 腳本使用 Luau 程式語言,該語言源自 Lua 5.1。

  • 與 Lua 5.1 相比,Luau 增加了性能增強和許多有用的功能,包括可選的類型系統、字符串插值和表的通用迭代。
  • 所有有效的 Lua 5.1 代碼都是有效的 Luau 代碼,但反之則不然。

大多數有關 Lua 的書籍和在線資源仍然廣泛適用於 Luau。要了解詳細的差異摘要,請參見 Luau 文檔中的 兼容性。有關語言語法,請參見 Luau 參考。

Luau 基礎

Luau 是逐漸類型化的,因此在創建變量時不需要指定類型。您可以使用 type() 來檢查對象類型:

logMessage = "用戶擁有超過 10 件物品!"
print(logMessage) --> 用戶擁有超過 10 件物品!
print(type(logMessage)) --> string

Luau 有全局和局部 範圍,但幾乎總是更好地使用 local 關鍵字來聲明變量和函數:

local logMessage = "用戶擁有超過 10 件物品!"
local function printMessage()
print(logMessage)
end
printMessage() --> 用戶擁有超過 10 件物品!

Luau 使用 nil 來表示不存在或空值,在條件語句中評估為 false:

local messageToUser
print(messageToUser) --> nil
print(type(messageToUser)) --> nil
if messageToUser then
-- 語句評估為 false
end

正如您可能已經注意到的,-- 開始一行註釋。--[[]] 創建一個塊註釋:

--[[
立即關閉宇宙月光射線。
應僅在午夜山區標準時間的 15 分鐘內調用,以避免對宇宙月光射線造成損害。
]]
local function stopCosmicMoonRay()
-- 稍後添加,這可能很重要
end

表 是數組和字典的通用術語。數組是基於 1 的,而不是基於 0,因此第一個項目是 [1]。您可以使用一組大括號來聲明數組和字典:

local myArray = {"薯片", "氣泡水", "莎莎醬"}
local myDictionary = {
snack = "薯片",
drink = "氣泡水",
dip = "莎莎醬"
}
print(myArray[1]) --> 薯片
print(myDictionary.dip) --> 莎莎醬

您可以使用 for 循環和 ipairs() 函數來遍歷數組,使用 pairs() 函數來遍歷字典,但 Luau 也允許您省略這些函數以獲得更簡潔的語法:

for index, value in ipairs(myArray) do -- 標準 Lua
print(index, value)
end
for key, value in pairs(myDictionary) do -- 標準 Lua
print(key, value)
end
for key, value in myDictionary do -- Luau 通用迭代
print(key, value)
end

您的第一個腳本

  1. 在 Roblox Studio 中,將鼠標懸停在 Explorer 窗口中的 ServerScriptService 上,然後單擊 +。

  2. 選擇 Script 以添加新腳本。

  3. 右鍵單擊腳本並將其重命名為 HelloScript。

  4. 雙擊腳本以在 腳本編輯器 中打開它。

  5. 將以下代碼添加到文件中:

    local helloArray = {"h", "e", "l", "l", "o"}
    local worldArray = {"w", "o", "r", "l", "d"}
    for index, value in helloArray do
    print(value)
    end
    print(table.concat(worldArray))
  6. 確保 Output 窗口已打開。

  7. 運行您的遊戲 並注意輸出:

    h
    e
    l (x2)
    o
    world

讓自己舒適

適應新開發環境的一個重要部分是配置它以滿足您的需求並了解可用的工具:

  • Studio 設置 中的 腳本編輯器 部分讓您可以調整生活質量功能,如字體、顏色、縮進、自動完成、括號和工具提示。您可能還想在 Studio 部分啟用黑暗模式。
  • 按住 Ctrl 或 Command 並單擊函數或變量會將您帶到代碼庫中的聲明(或其在線文檔)。使用 查找和查找所有 可以幫助您導航更大的項目。
  • Output 窗口是理解腳本行為的最基本工具。使用 ⋯ 菜單啟用 顯示上下文 和 顯示源。
  • 腳本分析 窗口顯示錯誤和警告的摘要,但您可能會發現其實用性有限;腳本編輯器在您輸入時已經突出顯示這些問題。
  • 日誌功能非常有限,沒有 DEBUG 或 FATAL 等日誌級別的概念。使用 print() 和 warn()。

有關配置 Studio 以進行腳本編寫的更多信息,請參見 腳本編輯器。

您的第二個腳本

  1. 在 Roblox Studio 中,向 Explorer 窗口中的 ReplicatedStorage 添加一個腳本並將其重命名為 OhNo。

  2. 將以下代碼添加到文件中:

    print("你好,腳本類型和位置!")
  3. 注意輸出與您運行 第一個腳本 時沒有任何不同。

要了解為什麼腳本沒有運行,請參見 腳本類型和位置。

©2026 Roblox Corporation、Roblox、Roblox 標誌及 Powering Imagination 是我們在美國及其他國家地區的部分註冊與未註冊商標。