Version and updating

Goal: install a new archive without losing your settings.

Documented version

This site documents the archive whose fxmanifest.lua declares version '1.17.2'. No version history is published here: what an update brings is announced by MrPoulpi Labs on Discord. To know the version installed on your server, open fxmanifest.lua or type resmon and find ox_target.

What belongs to you

Your settings live in four plain-text files: config.lua, config_interactions.lua, config_client.lua and config_server.lua. If you edited bridge/client.lua or bridge/server.lua to add a preset, write those changes down separately: prefer hooks, which an update does not overwrite.

Procedure

1. Back up the whole ox_target folder (timestamped copy outside resources/).

2. Export your configuration: in the configurator, import your current Lua files or your JSON project, then export the JSON project. It will be your reference.

3. Replace the resource with the new archive, without overwriting your four configuration files yet.

4. Compare the newly shipped config*.lua files with yours (your editor’s diff tool). Look for new keys in the shipped files: they must be added to your files, otherwise the script will use its default behaviour or a nil value.

5. Carry your settings over into the new files, key by key, rather than copying your old files on top.

6. Restart (restart ox_target or the server) and repeat the first test: F8, server console, player target, self, vehicle, ped, object.

Common mistakes

• Copying the old config.lua onto a new version: new keys are missing.
• Forgetting config_server.lua: your server actions disappear and options calling them are refused as an unknown action.
• Updating without restarting dependent resources: their options added through exports do not come back.