Roblox globals

顯示已棄用項目

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

Roblox 在包含 Luau 時提供了多種獨特的內置功能和變量。這些只能在 Roblox 上找到，並不會預設裝配到 Luau 或 Lua 中。

概要

函式

  • elapsedTime():number

    返回 Roblox 目前實例運行的時間（秒）。

  • PluginManager():PluginManager

    指向插件管理器，一個過時的單獨實體，以前需要創建插件。

  • settings():GlobalSettings

    返回 GlobalSettings 對象，可用於存取設定對象，配置 Roblox Studio 的行為。

  • tick():number

    返回此裝置的時間後，從 Unix 時代開始的秒數。

  • time():number

    返回自現有遊戲實例開始運行以來的秒數數量。

  • typeof(object : Variant):string

    返回指定對象的類型為字串，也支持 Roblox 特定類型 (例如 Vector3)。

  • UserSettings():UserSettings

    返回使用者設定對象，用於閱讀當前使用者的遊戲選單設定中的資訊。

  • version():string

    以字串形式返回 Roblox 的當前版本，包括生成、版本、修補和提交。

  • warn(params : Tuple):()

    與列印相似，但具有更明顯的格式（黃色），用於描述潛在問題的訊息。

屬性

  • Enum:Enums

    包含所有枚列對象。

  • game:DataModel

    指向數據模型單例，一個地方的層級根例子。

  • plugin:Plugin

    在 Studio 插件的上下文中運行代碼時，指向插件單例。

  • shared:Array

    一個表，在相同的執行上下文等級上運行的所有代碼之間共享。

  • script:LuaSourceContainer

    執行此代碼的 LuaSourceContainer 對象（Script、LocalScript 或 ModuleScript）的參考。

  • workspace:Workspace

    一個指向工作區服務的參考，包含一個地方的所有物理組件。

函式

elapsedTime

number

返回自 Roblox 目前版本開始以來已過多久的時間。在 Roblox Studio 中，這從 Roblox Studio 開始運行的時刻開始計數，不僅僅當開啟一個地方時。

返回

number

PluginManager

PluginManager

返回 PluginManager ，這是一個過時的單獨實體，以前需要創建插件。它仍然有可用的用途，例如如果您需要從 Roblox Studio 的指令欄創建插件對象。

返回

PluginManager

settings

GlobalSettings

返回 GlobalSettings 對象，可用於存取 Roblox Studio 設定選單中使用的設定對象。

返回

GlobalSettings

tick

number

返回自 Unix 時代以來，當前本地會話電腦上經過的時間，以秒為單位。在 1970 年 1 月 1 日的 00:00:00 表示了 UNIX 時代。

tick() 未被正式廢止，但有各種問題。它最多可能延遲一秒，並且在時區和操作系統之間返回不一致的結果。使用 os.time() , os.clock() 或 time() 取代。也考慮 DateTime.UnixTimestamp 和 DateTime.UnixTimestampMillis 。

返回

number

time

number

返回自現有遊戲實例開始運行以來所經過的時間，以秒為單位。如果目前的遊戲實例未運行，這將是 0 。

返回

number

typeof

string

返回指定的對象類型，作為字串。此功能比 Luau 的原生 type 功能更準確，因為它不會標示 Roblox 特定類型為 userdata 。

參數

object: Variant

將檢查其類型的 Luau 類型。

返回

string

UserSettings

UserSettings

返回 UserSettings 對象，用於閱讀當前用戶的遊戲選單設置中的信息。

返回

UserSettings

version

string

返回 Roblox 的當前版本為字串。版本字串中的整數以週期分開，每個整數分別代表以下內容：

  • 生成 - 正在主持客戶端的應用程式殼的當前世代。
  • 版本 - Roblox 目前的發行版本。
  • 更新 - 此版本的 Roblox 的目前更新數字。
  • 提交 - 被接受到此版本客戶端的最後一個內部提交的ID。

返回

string

warn

()

行為與 Luau 的列印功能相同，除了輸出以警告格式呈現，包括黃色文字和時間戳。此功能接受任何數量的參數，並會嘗試將它們轉換為包含空格的字串，然後結合在一起。

參數

params: Tuple

此功能接受任何數量的參數，並會嘗試將它們轉換為包含空格的字串，然後結合在一起。

返回

()

屬性

Enum

Enums

一個引用到枚數資料類型的參考，該資料類型儲存了 Roblox 上可使用的所有枚數。

game

DataModel

對 DataModel 的參考，這是 Roblox 父/子階層的根實例。

plugin

Plugin

代表從此 Script 執行的插件的 Plugin 對象的參考。此參考只在執行腳本作為插件的上下文中存在，不會傳到 ModuleScripts 內的插件中。要在 ModuleScript 中使用此參考，您必須明確傳递它。

assert(plugin, "This script must be run as a plugin!")

-- Code beyond this point will execute only if the script is run as a plugin

shared

Array

一個表，在所有共享相同執行上下文等級的腳本中共享。這與 _G 具有相同的目的。

script

LuaSourceContainer

指向執行你寫的代碼的腳本對象的參考。它可以是 Script , LocalScript 或 ModuleScript 。當在 Roblox Studio 指令欄執行代碼時，此變量無法使用。

workspace

Workspace

一個參考 Workspace 服務，包含 Roblox 世界的所有物理組件。