# Introduction

Let every character remember people under names of their own choosing.

## Welcome to Wolfden Remember Me

Wolfden Remember Me gives every character a private book of familiar faces. A player looks at someone, types `/remember` and saves them under a name of their own choosing, with an optional note. From then on, holding a key shows that name over the person's head, but only while their face can be recognized.

Nobody's real character name is ever revealed automatically. Two players can know the same person under two different names, and a stranger stays **Unknown** until someone decides what to call them. The resource folder is named `wd_rememberme`; keep that name when installing it.

## What players see

- **Hold Left Alt** to show the aliases of nearby people. Releasing the key hides every label at once.
- **Unknown** over anyone they have not remembered, or anyone wearing a disguise you have configured.
- **Face covered** over anyone wearing a mask or other face covering.
- **`/memories`** opens their book: search, edit aliases and notes, or forget someone.

Notes stay inside the book and never appear overhead. Memories belong to the current character, survive reconnects, and never say whether someone is online or where they are.

## Masks and disguises

On the standard male and female freemode models, every mask hides a face out of the box. You can add your own helmets, hats, glasses and face-hiding tops as coverings, and fake beards or wigs as disguises. See [Masks & disguises](#/docs/wd_rememberme/clothing).

## Works with your framework

Qbox, QBCore and ESX, with illenium-appearance, fivem-appearance, qb-clothing or esx_skin. The built-in interface needs no UI library; ox_lib dialogs and ox_target or qb-target menus are optional. See [Dependencies](#/docs/wd_rememberme/requirements).

## Get started

1. Check [Dependencies](#/docs/wd_rememberme/requirements).
2. Follow [Installation](#/docs/wd_rememberme/installation) to add the resource and database table.
3. Share the [Player guide](#/docs/wd_rememberme/player-guide) with your community.

## Make it yours

Change the key, commands, distances and label style in [Configuration](#/docs/wd_rememberme/configuration), translate everything players see into your community's language with [Translations](#/docs/wd_rememberme/configuration?section=translations), and teach the resource about your own clothing in [Masks & disguises](#/docs/wd_rememberme/clothing).

## Need help?

Use [Troubleshooting](#/docs/wd_rememberme/troubleshooting) for common issues, or ask in the [Discord](https://discord.gg/SHCSCp3B5k). Developers can connect ID cards and custom multicharacter scripts under [Exports & integrations](#/docs/wd_rememberme/exports).