roblox-game-systems — Claude Code skill: what it does, how to install
roblox-game-systems — a skill for Claude Code and Codex providing server-authoritative Roblox gameplay recipes. Activates when building currencies, inventory, weapons, round loops, or progression.
MIT 1,300 installs ★ 131 updated 2026-11-03
npx skills add EL4CTEO/roblox-skills --skill roblox-game-systems -a claude-codeWhat roblox-game-systems does
Provides Luau patterns where state remains strictly on the server while clients dispatch validated intents via remotes. Replicated attributes handle user interface updates without granting clients authority.
Included blueprints cover economy services, player leaderstats, XP levels, daily gifts, round intervals with team management, verified melee or projectile combat, gear storage, and pet companions. The sample CurrencyService.luau caps accounts at 1e12 and isolates writes to a single owner module.
Scripts depend on strict typing and integrate with persistence layers such as ProfileStore. Logic handles mid-game connections, character respawns, unexpected departures, and server shutdown events cleanly.
What it helps with
- build a server-authoritative soft currency service with attribute sync
- implement round loops with lobby intermissions and team assignment
- validate melee and ranged weapon hits directly on the server
- create an inventory manager for equipping items and purchasing gear
- wire up obby checkpoints, daily logins, and leaderstats tables
Example prompts for the agent
- Write a Luau CurrencyService module that syncs player coins using attributes
- Create a round system handling intermission, active match, and rewards
- Add server-side hit validation and cooldown checks for a melee weapon
How to install roblox-game-systems
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-game-systems -a claude-code2Manually: put the files in place
~/.claude/skills/roblox-game-systems/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/roblox-game-systems/
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-game-systems -a codex2Manually: put the files in place
.agents/skills/roblox-game-systems/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-game-systems -a cursor2Manually: put the files in place
.cursor/skills/roblox-game-systems/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install EL4CTEO/roblox-skills skills/roblox-game-systems2Manually: put the files in place
.github/skills/roblox-game-systems/SKILL.md1Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-game-systems -a gemini-cli2Platform CLI
gemini skills install https://github.com/EL4CTEO/roblox-skills --path skills/roblox-game-systemsManually: put the files in place
.devin/skills/roblox-game-systems/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add EL4CTEO/roblox-skills --skill roblox-game-systems -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about roblox-game-systems
How to install roblox-game-systems in Claude Code?
Run npx skills add EL4CTEO/roblox-skills --skill roblox-game-systems -a claude-code in your terminal.
What does roblox-game-systems do?
It provides authoritative server-side recipes and architectural guidelines for Roblox game systems.
What is required for roblox-game-systems?
A Roblox Luau environment and a persistence layer like ProfileStore to save player balances.
Source text
SKILL.md · MIT
---
name: roblox-game-systems
description: Recipes for common systems built on server authority - currency service and leaderstats, XP/levels, round loops with intermission and teams, validated melee/ranged combat, inventory and tools, soft-currency shops, obby checkpoints, daily rewards, pets. Use when implementing or reviewing gameplay systems such as rounds, combat, weapons, inventories, shops, currencies, or progression.
---
# Game systems recipes
Every recipe follows the same contract:
1. **State lives on the server** in a service module; persistent parts go through the data layer
(`roblox-data-stores`).
2. **Clients send intents** through validated, rate-limited remotes (`roblox-security`,
`roblox-networking`) and render state they receive (attributes, snapshots/deltas).
3. **Config is data**: tunables in a shared/server config module (or live `ConfigService` configs).
4. **Lifecycle-safe**: handles late joiners, respawns, leaving mid-action, and server shutdown.
| System | Reference |
| --- | --- |
| Leaderstats, currency service, XP/levels, daily rewards, obby checkpoints | [references/progression.md](references/progression.md) |
| Round loop (intermission → match → results), teams, spawning | [references/round-system.md](references/round-system.md) |
| Melee and ranged combat with server validation, cooldowns, damage attribution | [references/combat.md](references/combat.md) |
| Inventory, equipping tools, shop purchases (soft currency), pets that follow | [references/inventory-shop.md](references/inventory-shop.md) |
## Currency service (the pattern every economy uses)
```luau
--!strict
-- ServerScriptService/Server/Services/CurrencyService.luau
local Players = game:GetService("Players")
type Balances = { [Player]: number }
local MAX_BALANCE = 1e12
local CurrencyService = {}
local balances: Balances = {}
local function publish(player: Player)
player:SetAttribute("Coins", balances[player]) -- replicated to every client; UI listens
end
function CurrencyService.load(player: Player, saved: number?)
balances[player] = math.clamp(saved or 0, 0, MAX_BALANCE)
publish(player)
end
function CurrencyService.get(player: Player): number
return balances[player] or 0
end
-- Positive amount only; returns the new balance.
function CurrencyService.add(player: Player, amount: number, _source: string): number?
local balance = balances[player]
if balance == nil or not math.isfinite(amount) or amount <= 0 then
return nil
end
balances[player] = math.min(balance + math.floor(amount), MAX_BALANCE)
publish(player)
return balances[player]
end
-- Atomic check-and-spend; false if insufficient.
function CurrencyService.spend(player: Player, amount: number, _sink: string): boolean
local balance = balances[player]
if balance == nil or not math.isfinite(amount) or amount <= 0 or balance < amount then
return false
end
balances[player] = balance - math.floor(amount)
publish(player)
return true
end
Players.PlayerRemoving:Connect(function(player)
balances[player] = nil -- after the data layer has saved it
end)
return CurrencyService
```
- One module owns each resource; nothing else writes it. Log sources/sinks to analytics
(`roblox-analytics-liveops`).
- The in-memory balance is saved by the data layer (ProfileStore `profile.Data.coins`) — or make the
profile table the balance store directly.
- For display, clients read `player:GetAttribute("Coins")` and `GetAttributeChangedSignal("Coins")`.
`leaderstats` (a Folder with `IntValue`s under the player) shows values in the player list.
## Design checklist for any new system
- [ ] Where does authoritative state live, and how is it persisted?
- [ ] What can the client request, and how is each request validated and rate-limited?
- [ ] What happens on join mid-session, respawn, leave, teleport, and server shutdown?
- [ ] How is it tuned (config) and measured (analytics)?
- [ ] How does it behave with 1 player, full servers, and high latency?
- [ ] Is it streaming-safe on the client?
## Related skills
`roblox-architecture`, `roblox-security`, `roblox-data-stores`, `roblox-networking`,
`roblox-characters-animation`, `roblox-monetization`, `roblox-ui`.
© EL4CTEO · MIT · EL4CTEO/roblox-skills