Docs

Everything you need to get Sculpt running in Roblox Studio — setup, credits, features, no fluff.

Getting started

  1. Sign in with Discord. Hit the button on the landing page — no email forms, no passwords. New accounts get 15 welcome credits to play with.
  2. Install the plugin. Get it from the Creator Store — click Install and it lands in Studio automatically. Or download Sculpt.server.lua, paste it into a Script in Studio, right-click → Save as Local Plugin. Either way a Sculpt button appears in the toolbar.
  3. Pair it. One code, ten seconds — see below.
  4. Ask for something. Select a script, type what you want, hit Send. Sculpt reads the selected scripts as context and can apply code straight back into them.

Pairing the plugin

  1. Open your Dashboard and click Get pair code. You'll get a 6-digit code, valid for 5 minutes.
  2. In Studio, open the Sculpt panel and paste the code on the pair screen.
  3. Done. The plugin stores its own token (valid for 90 days) — no re-pairing until it expires or you sign out.

One account can be paired in several Studio installs at once. Your credit balance is shared across the site and every paired plugin.

How credits work

Every request costs credits based on how much the model actually reads and writes. No hidden per-message fee — small asks cost pennies of a credit, giant refactors cost more.

credits = (input tokens + 4 × output tokens) × model multiplier ÷ 100 000
  • Input tokens — your message plus any scripts you had selected (that's the context Sculpt reads).
  • Output tokens — the model's reply. Output is weighted ×4 because generating is the expensive part.
  • Model multiplier — smarter models cost more per token (table below).
  • Minimum charge per request: 0.01 credits.

The live estimate

Before you send, the plugin shows ≈ X cr at the bottom of the composer. It recalculates as you type, change model, effort, thinking, or select different scripts. It estimates input from your selected scripts + message, and expected output from the effort level (Low ≈ 800 tokens up to Max ≈ 8000, more if Thinking is on). The real charge is based on actual usage, so treat the estimate as a good guess, not an invoice.

Real examples (typical request: ~3k tokens in, ~2k out)

ModelCostRequests per 10 credits
Haiku 4.5≈ 0.04 cr~250
Sonnet 5≈ 0.08 cr~130
Sonnet 4.6≈ 0.11 cr~90
Opus 4.7 / 4.8≈ 0.19 cr~53
Fable 5≈ 0.36 cr~27

Models & pricing

Multipliers mirror what the models actually cost — you're never subsidizing someone else's Fable habit.

ModelMultiplierBest for
Fable 5×3.3Hardest problems, big refactors, "do it right"
Opus 4.8 / 4.7×1.7Complex systems, tricky bugs
Sonnet 4.6×1.0Everyday coding — the default
Sonnet 5×0.7Newer and cheaper than 4.6 (promo pricing)
Haiku 4.5×0.35Quick questions, small edits, speed
GPT-5.5 / 5.6Coming soon

Plans

  • Free15 welcome credits + 2 credits topped up daily. Daily top-up never stacks; it just refills you to the cap if you're below it.
  • Lite Pass$5 once for 60 credits, lasts 7 days — no subscription.
  • Pro$20/month for 250 credits.
  • Pro+$45/month for 700 credits — best price per credit.
  • Packsone-time credit bundles that never expire. Buying a plan adds credits on top of whatever you have — nothing gets wiped.
  • Customany 5–2000 credits at $0.20 each.

Wallet

Everything is paid from your wallet — top up a USD balance on the Dashboard, then buy plans, packs, or a custom credit amount straight from it. Every purchase stacks on top of the credits you already have. Plans do expire (Lite Pass after 7 days, Pro and Pro+ after 30) — the plan label drops back to Free, but your credits stay put. Credits never expire.

Effort & Thinking

Effort controls how long and thorough the reply gets — and since output tokens are the expensive part, it's also your main cost lever.

LevelExpected outputUse when
Low~800 tokensQuick answers, one-liners, "what does this do"
Medium~1 600 tokensEveryday edits — the default
High~3 200 tokensFull functions, multi-part answers
X-High~5 000 tokensWhole systems, long refactors
Max~8 000 tokens"Write the entire thing" mode

Thinking lets supported models reason before answering — noticeably better on tricky bugs and logic puzzles, and the estimate accounts for it (~×1.4 output). Turn it off for trivial asks to save credits.

These are targets, not hard limits — the model writes what the task needs, and you're charged for actual usage.

Applying code

Code blocks in Sculpt's replies come with action buttons — no copy-paste archaeology.

Updating an existing script

When a code block starts with a script marker, Apply writes it into the matching selected script (with a diff summary of added/removed lines):

-- script: PlayerController
local speed = 24

No marker? Sculpt applies to the script you have selected. Changes go through Studio's ChangeHistory, so Ctrl+Z works like normal.

Creating a new script

A new: marker gives you a Create button instead — name, class and parent in one line:

-- new: SprintHandler | LocalScript | StarterPlayer.StarterPlayerScripts
-- your new script body here

Valid classes: Script, LocalScript, ModuleScript.

Plugin features

  • / Themes — dark and light, toggle in the top bar, saved between sessions.
  • Image previews — image links in replies render right inside the chat (thumbnails via EditableImage, no browser hopping).
  • Thinking — deeper reasoning on supported models; costs a bit more output, often worth it on hard bugs.
  • ◐ Effort — Low → Max controls how long and thorough replies get. Higher effort = more output tokens = higher cost.
  • History — previous chats live in the history menu; the site Chat page shares the same account.
  • Quick actions — one-tap chips on a fresh chat: Find bugs, Refactor this, Explain code, Optimize.
  • Fallback — if your chosen model hiccups, Sculpt retries and can fall back to Sonnet 4.6 so your request still lands.

Pro tips — better answers, fewer credits

  • Select only what matters. Context is the biggest input cost. Two relevant scripts beat twenty random ones — cheaper and the model focuses better.
  • Paste the exact error. The red line from the Output window with the line number turns "why is it broken " into a one-shot fix.
  • One task per message. "Fix the double-jump, then we'll do the shop" lands better than a five-part mega-request.
  • Pick the right model. Haiku for quick questions, Sonnet for daily work, Fable when it genuinely has to be right. A Fable answer to a Haiku-sized question is just burnt credits.
  • Name your scripts. "In PlayerController, make sprint drain stamina" — Sculpt will target that script when applying.
  • Iterate. Apply, playtest, come back with what happened. Short follow-ups are cheap; the chat keeps context.
  • Watch the estimate. The ≈ X cr label updates live — if it looks high, deselect scripts or lower the effort.

Troubleshooting

Studio asks to allow HTTP requests

Click Allow — the plugin talks to the Sculpt server over HTTPS. If you blocked it, re-enable in Plugins → Manage Plugins; without it nothing can work.

No Sculpt button in the toolbar

Check the file is in your plugins folder (%LOCALAPPDATA%\Roblox\Plugins), then restart Studio. Local plugins also show in Plugins Folder in Studio.

"Pair code invalid or expired"

Codes live 5 minutes. Generate a fresh one on the Dashboard and paste it right away.

"gateway unreachable — check internet / try again"

Network hiccup between you and the AI gateway. Check your connection, hit send again — the request wasn't charged.

Apply put code in the wrong script

Apply matches the -- script: Name marker against your selected scripts. Select the intended script (or ask Sculpt using the script's exact name) and re-apply — and Ctrl+Z undoes any miss.

Balance in the plugin looks outdated

It refreshes when the panel opens and after every send. Reopen the panel if you bought credits mid-session.

FAQ

Where do I see my balance?

Top bar of the plugin, sidebar of the site Chat, and front-and-center on the Dashboard. Same number everywhere.

I ran out of credits. Now what?

Free plan refills you to the daily cap every day, so waiting works. Faster: top up your wallet on the Dashboard and buy exactly the credits you need (any custom amount), grab a pack, or get a plan — Lite Pass, Pro, or Pro+ — from the pricing section. Packs and credits never expire.

Why is a model greyed out with "soon"?

It's listed but not live yet (GPT family) or temporarily disabled. It'll light up automatically when available — no update needed.

Does Sculpt change my code without asking?

Not by default — every change sits behind an explicit Apply/Create click. There's an opt-in Auto-apply setting in the menu if you want it hands-free. Either way, everything goes through ChangeHistory and is undoable with Ctrl+Z.

What does Sculpt read from my place?

Only the scripts you select before sending — that's the whole context. Nothing is scanned in the background.

The estimate said 0.1 cr but I was charged 0.15. Scam?

The estimate guesses output length before the model writes anything. Long answers cost more, short ones less. The charge always follows the real token counts.