Troubleshooting and FAQ
To see errors in game, press F8 (the game console). On the server, look at the server console (or txAdmin “Live Console”).
- Installation
- The festival is not where it should be
- Music and sound
- Lights, effects and screens
- Keys and controls
- Tickets, stalls and lockers
- Crashes and performance
Installation
“You lack the required entitlement”
The server’s license key belongs to a different Cfx.re account than the one that bought the resource. Use a license key from the buying account, or transfer the asset in the Cfx.re portal. Then restart the server.
The stage is missing pieces, or F8 says a model is missing
You restarted only the resource. The new models need a full server restart:
- Stop the server completely.
- Start it again.
- Every player reconnects.
If it still happens, download the resource again: a file in the stream/ folder may be missing.
Buying tickets or at a stall does nothing / “you are not near”
OneSync is off. The festival needs OneSync to know where players are. Set onesync on (or Infinity) in your server settings and restart the server.
F8 says a model “is taking long to load”
Your game is still downloading, or is short of memory. Wait: it keeps trying on its own.
“You are not allowed” / the console does not open
- You are missing the permission line. Add to
server.cfg:add_ace group.admin vault-festival.admin allowand restart. - Check that you really are in
group.admin(Qbox / ESX). - QBCore: admins are not in
group.admin. Useadd_ace qbcore.god vault-festival.admin allowandadd_ace qbcore.admin vault-festival.admin allow. - If you use a job, check that its name is in
config/permissions.luaand that the job exists in your framework. - An admin may have blocked you for some minutes.
“/festival here” or “mount” says I am not allowed, but the console works
You are an operator, not an admin. By default only admins move or mount the festival. Give yourself vault-festival.admin, or set venueAdminOnly = false in config/permissions.lua.
The interaction options (buy ticket, open locker…) do not appear
vault-festivalstarts before your target script. Putensure vault-festivalafter ox_target or qb-target and restart.- The festival is unmounted.
Purchases say “not available on this server”
vault-festival starts before your framework. Fix the order in server.cfg and restart.
The desk item does nothing
- The item is missing from your inventory. Add it from
install/(see Installation). - With ox_inventory, the item must have
client = { export = 'vault-festival.useDesk' }. - You renamed the resource folder. Put its name back to
vault-festival. - You are not an operator, you are in a vehicle, or you are far from the festival.
The festival is not where it should be
I cannot see the festival
- It is at its default spot: in the sea off Del Perro beach. Fly there, or use
/festival herewhere you want it. - It is unmounted:
/festival mount, or Mount in the admin panel. - You are farther than 800 m (
Config.DrawDistance).
It floats in the air or is sunk
You were not standing on the ground when you used /festival here (you were flying, on a car, or on an object). Stand on the ground and repeat it. Without the island, the stage does not adapt to slopes: choose flat ground.
The island covers a road, a building or the coast
Move it. In the sea, leave about 260 m to each side, 180 m behind and 245 m in front clear. Or turn the island off in the admin panel and put the festival on flat land.
Music and sound
A song worked yesterday and now it is silent
The link has expired. Many links (Discord, temporary file hosts, some cloud drives) stop working after a while. Download the file, put it in the music/ folder, add it to config/audio.lua and restart the server. See Music.
I hear nothing
- You are too far. Music is heard up to 350 m (
Config.Audio.range). - The link is not a direct link to an audio file. YouTube, Spotify and web pages do not work.
- You added a file to
music/but did not restart the server. - The format does not play. Convert it to
.ogg. - Your game’s music/radio volume is very low.
“Could not download the audio” when analysing
The website that hosts the link does not allow it (CORS). The song can play but cannot be analysed. Put the file in music/.
“Could not decode the audio”
The format is not supported. Convert it to .ogg.
“The show could not be saved”
The server cannot write in the shows/ folder of the resource. Check that it exists and that the server has permission to write there. Very long sets can also be too big.
The automatic show looks wrong for my song
The analysis is automatic and approximate. Songs with a clear beat work best. Try Regenerate, change some cues with right-click, or play on top in Hybrid mode.
Lights, effects and screens
Music plays but there are no lights
- The song is not analysed. In Auto mode, a song without analysis has no lights. Press Analyse in the console.
- You are in Live mode with no scene selected. Choose a scene.
- Blackout is on, or Master is at 0.
An effect does not appear
That particle does not exist on your game version. F8 shows a message about it. Choose another one in config/effects.lua (see Configuration).
The pyro buttons do nothing
Pyro is not armed. Switch on Arm in the console, with the mouse.
The pyro fires by itself
The automatic show fires pyro in Auto and Hybrid modes, even when it is not armed. Use Live mode.
The LED screens show a still image
You are farther than 350 m, or Config.LiveScreens = false.
The light beams look invisible from some angles
You set Config.Render.faces to 1 or -1. Try the other one, or go back to 2.
Keys and controls
Alt does not work, or opens the radio
The pma-voice radio also uses Alt. Change one of the two:
- Each player: Settings > Key Bindings > FiveM > “Festival: touch the desk screens”, choose another key.
- For new players: change
touchScreensinconfig/controls.lua(example:'LCONTROL').
ox_target and qb-target also use Alt: the festival pauses them while you touch the screens. That is normal.
I changed the keys in config/controls.lua and nothing changed
The keys in the config are only for players who join for the first time. Players who already joined keep their keys. Change them in Settings > Key Bindings > FiveM.
F7 opens my billing menu
Many ESX servers use F7 for billing. Change the console key in Settings > Key Bindings > FiveM, or console in config/controls.lua before opening your server.
The texts are in the wrong language
Change Config.Locale in config/general.lua and restart. See Languages.
Tickets, stalls and lockers
I keep getting thrown out of the venue
You have no wristband. Buy one at the ticket booth by the entrance. Or make the festival free: required = false in config/economy.lua. Operators are never thrown out.
I changed the wristband item names and now players are thrown out
The old wristbands in their inventories have the old name. Keep the old names in config/economy.lua, or give players the new item.
A stall is empty
The items it sells do not exist in your inventory. With ox_inventory the server console warns about it at start; with the QBCore or ESX inventory the purchase fails with “It does not fit in the inventory”. Create them, or change them in config/economy.lua. The merchandise stall is empty by default.
The lockers do not open
Lockers only work with ox_inventory.
There are no ticket booths or shops
No framework was found (Qbox, QBCore or ESX), or it starts after vault-festival. Fix the order in server.cfg.
Crashes and performance
Players crash or objects disappear when arriving
The island adds about 500 trees and rocks. Turn Vegetation off in the admin panel (or vegetation = false in config/island.lua). If it still happens, lower the quality and turn off the live screens. See Performance.
Low FPS near the festival
Use /festival quality low. More tips: Performance and compatibility.
FAQ
Can I have two festivals at once? No. One festival per server.
Can I move it? Yes, at any time. /festival here moves everything, for everyone.
Can I put my own logo or video on the screens? No. The screens show the festival’s live visuals.
Is there a crowd of NPCs? No.
Does it change the map? No. Everything is placed by the script. Unmount it and the map is as before.
Can I sell drinks from my own items? Yes. Change the stall items in config/economy.lua.
Is the music included? No. You add your own. You are responsible for having the right to use it.