# Bloxsmith — Complete Product Documentation

> AI-powered Roblox UI generator — describe your GUI in plain English, get production-ready Luau code with real image assets for Roblox Studio.

Last updated: 2026-03-15

## What Bloxsmith Does

Bloxsmith is a full-stack AI tool for Roblox developers that generates production-ready user interface code. The workflow is:

1. **Connect**: Install the free Roblox Studio plugin and connect your workspace with a one-time session code
2. **Describe**: Type what you want in plain English (e.g., "Create a dark fantasy inventory screen with 6 item slots and a gold counter")
3. **Generate**: The AI creates complete Luau GUI code with real image assets, automatically uploaded to Roblox
4. **Publish**: Send the generated UI directly to your Roblox Studio place with one click

The entire process takes seconds, not hours. The generated code is standard Luau that works in any Roblox game.

## Architecture

Three-layer system:
- **Luau Plugin** (Roblox Studio): Handles session connection, UI tree extraction, and code injection
- **Next.js API** (server): HTTP bridge between plugin and web editor, plus AI generation endpoints
- **React Frontend** (UI Forge editor): Chat interface for describing UIs, asset management, code preview

## AI Models

- **Anvil mode**: Uses Claude Opus 4.6 for highest-quality UI generation. Best for complex, detailed interfaces. First generation costs $1.00 per frame; follow-up messages in a conversation are token-based.
- **Tongs mode**: Uses a lighter model for simpler UIs. First generation costs $0.25 per frame; follow-ups are token-based.
- **Adaptive mode**: Analyzes the user's existing ScreenGuis in their Roblox place and generates new UIs that match the same visual style. Always token-based pricing.

All models generate actual Luau code (not images or mockups) with proper Roblox UI hierarchy: ScreenGui, Frame, TextLabel, TextButton, ImageLabel, UICorner, UIListLayout, UIStroke, UIGradient, UIPadding, UIAspectRatioConstraint, and more.

## Style Presets

- **Stud**: Image-driven simulator UI with stud textures and heavy outlines — the default preset
- **Flat**: Light-themed flat UI with Sarpanch font, golden accents, and clean panels
- **Anime**: Neon gradient borders, dark panels, FredokaOne text with thick outlines
- **Adaptive**: Matches the styling of your existing in-game UIs (requires Studio connection)

Each preset controls colors, fonts, borders, textures, and layout patterns so generated UIs look consistent with a chosen art direction.

## Features

### UI Generation
- Natural language to Luau code conversion
- Full Roblox UI element support (Frame, TextLabel, TextButton, ImageLabel, ScrollingFrame, etc.)
- Responsive scaling with UIAspectRatioConstraint and UDim2
- Proper UI hierarchy and layout (UIListLayout, UIPadding, UIGridLayout)
- Adaptive mode learns from existing UIs in the user's place

### Asset Pipeline
- AI generates real image assets (icons, backgrounds, decorative elements)
- Automatic upload to Roblox via Open Cloud API
- Curated icon library with 500+ game-ready icons across categories (currency, animals, buttons, UI elements, weapons, etc.)
- AI-powered icon matching — describes your prompt and picks relevant icons
- AI image editing — modify, recolor, or restyle any asset
- Background removal (rembg) for clean asset extraction

### Studio Integration
- Free Roblox Studio plugin (.rbxmx file)
- One-click session code connection (no API keys needed)
- Automatic ScreenGui detection from the user's place
- Live code injection directly into StarterGui
- Works on Windows and macOS

### Conversation & Iteration
- Chat-based interface for natural back-and-forth refinement
- "Continue the conversation" to iterate on generated UIs
- Code viewer with syntax highlighting
- Full generation history with ability to revisit past generations

## Pricing

- **Free tier**: 2 generations for new accounts, no credit card required
- **Pay-as-you-go**: No subscriptions. Reload credits in $5, $10, $25, or $50 increments
- **Anvil** (Claude Opus 4.6): $1.00 per frame (first generation), token-based for follow-ups — best quality
- **Tongs** (lighter model): $0.25 per frame (first generation), token-based for follow-ups — faster, cheaper
- **Adaptive mode**: Always token-based pricing (input + output tokens with 1.8x markup)

## Security

- Roblox OAuth 2.0 authentication — Bloxsmith never sees or stores Roblox passwords
- Studio plugin runs locally and cannot access anything outside the user's session
- All API communication is HTTPS with strict CSP, HSTS preload, and X-Frame-Options headers
- Session codes are single-use and expire automatically
- User data can be exported or deleted on request (GDPR-ready)

## Frequently Asked Questions

**What is Bloxsmith?**
Bloxsmith is an AI-powered Roblox UI generator. It lets you describe a GUI in plain text and generates production-ready Luau code with real image assets that you can drop straight into Roblox Studio. It works as a free Studio plugin that connects to the Bloxsmith web editor.

**Is it safe to use with my Roblox account?**
Yes. Bloxsmith authenticates through Roblox's official OAuth flow — we never see or store your Roblox password. The Studio plugin only runs locally inside your own Studio session and cannot access anything outside of it.

**How much does a typical Roblox UI generation cost?**
Your first generation with a style preset costs $1.00 (Anvil) or $0.25 (Tongs) per frame. Follow-up messages in a conversation and Adaptive mode are token-based and vary by complexity. There are no subscriptions — you only pay for what you use.

**Does the Roblox UI generator work with any game?**
Bloxsmith works with any Roblox Studio place. Install the free plugin, connect with a session code, and your existing ScreenGuis are automatically detected. Generated UIs are standard Luau code that runs anywhere on Roblox.

**What AI models power the Roblox GUI generation?**
Bloxsmith uses Claude Opus 4.6 via Anvil to generate production-ready Luau UI code with real image assets. The AI understands Roblox UI patterns, responsive scaling, and proper Luau code structure.

**Can I use my own icons and images in the generated Roblox UI?**
Yes. Bloxsmith includes a curated icon library that gets automatically matched to your prompt. You can also pin specific assets from the sidebar, edit them with AI, and they'll be uploaded to Roblox and embedded in the generated Luau code.

**What if the generated Roblox GUI code isn't perfect?**
Generated code is standard Luau — you can edit it freely in Roblox Studio. You can also continue the conversation to refine the output, or use Adaptive mode to match your existing Roblox UI style automatically.

**How is Bloxsmith different from other Roblox UI tools?**
Unlike manual GUI editors or simple template plugins, Bloxsmith uses AI to generate complete, production-ready Luau UI code from natural language. It includes style presets, adaptive mode that learns from your existing UIs, real image asset generation, and direct Studio integration — all in one tool.

## Use Cases

Bloxsmith is ideal for:
- **Solo developers** who can code gameplay but struggle with UI design
- **Small teams** who want to prototype UI layouts quickly before polishing
- **Beginners** learning Roblox development who need professional-looking interfaces
- **Experienced developers** who want to skip repetitive UI boilerplate code
- **Game jam participants** who need UI fast under time pressure

### Detailed Use Case Pages
- [Roblox Shop UI Generator](https://bloxsmith.net/use-cases/shop-ui): Item cards, currency displays, buy buttons, category tabs
- [Roblox Inventory GUI Builder](https://bloxsmith.net/use-cases/inventory-gui): Grid slots, rarity borders, equipment panels, tooltips
- [Roblox HUD Design Tool](https://bloxsmith.net/use-cases/hud-design): Health bars, ammo counters, minimaps, wave indicators
- [Roblox Leaderboard UI Generator](https://bloxsmith.net/use-cases/leaderboard-ui): Ranked player lists, stat columns, podium displays
- [Roblox Notification UI Generator](https://bloxsmith.net/use-cases/notification-system): Toast messages, achievement banners, reward popups
- [Roblox Gamepass Shop Generator](https://bloxsmith.net/use-cases/gamepass-shop): VIP passes, multiplier cards, purchase buttons
- [Roblox Code Redemption UI](https://bloxsmith.net/use-cases/code-redemption): Promo code dialogs, input fields, reward displays
- [Roblox Level Up Screen Generator](https://bloxsmith.net/use-cases/level-up-screen): XP bars, stat breakdowns, rebirth interfaces

### Example Prompts
- "Create a shop UI with 4 item cards, a currency display, and a close button"
- "Design a dark sci-fi HUD with health bar, ammo counter, and minimap placeholder"
- "Build a pet simulator adoption screen with rarity tiers and a buy button"
- "Make a tower defense wave counter and upgrade panel"
- "Create a racing game leaderboard with top 10 players and lap times"

## Competitive Advantages

Unlike manual Roblox GUI editors or simple template plugins:
1. **AI-powered**: Generates from natural language, not drag-and-drop
2. **Production-ready code**: Output is real Luau, not screenshots or mockups
3. **Real assets**: Creates and uploads actual image assets to Roblox
4. **Style system**: Presets + Adaptive mode for consistent visual language
5. **Direct integration**: Plugin sends code straight to Studio, no copy-paste
6. **Iterative**: Chat-based refinement, not one-shot generation

## Links

- Homepage: https://bloxsmith.net
- Pricing: https://bloxsmith.net/pricing
- Studio Plugin: https://bloxsmith.net/plugin
- Use Cases: https://bloxsmith.net/use-cases
- Privacy Policy: https://bloxsmith.net/privacy
- Terms of Service: https://bloxsmith.net/terms
- GitHub: https://github.com/boshyxd/bloxsmith-prod
- LLMs.txt: https://bloxsmith.net/llms.txt