Flopperam Logo
// DOCUMENTATION

Flop AI Docs

AI agents for Unreal Engine. Analyze Blueprints, build levels, manipulate assets through natural language.

// OVERVIEW

Getting Started

Flop AI brings AI agents directly into Unreal Engine Editor. Connect to language models like Claude, GPT-5.2, Gemini, and Grok to create and modify your project through conversation.

Multi-Model

Claude, GPT-5.2, Gemini, Grok

Native UI

Chat window inside Unreal

3D Generation

Text/image to 3D models

Blueprint Analysis

Inspect and understand blueprints

example prompt
$ Analyze BP_StackOBotCharacter and explain how the movement system works
// SETUP

Installation

UE 5.5.4UE 5.6.1UE 5.7.2

Download Plugin

Download the FlopAI plugin for your Unreal Engine version. You must be signed in to download.

Go to Download Page

Supports UE 5.5.4, 5.6.1, 5.7.2 • ~20 MB • Windows x64

Installation Steps

1

Download the plugin for your UE version

Go to the Unreal Agent page and select your engine version. You must be signed in to download.

2

Extract the ZIP to your project's Plugins folder

Create the folder if it doesn't exist. Your structure should look like:

YourProject/Plugins/FlopAI/FlopAI.uplugin
3

Restart Unreal Engine

Close and reopen your project. The plugin will auto-load on startup.

4

Sign in via the menu

Go to Tools → Flop AI → Sign In and log in with your Flopperam account.

plugin menu
FlopAI plugin menu in Unreal Engine
Sign In

Opens the login dialog to authenticate with your Flopperam account.

Sign Out

Logs you out and clears your session.

Agent Chat

Opens the main chat window to interact with the AI agent.

Rebuild Index

Helps the agent read and understand your project.

// LAUNCH

Quick Start

Open Unreal with the plugin installed. Go to Tools → Flop AI → Agent Chat to open the chat panel. Sign in and wait for "Connected" status.

in-editor interface
Flop AI plugin running inside Unreal Engine editor

The agent runs directly inside Unreal Engine, with full access to your project.

example: movie theater

Built with: "Create a detailed movie theatre with tiered seating, a stage, and cinema materials."

Movie theater - building process
Movie theater - finished result
example: bowling alley

Built with: "Create a detailed bowling alley with 6 lanes, neon lighting, and a seating area."

Bowling alley - building process
Bowling alley - finished result
web interface
Flop AI web interface

Also available at flopperam.com/unreal-agent with tool timeline, image upload, and voice input.

// MODES

Agent Modes

Three modes for different workflows. Switch via the toolbar dropdown.

AgentEXECUTES

Plans and executes tasks. Spawns actors, modifies properties, creates blueprints and materials.

AskREAD-ONLY

Information and guidance without execution. Learn concepts, get code explanations, plan before building.

3DGENERATE

Create 3D models from text or images. Auto-imports as Static Mesh and spawns in level.

Mode selector dropdown
// 3D MODELS

3D Generation

Generate 3D models from text descriptions or reference images. Models include PBR materials and auto-import as Static Meshes.

how it works
Text PromptAI generates reference imageImage-to-3D conversionStatic Mesh in Unreal
GOOD
Fast Generation

Fastest generation, good quality. Best for quick iterations and prototyping.

HIGH
Balanced

Balanced speed and quality. Higher detail textures and geometry.

VERY HIGH
Maximum Quality

Highest quality. Best geometry, textures, and PBR materials. Slower generation.

Text-to-3D

Describe what you want. The system generates a reference image, then converts to 3D.

a medieval sword with ornate handle
Image-to-3D

Upload a reference image or concept art. Direct conversion to textured 3D mesh.

drag & drop or paste image

Auto-import: GLB downloaded and imported as StaticMesh

Auto-spawn: Placed in level at origin (adjustable)

Materials: PBR textures included with all quality tiers

Tier access: Good available to all users. High/Very High require Pro+ subscription.

// INSPECT

Blueprint Analysis

Deep inspection and understanding of any Blueprint in your project. Ask questions about structure, logic flow, variables, functions, and component hierarchies—get detailed answers without opening the Blueprint editor.

what you can inspect
Variables & Properties

See all variables with their types, default values, replication settings, and edit flags.

Functions & Events

Get function signatures, parameters, return types, and event dispatchers with full details.

Component Hierarchy

Explore the full component tree, including inherited components, class types, and attachment structure.

Graph Logic

Analyze EventGraph, function graphs, and macros—see nodes, connections, and execution flow.

Interfaces & Inheritance

View implemented interfaces, parent class relationships, and inherited property overrides.

Class Defaults

Inspect the Class Defaults Object (CDO) to see base property values and Blueprint settings.

common use cases
Understanding Existing Blueprints

Quickly understand how a Blueprint works without manually clicking through the editor. Great for onboarding to a new project or reviewing unfamiliar assets.

Debugging & Troubleshooting

Trace connections between nodes, check variable values, and understand execution flow when something isn't working as expected.

Documentation & Review

Get a complete overview of a Blueprint's structure for documentation, code reviews, or explaining systems to team members.

Selected Node Context

Select nodes in the Blueprint editor and ask about them directly. The agent sees what you've selected and can explain or modify those specific nodes.

example prompts
overviewGive me an overview of BP_PlayerCharacter
variablesWhat variables does BP_Enemy have and which ones are replicated?
functionsShow me all the functions in BP_WeaponBase and their parameters
componentsWhat components does BP_Vehicle have and how are they attached?
graph logicExplain the logic in BP_Door's EventGraph—what happens when the player interacts?
connectionsTrace the execution flow from BeginPlay in BP_GameMode
inheritanceWhat interfaces does BP_Interactable implement and what functions do they require?
selected nodesWhat do these selected nodes do? (with nodes selected in editor)
debuggingWhy might the Health variable in BP_Character not be updating? Show me where it's modified.
tip

For best results, use the full Blueprint path (e.g., /Game/Blueprints/BP_Player) or just the name if it's unique. You can also select nodes in the Blueprint editor and ask about your current selection.

// TOOLKIT

Features

Model Selector

Choose AI models. Auto mode picks the best fit, or select from Claude Opus, Claude Sonnet, Claude Haiku, GPT-5.2, and more.

Model selector dropdown

Voice & Image Input

Speak commands or paste screenshots. Show your scene, provide reference images, mark areas to modify.

Tool Timeline

Real-time view of agent operations — tool calls, parameters, results, timing.

Reasoning Control

Adjust thinking depth. Low for quick tasks, High/XHigh for complex operations.

// BILLING

Pricing & Credits

Credits represent API usage from AI providers like Anthropic, OpenAI, Google, and xAI. When you subscribe, Flop gives you twice the API usage value of what you pay—$15/month gets you $30 in usage, $30/month gets $60, and so on.

how credits work

Your credits are consumed based on the AI model you use and the complexity of your request. Different models have different costs per token—more capable models cost more per request.

Example: A simple spawn command might cost a few cents, while a complex multi-step Blueprint creation could cost more depending on the model and reasoning depth you've selected.

Your remaining balance is always visible in the agent interface. When it reaches $0, you'll need to subscribe or wait for your next billing cycle to continue.

subscription tiers
Free$0

One-time $10 API usage bonus when you sign up. No credit card required.

  • • Sonnet 4.5, GPT 5.2, Grok 4.1 Fast, Gemini Flash
  • • Voice & image input
  • • 3D generation (Good quality)
Pro$15/mo → $30 usage

Double your investment with 2x value. Access to all premium AI models.

  • • All models: Claude Opus/Sonnet/Haiku, GPT-5.2, Gemini, Grok
  • • 3D generation (High & Very High quality)
  • • Early access to new features
Plus$30/mo → $60 usagePOPULAR

Best value for regular users. Everything in Pro plus priority support.

  • • Everything in Pro
  • • Priority support
Max$100/mo → $200 usage

Maximum power for heavy users and teams. 2x value at scale.

  • • Everything in Plus
  • • $200 in monthly API usage
patreon membership

Prefer Patreon? We offer tiers from $5 to $100/month, each giving you 2x API usage value plus exclusive perks:

  • • Discord donor role & community access
  • • Name read in videos (higher tiers)
  • • Private meetings with the team (top tiers)
  • • Custom merch rewards

Already a patron? Sync your membership on the pricing page to activate your API usage.

note

Pricing, credit amounts, and tier benefits are subject to change as the service evolves. Subscription credits reset each billing cycle and do not roll over. See our pricing page for current details.

// PROMPTS

Examples

Be specific. Break complex tasks into steps. Use images when helpful.
Level Design
Build a 10x10 maze using walls with a single entrance and exitCreate a movie theatre with 5 rows of seats facing a large screenSpawn a circular arena with pillars around the edge for cover
Transforms & Selection
Move all the furniture in this room 200 units to the leftRotate these selected chairs to face the stageScale all the trees in my level to be 50% larger
Blueprints
Create a BP_SlidingDoor that opens when the player overlaps a triggerExplain how the damage system works in BP_CharacterAdd a Health variable to BP_Enemy with a default value of 100
3D Generation
Generate a medieval wooden barrel with metal bandsCreate a sci-fi control panel with glowing buttonsMake a 3D model from this concept art I'm pasting
// LINKS

Resources

Ready to start?

Download the plugin and connect your account.