Common Issues and FAQ

Common Issues

Performing a Fresh Install

When troubleshooting errors, the initial step is to perform a fresh installation, as it resolves approximately 95% of the issues reported in support tickets. Carefully follow the guide below to ensure a successful fresh install.

Refer to the fresh install guide to access the detailed steps for performing the process.

The UI is not opening

• If the UI fails to open, do a fresh script installation as detailed above.
• If you identify any errors in your F8 or the server console, review the list of common issues below on this page to see if any of them match your situation.
• If the issue persists, it's possible that you may have skipped a step during installation or made a mistake, please double check the install steps.

No such export GetUtils in resource lc_utils

• This error may occur when lc_utils has not been initialized. Please check in your server console for errors in the lc_utils file.
• If lc_utils has been properly loaded without errors, this issue might be due to incorrect resource loading order in your server.cfg. Ensure that lc_utils is loaded before any of its dependencies.

I need to manually restart the fuel script to it work

• This issue might be due to incorrect resource loading order in your server.cfg. Ensure that lc_utils is loaded before the fuel script.
• Move the fuel script out of the automatically starting folders, as it may start before lc_utils, causing the issue.

I'm having issues with jerry can

• By default, the jerry can is added to your inventory as an item with no metadata.
• If the jerry can is not refuelling the vehicle, this probably means that your inventory is detecting the jerry can as empty.
• If you cannot buy the jerry can, probably you the inventory gives the item in a different way than planned by the script.
• In both situations you have to:

1. For LegacyFuel: navigate to lc_utils/custom_scripts/server/inventory.lua, locate the givePlayerWeapon and givePlayerItem function and update it according to your inventory documentation.
2. For the other fuel scripts: you can edit the script code to match what your inventory requires. Their code are fully open source.

• Each inventory has a different way to handle weapons/itens so it's hard to give a precise answer to this issue. Please refer to your inventory documentation to learn the specific methods for accomplishing this.
• Finally, you can try different fuel scripts such as ox_fuel, ps-fuel, cdn-fuel, (and others) as they may be compatible with your inventory by default without extra changes.

The fuel pumps are not linking to a gas station

• If no pumps are linked: This issue happens when the incorrect fuel script is being used. Ensure that you are using the fuel scripts that came with Gas Station script.
• If some pumps are linked but others are not: To link fuel pumps with gas stations, follow these steps:

1. Open the config of the selected fuel script.
2. Find the GasStationOwner config and insert the coordinates there.
3. For each new gas station, provide a single set of coordinates. These should be in the form of a vector3, with an additional fourth value indicating the detection radius for gas pumps. Pumps outside this radius will not be linked with the gas station.

• For cdn-fuel you just have to match the gas station ID (found in the lc_gas_stations config) with the lc_gasStation_id config for each respective gas station.

I cannot start any job or my truck is not spawning

• Check if you have any anticheat or blacklist blocking the vehicles to spawn.
• Check if you correctly configured your keys and fuel script in the lc_utils script config.

The players are loosing their gas stations

• It happens when the owner doesn't have enough stock in his gas stations.
• You can precisely configure it or even disable it in the config. Search for Config.clear_gas_stations in your config.

I have to hotwire/lockpick the vehicles

• Your keys script has not been configured correctly. You can do that in the lc_utils script config.
• If you dont have your key script pre-built there, it's necessary to set the config to "other" and configure the export in the lc_utils/custom_scripts/client/keys.lua file.

Error parsing script / Failed to load script

• Your server artifacts are likely outdated. Update your server to version 5181 or above.
• This error occurs when uploading the script with Filezilla. You must use something like WinSCP.

You lack the required entitlement to use <resource>

• Try restarting your server and make sure your server key is correct. If you bought the resource on the wrong account, you can transfer it to another account on keymaster.

Failed to verify protected resource

• Files were possibly corrupted during transfer. Ensure hidden files are copied; the .fxap file in a protected resource must be included. Some FTP programs skip these files.
• This error occurs when uploading the script with Filezilla. You must use something like WinSCP.

FAQ

How to change the default gas price?

• To modify the default gas price, access the config file of the selected fuel script. Search for defaultGasPrice and defaultGasStock. Adjust their values accordingly.

Do the gas stations work if they are not owned?

• Yes, you can configure whether an unowned gas station has stock. This setting can be easily adjusted in the fuel script configuration.

Is it possible to add more gas stations?

• Absolutely! You possess the creative freedom to add any gas station.
• Simply replicate the existing gas stations configured as an example to create more.

How to change the logo in the LegacyFuel menu?

• Just go on LegacyFuel/html/ui.html and change the image URL on line 12.

How to change the LegacyFuel refuelling speed?

• Go on LegacyFuel/html/ui.js line 63 and change the number 1000 to the time you want. Lower is faster.

I must use the fuel scripts provided with the gas station?

• Yes! You must use one of the fuel scripts provided in the script file, or the things will not work properly.
• The fuel scripts code are open source, so you can edit anything you want there.

How to change the notification?

• In lc_utils/custom_scripts/client/notification.lua file you can find the default script notification, replace the existing notification with yours.

How to customize the UI?

• The UI's source code is unencrypted, allowing easy access to HTML, JS, and CSS files for customization. Proficiency in programming is necessary to make changes effectively.