Performance and compatibility
How heavy is it?
The festival only costs anything for players near it (800 m by default). Far away, it does nothing.
Each player chooses their own quality, so a player with a weak PC does not slow down the others:
/festival quality low
/festival quality medium
/festival quality high
Admins can set the default quality in the admin panel.
What costs the most (from most to least)
| What | Why | How to make it lighter |
|---|---|---|
| Real lights | Lights that shine on the ground and buildings. | Lower quality (lights in config/quality.lua). |
| Light beams | Hundreds of beams drawn every frame. | Lower quality, or Config.Render.technique = 3 (thin lines). |
| The island | About 520 extra objects (ground, trees, rocks, lamps). | Turn Vegetation off (saves about 500 objects), or turn the island off and use flat land. |
| Live screens | The LED screens and the touch screens show live visuals. | Config.LiveScreens = false. |
| The stage models | The amphitheatre is the heaviest theme; the Crystal spire is the lightest. | Choose a lighter theme. |
| Set-up pieces | Each extra piece adds objects and lights. | Fewer pieces, or lower config/building.lua limits. |
Objects created per player (approximate)
| With island | Without island | |
|---|---|---|
| Amphitheatre | about 930 | about 410 |
| Other themes | about 890 | about 370 |
These are local objects (only on each player’s game). They do not use your server’s network entity limit.
Recommendations
- Start with Medium as the default quality.
- If you have many players with weak PCs: default Low, and
Config.LiveScreens = false. - If players crash on arrival: Vegetation off first.
- Use
/festival debugto see FPS and how many lights are on. - Do not fire pyro by hand on top of a big automatic show moment: the game has a limit of particles at once, and some may not appear.
Compatibility
| Setup | Status |
|---|---|
| Qbox + ox_inventory + ox_target | Tested in game. |
| QBCore with its own inventory | Supported, not tested in game. |
| ESX with its own inventory | Supported, not tested in game. |
| QBCore or ESX with ox_inventory | Supported, not tested in game. |
| qb-target | Supported, not tested in game. |
| No target script (help text + E key) | Supported, not tested in game. |
| No framework | Supported (no tickets, shops or jobs), not tested in game. |
| OneSync off | Not supported. Tickets, stalls and lockers need OneSync. |
| pma-voice | Works. Change the touch-screen key if your radio uses Alt. |
Known detail: with ESX and its own inventory, the stall menu may show the item’s internal name instead of its label.
Known limits
- One festival per server.
- Music: only direct links to audio files. No YouTube, Spotify or streaming services.
- Sound: the volume depends on the distance to the stage. It has no direction and does not go quieter behind walls.
- Screens: they all show the festival’s visuals. You cannot put your own video or image.
- No NPC crowd.
- The lights on top of bridges and towers (LED bars and garlands) are always white and always on.
- Analysis: automatic and approximate. Very long sets may not fit. Two operators editing the same show at once: the last change wins.
- Island: you cannot swim in its lake or stream (they are shallow). The island is hollow underneath: divers can see inside it.
- Access control only moves the player to the entrance. A player using cheats can avoid it. Money and items are always checked by the server.
- Models are visible up to 800 m.
- Particles depend on the game version. If one does not exist on your version, change it in
config/effects.lua. - The newest parts (the amphitheatre theme, the island, the light bridges and towers, the set-up editor and the touch screens) have been checked carefully but not yet on a live server with many players. If you see something wrong, tell us.