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.com or https://discordapp.com, or their ptb. and canary. 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_audit first. Delivery is tried up to 8 times. A 4xx answer other than 429 marks the row failed at once.
  • pocketbook_retry_log <id> puts a failed row back in the queue.

See config_server.lua.