Start

Your first conversion

From a zipped ESX resource to a QBCore resource on your server in six steps. The conversion itself takes about a minute.

Before you start

The resource folder as a .zip, with fxmanifest.lua inside.
The right to change it: you wrote it, bought it with a licence that allows changes, or it is open source.
A SwisserAI account. The preview is free; converting a small resource like the one below costs 100 credits.

The six steps

We convert esx_shops, the open-source shop resource of ESX Legacy, to QBCore. It sells items from a menu, takes the money and gives the item.

1
Upload the zipped resource
In the sidebar open Coding, then Framework converter. Tick the checkbox that you are allowed to convert the resource, then press Choose a file and pick the zip. You can also drop the zip on the box.
1. 1. Choose a file: or drop the zip on the box
2. 2. Fetch: paste a public GitHub repository instead
3. 3. I am allowed to convert this resource: tick it first, the buttons stay grey until you do
2
Check the source, pick the target
The resource opens with the framework it was read as under Written for, here ESX Legacy. Under Convert to pick the framework your server runs, here QBCore.
1. 1. Written for: the framework read from the code; click another to correct it
1. 1. QBCore: pick the framework your server runs
2. 2. MOST COMMON: the most travelled route for ESX resources
3
Read the free preview
The preview appears at once and costs nothing. It counts every framework construct in the resource and sorts them by how much changes. Below it: what has no equivalent, what changes on your server, and every call by area.
1. 1. Direct, Reshaped, Rebuilt, Needs a decision: how much is a rename and how much needs judgement
2. 2. 100-210 credits: the least and the most this run can cost
4
Start the conversion
Press Convert for 100-210 credits. The range is the least and the most this run can cost. The credits are held until the run ends, and the rest goes back.
1. 1. Convert for 100-210 credits: starts the paid conversion
2. 2. Just write the plan for free: the decisions only, no files
5
Watch it convert
The stages light up one after another while the board lists each ESX call and the QBCore call it becomes. This run took 60 seconds. You can close the tab; the conversion keeps going.
1. 1. Stages: from Reading the resource to Packaging
2. 2. Files, constructs, credits, time: the counters update live
3. 3. Stop: cancels the run
1. 1. Area · count · kind: hardest kinds come first
2. 2. no equivalent: decided in the plan, not a rename
6
Check the result and download
The result says Every check passed or how many checks need a look. Press Download to get esx_shops-qbcore.zip, then install it like any resource:
1. 1. Every check passed: or how many checks did not pass
2. 2. Files, Syntax, Leftovers, Calls exist, Contract, Wiring: click one to filter the findings
1. 1. Download: the converted resource as one zip
```
ensure qb-inventory
ensure qb-menu
ensure esx_shops
```
Take the old ESX version out first, since both have the same folder name. The full guide is in Installing on your server.

Good to know

This run cost 100 credits: the resource is small, so the minimum applied. The checks passed after 1 repair round, which the converter runs on its own when a first pass fails a check.

Where to go from here

Install it

Replace the old resource, add dependencies, keep the start order.

Read the findings

What each of the six checks means and what to do about a blocker.

Understand the preview

Direct, Reshaped, Rebuilt and Needs a decision.

Other directions

QBCore to Qbox, anything to ox_core, and what is not supported.