Turn 💬 notifications into 📖 narratives.

🎞️ Showcase

Watch the demonstration video to see mad-thoughts in action.

📘 Documentation

Read the docs for more details.

Introduction

A thought bubble notification system designed for immersive roleplay.

In traditional FiveM servers, notifications often break immersion with meta-gaming information: "Not enough police online" or "You don't have the required skill level." These messages force players to acknowledge game mechanics rather than staying in character.

mad-thoughts transforms this experience by displaying notifications as the character's inner thoughts. When a player encounters a locked door they can't pick, instead of seeing "Lockpicking skill too low," they'll think: "This lock looks too complex for me..."

Features and Benefits

• 💭 Immersive Thought Bubbles: Displays character thoughts above the player's head
• 🎨 Rich Customization: Icons, colors, and timing options
• 👉 Scenario System: Automatic thoughts based on gameplay situations
• 💬 Message Variety: Random selection prevents repetition
• 📍 Location Awareness: Thoughts trigger in specific areas
• 🔁 Sequential Thoughts: Create story-driven thought chains
• 🌐 Server-Wide Thoughts: Send thoughts to all connected players
• 💻 Developer-Friendly: Simple exports for easy implementation

⭐ Perfect For:

• Skill check feedback that doesn't break immersion
• Subtle environmental storytelling
• Replacing meta-gaming notifications with in-character thoughts
• Adding personality and depth to player characters
• Creating a more cinematic and immersive experience

Transform your server's notification system from immersion-breaking text to character-driven thoughts. Your players will feel more connected to their characters, and your world will feel more authentic and alive.

Scenarios and Locations

The real power of mad-thoughts comes from creating your own custom scenarios and locations. While the resource includes several pre-built examples, you're encouraged to create ones tailored to your server.

Scenario-Based Thoughts

Scenarios automatically trigger thoughts based on specific conditions that you define. The included examples cover:

• Health status (low health)
• Environmental conditions (rain, thunder, night time)
• Player actions (swimming, running)
• Character needs (hunger, thirst)

Each scenario uses a check function to determine when to trigger, plus the same customization options as regular thoughts (message, icon, color, duration, etc.).

Location-Based Thoughts

Location thoughts appear when players enter areas you've defined. The resource includes examples for:

• Hospitals, police stations
• Beaches, mountains, landmarks
• Buildings, neighborhoods

You simply define coordinates and a trigger radius, along with the thought customization (message, icon, color, duration, etc.).

Both scenario and location-based features can be completely customized through the config.lua file or disabled entirely if you prefer to trigger thoughts only through direct exports.

Server-Wide Thoughts

You can send thoughts to all connected players:

• From a client script
• From a server script
• Using a command

Dependencies

• ox_lib

Support

Join our Discord community for support, regular updates and to request new features.