Luau Best Practices

### Luau Best Practices for [ROBLOX_GAME] - [GAME_SECTION]

#### **1. Server Authority & Validation**
✅ **Do:** Use `ServerScriptService` for critical logic to prevent client exploits.
```lua
-- Server-side validation example
local Players = game:GetService("Players")
Players.PlayerAdded:Connect(function(player)
    if player.UserId == 123456789 then -- Admin check
        player:SetAttribute("IsAdmin", true)
    end
end)
```

❌ **Avoid:** Trusting client-side inputs for game-critical systems (e.g., currency, inventory).

#### **2. Clear Intent with Type Annotations**
✅ **Do:** Use Luau type checking to document and enforce expected data shapes.
```lua
type PlayerStats = {
    Health: number,
    Coins: number,
    Inventory: { Item: string }
}
local function updateStats(player: Player, stats: PlayerStats)
    -- Logic here
end
```

#### **3. Efficient Event Handling**
✅ **Do:** Debounce rapid events (e.g., clicks) to reduce server load.
```lua
local debounce = false
local function onClick(player: Player)
    if debounce then return end
    debounce = true
    -- Process click
    task.delay(0.5, function() debounce = false end)
end
```