andrian-syh/roblox-optimum
Professional Roblox and Luau standards for AI agents: server-authoritative, leak-free, framework-agnostic, and laid out the same way in every file.
Changelog
All notable changes to this project are documented in this file. Changes that affect only the repository's own tooling, tests, or maintenance scripts are left out.
The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.
Unreleased
1.19.1 - 2026-11-11
Fixed
- Fixed Antigravity 2.0 and the Antigravity CLI never showing roblox-optimum's hook text to the model. The hooks sent
ephemeralMessagesteps, which Antigravity 2.0 hides from the model, so the skill routing, the delegation guidance, and the checker's findings never arrived. They now sendsystemMessagesteps. The Antigravity IDE keepsephemeralMessage, the only shape it documents. - Fixed the Antigravity prompt hook leaving out the
roblox-scouthint that Claude Code receives. Both hosts now build the routed line from one function.
1.19.0 - 2026-11-11
Subagents that each run on a model sized to their job, and hooks that send searches and second reads to them. Edits and decisions stay in the main conversation.
Added
- Added the
roblox-scoutsubagent. It locates remote handlers, data store calls, purchases, lifecycle hooks, and callers, and returns paths and lines in place of file contents. It judges nothing. In Claude Code it runs on the Haiku model. - Added a second-read mode to
roblox-auditor. It re-reads a finished change that touches money, saved data, or remotes in a fresh context, treats the change summary as a claim to check, and returns findings without scores. - Added delegation guidance to the session-start context: a code search that needs more than three reads goes to
roblox-scout, and a whole-project audit or a second read goes toroblox-auditor. - Added a prompt-routing hint that names
roblox-scoutwhen a request starts with a search across the project, such as "where is", "trace", or "what calls".
Changed
- Changed
roblox-auditorto run on the Sonnet model in Claude Code. - Changed the Antigravity Open Cloud gate to also catch eagerly loaded MCP tools named
mcp_<server>_open_cloud_invoke, in both the shippedhooks.jsonand the installed plugin.
Fixed
- Fixed
roblox-auditornever reading the false-positive catalog. The agent did not know where the shared references live. It now reads them from the plugin root in Claude Code, from the absolute install path in the Antigravity plugin, and from the relative path in other hosts. - Fixed the prompt router sending requests about an agent's own harness, plugin, hooks, skills, or subagents to the Luau skills.
- Fixed the end-of-turn check never running in the Antigravity IDE, which reports a normal stop as
model_stop.
1.18.1 - 2026-11-08
Fixed
- Fixed
open-cloud.mddescribing the roblox-optimum Open Cloud hook, its MCP tool, and.roblox-optimum.jsonas always present. The page now tells the agent to apply the table itself and names the hook only where roblox-optimum is installed, so the reference reads correctly on its own.
1.18.0 - 2026-11-08
A full audit of the standards against current Roblox documentation, the engine 746 API dump, and openapi.json. Platform facts that changed since they were written are corrected, references that contradicted each other now agree, and the build fails on dead anchors, a drifted invariant card, or an em dash in a shipped page.
Changed
- Changed
AGENTS.mdand the best-practices skill to carry one identical invariant card. The two had drifted apart: the rules file lacked the "most general level" comment rule, and the skill lacked the empty-section, deprecated-API, and cited-facts items. - Changed the studio-ops card to put user authority last, as every other card does, and its setup section to name the same three session facts as the card:
studio_id, Edit or Play, and who owns the files. - Rewrote
external-editors.mdfrom 40 KB to 20 KB. It keeps what changes a decision (which side wins, destructive defaults, security traps) and leaves install steps and full option lists to each tool's own docs. - Replaced every em dash in the skills, references, and
AGENTS.mdwith plain punctuation. - Changed the
api-currency.mdsnapshot to 8 November 2026 and Luau 0.746, which announceswhile localas supported upstream and continues the class prototype behind debug flags. Neither is ready for Roblox code. - Changed
genres.mdto name paid random item rules for simulators, SLIM avatars and the 16+ hangout gate for social games, andevaluation-matrix.mdto grade attributes andSetAsyncthe wayfalse-positives.mddoes.
Added
- Added journey events (
AnalyticsService:LogJourneyEvent) togrowth-apis.md: when a branching path beats a funnel, and the Creator Hub configuration limits a call must match. - Added search ads to
live-ops.mdandapi-currency.md, regional content availability topublishing.md, and Roblox's rewarded video playbooks tomonetization-policy.md. - Added a text contrast check (
Color3:GetContrastRatio, WCAG AA 4.5:1) to the accessibility basics inui-crossplatform.md.
Removed
- Removed
patterns.md, an index that repeated the skill's own list of the four pattern pages. Links now point at the page that holds the content. - Removed repeated rules from
performance.mdandfalse-positives.md.
Fixed
- Fixed
team-workflow.md, which gave the Open Cloud Luau Execution limit as two concurrent requests per universe.openapi.jsonsets ten incomplete tasks per place and five task creations per minute per API key owner. - Fixed
api-currency.mdmarking thePlayerCharacterDestroyBehaviordefault change as GA. Roblox scheduled it for 11 November 2026. - Fixed the diagnose skill pointing data store reads at Open Cloud. Studio routes them through
execute_luau. - Fixed
patterns/data.mdadvising a renamed store (PlayerData_v2) for schema changes, which abandons every existing save. It now advises a schema version inside each saved object. - Fixed
luau-language.mdtelling agents to type with--!strict, against the card's opt-in rule, and overstating which@rbxrequires Roblox supports. - Fixed
evals/README.md, whoseclaude -p --output-format jsoncommand could never see which skill ran. - Fixed
server-authority.mdandworkflow.md, which said readingWorkspace.AuthorityModealways throws from the command bar, plugins, andexecute_luau. The API dump makes it readable from engine 746; only older Studios throw.server-authority.mdalso lost its repeated trigger list and migration sections. - Fixed
device-performance.mdandapi-currency.md, which calledWorkspace.StreamingAdaptiveRadiusreadable and writable from code. Since engine 746 only a plugin or Open Cloud can read or set it. - Fixed
ui-crossplatform.mdstill marking the Input Action Manager as Beta. It is GA, asapi-currency.mdrecords. - Fixed
ui-crossplatform.mdsayingUIShadowcannot shadow text.UIShadow.Mode = Textshadows the glyphs, andInset,ShowBehindParent, andModeare now documented, soapi-currency.mdlists them as GA and the "undocumented member" example infalse-positives.mdusesUIBlurinstead. - Fixed
device-performance.mdcalling frustum streaming undocumented.Player.FrustumStreamingand its four modes have reference pages. - Fixed
templates.md, whosePlayerData.SaveAllsaved players one after another and could overrun the 30-secondBindToClosewindow thatrelease-readiness.mdwarns about. It now saves in parallel and waits for all of them. The store name lost its_v1suffix. - Fixed
patterns/world.mdcallingInstanceHandle:Waitunconfirmed. Its reference page now exists: it takes a timeout, returnsnilon timeout or an unreachable target, and never returns without one when the target is destroyed before it replicates. - Fixed two Luau examples (
patterns/lifecycle.md,device-performance.md) that put two statements on one line, against card item 9. - Fixed
patterns/data.mdtelling agents to save remaining players synchronously inBindToClose, and scoped its web-call batching claim to the four APIs Roblox documents as transparently batched. - Fixed
edge-cases.mdandcases/data-economy.md, which still advised renaming the store for a schema change. - Fixed
false-positives.mdgrading a hidden-state attribute as a Blocker. Every client can read it, but none can write it back, so it is Correctness at most. - Removed the [Verify] marks on the
BanAsyncdevice block (24 hours, lifted only byUnbanAsync), theColor3contrast signatures, and Extended Services for Compute (more than doubles per-player CPU), now that Roblox documents each. - Fixed
cases/monetization.md,security.md, andevaluation-matrix.md, which said to keep loot tables server-side and never replicate them. Paid random item odds must be shown before purchase, so one odds table serves the roll and the disclosure; only undisclosed data stays on the server. - Fixed
open-cloud.mdcalling the MCP Permissions access levels observed but undocumented. Roblox now documents Safe, Balanced (the default for every game), Full access, and Custom; the page now also tells agents to ask for one scope rather than Full access. - Fixed
live-ops.mdsaying Ads Manager has no keyword targeting and needs at least 10 ad credits. Search ads take up to 10 keywords per ad set, and the docs set no such campaign minimum. - Fixed
growth-apis.mdsaying notifications cannot be sent from Luau. Roblox's Open Cloud package sends them from a server script. Its referral rule also contradicted itself about when the invitee is recorded. - Fixed
workflow.md, whose session-setup table ranked the invocation argument above an inline token while its own precedence paragraph, the skill, and the review checklist rank the inline token first. - Fixed
release-readiness.mdsizing server memory by maximum players; Roblox's formula uses the peak number of connected players. - Fixed
diagnosis.mdcalling network ownership per instance. It is granted per assembly. - Fixed
cases/client-infra.mdnaming noAnalyticsServicemethod and ignoring that a player attribute reaches every client. - Fixed
security.mdandedge-cases.md, which said a local playtest can never read a secret. Roblox documents Local Secrets for exactly that. - Fixed
community-libraries.md, which did not say that ProfileService is no longer supported and that its author points new projects to ProfileStore. - Fixed the checker summary in
AGENTS.md, which left out hazards, yields insideUpdateAsync, and duplicateProcessReceiptassignments.
1.17.0 - 2026-11-05
Roblox documented open_cloud_invoke and MCP Permissions on 2026-11-04 (Use Open Cloud with the Studio MCP server). The Open Cloud gate was checked against every operation in Roblox's openapi.json, and the docs were rewritten from the official pages.
Added
- Added checker findings for
ReserveServerAsync()andTeleportOptions.ShouldReserveServer, now deprecated in the API dump, and for the removedWorkspace.UseInputSinkandPrimalPhysicsSolver. - Added
DataModel.ServerLowMemoryWarning, the*Contentproperty save,PlayerCharacterDestroyBehavioras default, theColor3contrast methods, experimental Luau 0.745 items, and Promotional Text and the appeals page toapi-currency.md, withServerLowMemoryWarningin the performance page.
Changed
- Changed the Open Cloud gate to name server restarts, matchmaking shutdowns, config publishes, and experiment start, complete, and schedule as irreversible, instead of "is not a known call".
- Changed the Open Cloud gate to raise a call's tier from its declared
scopes, never lower it.classify_open_cloud_callnow acceptsfilesandscopes. - Changed the gate's reasons to say when a path needs a scope Studio never grants, and that Studio routes data stores through
execute_luau. - Changed
open-cloud.mdto cite the official docs instead of calling them undocumented: prerequisites, the nine sections with their scopes, the high-impact list, scopes that are never grantable, permanent uploads, the full troubleshooting table, therbx-open-cloud-usage,rbx-permissions, andrbx-import-assetskills,openapi.jsonas the endpoint source, and the rate-limit headers. The Safe and Balanced presets are now marked as observed, not documented. - Changed the Studio MCP guide,
api-currency.md, SECURITY.md, MAINTAINING.md, and INSTALL.md to match, including a spec sweep againstopenapi.jsonas the way to recheck the gate. - Changed
api-currency.mdto engine and API dump 746 and Luau 0.745: Input Action Manager GA, orthographic camera Studio-only Beta,AuthorityModereadable and streaming propertiesPluginOrOpenCloud, the 64-bit integer RFC withdrawal marked as proposed, and older settled rows folded into the Settled line. - Changed the data, lifecycle, and performance pages for
PlayerCharacterDestroyBehaviorbecoming the default: save from data you hold, and read Player children before any yield. - Changed the Rojo guidance to require Rojo 7.7.1 or later, since Studio now saves
*Contentproperties.
Fixed
- Fixed the Open Cloud gate letting
POST /toolbox-service/v1/savesandsaves:bulkDeletethrough as reads. The toolbox and/operations/read rules were removed. - Fixed endpoint tricks that changed a tier. The gate now resolves dot segments, decodes
%-escapes, and drops the query, fragment, and trailing slashes before matching, and treats a full URL, another host, or a bad escape as irreversible. - Fixed ad campaign writes, which the docs said were denied but only asked. The gate now denies
/ads-management/.../campaignswrites. - Fixed the group deny, which also caught service-efficiency payments. It now covers only
/cloud/v2/groups/{id}memberships and join requests, and payments have their own deny. - Fixed asset uploads, which were tiered as reversible.
POST /assets/v1/assetsand any call withfilesare now irreversible, since Open Cloud cannot delete an upload. - Fixed
GET .../memory-store/queues/{id}/items:readpassing as a read. It dequeues items, so it is now a write. - Fixed Journeys publish (
repositories/JourneysConfig/publish) being tiered as a live config publish. It only changes the Creator Hub stage map, so it is now a reversible write. - Fixed read-only POSTs that asked needlessly: analytics
metrics,dimension-values, andbenchmarks, andexperiments:calculateMde. - Fixed
open-cloud.md, which said grants belong to the whole account. They are saved per game and per person, for external MCP clients only. - Fixed
open-cloud.md, which said the permissions gate onlyopen_cloud_invokeand that data store access throughexecute_luauis ungated. Data stores and memory stores go throughexecute_luauunder "Save & load data" and "Enable Studio Access to API Services", and "Connect to the internet" gatesHttpService. - Fixed the "Fix one player's data" recipe, which used Open Cloud data store calls. It now uses
DataStoreServicefromexecute_luau. - Fixed
api-currency.mdlistingPlayer:GetGlobalUserId()as callable. It is now listed as not callable.
1.16.0 - 2026-11-04
Studio's Assistant can now call Roblox Open Cloud through the MCP tool open_cloud_invoke, limited to the scopes the creator grants on the new MCP Permissions page. Neither is documented yet, so every fact here comes from the tool's schema and from probes in a private dev experience. This release also catches up with what Claude Code and Antigravity can do, based on each host's documentation and on probes in Antigravity 2.0.
Added
- Added
open-cloud.md, a reference foropen_cloud_invoke. It covers the permission levels and nine groups, what the permissions do and do not gate, R/W/X classification by method and path, a cloud preflight, recipes for data, live ops, publishing, prices, bans, analytics, and uploads, rollback points, permission profiles by project phase, errors, and rate limits. - Added
open_cloud_invoketo the Studio MCP guide's tool list, capability map, preflight, and error table, and a line in the MCP server instructions that points to the new reference before any write. - Added prompt routing to studio-ops for
open_cloud_invoke, Open Cloud, and MCP Permissions. - Added an Open Cloud gate (
roblox-optimum --open-cloud): a Claude Code PreToolUse hook onopen_cloud_invoke, and an Antigravity PreToolUse hook oncall_mcp_tool. Reads pass, writes ask with the call and its target universe, and flushing memory stores, changing secrets, asset permissions, groups, or ad campaigns is denied. Unknown writes count as irreversible. A project can list its dev universes underopenCloud.devUniversesin.roblox-optimum.json, and any other universe is named as production. - Added the same refusal to the Antigravity Studio proxy: a break-glass
open_cloud_invokecall returns an error before it reaches Studio. - Added
classify_open_cloud_callto the MCP server. It returns the same tier and decision offline, from the method and endpoint alone, so hosts without the hook get the same check. - Added a Claude Code PreToolUse hook on the Studio MCP
multi_edittool. A script edited in Studio never reaches disk, so no post-write check sees it. The agent now gets the standards before the edit and a reminder to read the lines back and runcheck_luauafter. - Added Antigravity prompt routing on
PreInvocation(lastUserInputwheninvocationNumis0), and aStophook that keeps the agent working once per broken Luau file written in the session. - Added Open Cloud trigger queries to the studio-ops evals.
Changed
- The studio-ops invariant card now asks for each Open Cloud call to be classified, and treats a denied scope as the user's answer. The publishing card's "never act outward" rule now names Open Cloud as well, and diagnose keeps player values out of reports when reading live evidence through it.
- The Antigravity copy of the auditor agent now reads with
read_fileas well asview_file, so it works in both Antigravity 2.0 and the IDE, and setsmainAgent: false,subagent: true,model: inherit, andcommandExecutionPolicy: off. - Trimmed
suggestedPromptsinplugin.jsonto three entries, since Antigravity drops the fourth. - Cut the API currency baseline (
api-currency.md) from 69 KB to 40 KB without dropping a fact an agent acts on. Settled APIs now sit in one "Settled [GA]" line per section, the deprecated list is a table of old and new names, and the repeated warnings about the documentation site lagging the engine are stated once.
Fixed
- Fixed Antigravity 2.0 writes going unchecked: the write hook now matches
write_fileandedit_file(args.Path) as well as the IDE'swrite_to_file,replace_file_content, andmulti_replace_file_content. - Fixed the Antigravity
PreToolUsereminder before a Luau write failing the tool call. Antigravity accepts only a permission decision there, so the reminder was removed.
1.15.0 - 2026-11-02
Adds a fifth skill, publishing, for the work that decides whether players find a Roblox experience and stay: the store listing, discovery, audience gates, launch readiness, ads, and live ops. The parts that touch code went into the existing rules instead. Each fact was checked against Creator Hub documentation, staff DevForum posts, Roblox shareholder letters, or the engine API dump, and every dated fact lives in the currency file.
Added
- Added the publishing skill, with its own invariant card, a launch readiness review that keeps code, place, and Creator Hub evidence apart, and hand-offs to the other four skills.
- Added two references for it:
publishing.mdcovers discovery, the store listing, icons and thumbnails, maturity and age tiers, and the marketing Roblox forbids, and ends with a launch checklist with stable IDs.live-ops.mdcovers the analytics dashboard, retention targets, falling impressions, Ads Manager, re-engagement tools, payouts, update cadence, and the first 90 days. - Added
growth-apis.mdto the coding references: AnalyticsService events and limits, player segments, experiments, experience notifications, and referrals. - Added the full paid random items rules, rewarded and immersive ads, and regional price levels for trades and gifts to the monetization reference.
- Added seven checker rules:
AnalyticsServicein client code, the five deprecatedAnalyticsService:Fire*calls, and reads ofAllowedExternalLinkReferences. The checker now has 101 rules. - Added a publishing platform state table to the currency file, with the date of each fact the new references rely on.
- Added prompt routing for the publishing skill. It routes on product names that read the same in any language, and leaves a request that names a coding API to the coding skills.
Fixed
- Fixed the advice to show the social links that
AllowedExternalLinkReferencesallows. The list is always empty, because links, handles, and invites inside an experience are banned for every player.
1.14.2 - 2026-10-31
The Studio MCP guide now covers how the tools actually behave, so agents with small context windows or weaker reasoning can follow it step by step. Each change was checked against the Studio MCP docs page, the live tool schemas of Studio 745, Roblox's DevForum announcements and bug reports, or the Open Cloud Luau Execution reference.
Added
- Added fixed recipes to the Studio MCP guide for session start, reading, editing, bulk changes, playtests, and asset generation. Each recipe has a stop condition.
- Added a list of Studio MCP calls that report success while nothing changed, such as
multi_editwithreplace_allreadingold_stringas a Lua pattern, with the read-back that catches each one. - Added a table of Studio MCP errors and when to stop, including an empty Studio list and
Target is not reachableduring play. - Added a table of which DataModel each Studio MCP call reaches, and rules for running Luau through the tool without freezing Studio.
- Added guidance on Roblox Assistant skills over MCP:
list_skillsandskillas a second opinion, andcreate_skillandedit_skillonly when the user asks. - Added two invariant card rules to studio-ops: keep the session facts in view after compaction, and treat a write as done only when a separate read shows it.
Changed
- Changed the studio-ops skill to load before the first Studio MCP tool call, not only when the user asks about tooling. Prompts that name Studio MCP or one of its tools now route to studio-ops.
- Changed the MCP server instructions to point at the Studio MCP guide when Studio MCP tools are connected.
- Changed the Studio MCP tool snapshot to the live server of Studio 745, which lists 33 tools, 8 more than the docs page.
- Changed the Studio CLI notes to the current docs address, and noted that it is separate from the MCP server and documents no exit codes.
Fixed
- Fixed the claim that Luau run through Studio MCP has no undo. A probe in Studio 745 showed that each
execute_luaucall is one undo step. The guide still treats undo as a safety net, not a plan. - Fixed the client probe advice for a playtest already running. A LocalScript put in
StarterPlayerScriptsduring play never runs. It goes in the player'sPlayerGui. - Fixed the Open Cloud Luau Execution limit. It allows ten incomplete tasks per place, not two concurrent requests per universe.
1.14.1 - 2026-10-31
The API currency baseline now reflects engine 745 and Luau 0.744. Every change below was checked against the engine API dump, the Engine API Reference, or a probe in Studio 745.
Added
- Added checks for deprecated calls that are common in game code:
Player:LoadCharacterandLoadCharacterWithHumanoidDescription,Humanoid:ApplyDescriptionandApplyDescriptionReset,Player:IsInGroup,Player:GetFriendsOnline,WorldRoot:FindPartOnRayand its two variants, andDataModel.VIPServerIdandVIPServerOwnerId. Each finding names the replacement. - Added
coroutine.finallyto the standards as available in Studio, with its documented contract and thecoroutine.wraptrap. - Added the TextChatService migration to the standards: code that reads chat message content stops working when a game moves to the updated chat.
- Added the Device Trust API to the standards, with the rule that only the server reads it.
Changed
- Changed the
ReserveServerfinding to recommendTeleportAsyncwithTeleportOptions.ReservedServerId. Its old advice,ReserveServerAsyncorShouldReserveServer, is deprecated too. The teleport patterns now use server IDs. - Changed the
RegisterTestLegacyfinding to nameTestService:RunTestsAsync, and updated the TestService notes for the newRegisterTest(testName, callback, options)argument order. - Changed the price-display rule to read prices with
MarketplaceService:GetProductInfoAsync, sinceGetProductInfois deprecated. - Changed the data store limits to say that per-server request limits are defaults that
SetRateLimitForRequestTypecan change, and added the memory store limit of 1,000,000 items and 100 MB for one sorted map or queue. - Changed several references from undocumented to documented now that the Engine API Reference covers them, including
RunService:BindToAnimation,Player.FrustumStreaming,TeleportOptions.ReservedServerId, theWorldRootcollision group methods, andLogger.
Fixed
- Fixed the
Collectionentry, which listed members the engine does not document. It now gives the documented callback API, and notes thatCreateCollectionraises "Collections are not enabled" in Studio 745. - Fixed the advice to run
wally install --lockedin CI. Stable Wally has no such flag, so CI now checks thatwally installleaveswally.lockunchanged. - Fixed the claim that secrets never work in a local playtest. Local Secrets in Experience Settings provide values for local testing.
- Fixed the
PromptCreateAssetAsyncandCollisionFidelity.Scalableexplanations, which contradicted their own replacements. - Fixed the 64-bit integer type and exact table types being described as possible future features. Luau has withdrawn both.
1.14.0 - 2026-10-18
Upgrade note: roblox-optimum now requires Node.js 22 or later. Node.js 18 and 20 have reached end of life. Run node --version, and upgrade Node.js before you update the package.
Added
- Added
--check --format jsonand--check --format sarif. SARIF 2.1.0 output lets GitHub code scanning show each finding on its line in a pull request, with a link to the reference page behind the rule. Both formats keep the exit code. - Added suppression directives for a finding you have judged intentional:
-- roblox-optimum: allow(rule)on or above a line, and-- roblox-optimum: allow-file(rule)in a file's header. A directive must name a rule. One that names no rule, an unknown rule, or allows nothing is reported, and the checker states how many findings directives allowed. They apply to--check, the hooks, andcheck_luaualike. - Added each finding's rule name in brackets, such as
[wait], which is the name a directive uses.explain_findingaccepts that name too. - Added a standards rule: tool directives (
--!strict,-- selene:,-- stylua:,-- roblox-optimum:) are not commentary. An agent never removes one, and never adds a suppression unless asked.
Changed
- Changed the minimum Node.js version from 18 to 22.
- Changed the prompt router so a request about a repository's own files, such as the changelog, README,
package.json, a.mjsscript, CI, a commit, or a release tag, no longer loads a Luau skill. The router reads only file and tool names for this, so it works the same in any language. - Changed the prompt router to send a reported loss, such as "players lose coins", to the
diagnoseskill. - Changed
roblox-optimum --selftestto run the test suite from a repository checkout. In an npm install it says where the tests are, since they no longer ship in the package. - Changed the package to ship no test code, which makes it about 1,200 lines smaller. The CLI no longer loads its tests on every run.
- Changed the prompt router to send a request that quotes a Luau or engine error, such as
attempt to index nilorInfinite yield possible, to thediagnoseskill. These messages are English in every locale, so this works in any language the request is written in.
Removed
- Removed the
--selftestoption fromroblox-mcpand from the Studio MCP proxy. Their tests run with the repository's test suite.
Fixed
- Fixed the prompt router reading "lag" inside longer words, such as "lagi", as a performance symptom.
- Fixed this package's own name,
roblox-optimum, counting as a sign that a request is about a Roblox game.
1.13.3 - 2026-10-18
Fixed
- Fixed the background currency refresh waiting seven days between runs instead of the documented 24 hours.
- Fixed
syncbuilding a checker pattern from an API-dump class name that was not checked to be an identifier. A malformed or tampered feed could have added a pattern that slows every--checkrun. - Fixed
syncwriting the engine version and Luau release text from the feeds intolive-currency.mdwithout checking it. Only digits and dots are kept now, and anything else is recorded asunknown. - Fixed two syncs running at once being able to leave a half-written cache. Cache files are now replaced in one step.
- Fixed
syncreading a response of any size. A response over 50 MB is now refused. - Fixed the checker and the MCP server trusting the patterns and explanation text stored in the currency cache. They now keep only the method and replacement names from each cached entry, rebuild the pattern and explanation from those names, and drop any entry whose names are malformed. A cache written by an earlier version or edited by hand gets the same validation as a fresh sync.
- Fixed
live-currency.mdserving a cached page as it was stored. The MCP resource is now rendered from the validated overlay on every read. - Fixed the background refresh starting again on every session when a sync fails, for example on an offline machine. A background sync now starts at most once an hour.
- Fixed
SECURITY.mdand the README naming%LOCALAPPDATA%as the Windows cache folder and an 8-second timeout. The cache is~/.cache/roblox-optimum/on every platform, and the timeout is 15 seconds.
1.13.2 - 2026-10-18
Added
- Added a table of contents to
community-libraries.md.
Changed
- Changed the shared references to name the reference file that holds each piece of guidance instead of a sibling skill, so the same text also works in the standalone roblox-best-practices skill.
- Changed the push and merge gates in
team-workflow.md, and the publish gate inrelease-readiness.md, to list selene and StyLua alongsidenpx roblox-optimum --check.
Fixed
- Fixed the Azul guidance in
external-editors.mdfor Azul 2.x: theliveFsSyncsetting and how to turn it off, Studio overwriting offline edits on session start, distributing a project with a sourcemap, and Azul working with Git.daemonPath, which Azul does not have, is removed.
1.13.1 - 2026-10-18
Fixed
- Fixed
doctorfailing withsep is not definedafterscripts/lib/was extracted in 1.13.0.
1.13.0 - 2026-10-18
Added
- Added
npx roblox-optimum sync, plus a non-blocking background refresh when a session starts (at most once every 24 hours), which fetches the live Roblox engine version, unambiguous service-level deprecations from the API dump, and the latest Luau release into a local cache. SetROBLOX_OPTIMUM_OFFLINE=1to disable network refresh. - Added the
roblox-optimum://references/live-currency.mdMCP resource, which serves the cached live engine and Luau currency overlay alongside the bundled reference pages. - Added
release-readiness.mdunderskills/best-practices/references/, covering the pre-publish checklist forBindToClose,ProcessReceiptidempotency,PolicyServicecompliance,TextChatServicemigration,StreamingEnabledreplication safety, memory and network telemetry gates, and Open Cloud CI/CD rollback. - Added a check for
DataStore:UpdateAsync()transform callbacks that calltask.wait(),wait(), or*Async()methods, which Roblox aborts at runtime. - Added recursive directory scanning to
--check, and a cross-file check for duplicateMarketplaceService.ProcessReceiptassignments across the files in a single--checkrun. - Added
MemoryStoreServiceto the server-only services checked in.client.luaufiles. - Added
runContext("server","client", or"shared") and Studio DataModel path prefix detection (ServerScriptService.,StarterPlayer.StarterPlayerScripts., andStarterGui.) to thecheck_luauMCP tool, so scripts inside Roblox Studio receive context checks without a.server.luauor.client.luaufilename. - Added
.agent/rules/roblox-optimum.mdtoinstall rules, alongside.agents/rules/roblox-optimum.md.
Changed
- Updated the engine and Luau currency baseline to Engine v742/v743 and Luau 0.743 (
constvariables, user-defined type functions,RunService:BindToSimulation,Workspace:StepPhysics, andAvatarSettings), and adopted a rolling-window policy inapi-currency.md. - Extracted the shared catalog, static checker, and live currency sync into
scripts/lib/so the CLI and MCP server load one copy of the rules and explanations.
Fixed
- Fixed false positives on custom methods that share a name with a deprecated Roblox API, such as
customTimer:Wait(),myQueue:Remove(),customPool:Destroy(), andPromise:Wait(), by requiring a Roblox receiver or service prefix on ambiguous method names.
1.12.1 - 2026-10-16
Removed
- Removed the MCP prompts
review_luau,diagnose_symptom, andscaffold_luau. Each duplicated a skill (code-review,diagnose, andbest-practices), and hosts listed them as extra slash commands, such as/plugin:roblox-optimum:roblox-optimum:review_luauin Claude Code. Every supported agent loads the skills, which carry the full instructions.
Fixed
- Fixed
uninstallremoving the MCP server from only the first configuration file of a host, which left an entry behind on a machine that has both the Devin Desktop and the Windsurf file.doctornow reports every such file. - Fixed the documented number of reference pages the MCP server serves, which was 35 instead of 39.
1.12.0 - 2026-10-16
To upgrade from 1.11.5:
- Run
npx roblox-optimum install --global --forceonce, to replace the Antigravity plugin and its hook configuration.
Added
- Added MCP resources (
resources/listandresources/read) that serve the 35 reference pages underroblox-optimum://references/*, and MCP prompts (review_luau,diagnose_symptom, andscaffold_luau) that pair a task with the invariant standards card. - Added structured output (
outputSchemaandstructuredContent) to thecheck_luauMCP tool, so hosts that read structured tool results receive{ clean, count, findings }alongside the text report. - Added checks and explanations for the ten deprecated members added to the review list in 1.11.5:
TextFilterResult:GetChatForUserAsync(),TeleportService:ReserveServer(),TeleportService:TeleportToPlaceInstance(),TeleportToPrivateServer(),TeleportPartyAsync(),TeleportToSpawnByName(),TeleportService.CustomizedTeleportUI,UserInputService.ModalEnabled, theUserInputServiceVR members,ContextActionService:BindActionToInputTypes(),AdGui.OnAdEvent, andGuiObject:TweenPosition(),TweenSize(), andTweenSizeAndPosition(). - Added
SessionStartandPreToolUsehooks to the Antigravity plugin, a roothooks.jsonfor workspace plugin checkouts, anddisplayName,logo, andsuggestedPromptsmetadata inplugin.json.
Changed
- Changed the MCP server to speak protocol revision
2026-07-28(server/discoverand per-request protocol version checks) alongside2025-11-25,2025-06-18,2025-03-26, and2024-11-05. - Changed
INSTALL.mdandREADME.mdto group each agent's install, verify, update, and uninstall steps into collapsible<details>sections.
Fixed
- Fixed the Antigravity plugin hook failing on Windows with
MODULE_NOT_FOUNDbecause the hook command quoted an absolute path inside the plugin directory. - Fixed the hooks missing the project root when Antigravity passes the workspace path under
workspacePaths.
1.11.5 - 2026-10-07
Added
- Added ten deprecated members to the review list, among them
TextFilterResult:GetChatForUserAsync, which now returns an empty string and is reported as a correctness finding,TeleportService:TeleportToSpawnByName,UserInputService.ModalEnabled, andMouse.KeyDown. - Added
if localandif constbindings, now in Studio beta, with guidance to keep them out of shipped code until they leave beta. - Added the DataStore metadata total and per-type request queue limits, the full MessagingService limits, the blocked port 1194, and the headers an Open Cloud request may carry.
- Added regional pricing to the monetization rules: read prices from
GetProductInfoand never compare against a fixed Robux amount. - Added guidance for Jecs, an Entity Component System library.
- Added the Analytics Error Report, Luau Heap snapshots, and Studio logpoints to the steps for a bug that cannot be reproduced.
Changed
- Changed the Azul guidance for Azul 2.0, where creating, renaming, moving, or deleting a file in a live session also changes Studio, so a deleted file now deletes the instance.
- Changed the Luau LSP guidance to the
luau-lsp.studioPlugin.*setting names, the built-in@gamerequire alias, andluau-lsp.analyzeLuaFiles. - Changed touch-button guidance to bind on-screen buttons through the Input Action System, with
ContextActionServicekept for existing projects.
Fixed
- Fixed the claim that Luau rejected integer types. A 64-bit integer type is an accepted design that Roblox has not shipped, so numbers remain doubles.
- Fixed the script capability
AssetRequire, which does not exist, toLoadUnownedAsset. - Fixed the Play Solo description. It runs a separate client and server with one player and hides only defects that need a second player.
- Fixed multi-client testing to name the Server & Clients mode, not Team Test.
- Fixed legacy chat being treated as a valid design choice. It was removed, and a custom chat must check
CanUserChatAsyncandCanUsersDirectChatAsync. - Fixed the Studio MCP guidance to say the standalone
studio-rust-mcp-serveris archived and to point to the built-in server.
1.11.4 - 2026-10-02
Added
- Added a Cline hook.
install --globalwrites~/.cline/hooks/PostToolUse, orPostToolUse.ps1on Windows, which checks each Luau file Cline writes and returns the findings to the agent. APostToolUsehook of your own is kept. - Added
--hook cline, which reports findings as Cline'scontextModificationand skips the tools that only read. - Added
--hook qoder, which reports findings asadditionalContext, the field the Qoder CLI reads back from aPostToolUsehook. - Added Qoder to the MCP entries
install --globalwrites, in~/.qoder/settings.json. - Added
.devin/rules/roblox-optimum.mdtoinstall rules, for Devin Desktop, the new name of Windsurf.
Changed
- Changed the Windsurf MCP entry to go to
~/.config/devin/mcp_config.jsonwhen that file exists, which is the file Devin Desktop now opens for its agents. - Changed
install --globalto skip Windsurf's skill copies when it writes the Codex copies to~/.agents/skills/, which Devin Desktop also reads.
Fixed
- Fixed the installer missing a Cline MCP configuration kept at
~/.cline/data/settings/cline_mcp_settings.json. - Fixed the Cline steps in INSTALL.md, which said Cline has no hook, and did not say how to update or uninstall.
- Fixed Qwen Code losing the subagent and
QWEN.mdfrom the extension since 1.11.3. Qwen Code reads a rootplugin.jsonthat names the Agent Plugins schema in place ofqwen-extension.json, and such a package carries skills and MCP servers only.install --globalnow writes the subagent beside the extension, with its tools as Qwen Code's tool ids. - Fixed the Qwen Code steps in INSTALL.md, which said the extension carries the subagent and
QWEN.md, and did not say how to update or uninstall. - Fixed the Windsurf steps in INSTALL.md, which did not name Devin Desktop, say why no hook is installed, or say how to update or uninstall.
- Fixed the Qoder steps in INSTALL.md. They said Qoder has no plugin format, gave a hook whose findings never reached the agent and whose matcher missed the IDE's own edit tools, and did not say how to update or uninstall.
1.11.3 - 2026-10-02
To upgrade from 1.11.2:
- Run
npx roblox-optimum install --global --forceonce, to replace the Antigravity and Cursor plugins and the Copilot CLI agent. - Run
npx roblox-optimum install rules --forcein each project that uses Antigravity. - In Codex, remove an MCP entry you added with
codex mcp add roblox-optimum, since the plugin now carries the server. - Delete the
roblox-*folders in~/.config/opencode/skills/if Codex is installed too.
Changed
- Changed the root
plugin.jsonandmcp.jsonto follow the Agent Plugins schema, which Kiro powers and Codex read. The Codex plugin now carries the MCP server. - Changed
install --globalto skip OpenCode's skill copies when it writes the Codex copies to~/.agents/skills/, which OpenCode also reads.
Fixed
- Fixed Antigravity never showing the agent what the checker found. Antigravity drops the output of a
PostToolUsehook, so the plugin's hook now stores each finding and aPreInvocationhook hands it to the agent before the next model call. - Fixed Antigravity ignoring the rule in
.agents/rules/and the plugin'srules/. Antigravity drops a rule with notriggerin its front matter, so both now load beside Luau files. - Fixed the Cursor plugin hook never running. Cursor reads a plugin's hooks from
hooks/hooks.json, and the installer wrote them tohooks.jsonat the plugin root. - Fixed importing the repository as a Kiro power, which Kiro rejected because the root
plugin.jsonwas not a valid manifest. - Fixed OpenCode listing each skill twice when Codex is installed.
- Fixed the
roblox-auditoragent's access in three hosts. Antigravity gave it no tools, Copilot CLI gave it every tool, and Cursor let it edit files. It now holds read-only tools in each. - Fixed the Antigravity, Cursor, and Kiro steps in INSTALL.md, which did not say how to update or uninstall. They also replace an undocumented
agy plugin validatewithagy plugin list, say how to stop Cursor reading Claude Code's plugins, and note that Kiro CLI 3 does not show a file hook's output to the agent.
1.11.2 - 2026-10-02
Fixed
- Fixed
doctorcounting a plugin version that Claude Code replaced or uninstalled as a cached copy, and the installer skipping Cursor because of such a copy. - Fixed the supervision-level instructions for Claude Code, which named a
/plugin configurecommand that does not exist. - Fixed the Claude Code steps in INSTALL.md, which did not say how to update or uninstall the plugin, or that auto-update is off for this marketplace.
- Fixed the
claude mcp addcommand in INSTALL.md, which registered the server for the current project only. It now passes--scope user. - Fixed the Codex steps in README.md and INSTALL.md, which left out adding the marketplace, how to update and uninstall the plugin, and that Codex runs a plugin's hooks only after you trust them.
- Fixed the installer's usage text, which named a
codex plugin addcommand that does not exist.
1.11.1 - 2026-10-02
Changed
- Changed the supervision guidance to state one order of precedence: an inline token, then the invocation argument, then the configured level, then Balanced. An empty argument now reads the same as none.
- Changed the
Chat:FilterStringForPlayerAsyncrow inapi-currency.mdto name the replacements the deprecated index gives,Chat:FilterStringAsyncandChat:FilterStringForBroadcast, while new work still filters throughTextService:FilterStringAsync.
Fixed
- Fixed the MCP server ignoring a message that is not a JSON object, lacks
"jsonrpc": "2.0", or carries an id that is not a string or number. Each now gets anInvalid Requesterror. - Fixed
roblox-optimumwith no argument waiting forever when run by hand, since it read a terminal as if it were a hook payload. - Fixed
--hookaccepting a shape it does not know and reporting nothing. It now names the shapes it takes and exits 2. - Fixed the pre-write reminder missing
.LUAUand.LUAfiles, and the post-write check resolving a relative path against the wrong directory when the payload names its owncwd. - Fixed host configuration files saved with a byte order mark being reported as unreadable, so the MCP server was never registered in them.
- Fixed a plugin reached through a symbolic link being invisible to the installer and
doctor, and a prerelease copy sorting level with its release. - Fixed broken pointers in
adaptive-mode.md,templates.md, andverification.md, the precedence count inminimal-code.md, a table inapi-currency.mdsplit by a blank line, a skipped heading level insection-layout.md, and a line holding two statements in thesecurity.mdrate limiter.
1.11.0 - 2026-10-01
Upgrading: rule files written by an earlier release carry no record of what they held, so npx roblox-optimum install reports them instead of replacing them. Run npx roblox-optimum install rules --force once to bring them across, after keeping any edits you made to them. For Cursor and Antigravity, run npx roblox-optimum install --global --force to move the plugin hook onto the bundled checker.
Added
- Added
--forcetouninstall. Without it,uninstallnow keeps a copy from an older release in case you edited it, asinstalldoes. - Added explanations to
explain_findingfor a frozen loop and for each member used on the wrong side of a.server.luauor.client.luaufile. - Added
--hook cursor, which reports findings asadditional_contextfor Cursor'spostToolUsehook. - Added detection of
repeat ... until false,while 1 do, andwhile(true) doloops that never yield, and ofGetRankInGroup()andGetRoleInGroup()withoutAsync. - Added Indonesian forms to the prompt routing, so a request such as "buat sistem stamina" or "leaderstats saya kadang hilang" names the skill it needs.
- Added the MCP entries and the Copilot hook to
doctor --global, and the plugin directories of Codex, Copilot CLI, Qwen Code, and the Antigravity CLI to the plugins the installer looks for, so a host that holds its own plugin no longer receives a second copy of each skill.
Changed
- Changed
install --globalto install only the parts you name. Namingrulesoragent, for example, no longer installs plugins, MCP entries, or hooks. With no part named, nothing changes. - Changed
install hookto ask Git where the commit hook goes, so it works in a worktree and honours acore.hooksPathinside the project. A hooks directory outside the project is left alone, and the installer prints the lines to add there. - Changed
install rulesto record what each rule file held when it was written. A file you edited since, includingAGENTS.md, is reported and kept until--force, anduninstallkeeps it too. - Changed the checker to report every use of a deprecated API rather than the first one only.
- Changed the Cursor plugin hook from
afterFileEdit, whose output never reaches the agent, topostToolUse. The Cursor and Antigravity plugin hooks now run the checker the plugin carries rather than downloading it on every edit. - Changed the MCP entries that
install --globalwrites to startroblox-optimum@latest, as the plugin entries do. An entry an earlier release wrote is updated in place. - Changed
rules/roblox-optimum.mdto be written only with--all, since arules/directory is no sign that an agent reads it. - Changed the ModuleScript template to fail loud when it cannot read a player's data:
Loadreports it, the session is never saved, and the Server Script tells the player.SaveAllnow waits for every save, soBindToCloseholds the server until the data is written. The templates no longer start with--!strict.
Fixed
- Fixed the Codex plugin hooks, which never ran the checker. Codex drops a hook's
argslist, so each hook startednodewith no script. - Fixed
installanduninstalltreating any pre-commit hook that mentions roblox-optimum as their own. Only a hook this tool wrote is replaced or removed now, so a hook you wrote, including one you added the check to, is never overwritten or deleted. - Fixed the lines the installer offers for an existing pre-commit hook, which blocked every commit that staged no Luau file under GNU
xargs. - Fixed the pre-commit hook skipping a staged file whose name holds a non-ASCII character, and a file that was renamed and edited.
- Fixed
install --forcereplacing a skill or agent copy that this tool did not write. A copy from an older release is now replaced whole, so a file a release stopped shipping is removed. - Fixed
uninstalldeleting a Kiro hook you edited, and fixed the Kiro hook's timeout, which sat where Kiro does not read it. - Fixed
install,doctor, anduninstallending in a stack trace when a write is refused. They now print one line naming the cause. - Fixed false findings: text inside an interpolated string, a string continued with
\z, a local function namedwait,tick, ordelay,:Preload()and the badge methods on an object that is not the service, and a type or folder named after a server service in a client file. - Fixed the frozen-loop check: it no longer counts a
returninside a closure or a field namederroras the loop's exit, it counts lowercase:wait()as a yield, and it leaves alone a loop that calls something that might yield. - Fixed the prompt routing for requests that share a word with another stack, such as "make the NPC react" or "a unity bonus", for build requests named after a symptom, such as "add a reset button", and for
c#andc++, which never matched. - Fixed a file that Codex's
apply_patchmoves being checked at its old path. - Fixed
explain_findingexplaining a frozen-loop finding as the deprecatedwait(). - Fixed
install --globalcorrupting a host's MCP configuration whose server list was not an object. The file is now reported and kept. - Fixed the Antigravity Studio proxy exiting with status 0 when it cannot find
StudioMCP.exe, and resolving the Studio directory against the working directory whenLOCALAPPDATAis empty. - Corrected the references:
vector.lerpexists, the published deprecation index now lists theGuiObjecttween methods, memory store partition limits are published as estimates, and the Studio MCP tool list namesgenerate_textureandsegment_meshand no longer namesrun_as_job.
1.10.0 - 2026-09-26
Upgrading: run npx roblox-optimum install --global --force to replace plugin copies from earlier releases. Their bundled MCP server fails to start, and the Antigravity copy duplicates every tool.
Added
- Added a
SessionStarthook for Claude Code and Codex. In a Roblox project, it tells the agent which skill fits each kind of request, and asks the agent to tell you once that the standards were applied. Outside a Roblox project, it adds nothing. - Added a
UserPromptSubmithook for Claude Code and Codex that names the skill a prompt needs before the model reads it, so a small model loads the right skill without recalling it. A prompt in a language other than English gets every skill listed, and a prompt about another language or engine, such as Python or Unity, gets nothing. - Added a
PreToolUsehook for Claude Code and Codex that restates the standards in brief just before the agent writes a.luaufile. - Added
*.project.json,.luaurc,foreman.toml,selene.toml, place files, and.luaufiles within two directory levels to the signs that mark a Roblox project.
Changed
- Changed the Cursor, Kiro, and Windsurf rules to load on every request. They loaded only once a
.luaufile was open, so a request made before that ran without them. - Rewrote the skill descriptions to open with when each skill applies, including requests that never name Roblox or Luau.
- Changed the MCP server's instructions and tool descriptions to say when to call each tool:
get_standardsbefore writing Luau, andcheck_luauafter every edit.
Removed
- Removed the MCP server from the Antigravity plugin.
install --globalregisters the server in~/.gemini/config/mcp_config.json, and with both, Antigravity listed every tool twice.install --global --forcereplaces the plugin directory whole, which removes the old entry.
Fixed
- Fixed the MCP server bundled in a plugin failing to start with
'roblox-mcp' is not recognized.npxread the plugin directory's ownpackage.jsonas the package to run. The plugin MCP entries and hooks runroblox-optimum@latest, which is not a version pin. - Fixed
roblox-studio-mcp-antigravityanswering theserver/discoverprobe with an empty result, which a client that follows MCP 2026-07-28 reads as a server supporting no version. The proxy refuses the probe with-32601, so the client falls back toinitialize.
1.9.1 - 2026-09-20
Changed
- Changed the logo from a shield to a rounded tile with a check mark.
Fixed
- Fixed a frozen-thread false positive on a one-line loop, such as
while true do task.wait(1) end. - Fixed a wrong-side false positive on a
GetServicecall quoted inside a string in a.client.luaufile. - Fixed the pre-commit hook skipping every staged path that contains a space. To replace a hook that an earlier release installed, run
npx roblox-optimum install hook. - Fixed
check_luauignoring itspathargument, so the.server.luauand.client.luauchecks ran from the CLI but not over MCP. - Fixed the MCP server answering an
initializenotification with a reply, and dropping batch requests without an answer. - Fixed MCP registration failing on a configuration file whose JSON is
nullor an array. The installer reports and keeps such a file. - Fixed four faults in
roblox-studio-mcp-antigravity: it cut off output still in flight when the server closed, stopped onEPIPE, failed when a Studio update removed a version directory, and started the server when imported as a module. - Fixed
doctornaming the wrong live copy when a version field reached 1000. - Fixed
install --globallisting hosts it installed nothing for.
1.9.0 - 2026-09-19
Added
- Added a statement to the
code-review,diagnose, andstudio-opsskills that they read the reference pages underbest-practicesand do not work alone.
Changed
- Shortened the
best-practicesskill description from 1011 to 868 characters, keeping every trigger word and hand-off. - Moved the API refresh procedure for maintainers out of the pages agents load.
- Cut two reference passages down to the rule they carried.
Fixed
- Corrected three engine claims against a running engine:
WorldRoot:Simulate,AutoSimulate, andSimulationRatefail withlacking capability RobloxEngine,Workspace.StreamingAdaptiveRadiusis a readable and writable boolean, and the members ofControlStateandEnum.InputSinkwere read from the engine. - Replaced the example probe, which failed with
lacking capability RobloxScript, with one that classifies the failure. A failed read is treated as unknown, not as a default value. - Corrected the claim that a probe proves an API does not exist. A made-up name and a security-gated member return the same error, so only the API dump settles absence.
1.8.0 - 2026-09-18
Added
- Added guidance on the three release-notes pages, versioned, weekly, and pending, and which question each one answers.
- Added engine surface through v739:
RunService:BindToAnimation,WorldRoot:Simulate,Workspace.StreamingAdaptiveRadius,QueueServicewithStandardQueue,Player.PauseTeleports, and theAnimatedImagefamily. - Added
GuiObject:TweenPosition,:TweenSize,:TweenSizeAndPosition, and.Transparencyas deprecated, as tagged in the API dump at v738. - Added the removed members
BasePart.siz,Part.shap,AssetService:PromptCreateAssetAsync, andEnum.CollisionFidelity.Scalable. - Added guidance to freeze metatables that never change, which makes metamethod lookup cheaper.
- Added three Server Authority behaviors:
SetPredictionMode()does nothing on the server,PredictionMode = Offno longer drifts in the local simulation region, and destroying anInputContextno longer stops client input. - Added a known false positive: stricter checks inside generic function bodies can fail
--!stricton unchanged scripts after an engine update.
Fixed
- Corrected three engine facts:
PlayerControlStatewas removed at v738 in favor ofControlStateandStateSchema,GuiService:GetUIScaleMultiplierwas removed, andGuiObject.InputSinkstopped serializing whenGuiObject.Sinkwas added. - Corrected the size of engine release 737 from 2 items to 22. The count came from the weekly page, which lists only live changes.
1.7.0 - 2026-09-12
Added
- Added plugin installs to
install --global. Cursor and Antigravity take a plugin that carries every component, other hosts take separate copies, and a host that already holds the plugin is skipped. - Added Kiro, Qoder, Cline, Qwen Code, Windsurf, Copilot CLI, and Codex to
install --global, and Kiro'sPostFileSaveandPostFileCreatehooks and.kiro/skills/to project installs. - Added MCP registration to
install --global. The installer merges the server into each host's configuration file, keeps every other server, and backs the file up once. - Added the Cursor
afterFileEdithook and the AntigravityPostToolUsehook, written at install time in each host's format. - Added
--hook copilotand--hook kiro, which report findings in the shape each host reads. - Added a per-host version of the
roblox-auditorsubagent for OpenCode, Kiro, and Copilot. - Added plugin reporting to
doctor, with a warning when a host reads both a plugin and a loose copy of the same skills. - Added plugin directories and MCP entries to
uninstall --global. The uninstaller removes only those this tool wrote.
Changed
- Changed
qwen-extension.jsonto declare the skills, the subagent, and the MCP server, so oneqwen extensions installcarries every component.
1.6.0 - 2026-09-10
Added
- Added
RemoteFunction:InvokeClientto the checker as a hazard, since a client that never returns hangs the server thread. - Added checks and explanations for
AnimationController:LoadAnimation,AnimationClipProvider:GetAnimationClipandGetAnimationClipById,MakeJoints,BreakJoints,BasePart.RotVelocity,Attachment.WorldRotation,ContentProvider:Preload,BadgeService:AwardBadge,BadgeService:UserHasBadge, andChat:FilterStringForPlayerAsync. - Added rules for the state of files at hand-off: no unused bindings, placeholder stubs, unfinished
-- TODOcomments, debugprintcalls, or backup copies. - Added a way to confirm that Script Sync is running with
InstanceFileSyncService:GetStatus(). - Added event teardown behavior:
Disconnect()drops queued handler calls, while destroying an instance still runs them. - Added edge cases for
BindableFunction:Invoke, which hangs without anOnInvokehandler, andBindableEvent:Fire, which returns before its listeners finish. - Added network ownership rules, including
SetNetworkOwnerlimits andSetNetworkOwnershipAuto(). - Added remote edge cases: a
RemoteFunctionreturn does not guarantee the client sees new server instances, and unhandled buffered events causeRemote event invocation discardedwarnings. - Added the difference between event connections, which accumulate, and
OnServerInvokeandOnClientInvokecallbacks, which replace each other. - Added network measurement caveats for the Developer Console and the MicroProfiler.
- Added the engine's deprecated API index as the authority for deprecations the checker does not flag.
Fixed
- Corrected the
UnreliableRemoteEventpayload limit guidance: Studio logs an oversized payload, and a live client drops it without a log.
1.5.1 - 2026-09-07
Fixed
- Fixed
roblox-optimumandroblox-mcpexiting without output when run through a symlink, such as afternpm linkor a pnpm install.
1.5.0 - 2026-09-07
Added
- Added
install --global, which writes the skills and theroblox-auditorsubagent into each agent's home directory so they load in every project. - Added
roblox-studio-mcp-antigravity, a proxy that makes Roblox's Studio MCP server usable from Antigravity on Windows. - Added
doctor, which reports every copy this tool wrote and whether it is current, older, or someone else's. - Added
uninstall, which removes only the files this tool wrote.--dry-runlists them without removing anything.
Changed
- Changed installer reports to show paths relative to the working directory or
~. - Changed global installs for Copilot to write the subagent to
~/.copilot/agents/.
Fixed
- Removed the version pin from the shipped MCP configuration files, which froze the server at one release.
1.4.0 - 2026-09-06
Added
- Added a check for
while true doloops that can neither yield nor exit. - Added a check for members used on the wrong side in
.server.luauand.client.luaufiles, such asPlayers.LocalPlayeron the server. - Added Git LFS locking for binary
.rbxlfiles to the team workflow guide. - Added branch protection,
--force-with-lease, and safe reverts to the team workflow guide. - Added automated place testing with the Open Cloud Luau Execution API.
- Added a response procedure for leaked credentials and
.ROBLOSECURITYtokens. - Added team workflow failure modes: autosave overwrites, unlanded place dependencies, and test places sharing data stores.
Changed
- Marked branch count and lifespan targets as observations, not engine rules.
1.3.0 - 2026-09-06
Added
- Added a team workflow guide: a branch place per developer, DataModel ownership, review checkpoints, and deployment through Open Cloud.
- Added engine network limits: about 500 client-to-server calls per second, and a 1,000-byte payload limit for
UnreliableRemoteEvent. - Added a network optimization order: remove traffic, send less often, shrink payloads, then pack buffers.
- Added criteria for judging networking libraries by per-frame batching and measured traffic.
Changed
- Required tracing every caller before refactoring shared code, and extended the guidance on removing unneeded ModuleScripts and dependencies.
- Marked data-loss protection and accessibility code as exempt from code reduction.
Fixed
- Corrected the
UnreliableRemoteEventguidance to send absolute state, since delivery is unordered. - Documented all three failure modes of
RemoteFunction:InvokeClient: a hang, a rethrown client error, and a disconnect mid-call. - Fixed broken links to
workflow.md.
1.2.0 - 2026-09-05
Added
- Added the
diagnoseskill, which traces a reported bug to its cause before any code changes. - Added the
get_standardsMCP tool, which returns the invariant standards card.
Changed
- Changed the MCP server to declare protocol revision
2025-11-25, and to keep answering2025-06-18,2025-03-26, and2024-11-05. - Set
license: MITin the front matter of every skill. - Changed
explain_findingto return direct links to the reference pages. - Rewrote the MCP tool descriptions to state what each tool does and does not do.
- Narrowed the per-frame garbage and re-validation rules to exempt cold paths, timers, and code that does not yield.
- Strengthened the rule to confirm project code and engine APIs before forming a hypothesis.
1.1.0 - 2026-09-05
Added
- Added checks and explanations for
Model:GetPrimaryPartCFrame(),Camera.CoordinateFrame, andPlayer:GetRankInGroupAsync()andGetRoleInGroupAsync(). - Added npm provenance attestations to releases.
Changed
- Updated the engine and Luau baseline to version 0.737.
- Marked
pcallandxpcallinside user-defined type functions as generally available. - Changed the pending engine change guidance to read the JSON source.
Fixed
- Fixed the hooks missing
MultiEditin Claude Code and Codex. - Fixed the Windsurf rule not loading, by setting
trigger: model_decision. - Replaced repository paths in the standards card with skill names and CLI commands.
- Fixed
explain_findingreturning incomplete URLs. - Fixed relative links in skills copied into a project.
1.0.0 - 2026-09-05
Added
- Added framework-agnostic Roblox and Luau standards covering file layout, documentation comments, server authority, lifecycle, and data persistence.
- Added the
best-practices,code-review, andstudio-opsskills. - Added the
roblox-auditorread-only subagent, which scores a whole project across security, lifecycle, performance, and replication. - Added the
roblox-optimum --checkCLI, which reports deprecated APIs and out-of-order section headers. - Added an MCP server with the
check_luauandexplain_findingtools. - Added the
ask,bal, andgosupervision levels. - Added
npx roblox-optimum installfor Claude Code, Cursor, Antigravity, GitHub Copilot, Codex, Windsurf, Cline, Kiro, Qoder, and Qwen Code.