🎈Hot Air Balloons! Script

Installation Guide (Coming Soon)

Welcome to the official installation guide for the xmmx_hotairballoons resource. This script brings immersive hot air balloon experiences to your FiveM server with smooth animations, camera controls, and interactive seats.


πŸ“¦ Dependencies

Ensure you have the following resources installed before using this script:

  1. ox_libarrow-up-right – UI and utility functions

  2. xmmx_bridgearrow-up-right – Bridge between UI elements and your logic


πŸ”§ Config

File: config.lua

Here's a breakdown of important config options you can customize:

βš™οΈ General

πŸͺ‘ Seat Settings

πŸ—Ί Blip Settings

πŸ“ Spawn Locations

⚠️ Use as few spawn locations as possible to avoid state bag rate limit issues.


πŸš€ Installation

1. Add Dependencies

Ensure these two resources are in your resources directory:

  • ox_lib

  • xmmx_bridge

Ensure ox_lib is initialized in your server config:

2. Add This Resource

Place the xmmx_hotairballoons folder in your resources directory and start it after the dependencies:

3. Verify Configuration

Open config.lua and:

  • Adjust balloon model if custom

  • Add/remove spawn locations

  • Tune idle, move, and height values

  • Match animation dict/clip with available emotes if customized


πŸ’¬ Locales

The Locales table is where you customize all the text for notifications, menus, targets, etc.:


πŸ§ͺ Testing

Once installed, restart your server, and ensure:

  • Hot air balloons spawn at configured locations

  • Players can interact and enter

  • Balloons ascend, idle, and descend as expected

  • State updates appear in debug if enabled


❓ Troubleshooting

  • Balloon doesn't spawn?

    • Make sure you're the first player to connect (spawns only once)

    • Check logs for [XMMX-DEBUG] output

    • Ensure model "balloon" exists or is streamed properly

  • State bag warnings in console?

    • Too many spawn locations or frequent updates

    • Reduce number of locations

    • Uses SetStateIfChanged optimization (already included)


Last updated