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.

"You dont have the required job to open this menu" error

• Well, its a bit intuitive, you dont have the job. You can disable the job requirement on config if you want.
• You can change the job there too, pay attention, the job there is the job NAME, not job LABEL.
• If you have configured the job and it still not works, you probably put the job label or the wrong name or you're not on duty.

I cannot start any job or my truck is not spawning

• This issue typically occurs when you haven't installed the truck mods correctly, preventing the script from spawning them. Attempt to spawn the vehicles using the admin menu to verify if the mods are installed properly.
• Verify if you have any anticheat or blacklist that might be preventing the vehicles from spawning.
• Search in your F8 for errors and make sure you have correctly configured your keys and fuel script in the lc_utils script config if you are not using the default scripts.
• Confirm if you have enough skill points to start a particular job. Initially, you can only begin jobs that don't require any experience and are within a maximum range of 6km.
• Try execute a fresh install as you may have some issue in your config or database.

SQL error: Unknown column 'progress' in 'field list'. How to fix?

• Drop your trucker_available_contracts and restart the script.
• Refer to the fresh install guide to access the detailed steps for performing the process.

SQL error: Column 'contract_name' cannot be null. How to fix?

• This error occurs when a contract in your config is incorrectly configured, possibly its missing the name. To resolve this issue, carefully review and update your configuration to ensure that each contract entry has a valid name specified.

SQL error: Illegal mix of collations. How to fix?

Run this sql in your database:

ALTER TABLE `trucker_users` CHANGE `user_id` `user_id` VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL;
ALTER TABLE `trucker_party_members` CHANGE `user_id` `user_id` VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL;
ALTER TABLE `trucker_trucks` CHANGE `user_id` `user_id` VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL;
ALTER TABLE `trucker_loans` CHANGE `user_id` `user_id` VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NOT NULL;
ALTER TABLE `trucker_drivers` CHANGE `user_id` `user_id` VARCHAR(50) CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci NULL DEFAULT NULL;

Some trailers are 'bouncing'

• For an unknown reason, certain trailers can bounce randomly. You can locate those trailers in the config and remove them from there.

Trucks are being destroyed or damaged without reason

• This issue may be caused by some vehicle-related script managing vehicle damage, such as a realistic vehicle damage system or something similar.
• The trucker script does not modify the health of trucks or trailers while they are spawned, so the damage is likely caused by an external resource.

I changed a job or a driver in the config, but it did not change on the interface

• Each job's data is saved in the database, so every change you make will only take effect for the next generated contracts, not the current ones. You can clear the "trucker_available_contracts" table in your database to remove the contracts using the old config.
• The same applies to drivers.

My drivers disappeared

• The drivers will only disappear when you don't have enough money in the trucker bank to pay them, so keep some money there otherwise, they will be fired.

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

Where to download the modded trucks?

• You can find the download link for the truck models in the script folder, in a file named truck_models_download.txt.

How to remove the modded trucks?

• Locate and delete the folder containing the modded trucks on your server.
• Open your script's configuration file and remove all references to the modded trucks (Config.jobs, Config.dealership).
• Changes to the configuration will only affect newly generated contracts. To remove existing contracts that reference the modded trucks, clear the trucker_available_contracts table in your database. This will delete current contracts, allowing new ones to generate with the updated configuration.
• The same process applies to drivers assigned to modded trucks. Review and update driver data in your database to ensure they are not linked to any removed trucks.

How to earn skill points?

• Experience points are earned by completing jobs. By default, you need 1000 EXP to level up. With each level up, you'll earn 1 skill point that can be spent on the skills page.

How do drivers work?

• Drivers work passively. You just have to assign a truck to them, and the driver will generate money for you over time. In the configuration, you can adjust all the time intervals and the amount of money earned.
• The drivers also require a fueled truck to work.

Is it possible to use trucks which are not bought through the script?

• Yes, you can use your personal truck for freight jobs.
• However, this applies exclusively to freight jobs. Quick jobs requires the use of rented trucks.
• The hired drivers also need to use a truck purchased in the Trucker script.

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.