Troubleshooting

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, 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.

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.
• Unknown Config.Locale: add locales/<code>.lua: Config.Locale names a language file that does not exist. Add that file or set Config.Locale = 'en'. See Translations.
• Invalid clothing classification, Invalid clothing kind or Clothing rule requires drawable and slot: a rule in Config.ClothingRules is incomplete. See Masks & 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.
• 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.

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.