The Template already contains saving, networking, interface, support tools and optional gameplay kits. This catalogue maps each system to its owner, switch and source note. The detailed notes named below are paths in the Template repository's docs/systems/ folder; they are not pages in the platform vault.
Paths beginning Services/, Controllers/, UI/, Config/, Rules/, Util/ and Roblox/ are relative to src/core/server/, src/core/client/ or src/core/shared/ as appropriate, and bootstrap/ to src/core/. server/Roblox/ names the server's engine wrappers (Http, MemoryStore, MessagingBus), which have no lifecycle and are not services. Server-only config is explicitly named. The current switches and their defaults are in src/core/shared/Config/Features.luau; off skips the system's lifecycle and associated interface. Required core systems have no switch.
Saving, replication and the player session
These are the shared foundations most gameplay services use. See Data and saving and Server authority for their contracts.
- Data
Core, always on.
Services/DataService(a folder module:init.luauand its private parts) owns ProfileStore profiles, sandboxed copies, shared values and ordered stores; sharedPlayerData,AccountDataandUtil/Migrationsdefine their data. While Roblox's DataStores are down, a load waits (ProfileStore retries until the player leaves) instead of kicking. Source note:docs/systems/Data.md.- Save slots
Core, configured through
Config/Savesrather than a feature switch.DataServiceandSaveServiceown slot profiles and transitions;UI/Screens/SavePickerpresents the choice. Each slot is a complete save, whileRules/Savessummarizes available slots; the slot being played is listed from memory, the others are read. Source note:docs/systems/Save Slots.md.- Save support
Core, with
admin. Four developer commands (saveversions,savepreview,saverestore,saveedit) list a save's stored versions, compare one with the save now, roll the save back and set one allowlisted field in an offline player's save. Every write is a new stored version, so a rollback can be rolled back, and the purchase ledger is kept. They read and write the real store only.DataService/VersionsandRules/SaveSupporthold the logic. Source note:docs/systems/Save Support.md.- Account data
Core, always on.
DataServiceloads the separatePlayerAccountsprofile, exposed privately asClientState.accountData. It stores once-per-account facts such as code use, daily rewards and referrals independently of the selected slot. A reward taken once per account (a code, a daily reward, a referral payout or welcome, a subscription period, the Premium bonus, the group reward, a staff support grant) is a claim throughServices/ClaimServiceandRules/Claims: one account write records the marker and the claim inAccountData.claims, the payment waits for a confirmed account save (DataService.saveAccountAndConfirm), then oneRewardService.grantpays every reward whole with aclaim-<id>receipt in the slot. A reward that does not fit (RewardService.fits:at_cap,inventory_fulland the rest) is refused with nothing written. A real claim forces two saves; a test-mode claim none. Source note:docs/systems/Account Data.md.- Networking
Core, always on.
Shared.Remotesdeclares guarded intents, queries, facts and traps;Roblox/RemoteGuardvalidates their arguments before each owning service's handler checks meaning. Source note:docs/systems/Networking.md.- MemoryStore
Core, not a service.
server/Roblox/MemoryStoreis the only caller ofMemoryStoreService: it hands out sorted maps, hash maps and queues whose calls check Roblox's limits before any request, retry a throttled request with backoff, count their request units forbudgetsand answer aResultinstead of throwing.PlatformService,ExperienceNotificationServiceandReservedServerServicego through it. Source note:docs/systems/MemoryStore.md.- Messaging bus
Core, not a service.
server/Roblox/MessagingBusis the only caller ofMessagingService: every cross-server topic is declared with a payload check and a publish rate, a message that does not fit is refused before it reaches Roblox, a failed publish is retried, and a failed subscription is tried again every 60 seconds until Roblox accepts it. Each server subscribes once per topic and hands each valid message to every local handler; the functionsubscribereturns removes the handler, and the server unsubscribes once a topic's last handler is gone. Players never send or see these messages. Source note:docs/systems/Messaging.md.- Http
Core, not a service.
server/Roblox/Httpis the only caller ofHttpServicefor outbound requests and experience secrets: it keeps the server under Roblox's limits (500 requests a minute to any host, plus 2,500 to Open Cloud) with a per-host share fromConfig/Http, retries whatRules/Httpsays is worth retrying, counts requests by host forbudgets, and reads secrets once without printing them. A request the budget refuses comes backlimited.PlatformServiceandExperienceNotificationServicesend through it. Source note:docs/systems/Http.md.- State sync
Core, always on.
Services/SyncServicereplicatesSharedStateand each player's private saved or optional state throughsync.startandsync.patch.SyncControllerpopulates client atoms; the sync layer is not another saved store. Source note:docs/systems/State Sync.md.- Session
Core, always on.
Services/SessionServicetracks visits, timestamps and playtime throughDataService, and publishes session facts inSharedState. Saved keys includecreatedAt,lastSeenAt,sessionsandplaytimeSeconds. Source note:docs/systems/Session.md.- Characters
Core, always on.
Services/CharacterServiceowns player characters:Config/CharacterssetsPlayers.CharacterAutoLoads(off by default, so the service spawns on join and respawns 5 seconds after a death, retrying a failed load), and game code callsrespawn, places spawns withsetSpawnPicker(a place in the void is ignored) and waits on thereadysignal. Unused Humanoid states (FallingDown,Flying,Ragdoll,StrafingNoPhysics) are disabled on the server and, throughCharacterController, on the owning client; climbing and swimming are on, so trusses and water work, and a game without them turns them off inConfig/Overrides/Characters.descriptionFor,applyDescriptionandrestoreDescriptionhandle avatars. Source note:docs/systems/Characters.md.- AFK
Core, always on.
AfkServiceandAfkControllermark a player with no input forConfig/Afk.afkSeconds(two minutes) as AFK, from the client's idle hint stamped with server time: other players see an AFK row on the player's overhead, staff see it in the inspector and withafk, and playtime rewards stop counting. A phone's motion sensors do not clear it, so an idle phone stays AFK, and the client listens to input only while the player is reported AFK or warned. A warning toast comes before Roblox's 20-minute idle kick; the game never moves or kicks an AFK player.SharedState.afkUsersis public; nothing is saved. Source note:docs/systems/AFK.md.- Settings
Core, always on.
SettingsServicevalidates preferences and binding changes;SettingsWindow,SoundController,MusicController,InputControllerandGraphicsControllerapply the synced result. Values live in per-slotsettingsandbindings, defined byConfig/SettingsandConfig/Input. Settings also opens the HUD layout editor (Customize layout), whosesettings.requestLayoutshares the settings bucket;SettingsService.saveLayoutwritesPlayerData.layout. Source note:docs/systems/Settings.md.- Collision groups
Core, always on.
CollisionGroupServiceregisters the groups inConfig/CollisionGroupsonce at boot (checked byRules/CollisionGroups: known groups, one answer per pair, Roblox's limit of 32 withDefault) and keeps parts in them: player characters inPlayers, NPCs inNpcs, parts taggedCollisionEffects(or every part under a tagged model) inEffects. NPCs pass through each other; effects land on the world but never touch players, NPCs or each other; players collide with each other, as in Roblox, until a game setsPlayers.collides.Players = falseinConfig/Overrides/CollisionGroups. A game adds its own groups and tags there. Nothing is saved. Source note:docs/systems/Collision Groups.md.- Streaming
Core, always on. Every place streams its world: the baseline (
StreamingEnabled,PauseOutsideLoadedArea, a 64-stud minimum and 512-stud target radius, opportunistic stream-out) is in theWorkspaceentry of each place's project file, andlune run buildholds every place to it.Roblox/Streamingmoves players and waits for parts safely under streaming. Nothing is saved. Source note:docs/systems/Streaming.md.
Interface and device systems
Screens compose shared components and read state rather than deciding rewards. See The Template UI for Fusion, Charm and device behavior.
- UI and device facts
Core, always on. Client
Device,DeviceController,UIController,UI/App,Theme,Topbar,Menu, components (charts inUI/Components/Charts, among themSparkline) and screens own the interface.Device.device()describes input and device facts, andUI/Util/deviceStateshares the common ones (touch,gamepad,vr,reducedMotion,scale,room) with every component through one subscription each;UI/Util/fromCharmbridges atoms into Fusion,UI/Util/keyedkeeps list rows while their key stays, andUI/Util/rowWindowbuilds only the rows in view.WindowhasFitContent(a game's own form window sets it);DropdownhasInline,SelectedMany(several picks, each with a tick) andKind = "user"(people, with headshots and names). The top bar holds Settings, Feedback (whileplatformis on), Friends (whilecommunityorreferralsis on), the custom player list's Players button on touch, with a controller and in VR, and staff tools; a game's own windows open from the menu. Source note:docs/systems/UI.md; handbook: the interface.- HUD layout
Core, always on; the players' editor is
layoutEditor, on by default. Every HUD piece is a widget ofConfig/LayoutthatLayoutControllerplaces with the pureRules/Layout.solve, so nothing overlaps on any screen; screens bind to their widget withUI/Util/widget. Roblox's chat window, thumbstick and jump button are kept clear where Roblox reports them. A game names regions or its own zones,"free"or"strict"mode, and adds its own widgets inConfig/Overrides/Layout.luau. Players rearrange the unlocked widgets in Settings, Customize layout (Screens/LayoutEditor), saved per device class inPlayerData.layoutthroughsettings.requestLayoutandSettingsService.saveLayout. Source note:docs/systems/Layout.md; handbook: the HUD layout.- Chat
Core, always on;
Config/Chat.modepicks the window."roblox"(the default) styles Roblox's own window, input bar, tabs and bubbles from the Theme (Theme.chat, messages and bubbles at 18 px);"custom"turns Roblox's off and draws the Template's (Screens/Chat,Components/ChatWindow) or a game's (ChatController.setWindow), on TextChatService;"none"shows no window. Names carry the role, Premium, subscription and title tags, and a role colours the name and bubble. Bubbles stand on the overhead's top row (Config/Overhead.anchor). The chat window is the layout'schatwidget: Roblox's moves among the eight places Roblox can draw it (Rules/Chat), the Template's anywhere.Config/Chat.robloxWindow(how Roblox sizes its window) is read only by the layout, to keep the chat's area right on a resized screen. In custom mode D-pad Up puts the cursor in the bar while nothing is selected, and the bar's placeholder says so (chat.placeholderGamepad); with a selection the D-pad moves it, and A on the selected bar focuses it. A game restyles withChatController.styleandsetMessageFormatter, which must keep the text Roblox delivered. The bar stays off while muted or whenCanUserChatAsyncsays no. The controller is ready for Roblox's platform-integrated chat (required from May 2027), which hides message text from scripts: it notices (orConfig/Chat.platformIntegratedsays so), drops the tags, and in custom mode shows Roblox'sTextChannelWindowin the Template's frame. Nothing is saved; no remote. Source note:docs/systems/Chat.md.- Player list
Core, always on;
Config/PlayerList.modepicks the list.PlayerListServicewrites each player'sleaderstatsfromConfig/PlayerList.stats(a currency, a saved stat, or a value the game sets withPlayerListService.set) as text, so huge numbers fit, at most once perupdateSeconds(1) andmaxRowsPerSecond(100) rows a second across the server; test-mode players keep their real save's values."roblox"(the default) uses Roblox's list, which cannot be styled; the columns keep config order through aPrioritychild."custom"hides Roblox's and shows the Template's (Screens/PlayerList,Components/PlayerRow): a compact panel in a corner, one line per player with headshot, name, role and a column per stat, sorted and grouped by team, opened with Tab,ButtonR3or a Players button in the top bar on touch, with a controller and in VR (assets.images.icons.players; a console has no Tab key, and nothing on screen names R3); a row pops out a player card (Components/PlayerCard) with Roblox's Add friend, View avatar and Block prompts, and a Trade button whiletradingis on withConfig/Trading.entry.playerCard. A player who is already a friend has a small friends icon after the name on their row and a still Friends mark on the card where Add friend would be (FriendshipController:IsFriendsWithAsynconce per player, from the list's first opening, kept current by Roblox's friended and unfriended events).PlayerListController.addColumn,removeColumn,setSort,setRowandrefreshshape it from game code."none"writes no stats. Nothing is saved; no remote. Source note:docs/systems/Player List.md.- Loading screen
Core, always on.
bootstrap/Loading.clientandbootstrap/LoadingScreenappear before packages replicate, always with the "Powered by Blockout Games" attribution (LICENSE.md, section 2).LoadingControllerpreloads the critical tier of asset ids (Config/Loading.preload,Rules/Preload; the hud tier follows behind the screen, the background tier after spawn in small batches, a window's own assets on its first opening; an image goes toPreloadAsyncas anImageLabelshowing it, because a bare id string fails for an uploaded image), preloads world instances taggedPreloadonce the place loads, and waits for the player's data, side by side under one timeout, usingConfig/LoadingandConfig/Brand. Source note:docs/systems/Loading Screen.md.- Overhead
Core, always on.
OverheadControllerdraws an overhead over each character's head (and over any model taggedOverhead, such as an NPC), with rows stacked from the head up: the name (10), the worn title (20, fromTitleController) and the AFK tag (30, fromAfkController). A game adds a row withOverheadController.addRowand callsrefreshwhen its value changes. At mostmaxShown(20) are drawn, the nearest withinmaxDistance(60 studs), and only those hold a billboard, taken from a pool and handed on as others come nearer, so 100 characters cost 20 billboards; a repaint writes only what changed. Rows arerowStuds(0.5) tall,offset(2) studs over the head. The local player sees their own name and title (showOwn,ownRows). Every row is styled byTheme.overhead: Fredoka One, a thick outline incolors.overlaythat scales with the text, and a light top-to-bottom shade. Each head holds an Attachment (Config/Overhead.anchor) at the top of the rows that show, which chat bubbles stand on. Settings are inConfig/Overhead(a game's inConfig/Overrides/Overhead.luau), rules inRules/Overhead. Nothing is saved. Source note:docs/systems/Overhead.md.- Haptics
haptics, on by default.HapticController.play(name)plays a named pattern fromConfig/Haptics(Rules/Hapticslightens it under reduced motion) through Roblox'sHapticEffecton phones, gamepads and Quest controllers that have a motor; success and error toasts and celebration effects use it, and game code may. Players turn it off with the Vibration setting (settings.haptics). No loop or remote. Source note:docs/systems/Haptics.md.- Capture
capture, on by default.CaptureController.offertakes a screenshot of a moment game code picks and opens Roblox's share prompt, or the save prompt where the regional policy'scontentSharinggate is not allowed or not read yet, under a cooldown and a per-session cap fromConfig/Capture. Nothing is captured unless game code asks; nothing is saved. Source note:docs/systems/Capture.md.- Avatar
avatar, off by default.AvatarControllerand theAvatarWindow(a menu button) offer Roblox's save-outfit and save-avatar prompts for the look worn in the game; game code callsinspect(userId)andplayEmote(name), andConfig/Avatar.emotesMenuturns Roblox's emotes menu on or off. No remote, nothing saved. Source note:docs/systems/Avatar.md.- Main menu
mainMenu, off by default. A menu the player sees before playing and can reopen from the HUD's menu: a panel of pages fromConfig/MainMenu, each with a title, a body and buttons that play, change page, go back or open a window. A part taggedMenuCameraframes the view while it is up; a page that names a switch is left out while that switch is off. Play always hands back a camera that follows: a still camera type taken when the menu came up (Fixedbefore the character exists, orScriptable) comes back asCustom, on the saved subject or else the player's own character; a game that wants a still camera after the menu sets it from its ownMainMenuController.setBackgroundhook. The shipped pages are the Template's showcase composition, to replace. Source note:docs/systems/Main Menu.md.- Release notes
releaseNotes, off by default.lune run changelogbundles the public changes ofCHANGELOG.mdinto the build,Roblox/ReleaseNotes.load()reads them, and the main menu's "What's new" page browses them. No service, remote or saved data. Source note:docs/systems/Release Notes.md.- Tutorial
tutorial, off by default.TutorialServicewalks a new player through the steps ofConfig/Tutorialon their first join: a panel with Next and Skip, and a highlight or ring on what a step points at. A step completes when the player does what it asks or game code signals it; progress is saved on the account (AccountData.tutorial) and logged as the onboarding funnel.tutorial restart|skip|finishis the test command. Source note:docs/systems/Tutorial.md.- Sounds
Core, always on.
Controllers/SoundControllerplays named assets at the player's saved volume. Callers use shared assets rather than embedding asset ids. Source notes:docs/systems/Settings.mdanddocs/systems/UI.md.- Music and ambience
Core, silent until configured.
Controllers/MusicControllerplays the highest-priority context asked for by game code (MusicController.request(reason, context)), the main menu or a part taggedMusicZone(attributeMusicContext). A context inConfig/Overrides/Music.luauhas a priority, a playlist ofassets.sounds.musickeys that crossfade, and an optionalassets.sounds.ambienceloop. TheMusicandAmbiencesound groups follow the savedmusicVolumeandambienceVolume;duck(reason, on)lowers them for a video or an ad. Ambient zones are checked only while a zone part is in the world. The Template ships no contexts: no instances, no loops, and no Music or Ambience slider. Source note:docs/systems/Music.md.- World sound
Core, always on.
WorldSoundController.playAt(name, position or part)on the client, andWorldSoundService.playAt(name, position)on the server for the players in range, play a sound from a small pool of emitters under a voice cap and skip what is too far to hear. Parts taggedAmbientZoneplay a looped ambience that fades with distance. Names are Asphalt keys inassets/sounds/world/; volumes follow the Sounds and Ambience settings. Ambient sound zones are checked only while a zone part is in the world, and each sound's settings are worked out once and kept (Rules/WorldSound.settings). The Template ships no world sounds. Source note:docs/systems/World Sound.md.- World motion
Core, always on.
WorldTweenController.playtweens world instances on the client: a tween replaces another moving the same property, and decorative tweens snap on a low graphics tier, far from the camera or over a cap.WorldTweenService.playsends a server tween intent once as attributes; every client plays it, and at the end the server sets the goal, clears the goal attributes and removes the tag. The timing attributes stay until the next intent overwrites them: clients follow only tagged instances.AnimationController.playplays animation tracks by asset key, cached per Animator under a cap. Source note:docs/systems/World Motion.md.- Graphics quality and lighting
Core, always on, client-only.
Controllers/GraphicsControllerruns every client at a tier,low,mediumorhigh: forced by thegraphicscommand, else the savedgraphicsQualitysetting (Display, Graphics quality: Automatic, Low, Medium, High), else the player's Roblox graphics level, else the device (desktop high; console, tablet and VR medium; phone low). While automatic it times a few seconds of frames now and then and steps down a tier when the 95th percentile stays overConfig/Graphics.autoStep.budgetMs, stepping back up slowly so it never flaps. A tier change switchesLighting.GlobalShadows, post effect classes (keyed by Roblox's class names, such asBloomEffect), theRateof emitters taggedQualityParticles, the interface effects' particle cap and decoration taggedQualityDecor(hidden below itsQualityMinimumattribute; hidden decoration whose area streamed out is let go while the tier stays low); nothing runs per frame otherwise.Config/Graphics.tiersis the one place a game changes what a tier does. The lighting preset inConfig/Graphics.preset(the Template'sneutral, a new place's defaults) is applied at boot, with per-tier variants;GraphicsController.setPresetblends to another. Game code readsGraphicsController.tier()for its own effects. Rules inRules/Graphics. Source note:docs/systems/Graphics.md.- Localization
Core, always on. Every player-facing string is a key in
Config/Stringsread throughUtil/Localize.text;client/Localizationinstalls Roblox's translator for the player's locale before the interface is built,Util/Formatfollows the locale's separators, and toasts carry keys withargs.lune run stringsexports the table for the Creator Hub;Config/Localizationholds the pseudo-locale and number styles. Nothing is saved. Source note:docs/systems/Localization.md.- Effects
effects, on by default.EffectsController,UI/Screens/Effects,Config/EffectsandUtil/Particlesprovide interface particles and their sounds. Nothing is saved. Source note:docs/systems/Effects.md.- Notifications
Core, always on.
NotificationServicesendsnotifications.pushed;NotificationControllerkeeps the toasts on screen, queues the rest and times each from when it shows, andUI/Screens/Notificationsdraws them at the top centre (the layout'stoastswidget). The default time, the on-screen caps and the queue areConfig/Notifications(defaultSeconds,maxVisible,maxVisibleTouch,maxQueued). No inbox is saved. Source note:docs/systems/Notifications.md; handbook: analytics and notifications.- Input and contextual touch actions
Base input is core;
touchActions, off by default, enables its optional context/touch delivery.InputController,UI/Screens/TouchActions,Config/Input,Rules/BindingsandRules/InputContextsown binding and context behavior. Saved binding edits go through SettingsService. Source notes:docs/systems/Input.mdandContextual Input.md.
Economy and account rewards
The economy and monetization page covers currency, receipts, passes, codes and rankings in depth.
- Currency
Core, always on.
CurrencyServicealone changesPlayerData.currenciesusingConfig/Currencies,Rules/CurrenciesandRules/Pricing;exchangechanges several balances and the owner's own record in one save update, and withwholerefuses a reward that does not fit under the cap rather than paying part of it. Source note:docs/systems/Currency.md.- Rewards
Core, always on. One shape for what a player is given (
currency,item,boostortitle, one reward or a list, with the{ currency, amount }shorthand) in every config that gives one, and one write path:RewardService.fitsandgrant, over the pureRules/Rewards(the type) andRules/Grants(the fits check and the change).Util/RewardLabelnames a reward through thereward.*strings. An owned title is skipped; anything else that does not fit refuses the whole list. Source note:docs/systems/Rewards.md; handbook: one reward shape.- Monetization
Core, always on.
MonetizationService(a folder module:Products,Gamepasses,Gifts) owns receipts and pass ownership;MonetizationControllerowns prompts.Config/Monetizationsupplies ids and keys (plain strings, so a game's own need no cast), what a product or pass grants (grants = { rewards }, no handler needed) and its place in the shop's Robux Store (store = <order>);MonetizationController.store,priceandownsGamepassfeed the Store rows.Rules/Purchasescombines history. Real purchases live in the selected save'spurchasesandgamepasses. Experience subscriptions (subscriptions, off by default) are decided bySubscriptionServicewithRules/Subscriptions; the period record is inAccountData.stats. Source note:docs/systems/Monetization.md.- Regional policy
Core, always on.
RegionPolicyServicereads Roblox's policy for each player on join and gates what depends on it (Rules/Policy):paidRandomItems,paidItemTrading,ads,subscriptionsandcontentSharing. A restricted player is never offered what a gate covers, and the server refuses it if they ask anyway; the client reads its own view inClientState.policy, and a field Roblox does not answer counts as restricted.waitForis woken byreadyor the player leaving, without polling. No link or handle is shown inside an experience (allowsLinkis always false). It is core because every game that sells anything needs it. Nothing is saved. Source note:docs/systems/Regional Policy.md.- Rewarded ads
rewardedAds, off by default.RewardedAdService,AdControllerand the Shop window's rows offer each placement inConfig/Ads: a fixed reward of any kind (never random) paid as a developer product after Roblox confirms the view, capped per player a day, offered only where Roblox has an ad and the regional policy allows ads (Rules/Ads). The day's views are counted inAccountData.stats.adsandadsimare the test commands. Source note:docs/systems/Rewarded Ads.md.- Premium perks
premium, off by default.PremiumServicereads Roblox Premium membership on load and on change and publishes it inSharedState.premiumUsers. Each perk inConfig/Premiumis optional: currency multipliers game code asks for withmultiplier(purchases, refunds and grants are never multiplied), a daily bonus (a once-per-account claim), a chat tag and a shop upsell that opens Roblox's prompt.premium on|off|realis the test command. Source note:docs/systems/Monetization.md.- Gifts
gifts, off by default, requires shop.GiftServicelets a player buy a pass or a product's reward for another player in the server from the Shop window; each gift inConfig/Giftshas a developer product of its own, and a gifted pass is an entitlement on the recipient's account. Orders and the outbox are inPlayerData.gifts, received gifts inAccountData.gifts; the same order asked again (a prompt closed and reopened for the same player) writes and saves nothing. Source note:docs/systems/Monetization.md.- Leaderboards
leaderboards, on by default.LeaderboardServicepublishes rankings for the Top window and world boards.Config/Leaderboards,Rules/LeaderboardsandUtil/BigNumdefine scores and storage encoding. The stats in the player list are no longer its own: they are the Player list system's (Config/PlayerList,PlayerListService), which runs whatever this switch says. Ordered stores are separate from PlayerData. Source note:docs/systems/Leaderboards.md.- Daily rewards
dailyRewards, on by default.DailyRewardService,DailyRewardControllerandDailyRewardWindowuseConfig/DailyRewardsandRules/DailyRewardsfor claim eligibility and streaks. The record is once per account inAccountData.daily, and each reward is a claim throughClaimService. WithopenOnJointhe window opens once per visit when today's reward waits;DailyRewardController.hold(reason, on)makes it wait (a showcase scenario holds it, and a game can for a cutscene or tutorial), and it opens when the last hold lets go. Source note:docs/systems/Daily Rewards.md.- Playtime rewards
playtimeRewards, off by default.PlaytimeServicecounts time played in this session on the server and pays each reward ofConfig/Playtime.rewardsonce claimed (playtime.requestClaim); every join starts the count again and nothing is saved but the pay. Rewards may be of any kind.playtime ready|resetis the test command. Source note:docs/systems/Playtime Rewards.md.- Season pass
seasonPass, off by default.SeasonPassServicegives season points from claimed quests, playtime and the game's own moments (award), and each tier of a season inConfig/SeasonPassgives a free reward and, with the premium track bought (seasonPremium), a paid one, claimed throughseasonPass.requestClaim; the window shows a tier's two rewards on their own line. The playtime tick runs only during a season. Progress is inPlayerData.seasonPass; a new season is config only.seasonpass points|premium|resetis the test command. Source note:docs/systems/Season Pass.md.- Codes
codes, on by default.CodeServicereads server-onlyConfig/Codesand checksRules/Codesand UTC dates fromUtil/Time;CodesWindowsubmits text. A redemption and its rewards are one claim throughClaimService: the code is recorded inAccountData.codesand the rewards are paid into the active slot after the account save, once per account. A code whose rewards do not fit (RewardService.fits) is refused and stays unused. The Template'sWELCOMEandBLOCKOUTare demo examples that stay live underdemo = false; a game removes them insrc/core/server/Config/Overrides/Codes.luau. Source note:docs/systems/Codes.md.- Referrals and invites
referrals, on by default.ReferralService,InviteControllerand the invite card ofFriendsWindow(under the friends list: what an invite is worth, friends brought, and Roblox's invite prompt) use join data, account messages,Config/ReferralsandRules/Referrals, with who qualifies (the cap, account age, time played, friendship) in the server-onlysrc/core/server/Config/Referrals. The qualifying wait is one timer per new player, cancelled when they leave. Records are inAccountData.referral; payouts and the welcome are claims throughClaimService. Source note:docs/systems/Referrals.md.- Community: favourite, group and friends
community, on by default.CommunityService,CommunityControllerandFriendsWindowuseConfig/CommunityandRules/Community. The server times Roblox's favourite and group-join prompts, both off until configured, with a cooldown per account. It paysgroupReward(any reward kind or a list; 0 coins by default, which pays nothing) once per account (a claim) afterPermissionServicereads the membership from Roblox, and never rewards a favourite. The Friends window opens from a person icon in Roblox's top bar (shown whilecommunityorreferralsis on; the window is shared with Referrals' invite card) and lists friends in this experience, with Join for one in another public server, sent throughTravelService. Friends in this very server come fromFriendshipController(the cache the player list shares, read from the server's own players), so they show whatever Roblox's online list says of them and appear and go as they join and leave. A friend in another server of this very place is listed and joinable even whileConfig/Game.placesdoes not list its id (beforelune run init, or a developer's own test place): this server'sgame.PlaceIdstands in for it. The server cannot read a friend's "who can join me" privacy, so a game that needs it setsfriends.join = falseinConfig/Overrides/Community. No new field: thecommunity.*keys ofAccountData.statsandflags. Source note:docs/systems/Community.md.- Badges
badges, on by default.BadgeService,Config/BadgesandRules/Badgesaward badges through Roblox; Roblox owns their persisted ownership. A save watcher checks what is due; it stops once every badge with an id is owned, and is never started without badge ids or in Studio. No badge save field is needed. Source note:docs/systems/Badges.md.- Quests
quests, on by default.QuestService,QuestControllerandQuestsWindowuseConfig/QuestsandRules/Queststo track progress and validate claims. A claim is oneRewardService.grantthat records the quest claimed and pays the whole reward, of any kind; a reward that does not fit is refused and stays claimable. The save is watched only when a quest has astatgoal, and the playtime tick runs only while a loaded player has a playtime quest left to finish (a join, a slot or test-mode switch, thequestcommand or the daily reset starts it again). Per-slot state is inPlayerData.quests. Source note:docs/systems/Quests.md.- Shop
shop, on by default.ShopService,ShopControllerandShopWindowuseConfig/Shop,Rules/ShopandRules/Pricingfor server-priced upgrades. The charge and the new level are oneCurrencyService.exchange.ShopController.rowsis a computed getter, priced only when read. Below the upgrades, the Store section sells the products and passes with astoreorder for Robux. Bought levels are inPlayerData.upgrades. Source note:docs/systems/Shop.md.
Optional gameplay kits
These kits provide specific foundations and have their own system notes. A built server foundation does not imply that every possible player tool or device playtest is complete.
- Interactions
interactions, off by default.InteractionService,InteractionControllerandInteractionPromptimplement tagged nearby prompts with server-validated begin, cancel and completion. Config isConfig/Interactions, rules areRules/Interactions; no saved data. A tracked part's attributes are read when they change, not on every scan. The nearest target in range is prompted and kept until it leaves range or another is nearer byConfig/Interactions.switchDistance(1 stud), and through a hold for as long as it stays in range, so the prompt never flicks between two targets about as far away; a target on the player's own character never prompts them. The prompt's look is a style, picked per target: the part'sInteractionStyleattribute, else its action'sstyleinConfig/Interactions.actions, elsedefault. Four ship inUI/Components/InteractionStyles(default, a bottom panel;pill, whose hold fills the pill itself;card, with the action's icon and description;ring, a billboard over the part), built from one set of parts so they read as a family: a key badge (a keycap, a gamepad button or a touch capsule; in VR the controller's button), the title, a "Hold" hint and a round-ended bar filling over a visible track. Pressed and waiting for the server, the badge lights in the accent and the hint reads "Starting…"; refused, they turn the danger colour. The hold bar is driven by the frame: the screen fillsstate.progressonce a frame from when the hold began and how long it lasts (prompt.hold), evenly, with no spring, and a finished hold stays full until the key lifts or the target goes; a style fills it directly. A prompt's width is fixed when it shows, so it never changes size mid-hold; sizes areTheme.interactionPromptandTheme.interactionStyles. A game adds or replaces a style withInteractionController.registerStyle(name, style)before the first prompt; a style draws and decides nothing. Theinteractionfixturetest levers belong to this kit: each is a post with a handle that tilts toonColororoffColorwhen a server hold toggles it, and its style's name above it in the overheads' look (Config/Interactions.fixture, withlabelFont,labelStrokeandlabelStrokeColor).spawnmakes one per style inConfig/Interactions.styleson the ground ahead of the caller,spawn <style>one in that style. It needs onlyinteractionsand refuses when the game registers its ownactivateaction. Source note:docs/systems/Interactions.md.- Inventory
inventory, on by default.InventoryService,InventoryControllerand the demand-mountedInventoryWindowuseConfig/InventoryandRules/Inventoryfor per-save items and equipment inPlayerData.inventory; item labels areConfig/Stringskeys.Config/Inventoryships five generic sample items: three stacks (material,ticket,giftBox) and two pieces of equipment (toolin thetoolslot,trophyin thedisplayslot). An item may name anicon(a key ofassets.images.icons, checked bylune run catalog),tradableandpaid. Whiledemois on,DemoServicegives each saveConfig/Demo.starterItemsonce, under thedemosource; without the demo nothing is granted on join. The window is a toolbar (search, and the Name, Quantity and Newest sorts), the equipment slots as tiles, and the owned items as a paged grid of tiles (Components/CollectionGrid,Theme.inventory.pageSize16 to a page, L1 and R1 on a gamepad), so a full inventory builds no more than a small one; the pager shows only when there is a second page: a second press on an item equips it (a worn piece then reads Equipped under its name, in the success colour, and only stacks carry a ×N badge), and a press on a slot takes its item off. An inventory holding more entries than a loweredcapacitystill works: it spends, removes, equips, tops up a stack it holds and gives items away in a trade, and only what would add an entry is refused (inventory_full).InventoryService.equipped(player, slot)is checked once per save change, so a call on every hit is a table lookup. Rewards arrive under therewardssource;giveitemandtakeitemare the staff commands. Turning it off preserves saved inventory. Source note:docs/systems/Inventory.md.- Trading
trading, on by default, needsinventory.TradeService,TradeController,TradeWindowandTradeRequestlet two players in the same server swap inventory items, withConfig/Tradingand the pureRules/Trade. One asks; the other accepts or declines withinrequestSeconds(30) on theTradeRequestdialog. Each then builds an offer from their own inventory in the trade window, any change to either offer clears both Readys, and once both are Ready aconfirmSeconds(3) countdown runs before both Confirm. The server checks every call against the saves it holds: the item is owned,tradable = trueinConfig/Inventoryand not worn, the two are withinrange(30 studs), neither is in test mode, and the whole swap fits both inventories. An item markedpaidis refused unless both players' regions allowpaidItemTrading. At the second Confirm the trade is removed first, so nothing can move twice; the swap is checked again; both saves change with no yield between them throughInventoryService.applyunder thetradesource, the first put back if the second is refused; and both saves are forced. A trade is cancelled with nothing moved when a player leaves, starts to travel, changes save, respawns out of range or presses Cancel.Config/Trading.entrypicks how a trade starts: a Trade button on another player's card in the custom player list (playerCard) and a hold-to-trade prompt on other players' characters (prompt, drawn through the interaction prompts, so only whileinteractionsis on too); a game's own interface callsTradeController.request(player). Each player's requests and open trade sync to that player alone (ClientState.trade), and the sixtrade.*remotes are queries rate-limited per player. Staff list this server's recent trades withtrades [user]. Nothing new is saved, and there is no cross-server trading. Source note:docs/systems/Trading.md.- Progression
progression, off by default.ProgressionService,ProgressionControllerandProgressionWindowuseConfig/ProgressionandRules/Progression: XP from quest claims andaward(player, event)with a prestige bonus, levels, unlocks worked out from the level and prestige count (unlocked(player, id)), and prestige.ProgressionController.viewis a computed getter (the prestige preview is worked out only when read) andreadyis the menu dot.progression.requestPrestigenames the count the player saw, so a repeat refuses; oneCurrencyService.exchangestarts the track over and resets exactly the currencies and shop upgradesprestige.resetsets true, keeping everything else. XP and prestiges are inPlayerData.progression;progressionis the test command. Source note:docs/systems/Progression.md.- Boosts
boosts, off by default.BoostService,BoostController,BoostsWindowand theBoostBarHUD countdown useConfig/BoostsandRules/Boosts. A player holds boosts, bought with each boost's product (boostDoubleCoins) or given by game code withgrant, and uses one withboosts.requestActivate, which names the stock the player saw so a repeat refuses. The end is a saved server timestamp, so a boost runs on wall-clock time, survives rejoins and server hops, and needs no server timer. Game code multiplies what it pays bymultiplier(player, key). Stock and ends are inPlayerData.boosts;boostsis the test command. Source note:docs/systems/Boosts.md.- Titles
titles, on by default, needs no other switch.TitleService,TitleControllerandTitlesWindowuseConfig/TitlesandRules/Titles. A title is fixed text from config with aTheme.colorstoken and an unlock: a badge's rule met on the save, a quest claimed, a Progression level, a game pass, a role, orgrantedby game code (TitleService.grant). Badge, quest and level titles are kept inPlayerData.titlesonce met; pass and role titles count while they last.titles.requestEquipnames one title (or none); the server checks ownership. The worn id replicates inSharedState.titles; clients draw a chat tag after any staff and Premium tag and a title row on each character's overhead (OverheadController), hidden for others by the "Other players' titles" setting.TitleController.viewis a computed getter.title grant|revokeis the test command. Source note:docs/systems/Titles.md.- Text filter
Core, always on.
TextFilterService.broadcast,forUserandchatForUserrun Roblox's text filter for the right audience, cache each answer briefly (Rules/TextFilter) and budget calls per player (Config/TextFilter). A failed filter or an empty budget is a refusal, never unfiltered text. The admin suite and the staff Feedback list use it; any text a player types that others see should too. Source note:docs/systems/Text Filter.md.- NPC navigation
npcNavigation, off by default, needs no other switch.NpcService(a folder module with itsNavigationpart) andNpcControlleruseConfig/NpcsandRules/Npcs. Game code spawns NPCs of a configured kind (spawn, within an agent cap and a cap per kind), sends them to a point or a part (walkTo) and hears how each walk ended:arrived, or onefailedreason (unreachable,stuck,timeout,target_removed,busy). Every path request goes through one bounded queue with a limit on computations at once, retries and replans; a walk replans only when its target moved far enough, a waypoint ahead is blocked or a waypoint was missed. Stopping, a new walk, despawning, death and the target going cancel the queued work, connections and timers. Destinations come only from server code: there is no remote, and NPC physics stays with the server. NPCs disable the unused Humanoid states (Flying,StrafingNoPhysicsand the rest). Clients bob the nearest visible NPCs within a distance and budget. Nothing is saved. A game's look is a model inServerStorage.NpcModels; otherwise a plain placeholder rig.npcs fixture|stats|clearbuilds a crowd (NPCs of thewalkerkind walking between stations, with obstacles between them) and reports its path and cost counters. Source note:docs/systems/Npcs.md.- Offline production
offlineProduction, off by default, needs no other switch.OfflineProductionServiceusesConfig/OfflineProductionandRules/OfflineProduction. Game code that knows what a player produces sets a whole per-hour rate withsetRate; it is saved in the player's slot (PlayerData.offline), because what produces is the game's own. Leaving stamps the server time on the real save; the next join of that slot pays the absence once, at mostmaximumSecondsof it, in oneCurrencyService.exchangethat also clears the stamp, and a toast explains the time away and the pay (Rules/OfflineProduction.messagereturns anoffline.notice.*string key and its arguments). A clock behind the stamp pays nothing; pay the currency cap refuses waits as pending, up to one capped absence. ProfileStore's session lock keeps a slot's claim to one server; nothing runs while a player is away.offline rate|awaysets a rate or claims a pretend absence. Source note:docs/systems/Offline Production.md.- Experience notifications
experienceNotifications, off by default, needs no other switch.ExperienceNotificationServiceandExperienceNotificationControlleruseConfig/ExperienceNotificationsandRules/ExperienceNotifications. Game code sends a kind now or schedules it; game servers send through Open Cloud with the secretNotificationsApiKey, within a per-player limit shared by every server, and the server picks when Roblox's opt-in prompt is offered. Nothing new is saved butAccountData.stats.notificationOfferedAt; the schedule lives in MemoryStore.pushnotify prompt|sendtests it. Source note:docs/systems/Experience Notifications.md.- Camera profiles
cameraProfiles, off by default.CameraProfilesControllerandConfig/CameraProfilesprovide native camera presets and named overrides without a frame loop. VR retains Roblox's camera. Source note:docs/systems/Camera Profiles.md.- Camera transitions
cameraTransitions, off by default.CameraTransitionControllereases the camera between owners (a native profile change, a cinematic, a game's own camera) overConfig/CameraTransitions.seconds, scaled by the player's camera-motion setting; Reduced Motion, VR and negligible moves cut. Game code callscapture()just before it takes or gives up the camera. Source note:docs/systems/Camera Transitions.md.- Seasonal events
events, on by default.EventServicechecks schedules inConfig/EventsusingRules/Eventsand publishesSharedState.event;EventBannerdisplays it. An event markeddemo = trueruns (and can be previewed) only whiledemois on: the Template's example winter festival (winter2026) is one. No saved event field. Source note:docs/systems/Events.md.- Travel
travel, on by default.TravelServiceis the owner of cross-place teleports;TravelControllercovers transitions.Config/Game.places,Config/Travel,Rules/PlacesandRoblox/Placedescribe places.sendwith{ server = jobId }joins one server of a place (a friend's), andoptions.reservereserves a fresh server by aReservedServerIdof its own. A trip to another server of this very place needs no id inConfig/Game.places: while its id there is 0, or this server's tier is unknown,game.PlaceIdis used. When a teleport does not leave, the server firestravel.failedand the client takes the loading screen that covered the trip back down, so the player sees the failure toast. Trip data travels in teleport data, not a new save field. Source note:docs/systems/Travel.md.Reserved servers and
follow. Roblox joins a reserved server only with the access code its reservation returned (or theReservedServerIdit was made with), never by job id, and only the reserving server sees the code.ReservedServerServicekeeps a MemoryStore hash map (BlockoutReservedServers): whoever reserves a server callsReservedServerService.record(privateServerId, accessCode)(TravelService,MigrationServiceand the adminprivateservercommand do; passaccessCodenil for aReservedServerIdserver), the record lasts ten minutes, and the reserved server keepsjob/<JobId>-> how to join it while it runs. The adminfollowreads that one entry. A game that reserves its own servers must record each one when it sends players there, or staff are told the server was not recorded. Access codes never reach a client or a log.
Staff, security and integrations
These systems are shared operational tools. The platform bridge is on the Template's main, off until a game turns it on, as described on its own page.
- Permissions
Core, always on.
PermissionService,Config/PermissionsandRules/Permissionsdetermine studio roles;ChatControllerand admin gating read the result.SharedState.playerRolespublishes only roles aboveplayer(a missing entry reads asplayer), so an ordinary join or leave writes nothing. Shared staff suspensions are saved throughDataService.updateShared. Source note:docs/systems/Permissions.md.- Admin and performance diagnostics
admin, on by default.AdminService,MetricsService,AdminController,DiagnosticsController(theperfprobe,perfscenariofixtures andstress ui, whose parts load on the first developer command that needs them, not at startup) and the panel and console insrc/core/admin/provide typed commands, dashboards, captures and support tools.AdminServiceis a folder module:init.luau, its parts (Registry,Targets,Audit,Remotes,Moderation,BanList,Watchlist,StaffGuard,Delivery) and one file per command group inCommands/.Deliveryclones the panel and console fromServerStorage.AdminSuiteinto thePlayerGuiof those who may use them only; an admin tab polls throughTab.poll, only while shown. Config isAdmin/Perf, with the staff guard's limits in the server-onlyConfig/Admin; shared saved values hold bans, watchlist and staff-guard counts. Source note:docs/systems/Admin.md; handbook: admin suite.- Client performance
clientPerf, on by default, withadmin.ClientPerfService,PerfOverlayController,Screens/PerfOverlay,Config/PerfandRules/ClientPerfown the staff performance overlay (overlay, F7) and the clients' frame reports kept in server memory (clients,ClientPerfService.summary()). Nothing is saved. Source note:docs/systems/Client Performance.md; handbook: client performance reports.- Anti-cheat
antiCheat, on by default.AntiCheatService, its Checks,AntiCheatController,RemoteGuard, the server-onlyConfig/AntiCheat(thresholds, weights, messages; the shared one holds only the sensor's settings) andRules/AntiCheatown checked detections and responses. Scores are per server; watchlist records use the admin shared value. Source note:docs/systems/Anti-Cheat.md; handbook: anti-cheat.- Voice
Core, always on. Roblox voice chat stays Roblox's.
VoiceService.hasVoicesays whether a player in this server has voice, and the adminmutealso mutes their voice (throughAudioDeviceInput.Muted), again if they rejoin while muted;setMutedwatches only muted players for new voice inputs, so there is no per-player connection otherwise. Nothing in the Template needs voice; nothing is saved. Source note:docs/systems/Voice.md.- Server migration
serverMigration, on by default.MigrationServiceandConfig/Migrationmove players through a holding server during shutdown or staff migration, behind the loading screen. Leaving the old server invokes ordinary saving. Source note:docs/systems/Server Migration.md; handbook: server migrations.- Test sessions
testMode, on by default.TestModeService, DataService's sandbox and purchase emulation run against disposable copies.Config/TestMode, Testing tab and TestPurchase screen expose the tools;SharedState.testModeUserssignals who is testing. Source note:docs/systems/Test Sessions.md.- Analytics
analytics, on by default.AnalyticsServicealone sends Roblox events and batches ordinary economy events.Config/Analyticsholds the registries: funnels (withfirst_session, logged bySessionService), economy reason prefixes and their transaction types, and custom event names; an unlisted funnel step or custom event is not sent, and a coverage spec fails a call the registries do not list. No custom analytics remote or saved event field. Source note:docs/systems/Analytics.md; handbook: analytics and notifications.- Live config
liveConfig, on by default.LiveConfigService,Config/LiveConfigandRules/LiveConfigread allowlisted values and kill switches from Roblox's experience configs (ConfigService), check them against the build and mirror them inSharedState.liveConfig. The Template lists no key, so a new game reads nothing; a game opts in fromConfig/Overrides/LiveConfig.luau, andcodes,dailyRewardsandeventshonour a kill switch once listed. Nothing is saved. Source note:docs/systems/Live Config.md; handbook: live config and kill switches.- Error reports
errorReports, on by default: until something errors it costs oneScriptContext.Errorconnection and one idle timer per side.ErrorReportServiceandErrorReportControllercatch server and client script errors;Rules/ErrorReportsgroups them by signature (the message without numbers, ids or players' names, plus the top stack frame) in one bounded table per server with counts and first and last seen; a repeated error's text is cleaned once, on both sides. Clients send batches througherrorReports.report, limited per player a minute and cleaned again on the server. Staff read it witherrors; every five minutes the server exports its new counts asscript_erroranalytics events, one total per side. Nothing is saved. Source note:docs/systems/Error Reports.md.- Platform
platform, off by default.PlatformService(a folder module:Connection,Reads,Writes,Status), sharedRules/Platform(a folder module:Requests,Responses,Summaries,Cache), serverConfig/Platform, sharedConfig/Feedback,FeedbackWindowand its Feedback button in the top bar provide cached market reads, feedback writes, cross-game transfers and studio bans; feedback and transfer calls are also capped for the whole game (30 each a minute, counted in MemoryStore). Requests go throughserver/Roblox/Http. There is no PlayerData field; MemoryStore holds read cache entries. Source note:docs/systems/Platform.md; handbook: platform bridge.- Market board
marketBoard, off by default, requires platform.MarketBoardServicereads the games a developer chose, and the platform's breaking-out list, throughPlatformServiceonce a minute for every server; the Market window shows players now, the change over the last hour and a 24-hour chart, marked stale while the platform cannot be reached. Source note:docs/systems/Market Board.md.
Developer tooling and the removable example
These run during development or demonstrate the foundations; they are not extra production services.
- Module diagnostics
Developer-only
.lune/modules.luauand.lune/lib/modules.luauinspect module metadata. No runtime switch or saved data. Source note:docs/systems/Module Diagnostics.md.- Catalog validation
Developer-only
.lune/catalog.luauand.lune/lib/catalog.luauvalidate configured catalog data. No runtime switch or saved data. Source note:docs/systems/Catalog Validation.md.- Pure utilities
Core shared
Util/*provides Result, cleanup-adjacent helpers, cooldowns, rate limiting, formatting, time and large numbers;Roblox/Observersowns Roblox-specific observation (everyobserveCharacterwatch ends through one shared leave listener, so a leave runs only the leaver's cleanups).Util/Poolreuses short-lived instances (prewarm, cap, acquire and release, twice safely) andRoblox/LifetimereplacesDebris:destroyAfterorreleaseAfterback to a pool, on oneUtil/Schedulerheap per side; theinstancescommand shows both.RateLimiter:prune()forgets refilled buckets for a limiter keyed by something that outlives its player.Format.abbreviateturns scientific past 1e36, reads NaN as0and infinities as∞;WeightedRandomweights must be finite. There is no feature switch or saved field. Source note:docs/systems/Utilities.md.- Demo
demo, on by default.DemoService, the HUD's demo buttons and coin effects (not built whiledemois off),Config/Demo, the example product and pass (exampleCoins, granted from config, andexampleVip), the example codesWELCOMEandBLOCKOUT, thewinter2026example event and theDemoLeaderboardpart demonstrate the full request-to-save-to-interface loop. The interaction test lever is not part of the demo. Demo flags useflags.demoFirstClick; coins use CurrencyService. Switch it off when real gameplay replaces it, then follow the Template'sdelete-demoskill, which also removes the showcase: it turnsdemoandshowcaseoff inConfig/Overrides/Features.luaurather than removing the switches, removes theviptitle with the example pass, leavesdoubleCoinswhileboostsis off, and edits nothing in.lune/. Source note:docs/systems/Demo.md.- Showcase
showcase, off by default, needsmainMenu. Part of the demo composition: loads one example scenario fromConfig/Showcase.scenariosat a time from the main menu's Feature showcase page, with instructions, Reset and Exit, and removes everything it set up on exit. A scenario is a clientview(the component gallery; effect, haptic, toast and capture triggers; the camera profiles), an adminfixture, a documented testflow, orplanned; any of them may name awindow(an Open button) andtryconsole lines (a Run button each, shown only to a role whose catalog has the command). The registry covers the player-facing, staff, monetization, platform, performance and developer systems. The component gallery is a sidebar of sections (charts and stats, tables and grid, controls with both Dropdown modes, several picks at once and people, buttons, navigation, text, surfaces, feedback, overlays). Specs fail while a system note or feature switch has no scenario, a fixture ortryline names no registered command, or a UI component is missing from the gallery, so a new system, switch, component or admin command adds its showcase entry with it. The stage is built on the first scenario load, not at startup. Thedelete-demoskill removes it with the demo. Source note:docs/systems/Showcase.md.
When adding a system, update the Template's docs/systems/Systems Index.md and the owning system note in the same change. The architecture page explains lifecycle and dependency direction; testing and tooling explains verification.
Updated