Typed Module
Create a Luau ModuleScript for weighted random rewards with type annotations and a simple usage example.
Likely output: A ModuleScript API with typed tables, validation, and a short ServerScriptService usage snippet.
Luau-focused
Roblox Lua script generator that speaks Luau.
Roblox developers often say Lua, but modern Roblox scripting uses Luau. This page focuses on Luau patterns, Roblox services, and Studio placement details that plain Lua snippets usually miss.
Example prompts and outputs
CollectionService Tags
Generate a Luau script that uses CollectionService tags to make all tagged bounce pads launch players upward.
Likely output: A ServerScriptService Script using CollectionService, touched handling, and debounce state.
RemoteEvent Contract
Create a Luau RemoteEvent pattern for requesting a daily reward with server-side cooldown checks.
Likely output: A server handler and a minimal client call with validation notes.
Reviewable implementation evidence
Manual Studio verification requiredTyped Luau weighted-reward module
A strict, reusable ModuleScript with an exported record type, validation, and injectable randomness for deterministic tests.
Prompt
Write a --!strict Luau module that chooses a weighted reward and rejects empty or invalid reward tables.
--!strict
export type Reward = {
name: string,
weight: number,
}
local WeightedRewards = {}
function WeightedRewards.choose(
rewards: { Reward },
random: Random?
): Reward
assert(#rewards > 0, "At least one reward is required")
local totalWeight = 0
for _, reward in rewards do
assert(reward.weight > 0, "Reward weights must be positive")
totalWeight += reward.weight
end
local generator = random or Random.new()
local roll = generator:NextNumber(0, totalWeight)
local cursor = 0
for _, reward in rewards do
cursor += reward.weight
if roll <= cursor then
return reward
end
end
return rewards[#rewards]
end
return WeightedRewardsSetup
- Create ReplicatedStorage/Shared and add a ModuleScript named WeightedRewards.
- Require it from a server Script for authoritative reward selection.
- Pass Random.new(seed) in tests when you need repeatable selections.
Verification checklist
- Call choose with two positive weights and confirm it returns one of the supplied records.
- Pass an empty table and confirm the assertion identifies the missing rewards.
- Pass a zero or negative weight and confirm validation fails before selection.
Expected result
Callers receive one typed Reward record, while malformed configuration fails with a specific assertion.
Limitations
This module only selects a value. The server must separately grant, persist, and audit any valuable reward.
Supported request types
- Typed Luau modules
- Roblox service usage
- RemoteEvent contracts
- CollectionService patterns
- Debounce and cooldown logic
Roblox Studio installation guidance
- Use ModuleScripts for reusable functions and require them from Scripts or LocalScripts.
- Use type annotations when they make APIs clearer, not as decoration.
- Place shared modules in ReplicatedStorage only when both client and server can safely read them.
Common mistakes
- Using generic Lua APIs that do not match Roblox services or instances.
- Putting server secrets or reward authority in a shared ModuleScript.
- Assuming a table type makes runtime data safe without validation.
Debugging guidance
- Use Luau type warnings as early signals, then verify runtime behavior in Output.
- Print module return values when require paths are unclear.
- Check whether a module is running on the client, server, or both.
Limitations
- Luau types help readability and tooling, but they do not replace runtime checks for player input.
- Generated snippets may need object names adjusted to your place hierarchy.
Safety and responsible use
- Keep purchase validation and reward grants in server-only scripts.
- Do not use generated code to bypass Roblox platform restrictions or exploit other games.
FAQs
Is Roblox Lua different from Luau?
Roblox uses Luau, a Lua-derived language with Roblox APIs, optional typing, and performance-oriented syntax support.
Should I ask for types in every script?
Ask for types when a module or API will be reused. Small one-off scripts can stay simpler.