v1.0Last updated: October 2026

Picoo Documentation

Your AI copilot for Roblox Studio. Type what you want in plain English at picoo.io/chat — Picoo writes the Lua, builds the UI, generates 3D models, and wires entire game systems for you. No SDK, no setup files, no boilerplate.

Code Generation
3D Models
Game Systems
Terrain & Effects
NPC & Quests
Game Audit
Performance Profiler
Image → UI
Install Picoo from the Roblox Creator Store

Install Plugin

Set up Picoo in 3 steps. Takes under 2 minutes.

1

Install the Picoo plugin

Open the Picoo plugin on the Roblox Creator Store and click Get. It auto-installs into Studio.

2

Connect with your Picoo connection key

Pick a plan and your connection key appears on the setup page; it starts with picoo_. In Studio open the Picoo panel (Plugins tab → Picoo), paste the key into the “Paste your API key” box and click Sign in.

3

Click Allow when Studio asks

Studio asks twice: once so Picoo can reach picoo.io, once so it can edit scripts. Click Allow both times. Clicked “Don't Allow”? Open Manage Plugins in the Plugins tab and turn Picoo's permissions on. You're ready to build.

Games that save data: in File → Experience Settings → Security, turn on Enable Studio Access to API Services so DataStore-backed systems work while you test. Allow HTTP Requests there is for your game's own web calls, and Allow Third Party Sales only if you sell GamePasses or Developer Products. One-time per place file.
Edit mode only. Picoo works in Edit mode, not during Play mode. Do not press Play while Picoo is building your game systems.

Quick Start

After connecting, type what you want to build in the chat. Picoo writes Lua scripts, creates instances, and builds everything directly in your game. Try these examples:

Example promptsTry these
lua
-- Open picoo.io/chat and type any of these:

"Give me a sword in StarterPack"
"Add 2 zombie enemies that chase the player"
"Build a shop UI with 3 items and a Buy button"
"Generate a magical purple crystal in 3D"
"Create an obby with 5 stages and checkpoints"
"Drop a screenshot of UI → I'll rebuild it in Roblox"
"Make NPCs that talk and give quests"
"Audit my place and tell me what's broken"
Generate scripts (server + client)auto
Build UI from text or imagesauto
Insert 3D assets (3,500+ CC0 Kenney library)auto
AI 3D model generation (Rodin)auto
Wire complete game systems (combat, shop, quest)auto
Multi-language: TR / EN / ES / anyauto
Recipe-grade compound systemsauto
Edit-mode workflow (no Play required)auto
Everything above happens through one chat prompt — Picoo handles the architecture, file placement, and wiring. No setup files, no boilerplate.

Connection Key

Each Picoo account has one connection key. It appears on the setup page once you pick a plan, starts with picoo_ and links the Studio plugin to your account: paste it into the plugin once and it stays saved. In the plugin the box says “Paste your API key”. Your email or password won't work there. Later you can also find it here:

This is not an OpenAI, Anthropic or Gemini key, and you don't need one of those. Picoo runs the AI models on its own account, and each turn is paid for with your plan's credits.

picoo.io→Dashboard→Picoo→Studio Connection
Never share your connection key. Anyone with it can run actions in your account and spend your credits. Paste it only into the Picoo plugin in your own Studio. If it leaks, regenerate it from the dashboard.

Chat Interface

You chat with Picoo at picoo.io/chat in your browser; the Picoo plugin in Studio receives each change and applies it to your open place. Type what you want in plain English and Picoo handles everything — writing scripts, creating instances, setting properties.

How it worksOverview
lua
-- You type in the chat:
"Build me a combat system with a sword and health bar"

-- Picoo creates:
-- + ReplicatedStorage/Remotes/CombatRemote
-- + ServerScriptService/CombatServer
-- + StarterGui/HealthBarUI (dark theme, animated)
-- + StarterPack/ClassicSword (Tool)
-- + StarterPlayerScripts/CombatClient
-- Done in 42 seconds, from 5 credits (Sonnet)
Edit mode only. Picoo only works in Edit mode. Do not press Play while Picoo is creating scripts — it will disconnect.

Code Generation

Picoo writes production-ready Lua code with --!strict type safety, anti-exploit validation, and proper server/client architecture.

Example: Sprint SystemGenerated by Picoo
lua
--!strict
-- StarterPlayerScripts/SprintHandler (LocalScript)
local Players = game:GetService("Players")
local UserInputService = game:GetService("UserInputService")

local player = Players.LocalPlayer
local SPRINT_SPEED = 32
local WALK_SPEED = 16

UserInputService.InputBegan:Connect(function(input, processed)
    if processed then return end
    if input.KeyCode == Enum.KeyCode.LeftShift then
        local char = player.Character
        if char then
            local hum = char:FindFirstChildOfClass("Humanoid")
            if hum then hum.WalkSpeed = SPRINT_SPEED end
        end
    end
end)

UserInputService.InputEnded:Connect(function(input)
    if input.KeyCode == Enum.KeyCode.LeftShift then
        local char = player.Character
        if char then
            local hum = char:FindFirstChildOfClass("Humanoid")
            if hum then hum.WalkSpeed = WALK_SPEED end
        end
    end
end)
Picoo automatically places scripts in the correct location — Server scripts in ServerScriptService, LocalScripts in StarterPlayerScripts, ModuleScripts in ReplicatedStorage.

3D Model Generation

Describe what you want and Picoo generates a 3D mesh, uploads it, and inserts it directly into your game. Takes about 6–8 minutes. Costs 15 credits.

Example prompts3D Models
lua
-- Type in chat:
"Generate a low-poly medieval castle"
"Create a cartoon treasure chest"
"Make a sci-fi laser gun, blue glow"

-- Picoo will:
-- 1. Generate the 3D model via AI
-- 2. Upload it to Roblox
-- 3. Insert it into Workspace
-- 4. Position it near your camera

Game System Templates

One prompt = complete game system. Picoo creates all scripts, RemoteEvents, UI, and instances. Tested architectures with anti-exploit validation.

Combat System

Sword, damage, health bar, respawn, cooldowns

Pet System

Hatching, rarity, follow AI, inventory, DataStore

Shop System

Item catalog, currency validation, purchase UI

Obby Checkpoints

Stage tracking, kill bricks, respawn, leaderboard

Daily Rewards

7-day streak, DataStore save, claim UI

NPC Dialog

Dialog trees, typewriter effect, ProximityPrompt

Quest System

Collect/kill/visit quests, progress tracking, rewards

Inventory

Grid UI, drag-drop, stackable items, DataStore

Vehicle System

Welded car, VehicleSeat, kinematic WASD driving

Tycoon

Droppers, collectors, upgrades, buy buttons

Game Audit & Score

Ask Picoo to audit your game and get a quality score out of 100. It scans structure, security, performance, and gameplay — then offers to auto-fix every issue.

Game AuditExample
lua
-- Type: "Audit my game and give me a quality score"

-- Picoo runs a comprehensive scan:
-- Structure: SpawnLocation, script placement, hierarchy
-- Security: RemoteEvent validation, client-side currency
-- Performance: Part count, unanchored parts, StreamingEnabled
-- Dead Code: Unused RemoteEvents, empty/disabled scripts
-- Gameplay: Baseplate, DataStore usage, kill bricks

-- Output: Game Quality Score: 72/100
-- + offers to fix each issue automatically

Performance Profiler

Picoo adds a server script that prints memory, server FPS and an instance census to Output when you press Play, with a specific optimization step for each issue it finds.

Performance ProfileExample output
lua
-- Type: "Profile my game's performance"

-- Picoo adds a profiler script. Press Play and it prints:
-- Memory: 245 MB (OK)
-- FPS: ~58 (OK)
-- Instances: 12,450
--   Parts: 3,200 (MeshParts: 890)
--   Scripts: 45 (Active: 38)
--   GUI Objects: 120
--   Particles: 18
-- StreamingEnabled: true

-- Issues Found:
-- 1. 340 unanchored parts causing physics load

NPC & Quest Systems

Picoo creates full NPC AI with pathfinding, dialog trees with typewriter effects, and quest systems with progress tracking.

NPC DialogGenerated
lua
-- Type: "Make NPCs that talk and give quests"

-- Picoo creates:
-- + DialogData (ModuleScript) - dialog trees
-- + DialogServer (Script) - proximity + state
-- + DialogClient (LocalScript) - typewriter UI
-- + QuestServer (Script) - progress tracking
-- + QuestUI (ScreenGui) - quest log + tracker
-- + NPC Models with ProximityPrompt

-- Quest types: collect, kill, visit, talk, deliver
-- All progress tracked server-side via Attributes

Terrain & Effects

Generate terrain with Perlin noise, create particle effects, lighting presets, and sound design — all from plain English.

Terrain ExamplesPrompts
lua
-- Terrain:
"Create a desert terrain with sand dunes"
"Build a mountain range with snow peaks"
"Make an ocean with a small island"

-- Effects:
"Add fire particles to the torch"
"Create a healing glow effect"
"Make a dash trail effect"

-- Lighting:
"Set up horror lighting with fog"
"Create a sunset atmosphere"
"Add underwater post-processing"

Credits & Pricing

Every AI interaction costs credits. Pack credits never expire. Each renewal adds your plan's monthly credits on top of them; unused monthly credits don't roll over. Monthly credits are used first.

AI chat turn — Haiku / Sonnet1 / 5 credits
Each change past the first two in a turn (up to 15 per turn)+1 credit
Each attached image+2 credits
Turn whose AI cost runs above normal (e.g. a very large place)+ surcharge
UI kit generation5 credits / element
Luau typecheck + cloud sandbox execution + AI verificationincluded free
3D Model Generation15 credits
Thumbnail Generation2 credits
Pro
200/month$19/mo ($12/mo yearly)
Business
500/month$49/mo ($35/mo yearly)

Troubleshooting

Plugin not connecting

Read the line above the key box in the Picoo panel: it says what went wrong. Your connection key starts with picoo_ and appears once you pick a plan; clear the box, paste only the key and click Sign in. If it says Studio blocked Picoo's web access, open Manage Plugins (Plugins tab) and turn Picoo's permissions on.

DataStoreService: StudioAccessToApisNotAllowed error

File → Experience Settings → Security → toggle 'Enable Studio Access to API Services' ON. This lets DataStore work in Studio Play mode. One-time per place.

Connection timed out

Complex tasks (5+ scripts) may exceed Roblox's HTTP timeout. The scripts are still being created — check Explorer panel. Send another message when ready.

Credits not updating

Credits refresh when you reconnect. Click the menu button > Reconnect in the plugin.

3D model not appearing

Model generation usually takes about 6–8 minutes. It will auto-insert into Workspace when ready. Check the chat for status updates.

Plugin disappeared after Play mode

Picoo only works in Edit mode. After stopping Play mode, the plugin will reconnect automatically.

Scripts created in wrong location

Tell Picoo where you want them: 'Create a script in ServerScriptService called MyHandler'. It follows your instructions.

Still stuck? Email us at help@picoo.io and we'll help you get set up.