Start here

Before you install

What every SmokeScripts script needs on your server before its own install steps.

Do these checks once per server. Each script's install page then covers only that script.

Get the files#

Sign in with Cfx.re at checkout. A paid script lands in your Cfx.re Portal right away, and you can download it again there at any time. Free scripts not on GitHub are claimed on Tebex and land in the Portal the same way.

Use the right server key#

Escrowed scripts start only on a server whose license key belongs to the Cfx.re account that bought them. If the server prints You lack the required entitlement, see Escrow errors. Servers covered: see Licence.

Copy every file#

Upload the whole resource folder, hidden files included. Escrowed scripts ship a .fxap file, and some FTP programs skip hidden or protected files. A missing file shows up as Failed to verify protected resource.

Install the shared dependencies#

Every SmokeScripts script needs ox_lib. Some also need oxmysql or OneSync. Each script's install page lists the rest.

Know what you can edit#

Paid scripts are encrypted with Cfx.re Asset Escrow, but the Lua files in their config/ and bridge/ folders stay open: the config and the framework, inventory, notify and other bridges. smoke_target and smoke_mobility ship unencrypted, with every Lua file under escrow_ignore. Open-source scripts on GitHub come with full source.