Track 2 · Pro Path

Promises & async: turning callbacks into linear code

FiveM is full of callback APIs: PerformHttpRequest, the older async MySQL libraries, NUI callbacks. Stack three of them and your code turns into a pyramid, each result trapped one level deeper than the last. Promises flatten the pyramid. Combined with Citizen.Await, you get top-to-bottom code that feels synchronous while the server stays free to do other work. This lesson builds the real thing: you wrap PerformHttpRequest in a promise, await it, handle failure with :reject(), and chain three calls in a straight line.

You'll learn: promise.new(), :resolve(), :reject(), Citizen.Await, and the callback-to-promise wrapping pattern
Time: ~22 minutes
Prereqs: P1 (oxmysql), P2 (HTTP)
Outcome: You can wrap any callback API as a promise and read three async calls top to bottom instead of nesting them

BEFORE YOU START

Build it

Make the resource folder

The server has one folder for this lesson.

Inside your server's resources folder, create this folder:

code

resources/qu_promises

Promises & async: turning callbacks into linear code

Build it

Make the resource folder

Create the files

Write fxmanifest.lua

Write the lesson code

Start and test it

Keep reading the full lesson