Skip to main content

Notifications & HUD

ScaleformUI provides wrappers for Grand Theft Auto V's notification system. Whether you need simple feed alerts, advanced dialogue popups with character images, help text, or 3D world text, everything is consolidated under the Notifications class.

Feed Notifications​

Feed notifications appear above the minimap on the left side of the screen.

Simple Notifications​

using ScaleformUI;

// Basic notification
ScaleformUINotification notification = Notifications.ShowNotification("This is a simple notification!");

// Colored notification (Uses NotificationColor enum)
Notifications.ShowNotification("Colored notification!", NotificationColor.Red, true, true);

// To hide/remove a specific notification early:
if (notification != null)
    notification.Hide();

Advanced Notifications​

Advanced notifications are the dialogue boxes you receive from characters in GTA Online (e.g., Lester, Martin). They include a title, subtitle, main text, and a character icon.

// The wrapper provides an enumeration of all default GTA V characters (NotificationChar)
string selectedChar = NotificationChar.Lester;

Notifications.ShowAdvancedNotification(
    "Lester Crest",         // Title
    "Heist Setup",          // Subtitle
    "Are you ready for the next job?", // Main Text
    selectedChar,           // Icon Dictionary
    selectedChar,           // Icon Name
    HudColor.NONE,          // Background Color
    SColor.AliceBlue,       // Flash Color
    true,                   // Blink minimap?
    NotificationType.Default, 
    true,                   // Show in Brief
    true                    // Sound
);

Help Notifications​

Help notifications appear in the top-left corner (the black box with white text).

// Standard Help Notification (Duration in ms)
Notifications.ShowHelpNotification("Press ~INPUT_CONTEXT~ to interact.", 5000);

// Floating Help Notification (3D World Space)
// This requires a Vector3 position in the world to anchor the text.
Notifications.ShowFloatingHelpNotification("Press ~INPUT_CONTEXT~ to pick up item", new Vector3(100f, -100f, 30f), 5000);

3D Text & 2D Text​

If you need to draw text manually per-frame (e.g., inside a Tick/Update loop), ScaleformUI offers straightforward 3D and 2D text wrappers.

// Draw 3D Text in the world
// Note: Must be called every tick
Notifications.DrawText3D(
    "Floating World Text", 
    new Vector3(100f, -100f, 30f), 
    SColor.White, 
    0.5f,        // Scale
    ScaleformFonts.CHALET_LONDON_NINETEENSIXTY, 
    true         // Drop shadow
);

// Draw 2D Text on the screen (X, Y percentage)
Notifications.DrawText(
    "Screen Text", 
    new PointF(0.5f, 0.5f), // Center of screen
    0.5f,        // Scale
    SColor.HUD_Green, 
    ScaleformFonts.PRICEDOWN_GTAV_INT, 
    Alignment.Center, 
    true,        // Drop shadow
    true         // Outline
);

Subtitles​

Subtitles appear at the bottom center of the screen (typically used for dialogue or mission instructions).

// Show a subtitle (Duration in ms)
Screen.ShowSubtitle("Go to the yellow marker.", 3000);