Profiles
F5 Boost has a profile system that lets players save, load, and share their settings. Profiles are stored server-side in MySQL, tied to the player's Rockstar license.
Saving a Profile
Open the menu, go to the Profiles tab, type a name (max 30 characters) and click save. The current preset, mode, all slider values, and all toggle states are captured into the profile.
Each player can have up to Config.MaxProfiles profiles (default: 5). The counter at the bottom of the save section shows how many slots are used. When all slots are full, the save section is hidden.
Loading a Profile
Click the download icon next to any saved profile. This applies all settings from that profile immediately, updates the UI, and saves to KVP.
Overwriting a Profile
Click the save icon next to an existing profile to overwrite its settings with your current ones. The profile name stays the same, only the settings data is replaced.
Deleting a Profile
Click the delete icon next to a profile. This frees up the slot.
Default Profile
Click the star icon to set a profile as your default. A filled star means it's the active default.
The default profile is applied automatically when a player joins the server, but only if they don't already have saved KVP settings. This means:
- First join: no KVP data exists, default profile is applied
- Returning player: KVP data exists from their last session, default profile is ignored
Click the star again to unset the default.
Default profiles are useful for servers that want to push a recommended baseline to new players. Set up a profile with your preferred settings and mark it as default. Every new player will start with those settings.
Share Codes
Share codes let players exchange settings without the database. A share code encodes all settings into a compact string like F5-A7K-M3P-X9Q.
Exporting
Click Export in the Profiles tab. The script generates a code from your current settings and puts it in the input field. Copy it and send it to anyone.
Importing
Paste a share code into the input field and click Apply. If the code is valid, the settings are applied immediately. If invalid, the input field flashes red.
How Share Codes Work
The code uses a custom Base32 encoding (Crockford variant, no ambiguous characters like O/0/I/L). It packs all settings into a single number:
| Data | Bits |
|---|---|
| Graphics preset (8 options) | 3 bits |
| Performance mode (4 options) | 2 bits |
| Shadow distance (0-100) | 7 bits |
| Object quality (0-100) | 7 bits |
| Character quality (0-100) | 7 bits |
| Vehicle distance (0-100) | 7 bits |
| Toggle flags (6 toggles) | 6 bits |
The result is 8 Base32 characters plus a checksum character, prefixed with F5- and formatted with dashes for readability.
The checksum catches typos. A single wrong character makes the code invalid.
Database Schema
Profiles are stored in the f5_boost_profiles table:
| Column | Type | Description |
|---|---|---|
id | INT | Auto-increment primary key |
identifier | VARCHAR(100) | Player's license2: or license: identifier |
slot | TINYINT | Profile slot number (1 to MaxProfiles) |
name | VARCHAR(50) | Profile display name |
settings | LONGTEXT | JSON-encoded settings snapshot |
is_default | TINYINT(1) | Whether this is the auto-apply profile (0 or 1) |
created_at | TIMESTAMP | When the profile was created |
updated_at | TIMESTAMP | Last time the settings were updated |
The table has a unique index on (identifier, slot) to prevent duplicate slots per player.
Player Identification
F5 Boost identifies players by their Rockstar license. It uses license2: when available (more stable), falling back to license: as a universal fallback.
Settings Sanitization
All settings coming from the client are validated server-side before being stored. Number values are clamped to 0-100 and floored to integers. Types are checked against a schema (strings stay strings, booleans stay booleans, numbers stay numbers). Unknown keys are stripped.