Documentation
Everything you need to master HyperDevs.
1 Getting Started
What is HyperDevs?
HyperDevs is an AI-powered development environment for Roblox game creators. It integrates multiple AI providers to help you generate 3D models, animations, textures, and Luau scripts — then import them directly into Roblox Studio with one click.
Unlike traditional tools that require Blender, manual rigging, and complex export workflows, HyperDevs automates the entire pipeline from text description to game-ready asset.
System Requirements
- ● OS: Windows 10/11 (64-bit) — macOS coming soon
- ● RAM: 8 GB minimum, 16 GB recommended for 3D generation
- ● Storage: 500 MB free space
- ● Roblox Studio: Latest version for MCP integration
- ● Internet: Required for AI providers (unless using Ollama)
Installation
Download the installer from the download page
Run NexusStudio-Setup.exe
Follow the installation wizard — choose your install location and create desktop shortcut
Launch HyperDevs from Start menu or desktop shortcut
Setting Up API Keys
HyperDevs supports multiple AI providers. You can bring your own API keys, or use our free HyperDevs Cloud tier.
Recommended for Beginners: Google Gemini
Affordable, fast, and excellent quality for most tasks.
- ✓ $1 for 1M tokens (very affordable)
- ✓ Fast response times
- ✓ Great for coding and creative tasks
- ✓ Easy signup process
Adding Your Key in HyperDevs
- 1. Open HyperDevs and click the Settings icon (⚙️) in the top-right
- 2. Select "API Keys" from the left menu
- 3. Choose your provider from the dropdown (Gemini, Claude, OpenAI, or Ollama)
- 4. Paste your API key in the field
- 5. Click "Save" — your key is stored locally and encrypted
🔒 Your keys stay on your computer. All API keys are stored locally in encrypted storage. We never see your keys or your generations.
Your First Asset
Let's create your first 3D game asset using AI. This workflow takes you from text description to Roblox Studio in under 2 minutes.
Generate an Image
Click the ImgGen tab in the left sidebar
In the prompt box, type: "A magical fantasy sword with glowing runes"
Click "Generate" and wait 5-10 seconds
Click "Use for 3D" when you like the result
Convert to 3D
Your image is automatically sent to the 3D generator
Choose: TripoSR (fast, 15s) or Tripo3D (better quality, 30s)
Click "Generate 3D Model" and wait
Preview your model in the 3D viewer — rotate and inspect it
Optimize for Roblox
Click the Prep tab to see polygon count
Roblox limit: ~10K triangles per part
If needed, enable "Auto Reduce" and click "Optimize"
Import to Roblox Studio
Make sure Roblox Studio is open with a place loaded
Click "Import to Studio" in the Prep tab
Your model appears in Studio as an EditableMesh!
Position, scale, and customize as needed
2 AI Providers
HyperDevs supports multiple AI providers. Choose the one that fits your needs and budget. You can switch providers per-tab or use different providers for different tasks.
Google Gemini
Best for beginners
- ✓ Very affordable ($1/1M tokens)
- ✓ Fast response times
- ✓ Great quality for coding & creative
- ✓ Easy signup
Anthropic Claude
Best for complex coding
- ✓ Excellent for Luau scripting
- ✓ Strong reasoning abilities
- ✓ Long context windows
- ✓ More expensive but worth it
OpenAI GPT-4
Best all-around
- ✓ Excellent for all tasks
- ✓ Fast and reliable
- ✓ Great creative capabilities
- ✓ Mid-range pricing
Ollama
Free & offline
- ✓ Completely free
- ✓ Runs locally (offline)
- ✓ Use Llama 3, Mistral, Gemma
- ✓ Slower but private
💡 Tip: Start with Gemini for affordability. Switch to Claude for complex coding tasks. Use Ollama for offline work.
3 Tabs Guide
HyperDevs has six integrated AI tabs. Each tab serves a specific purpose in your game development workflow.
Game Tab
The main hub and control center. Connect to Roblox Studio, manage your project, and access all other tabs from here.
Key Features
- • Studio Connection: One-click connect to Roblox Studio via MCP
- • Project View: See your game hierarchy and open places
- • Quick Actions: Import models, run scripts, refresh connections
- • Status Monitor: Connection status and MCP tool availability
ImgGen Tab
Generate game assets from text descriptions using Flux Schnell — one of the fastest image generation models available.
Key Features
- • Text-to-Image: Describe what you want in plain English
- • Fast Generation: 5-10 seconds per image
- • Multiple Variations: Generate until you find the perfect look
- • One-Click Transfer: Send directly to 3D generation
💡 Prompt Tip: Be specific about style, materials, and lighting. Example: "A crystal sword, glowing blue runes, dark fantasy style, metallic surface"
Coder Tab
AI-powered Luau scripting assistant with full project context. Write, debug, and optimize code with help from AI.
Key Features
- • Smart Context: AI reads your entire game structure via Memory
- • Script Generation: Create complete scripts from descriptions
- • Debugging: Find and fix errors in existing code
- • Live Apply: One-click apply changes directly to Studio
3D Generation Tab
Convert images to 3D models using TripoSR or Tripo3D. Fast, high-quality mesh generation from any image.
Model Comparison
TripoSR
- ✓ Fast (~15 seconds)
- ✓ Good quality
- ✓ Lower detail
Tripo3D
- ✓ Better quality
- ✓ More detail
- ✓ Slower (~30 seconds)
Animation Tab
Generate rigged 3D characters from single images using Meshy v6. Preview animations before importing to Studio.
Key Features
- • Image to Character: Upload any character image
- • Auto Rigging: Full skeleton with bones
- • Animation Preview: See your character move before importing
- • Direct Import: Send to Studio as rigged mesh
Prep Tab
Optimize models for Roblox's strict asset limits. Reduce polygons, bake textures, and prepare for Studio import.
Optimization Tools
- • Polygon Reduction: Auto-reduce to meet Roblox limits
- • Texture Baking: Convert materials to optimized textures
- • Material Optimization: Simplify materials for better performance
- • One-Click Import: Send directly to Studio as EditableMesh
⚠️ Roblox Limits: EditableMesh parts should be under ~10K triangles. Use the auto-reduce feature to stay within limits.
Memory Tab
Deep scan your project to build a knowledge graph. The AI understands your game architecture before every task.
Memory Features
- • Quick Scan: Fast overview of your project structure
- • Deep Scan: Complete analysis of scripts, hierarchy, and patterns
- • Knowledge Graph: Visual map of how everything connects
- • AI Context: Better code suggestions with full project understanding
Viewer Tab
Preview your 3D models in a built-in viewer before importing to Studio. Rotate, zoom, and inspect from all angles.
Viewer Features
- • 3D Preview: Rotate and zoom your model
- • Lighting Control: Adjust lighting to see details
- • Wireframe Mode: Check mesh structure
- • Stats Display: See polygon count and dimensions
4 Asset Pipeline
Complete guide to the asset generation pipeline — from text prompt to game-ready asset.
Pipeline Overview
1. Text to Image
Start with a clear description of what you want to create. The more specific, the better the results.
Prompt Best Practices
- ✓ Be Specific: "A red sword" → "A crimson broadsword with golden crossguard"
- ✓ Include Style: "fantasy", "sci-fi", "medieval", "modern"
- ✓ Describe Materials: "metallic", "wooden", "crystalline", "stone"
- ✓ Add Details: "engraved runes", "glowing gem", "worn leather"
2. Image to 3D
Convert your generated image to a 3D mesh using AI-powered model generation.
Choosing the Right Model
Use TripoSR for:
Quick iterations, simple objects, when speed matters
Use Tripo3D for:
Final assets, complex objects, when quality matters most
4. Mesh Optimization
Roblox has strict limits on mesh complexity. Optimize your models before importing.
Roblox Limits
- • EditableMesh: ~10K triangles per part recommended
- • Triangle Count: Higher counts can cause performance issues
- • Texture Size: Keep textures reasonable (1024x1024 or lower)
Optimization Tips
- ✓ Use auto-reduce for high-poly models
- ✓ Bake multiple materials into single texture
- ✓ Remove hidden geometry (bottom of objects, etc.)
- ✓ Test in Studio with other objects to check performance
5. Importing to Studio
One-click import places your model directly into Roblox Studio as an EditableMesh.
Before Importing
- • Make sure Roblox Studio is open
- • Have a place loaded (empty or existing project)
- • Verify MCP connection is active (check Game tab)
After Importing
- • Model appears at workspace origin
- • Use Studio tools to position and scale
- • Add scripts, collisions, and other properties as needed
- • Save your place to persist the imported model
5 Memory System
The Memory system gives AI full context of your game. It scans your project and builds a knowledge graph for smarter, more relevant assistance.
How It Works
When you scan your project, HyperDevs analyzes:
What Gets Scanned
- • Entire game hierarchy
- • All scripts and their contents
- • Instance names and organization
- • Service dependencies
- • Asset references
What AI Learns
- • Your game's architecture
- • Coding patterns and style
- • Common scripts you use
- • How parts are organized
- • Your project's unique patterns
Quick Scan vs Deep Scan
Quick Scan
Scans in ~10 seconds. Good for getting basic project structure.
Use when: You want quick context or made minor changes.
Deep Scan
Scans in ~30-60 seconds. Analyzes all scripts in detail.
Use when: Starting a session, after major changes, or for complex tasks.
Game Knowledge Graph
The Memory tab visualizes your game as an interconnected graph. This helps the AI understand relationships between systems.
What the Graph Shows
- • Servers: ScriptServer, StarterPlayer, etc.
- • Services: ReplicatedStorage, Players, etc.
- • Connections: How scripts reference each other
- • Hotspots: Areas with lots of activity or scripts
6 Advanced
Power user techniques and best practices for getting the most out of HyperDevs.
Custom System Prompts
You can customize how AI responds by setting custom system prompts for each tab.
Use Cases
- • Coding Style: Enforce specific patterns or frameworks
- • Response Format: Request JSON, Markdown, or other formats
- • Domain Knowledge: Add game-specific context or rules
- • Constraints: Set limits on response length or complexity
Understanding EditableMesh Limits
EditableMesh is powerful but has limits. Understanding these helps you create better assets.
Key Limits
| Triangles per part | ~10K recommended |
| Texture size | 1024x1024 or lower |
| Materials per mesh | 1 (baked recommended) |
Local Model Setup with Ollama
Run AI models locally for free and complete privacy. Great for offline work.
Setup Steps
- 1. Download Ollama from ollama.ai
- 2. Install and run Ollama
- 3. Pull a model:
ollama pull llama3 - 4. In HyperDevs, select Ollama as your provider
- 5. Models appear automatically — no API key needed!
Recommended Models
- • llama3: Best all-around (8B or 70B)
- • mistral: Fast and capable (7B)
- • gemma: Google's model (2B or 7B)
7 Troubleshooting
Common issues and how to resolve them.
Common Errors
"API Key Invalid"
Your API key was rejected by the provider.
Solution: Verify your key is correct and has credits available. Check the provider's dashboard.
"MCP Connection Failed"
Can't connect to Roblox Studio.
Solution: Make sure Studio is open and you're logged in. Try restarting both HyperDevs and Studio.
"Generation Failed"
AI provider returned an error.
Solution: Check your internet connection. Try a different provider or rephrase your prompt.
Import Failures
Model Won't Import to Studio
- ✓ Check MCP Connection: Game tab should show "Connected"
- ✓ Verify Studio is Open: Must have a place loaded
- ✓ Check Polygon Count: Over 20K triangles may fail
- ✓ Try Again: Sometimes a retry works
- ✓ Export as File: Use "Export OBJ" as fallback