Introduction
Welcome to the official documentation for the Aero Framework, a high-performance C# server-side development framework designed specifically for FiveM (Cfx.re) servers.
Why Aero Framework?
Developing server resources in C# for FiveM historically introduces performance and engineering challenges, particularly regarding garbage collection overhead, native interop marshaling, and manual handler boilerplate.
Aero resolves these limitations by introducing a customized architecture optimized for the Cfx.re Mono runtime environment:
⚡ Circular-Buffer Event Dispatcher
Handles server-side events using pre-allocated circular buffers, resulting in extremely low garbage collection pressure and optimal execution speed.
🔎 Zero-Touch Reflection Loader
Dynamically scans your custom assemblies on startup to automatically map and register commands, event callbacks, and driver models.
Getting Started
Installing the Aero Framework is simplified by the automated console utility.
1. Download the Installer
Download Aero.Installer.exe and place it in the root folder of your FiveM server (the folder containing your resources/ directory).
2. Execute the Installer
Run the executable in your console. The installer will automatically download the core modules, register all external dependencies, and construct the correct resource structure:
# Windows
./Aero.Installer.exe
# Linux
chmod +x Aero.Installer.exe
./Aero.Installer.exe3. Enable the Resource
Open your server configuration file (usually server.cfg) and append the loading directive:
ensure aero-core