UI AI Builder by Risor
======================

Generate a complete, Roblox-style game UI (HUD, shop, inventory, battle pass,
spin wheel, settings...) from one line of text or your game design document.

1. INSTALL
   - Node.js LTS: https://nodejs.org
   - Plugin: get it on the Roblox Creator Store (it appears in Plugins > Risor),
     or, if you bought the file on risor.shop, put UIAIBuilder.rbxmx in Studio's
     plugins folder (Studio > Plugins tab > Plugins Folder) and restart Studio.
   - Unzip this folder anywhere.

2. START THE BRIDGE
   Double-click start-bridge.cmd (Windows) or start-bridge.command (Mac) and keep
   the window open. The first time, Studio asks if the plugin may access
   127.0.0.1: allow it.

3. CHOOSE YOUR AI (plugin > gear icon > AI provider)
   - Claude Code: uses your Claude Pro/Max subscription. Install Claude Code
     (https://claude.com/claude-code), sign in once, done. Nothing to paste.
   - API key: paste an Anthropic API key (console.anthropic.com). Pay per use,
     roughly US$ 1-3 for a full pack of ~20 screens.

4. ICONS (optional, recommended)
   Paste a Gemini API key (aistudio.google.com/apikey, billing enabled) in
   Settings > Icons. In the Style tab, "Draw missing" paints the icons your
   screens use, in your game's style, and uploads them to YOUR Roblox account.
   Every 16 icons = 2 image uploads. Don't upload hundreds of images in one day:
   Roblox moderates accounts that bulk-upload.

Your keys stay on your PC (bridge/work/config.json). They are never saved in
the place file and are only sent to the AI provider you chose (Anthropic, and
Google Gemini for icons).

SECURITY
   - The bridge only listens on 127.0.0.1 (this computer) and refuses requests made by web pages in your browser.
   - The AI can only read the files you attach (bridge/work/uploads), nothing
     else on your PC.
   - No telemetry: nothing is sent to Risor.

Latest version and checksum: risor.shop/downloads/ui-ai-builder

PDF game design documents: read locally if Python + PyMuPDF are installed
(pip install pymupdf), otherwise sent whole to Claude, which reads PDFs natively.
