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.
Install Plugin
Set up Picoo in 3 steps. Takes under 2 minutes.
Install the Picoo plugin
Open the Picoo plugin on the Roblox Creator Store and click Get. It auto-installs into Studio.
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.
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.
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:
-- 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"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.
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.
-- 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)Code Generation
Picoo writes production-ready Lua code with --!strict type safety, anti-exploit validation, and proper server/client architecture.
--!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)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.
-- 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 cameraGame 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.
-- 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 automaticallyPerformance 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.
-- 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 loadNPC & Quest Systems
Picoo creates full NPC AI with pathfinding, dialog trees with typewriter effects, and quest systems with progress tracking.
-- 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 AttributesTerrain & Effects
Generate terrain with Perlin noise, create particle effects, lighting presets, and sound design — all from plain English.
-- 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.
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.