Module B5 · Data that survives a restart

Persistence without a database: the KVS

Most beginners think the only way to make data survive a restart is a database. It is not. FiveM ships a per-resource key-value store, the KVS, that writes small values straight to disk for you. No schema, no connection string, no SQL. In this lesson you build a counter that climbs every time you run a command, then survives a full server restart untouched. Once it works, you will know exactly when the KVS is the right tool and when it is the wrong one.

You'll build: A server resource that increments a counter on command and reloads the same number after a full server restart, proving the value lives on disk and not just in memory.
Time: ~18 minutes
You need: A local FiveM practice setup you can restart, a text editor, and the heal-command or natives-toolbox resource already working so you are comfortable with RegisterCommand on the server.
You'll learn: The built-in key-value store, the typed get and set natives, deleting and listing keys, and the exact line where KVS stops being enough and you reach for MariaDB plus oxmysql instead.

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_kvs_counter

Persistence without a database: the KVS

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