Start
Troubleshooting
Console messages FX Pocketbook prints, what they mean, and how to close an operation the book held for an admin.
Run pocketbook_health in the server console first. It names what is missing. See Installation.
#Console messages
| Message | Cause | Fix |
|---|---|---|
sql/install.sql not found; database setup skipped. |
The folder was copied incompletely | Copy the whole fx-pocketbook folder again |
N table(s) missing; creating them. |
A notebook table is missing, for example it was deleted | Nothing. The setup creates it from sql/install.sql on the same start |
Database setup error: ... and Database setup finished with N error(s). Run pocketbook_health. |
A statement of sql/install.sql failed. The database's error follows each line |
Fix the cause. The file runs again on the next start, because the hash is saved only after a clean run |
VORP items could not be added automatically; add them from sql/install.sql. |
The insert into VORP's items table failed |
Run the INSERT IGNORE INTO items block of sql/install.sql by hand |
N item(s) added to VORP. Restart the server once so vorp_inventory loads them. |
New items were added | Restart the server once |
Import sql/install.sql before using relays. |
The relay table could not be read | Check the database setup lines above it |
Audit storage unavailable; import sql/install.sql. |
The log table could not be written | Check the database setup |
Staff queue needs database check (sql/install.sql). |
The offline staff change queue of Business could not run | Check the database setup |
Billing sweep needs database check (sql/install.sql). |
The Ledger's scheduled check could not run | Check the database setup |
Config.Atlas.Blips: skipped an entry (id ...) |
An Atlas map sign has a bad id, no name, or coordinates outside Config.Atlas.Bounds |
Fix that entry |
holding: writing animation ... could not be loaded (is fx-pocketbook-anims started?) |
The animation resource is not started | Start fx-pocketbook-anims |
fx-toolbag is not started: ensure fx-toolbag after /pocketbook_hold |
/pocketbook_hold needs fx-toolbag |
Start fx-toolbag, or leave the grip as it is |
holding: <player> tried to save the notebook place without permission |
A player without command.pocketbook_hold pressed save |
Give the ACE permission to the people who tune the grip |
#What pocketbook_health reports
| Line | Meaning |
|---|---|
framework: Only one VORP/RSG framework selected with Config.Framework should run. |
Both VORP and RSG are started with 'auto', or the framework you named is not started |
inventory: vorp_inventory is not started. (or rsg-inventory) |
Start the inventory before the notebook |
money: This VORP adapter supports cash; another account needs a verified bank adapter. |
Config.MoneyAccount is not 'cash' on VORP |
money: Set the RSG money account to cash or bank. |
Config.MoneyAccount has another value on RSG |
music: Phonograph data is not loaded; check the startup logs. |
The phonograph table could not be read on start |
relays: Signal relay data is not loaded; check the startup logs. |
The relay table could not be read on start |
action: <name> is not loaded; update the manifest and app files together. |
An app's server file is missing. The manifest and the app folders come from different versions |
database: oxmysql is not started. |
Start oxmysql first |
database: Database schema could not be read; check the connection and information schema permissions. |
The database user cannot read information_schema |
table: <name> ... |
A table is missing |
column: <name> ... |
Columns are missing from a table. The line lists them |
engine: <name> must be InnoDB for transaction safety; current engine: ... |
Convert that table to InnoDB |
Every line of pocketbook_health follows Config.Locale, the server language. The English text is shown here.
#The book does not open
| Symptom | Cause |
|---|---|
| "You need a Pocketbook in your inventory to use it." | Config.Access.RequireItem = true and the player has no notebook item. The plain pocketbook or any colour item counts |
| "Inventory unavailable. Try again shortly." | The inventory could not be read |
| F1 does nothing | Config.MenuOpenMode = 'command', or Config.OpenMenuKey.useKey = false. With 'keybind' there is no command |
| The book closes by itself | Mounting a horse, entering a vehicle or water, ragdoll or death close it while Config.Holding.CloseOnMount = true. It also closes when the server check every Config.Access.CheckInterval ms finds no notebook item |
| The book does not open while charging | The player is charging a back radio battery (fx-radio). It opens again when the charging ends |
#Store
| Symptom | Cause | Fix |
|---|---|---|
| "The preview model could not be loaded." (Turkish: "Onizleme modeli yuklenemedi.") | The player's game does not know the notebook model. After an update of fx-pocketbook-assets that adds models (for example new colours), a game that joined before the update still holds the old model list (.ytyp) |
Restart fx-pocketbook-assets and have the players reconnect |
| The preview takes a few seconds | A notebook model streamed for the first time can take a moment. The store waits up to about 5 seconds | Nothing |
| The radio, battery and charger are missing from the store | Those rows have requires = "fx-radio" and show only while fx-radio is started |
Start fx-radio, or leave them hidden |
#Game texts without Turkish letters
VORP notices, hold prompts and map blip names write s, g, i and I where the text has ş, ğ, ı and İ. This is on purpose: the game's own font has no such letters and would show boxes. The notebook changes only these texts (PocketText.Native); the pages of the book keep every letter.
#Held operations
When the book moves money or items through the framework, the inventory or a bank script, the answer can be unclear: the call may or may not have happened. The book does not retry such an operation. It holds it for an administrator. The player sees that the operation is waiting; the shipped FAQ tells players to give the operation number to an admin and not to repeat it.
Check the player's money or inventory yourself, then close the operation with the matching command. The note is required and is saved with the decision. None of these commands moves money or items by itself; they record what you verified.
| Command | Table | Decisions |
|---|---|---|
pocketbook_resolve_money <id> <decision> <note> |
fx_pocketbook_money_ops |
settled (the move happened) or aborted (it did not) |
pocketbook_bank_resolve <id> <decision> <note> |
fx_pocketbook_bank_ledger |
settled or aborted. Closes the Bank ledger row only |
pocketbook_resolve_relay <id> <decision> <note> |
fx_pocketbook_relay_operations |
moved (the relay item was taken; the pole is installed) or unchanged. Note at least 8 characters |
pocketbook_resolve_music <id> <decision> <note> |
fx_pocketbook_music_inventory_ops |
moved, unchanged, returned, notreturned or legacy. Note at least 8 characters |
pocketbook_resolve_staff <id> <decision> <note> |
fx_pocketbook_staff_changes |
applied or cancelled, for a Business hire, fire or grade change |
pocketbook_resolve_birdcare <id> <decision> <note> |
fx_pocketbook_bird_care |
consumed or unchanged, for bird seed, medicine or a training kit |
pocketbook_resolve_paper <id> <decision> <note> |
fx_pocketbook_papers |
moved or unchanged, for blank paper and letter items. Note at least 8 characters |
pocketbook_resolve_parcel <parcel> <line> <decision> <note> |
fx_pocketbook_parcel_lines |
moved or unchanged, for one line of a parcel |
pocketbook_resolve_stamp <id> <decision> <note> |
fx_pocketbook_postage |
moved, unchanged or returned. Note at least 8 characters |
pocketbook_resolve_stationery <id> <decision> <note> |
fx_pocketbook_postal_goods |
moved or unchanged, for post office workshop goods. Note at least 8 characters |
The commands are restricted: the console can run them, a player needs command.<name>.
#Discord logs are not sent
- The webhook must be on
https://discord.comorhttps://discordapp.com, or theirptb.andcanary.subdomains, with the path/api/webhooks/<id>/<token>. A versioned path such as/api/v10/webhooks/...works too. Any other address is never contacted and the rows stay local. - Rows are always written to
fx_pocketbook_auditfirst. Delivery is tried up to 8 times. A4xxanswer other than429marks the rowfailedat once. pocketbook_retry_log <id>puts a failed row back in the queue.
See config_server.lua.