Luau-Luau scripting for Roblox developers

Example

Enable strict type checking at the top of a ModuleScript to get compile-time feedback and catch API mismatches early: ```lua --!strict export type PlayerStats = { health: number, mana: number, } local Stats = {} function Stats.new(h: number, m: number): PlayerStats return { health = h, mana = m } end return Stats ``` The `--!strict` directive turns on Luau's stricter checking for that file and `export type` documents and enforces the module's public types.

Scenario

Real-world use: In a team with separate scripters and systems (combat, UI, save/load), one team writes a `PlayerStats` module and exports the type. Other teams use that exported type to safely interact with player data; CI runs the Luau type checker on each commit to prevent accidental API changes from shipping. This reduces runtime nil errors and mismatched field usage across modules.

Example

Common server pattern handling a RemoteEvent with validation: ```lua -- Server-side Script local remote = game.ReplicatedStorage:WaitForChild("UseItemRemote") remote.OnServerEvent:Connect(function(player, itemId) -- Validate caller and input if typeof(itemId) ~= "number" then warn("Invalid itemId from", player.Name) return end local success = InventoryService:ApplyItemToPlayer(player, itemId) if not success then warn("Failed to apply item", itemId, "for", player.Name) end end) ``` This shows connecting to engine events, validating network input, and delegating logic to services or ModuleScripts.

Scenario

Real-world use: Multiplay games must be server authoritative. Using Luau inside Roblox Studio, developers wire Instance events (`Touched`, `Heartbeat`, `OnServerEvent`) to ModuleScripts that encapsulate logic. Validation in event handlers prevents hacked clients from doing illegal actions. Modules keep logic testable and shareable between scripts (server, plugins, or tests).

Example

Module pattern and lightweight object style: ```lua -- HealthModule (ModuleScript) local Health = {} Health.__index = Health function Health.new(maxHealth) return setmetatable({ max = maxHealth, current = maxHealth }, Health) end function Health:TakeDamage(amount) self.current = math.max(0, self.current - amount) end return Health ``` Example using `task.spawn` for non-blocking background work: ```lua task.spawn(function() -- expensive but non-blocking work for i = 1, 1000 do -- do something spread across frames task.wait() end end) ``` (Using `task.*` APIs is a Roblox runtime idiom for safe concurrency — Luau code works naturally with those tools.)

Scenario

Real-world use: Large games structure code into ModuleScripts by subsystem (AI, UI, inventory). The team uses constructor patterns (above) for reusable components. For background tasks (map generation, asynchronous loading), `task.spawn`/`task.defer` or coroutines keep the main thread responsive. Combined with Luau types and code organization, this makes complex systems maintainable and easier to test.