# Troubleshooting Practical fixes for common setup and runtime issues. ## Read the server console first Restart `wd_rememberme` and read the server console. A working start shows `Framework bridge: qbox` (or `qb`, `esx`). The messages below tell you what is wrong. Console messages are always in English. Messages players see are quoted here in English, the default; if you have set up a [translation](#/docs/wd_rememberme/configuration?section=translations), they see your wording instead. ## Startup waiting `Startup waiting: … (retrying every 5 s)` means the resource is waiting for something and has not started working yet. The text after it says what: - `Select Config.Framework explicitly: expected exactly one framework`: more than one framework, or none, is running. Set `Config.Framework` to `'qbox'`, `'qb'` or `'esx'`. - `Configured framework is not started`: the framework in `Config.Framework` is not running. Check its name and start it before `wd_rememberme`. - A database error mentioning `wolfden_rememberme`: the table is missing. Import `sql/install.sql` as described in [Installation](#/docs/wd_rememberme/installation?section=2-create-the-database-table). Players see *Remember Me is still starting. Try again shortly.* until this is fixed. ## Errors on start - `Input limits exceed the supplied SQL schema`, `Invalid recognition limits`, `Invalid distance/TTL configuration` or `Invalid ID card distance`: a setting is outside its allowed range. Check the rules in [Configuration](#/docs/wd_rememberme/configuration). - `Unknown Config.Locale: add locales/.lua`: `Config.Locale` names a language file that does not exist. Add that file or set `Config.Locale = 'en'`. See [Translations](#/docs/wd_rememberme/configuration?section=translations). - `Invalid clothing classification`, `Invalid clothing kind` or `Clothing rule requires drawable and slot`: a rule in `Config.ClothingRules` is incomplete. See [Masks & disguises](#/docs/wd_rememberme/clothing?section=add-coverings-and-disguises). - `Config.UI = ox_lib requires ox_lib started first`, in the client F8 console: start ox_lib before `wd_rememberme`, or set `Config.UI = 'builtin'`. ## No active character Players see *No active character.* when the server cannot find their character, for example in character selection. If it happens with a loaded character, the framework is not the one the resource is using; set `Config.Framework` explicitly. ## Labels never appear - Hold the key; labels disappear as soon as it is released. If the player rebound it, the default no longer applies. - The other person must be within `Config.RevealDistance` (8 m), on screen and not behind a wall. - If everyone shows **Face covered**, see below. ## Everyone shows Face covered - **Custom ped model.** Models not in `Config.Masks` always count as covered. [Add the model](#/docs/wd_rememberme/clothing?section=custom-ped-models). - **A clothing rule with `collection`.** If the game cannot read the item's collection, the rule counts as covered. Use a recent FiveM client and server artifact, and check the collection name. - **Slow replies.** If the other player's game does not answer in time (`Config.ProbeTimeoutMs`), they count as covered. On a slow server, raise it slightly. ## Someone shows Unknown when I remember them They are wearing an item configured as a disguise, or your memory is of a different character on their account. Holding the key shows **Unknown** for both. ## Alias takes a moment to come back After a mask comes off, the alias returns at the next label update while the key is held, about a second by default (`Config.RefreshMs`). ## /remember says "Look at a nearby visible person" Stand within `Config.InteractionDistance` (2.5 m) of the person, with them on screen and nothing in between. Masked or disguised people cannot be remembered. ## Target option is missing Set `Config.Target` to `'ox_target'` or `'qb-target'`, and start that resource before `wd_rememberme`. The option is only shown for people who can be remembered: close by and with a visible face. ## Invalid alias or note Players see *Invalid alias or note. Check the length and remove control characters or ~.* Aliases are up to 64 characters and notes up to 500 by default. Aliases cannot contain line breaks, control characters or `~`. ## Different characters share memories On ESX, your multicharacter is giving every character on an account the same identifier. See [How characters are identified](#/docs/wd_rememberme/exports?section=how-characters-are-identified). ## Your memory list is full The character has reached `Config.MaxRecords` (500). Forget someone, or raise the limit. ## Unable to complete this request The server console shows `Request failed; check database migration and integration setup.` Usually the table is missing or was created differently. Import `sql/install.sql` again into the database oxmysql uses. ## Some text is still in English - **Missing phrases.** Anything your locale file leaves out falls back to English. Copy the missing lines from `locales/en.lua` and translate them. - **Not restarted.** Locale files load when the resource starts. Restart `wd_rememberme` after editing one. - **Key binding name.** FiveM stores it when a player first joins, so players who already have the binding may keep the old name. - **ID details in notes.** Notes saved by the ID card export keep the wording they were saved with. ## Restarting the resource Restarting `wd_rememberme` while players are online is safe. Open books close, labels clear, and every memory is still in the database.