aura_thoughts

Aura Thoughts is a FiveM script that displays contextual thought bubbles when players enter specific zones in the game world. Featuring a modern UI with smooth animations and FontAwesome icon support.

Features

• Zone-Based Thoughts: Configurable zones with custom thoughts that trigger on entry

• Dynamic Display: Show thoughts with optional icons and durations

• Modern UI: Clean, dark theme design

• Smooth Animations: Fade in/out transitions for a polished experience

• Easy Integration: Simple exports for client-side usage

• Customizable Styling: Modify colors, fonts, and layout via CSS

Installation

1. Clone this repository or download the latest release.

2. Place the aura-thoughts folder in your FiveM server's resources directory.

3. Add ensure aura-thoughts to your server.cfg file.

4. Configure the zones and thoughts in the config.lua file.

5. Restart your FiveM server.

Usage

Client-Side Exports

Show Persistent Thought

exports['aura-thoughts']:ShowPersistentThought(text, icon, iconColor, borderColor)

• text (string): The message to display

• icon (string, optional): FontAwesome icon class (e.g., "fas fa-lightbulb")

• iconColor (string, optional): Hex color for the icon (e.g., "#32CD32")

• borderColor (string, optional): Hex color for the border (e.g., "#228B22")

Show Temporary Thought

exports['aura-thoughts']:ShowTemporaryThought(text, icon, duration, iconColor, borderColor)

• text (string): The message to display

• icon (string, optional): FontAwesome icon class

• duration (number): Display time in milliseconds

• iconColor (string, optional): Hex color for the icon

• borderColor (string, optional): Hex color for the border

Hide Thought

exports['aura-thoughts']:HideThought()

Example Usage

-- Show a persistent thought with an icon
exports['aura-thoughts']:ShowPersistentThought("I wonder what's in that building...", "fas fa-question")

-- Show a temporary thought for 5 seconds
exports['aura-thoughts']:ShowTemporaryThought("This place gives me the creeps!", "fas fa-ghost", 5000)

-- Show a thought with custom colors
exports['aura-thoughts']:ShowPersistentThought("Green vibes!", "fas fa-leaf", "#32CD32", "#228B22")

-- Hide the current thought
exports['aura-thoughts']:HideThought()

Configuration

Edit config.lua to define zones and their associated thoughts:

Config = {
    Zones = {
        {
            coords = vector3(0.0, 0.0, 0.0),  -- Zone center coordinates
            radius = 50.0,                    -- Zone radius
            icon = 'fas fa-question',         -- FontAwesome icon
            iconColor = '#32CD32',            -- Icon color (optional)
            borderColor = '#228B22',          -- Border color (optional)
            duration = 5000,                  -- Duration for temporary thoughts
            randomThoughts = true,            -- Random thought selection
            type = "persistent",              -- 'persistent' or 'temporary'
            thoughts = {
                "This place feels familiar...",
                { text = "I should be careful here", icon = "fas fa-exclamation-triangle", duration = 3000 }
            }
        }
    },
    Debug = false  -- Enable debug mode
}

Screenshots

• Sewers

• WhiteWidow

• LSCustoms

• CourtHouse

Support

For support, please open an issue on our GitHub repository or contact us through our discord.