Troubleshooting

Console messages and their causes.

Not released yet. These pages are written from the code of manniche_crosshair and can change before the release.

Console messages

Message	Cause and fix
`Config.Storage.driver is 'mysql' but oxmysql is not started`	`oxmysql` is not running. The resource falls back to JSON. Start `oxmysql` before `manniche_crosshair`.
table `manniche_crosshair_data` is missing	The SQL file was not imported.
`data/players.json is corrupt`	The JSON file could not be parsed. The old content is saved as `players.json.bak`.
`Config.Framework '...' is not a valid adapter`	Use `'auto'`, `'esx'`, `'qbcore'`, `'qbox'` or `'standalone'`.
`adapter '...' failed to initialise`	The chosen framework failed to initialise, so the resource uses standalone. Start the framework first.
`Config.WeaponOverrides['...'] uses unknown category`	Use one of the ten categories listed in Configuration.
`interface is still loading`	The editor was opened before the NUI reported ready. Wait and retry.
`could not load your crosshair data (...)`	The load request failed and defaults are used. Check the error value, for example `no_identifier`.
`duplicate preset id '...'`	Two presets use the same id. The later one wins.

The command does nothing. The command name is Config.Command. There is no default key unless Config.OpenKey is set.
Settings are not saved. The player has no usable identifier (no_identifier), or the profile limit was reached (Config.Limits.maxProfiles).
Imports are refused. Config.EnableSharing is false, or the code is longer than Config.Limits.maxImportLength.
The crosshair is hidden. Check Config.Visibility. Unarmed, melee and scoped are hidden by default.
Debug info. Set Config.Debug = true, then run the client command manniche_crosshair_debug to print framework, weapon and crosshair state.