# D.H. / 666f78: Quick Names

Random name generator (preset-based)

![Quick Names window](docs/window.png)
![Preset list](docs/presets.png)

## Features

- One-click name generation with gender filters.
- Preset dropdown with labels from preset metadata.
- Optional custom preset folder via FilePicker.
- Remembers the last selected preset per user.

## Installation

1. Open _Add-on Modules_ in Foundry VTT.
2. Choose _Install Module_ and paste the manifest URL:
   ```sh
   https://github.com/666f78/dh-quicknames/releases/latest/download/module.json
   ```
3. Install, enable the module in your world, and reload the client.

Alternatively, download the latest release archive from the [GitHub releases](https://github.com/666f78/dh-quicknames/releases) page and drop contents into your Foundry Data/modules directory.

## Usage

- GM opens the module from the scene controls toolbar.
- Pick a preset, choose filters, then Generate.
- Use the folder icon next to the preset label to select a custom folder.
- Reset icon returns to the default module presets.

Preset format

```json
{
  "meta": { "label": "My Preset Name", "locale": "en-US" },
  "names": {
    "female": ["Anna", "Maria"],
    "male": ["Ivan", "Taras"]
  },
  "surnames": ["Shevchenko", "Franko"]
}
```

## Notes

- Presets are read from the selected folder. The module scans `*.json` files.
- If `meta.locale` is set, it is shown in the preset list as `Label (locale)`.
- Default folder: `modules/dh-666f78-quicknames/presets`.