Troubleshooting

The upload is refused

Each refusal says why. The most common ones:

• No fxmanifest.lua found. Zip the resource FOLDER itself, not the folder that contains it. The zip holds something else, or the manifest is missing. See Zipping the resource.
• Upload a .zip of the resource folder. Only .zip works. Repack a .rar or .7z as zip.
• This resource is escrow-protected. It contains encrypted .fxap files and cannot be read by anyone but the game.
• Could not read author/repo. It must be a public repository. The repository is private, or the link has a typo. Download it as a zip and upload that.
• The archive is 31.2 MB. The limit is 25 MB. Remove large media such as videos or stream files from the zip; they are not converted anyway.
• Confirm you are allowed to convert this resource first. Tick the checkbox under the drop zone.

The framework is wrong or unknown

When the setup shows We could not tell which framework this is written for., pick it under Written for. This happens for resources that barely call a framework, or that use their own wrapper around it.

When it guesses the wrong one, click the right one under Written for before you start. The preview updates at once. Never convert with the wrong source: calls already written for the target would be converted a second time.

The result has checks to review

A result that says Delivered, but 1 check did not pass has at least one blocker. It is delivered so you can inspect it, but do not run it on a live server as it is. Open What We Found and work through the blockers:

• client/client.lua lost part of its content: the file came back shorter. Compare it in the diff and copy the missing part from the original, converting its calls by hand.
• The event "…" disappeared: a name other resources use is gone. Add the event back under its old name.
• client/main.lua still contains QBCore code: a call of the source framework survived. The finding names the line.
• vehicles.lua is not valid Lua: the file does not parse. The detail names the line.

Large resources with hundreds of files end with findings more often than small ones. When a resource has many blockers, it can be faster to convert its parts separately.

A file is not loaded by the manifest

The warning client/cl_main.lua is not loaded by the manifest means no line in fxmanifest.lua loads that file. Check the original manifest: if it did not load the file either, the file was unused before and nothing changed. If it did, add the file to the matching script list.

Errors on the server

When a converted resource throws an error, check in this order:

• Dependencies. No such export or attempt to call a nil value on an export usually means a resource the converted code calls is not started, or starts later.
• Items. A purchase or reward that silently fails often means the item is missing from the target's item list.
• Locale text. A message that shows %{amount} or a key name instead of text points at a placeholder that does not match. Compare the locale file with the call.
• The findings for that file. A warning or note in the result often points at the same spot.

To fix code in chat, import the converted resource into the AI Script Generator and paste the exact error.

The download seems to do nothing

After a click on Download, the browser first receives the whole zip and only then opens the save dialog. The button shows no progress meanwhile. For a resource with hundreds of files this can take a while. Wait before clicking again, and check that your browser does not block downloads from the site.

Credits and failed runs

• This conversion needs 210 credits and you have 80. To start, your balance must cover the upper end of the price range, even though the run often costs less. Top up, or wait for the daily 25 free credits.
• A failed or stopped run is not charged the 100 credit minimum. You pay only for the steps it finished, and the rest of the hold goes back.
• A conversion of this resource is already running. One run per resource at a time. Wait for it, or press Stop.

See the pricing page for top-ups and plans.

Still stuck

Use Report a problem at the bottom right of the resource page, so we see the conversion you mean, or ask in the SwisserAI Discord with the link to the resource.