Start

Updating

Move to a newer FX Pocketbook version without losing your settings, the notebook grip or your data.

#Steps

  1. Back up the database.
  2. Keep a copy of the files you edited: config.lua, config_shops.lua, config_server.lua, framework/frameworks.lua, the apps/<id>/config.lua, apps/<id>/config_server.lua and apps/telegram/*_config.lua files, and any locale you changed.
  3. Keep holding.json if you placed the notebook in the hand with /pocketbook_hold. The package does not ship this file: the first save creates it in the resource folder, and it replaces the Config.Holding.Offset values for everybody.
  4. Replace the fx-pocketbook folder.
  5. Copy your values back into the new config files. New keys come with their defaults in the new files.
  6. Replace fx-pocketbook-assets only when the update includes it. The large images, sounds and models are kept in that resource so that a code update does not make players download them again. When it brings new models, restart it and have players reconnect: a game that still holds the old model list cannot load the new ones (see Troubleshooting).
  7. Start the server and run pocketbook_health.

#Coming from a version with the back radio

The back radio set has moved out of fx-pocketbook into its own resource, fx-radio. Config.Radio, the /telsiz and /telsiz_test commands and the radio models are no longer in the notebook. If your server uses the radio, install fx-radio and copy your old Config.Radio values into its config.lua. The item names stayed the same (pocketbook_radio, pocketbook_radio_battery, pocketbook_radio_charger), so players keep their radios and the charge of their batteries. Without fx-radio the notebook simply gets its signal from towns and relay poles.

#Database changes

You do not import anything. On every start the notebook checks that all its tables exist and compares sql/install.sql with the hash saved in fx_pocketbook_meta. When a table is missing or the file changed, every statement runs again: new tables are created, missing columns are added, and existing rows are not touched. When nothing changed, the step is skipped with two queries.

If an update adds new items, VORP gets them in the same step and the console asks you to restart once:

cfg[fx-pocketbook] 1 item(s) added to VORP. Restart the server once so vorp_inventory loads them.

On RSG, add new items to rsg-core/shared/items.lua yourself. See Items.

#Locales

Texts are in locales/<language>.json and apps/<id>/locales/<language>.json. If you edited one, add the new keys from the shipped file to yours. A missing text falls back to the Config.LocaleFallback language ('tr'). Language changes take effect on resource restart.