🚀 RocketeerGame Demo Reference
This is intended as a demonstration of integration rather than how structured and refined gameplay mechanics should behave, however it could be used as a starting point for something comprehensive.
Core Architecture: The game consists of 7 main C++ classes working together - ARocketPawn (player), AObstacleManager (obstacles & projectiles), AEnemyManager (enemy spawning), AFlightPath (enemy movement), AObstacle (game objects), AEnemy (enemy behavior), and URocketeerEventSubsystem (global events).
Advanced Features: Object pooling for performance, event system with delegates, speed synchronization across systems, texture-based obstacle patterns, spline-based enemy flight paths, health/combat systems, and series-based enemy spawning with tracking.
🎮 Game Functions Overview
Implementation Architecture: All AI-callable game functions are implemented in Blueprint (using the LLMAI plugin's function definition system) and delegate to the underlying ROCKETEER_API C++ classes for performance and functionality. The core game logic is handled by classes like ARocketPawn, AEnemyManager, AObstacleManager, and URocketeerEventSubsystem. These functions are all combined into a unified Rocketeer Function Profile that the AI can access through natural language commands.
→ Learn more about the C++ API
🎯 Core Game Functions
👤 Player Management
👾 Enemy System
🌍 Environment
⚔️ Combat System
⏱️ Timer System
🏗️ C++ API
📋 Blueprint Assets
🎯 Core Game Functions
AIF_StartGameRocketeer
Description: Initialize a new game session
"Start a new game"
"Begin Rocketeer game"
"Let's play!"
AIF_CloseGame
Description: End the current game session
"Close the game"
"Exit Rocketeer"
"Stop playing"
AIF_SetGameStage
Description: Change the current game stage and difficulty
•
Stage (integer): Stage number (0-2)•
Difficulty (string): "easy", "medium", "hard"•
FlightpathGUIDs (string): An array of comma seperated flightpath GUIDs that the game will use to spawn enemies"Set the game to stage 2, hard difficulty"
"Advance to stage 1 easy"
AIF_SetGameSpeedMultiplier
Description: Adjust the overall game speed
•
SpeedMultiplier (number): Speed multiplier"Make the game faster"
"Slow down the game"
"Set speed to double"
AIF_GetGameControls
Description: Receive the control descriptions the player can use to control the game
"What controls do I have?"
👤 Player Management Functions
AIF_AddLife
Description: Grant an extra life to the player
"Give me an extra life"
"Add 2 lives"
AIF_RemoveLife
Description: Remove a player life
"Remove a life"
"Make this harder, take away 2 lives"
👾 Enemy Management Functions
AIF_SpawnEnemySeries
Description: Using a flightpath GUID reference you can spawn a number of enemies in a series which will fly along the path. This function returns a SeriesID which you can use to track series progression via events from the game.
•
FlightpathGUID (string): The GUID of the flightpath•
NumEnemies (integer): Number of enemies in this series (default: 1)•
SpawnInterval (number): Interval between each enemy in this series, best to keep the enemies close together for a tight formation (default: 0.2)•
InitialOffset (number): Seconds delay before spawning in the enemies in seconds. You can use this to offset compared to other series (default: 0)•
MovementSpeed (number, optional): You can set a specific speed for this enemy series, or omit if you want to just use the flightpath default speed (default: -1)"Spawn 3 enemies on flight path"
"Create enemy series with tight formation"
"Launch 5 attackers with 2 second delay"
AIF_AddEnemyFlightPath
Description: Create a new flight path for enemies
•
EnemyType (string): Sentinel is only implemented enemy•
Speed (string, optional): Speed of the enemies down the spline•
SplinePoints String of comma seperated points in x,y alternating pairs"Create a flight path that swoops down from the left"
"Add a zigzag pattern"
"Make a circular attack route"
AIF_GetGameActiveFlightPaths
Description: Retrieve list of available flight paths
"What flight paths are available?"
"List all flight patterns"
"Show me the attack routes"
AIF_GetGameFlightpath
Description: Get detailed information about a specific flight path
•
flightPathId (integer): ID of the flight path to query"Show me details of flight path 2"
"Describe the swooping pattern"
"What does path 1 look like?"
🌍 Environment Functions
AIF_SpawnObstacles
Description: AI can spawn one of three different types of test obstacles, used in stage 0 to show examples to the player
•
ObstacleType (string): "TestAsteroids", "TestCrystals", "TestPlates""Add some obstacles"
"Spawn some Plates"
"Spawn some Asteroids"
"Spawn some crystals"
🖥️ UI Management Functions
AIF_SetGameHUDVisibility
Description: Toggle the game HUD display
•
Visible (boolean): true to show, false to hide"Hide the HUD"
"Show the game HUD"
"Turn off the UI"
AIF_SetChatVisibility
Description: Control the chat interface visibility
•
Visible (boolean): true to show, false to hide"Show the chat"
"Hide the chat interface"
"Turn off chat display"
AIF_SetGameBackgroundVisibility
Description: Toggle background elements
•
Visible (boolean): true to show, false to hide"Turn off the background"
"Show the background"
"Hide background graphics"
⚔️ Weapon System Functions
AIF_SetGameRocketFiringMode
Description: Change the rockets's firing mode, the AI can use this as part of a challenge such as the trivia round
•
mode (integer): "0: Disabled", "1: SingleShot", "2: TriShot"•
duration (float, optional): Time limit for mode change in seconds, 0 = infinite"Upgrade to triple shot"
"Disable weapons for 10 seconds"
"Give me spread shot for 30 seconds"
⏱️ Timer System Functions
AIF_AddGameTimer
Description: Create a countdown timer with AI callback
•
Seconds (Integer): Number of seconds for the player to accomplish a task, •
Description (string): Description of the timer for the player if required•
ShowCountdown (Integer): Number of seconds to countdown for the player. eg set to 3 and the last 3 seonds will have a audible beep and number of the screen. 0 = no countdown•
ShowCountdown (Boolean): AI will respond to this timer expiring"Set a 30 second timer with a three second countdown"
"Create a challenge timer"
AIF_GameTimerCancel
Description: Cancel an active timer
•
TimerId (integer): ID of the timer to cancel"Cancel that timer"
"Stop the bonus timer"
🏗️ ROCKETEER_API: C++ Module Interface
📚 What is ROCKETEER_API?
The ROCKETEER_API macro is the core export/import interface that makes the RocketeerGame C++ classes available to other modules, Blueprint systems, and external code. Used to create blueprint-friendly classes and events.
// Core API Definition
#ifndef ROCKETEERGAME_API
#ifdef ROCKETEERGAME_EXPORTS
#define ROCKETEERGAME_API __declspec(dllexport)
#else
#define ROCKETEERGAME_API __declspec(dllimport)
#endif
#endifGame Management Classes
Exported Classes:
ROCKETEERGAME_API ARocketPawn - Player rocket with movement, state management, and weapon systems•
ROCKETEERGAME_API AObstacleManager - Texture-based obstacle patterns and projectile management•
ROCKETEERGAME_API AEnemyManager - Enemy spawning, series tracking, and AI coordinationActor Classes
Exported Classes:
ROCKETEERGAME_API AFlightPath - Spline-based enemy movement paths with firing patterns•
ROCKETEERGAME_API AObstacle - Pooled game objects with health, collision, and physics•
ROCKETEERGAME_API AEnemy - AI enemies with path following and combat capabilitiesGlobal Event Management
Exported Classes:
ROCKETEERGAME_API URocketeerEventSubsystem - Global event broadcasting system• All delegate types for Blueprint event binding
• Static event firing functions for C++ integration
📋 Blueprint Implementations
🎯 Game Assets and Blueprint Classes
The RocketeerGame demo uses several Blueprint assets that extend and configure the C++ base classes. These Blueprints provide the game-specific content, AI integration logic, and visual elements.
DT_Rocketeer_GameStageList
Base C++ Class: UDataTable
Purpose: Data table that provides instructions to the AI when each stage starts. Contains stage configurations, difficulty settings, and contextual information for AI decision-making.
Predefined FlightPaths
Base C++ Class: AFlightPath
Available Patterns: Three swoop patterns and two vertical weave patterns that the game uses to spawn enemies. The AI can retrieve information about these paths, create new ones, and optionally include them in the SetGameStage function call.
PAWN_Rocket
Base C++ Class: ARocketPawn
Purpose: Blueprint subclass of the player-controlled rocket. Configures mesh, materials, input handling, and visual effects for the rocket ship.
STRUCT_GameTimer & STRUCT_GameStage
Base C++ Class: USTRUCT
Purpose: Blueprint structures that define internal data formats for game timers and stage configurations. Used by the game systems for state management and AI communication.
BP_rocketeer_backdrop
Base C++ Class: AActor
Purpose: Default backdrop actor for the game environment. Provides the visual background and atmosphere for the gameplay area.
BP_Rocketeer_GameManager
Base C++ Class: AActor or AGameModeBase
Purpose: Main scripting hub for game systems. Handles interpretation of AI function calls, manages game state, coordinates between systems, and implements the LLMAI function definitions that bridge natural language commands to C++ game logic.
ENEMY_Sentinel
Base C++ Class: AEnemy
Purpose: The primary enemy type available in the game. Configured with specific mesh, materials, health, movement patterns, and combat behavior.
Obstacle Definitions
Base C++ Class: AObstacle
Available Types: Three types of obstacles (TestAsteroids, TestCrystals, TestPlates) and projectile definitions. Each configured with unique meshes, collision properties, health values, and visual effects.
Obstacle_Patterns Obstacle pattern textures, each color channel is assigned an obstacle type by the game manager and configuration passed to the obstacle manager which uses it to determine which obstacles spawn over time.