> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexdev.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configuration

> The nexdev_watermark config.lua options — command, permissions, auto-hide toggles, and locales.

Basic options live in `config.lua`. Edit and restart the resource to apply. Everything **visual** (text, logo, colors, position, size) is managed in game with the editor and saved to `data/config.json` automatically — you never edit that file by hand.

## Options

| Key                       | Default                     | Description                                                                               |
| ------------------------- | --------------------------- | ----------------------------------------------------------------------------------------- |
| `Config.Locale`           | `'en'`                      | Language for every notification and editor label                                          |
| `Config.Command`          | `'nexwm'`                   | Chat command that opens the editor; the console form supports `show`, `hide`, and `reset` |
| `Config.ManageAce`        | `'nexdev_watermark.manage'` | ACE permission required to open the editor and change the watermark                       |
| `Config.ManageGroup`      | `'group.admin'`             | Group auto-granted the permission on start. Set to `'none'` to manage the ACE yourself    |
| `Config.HideInPauseMenu`  | `true`                      | Hide the watermark while the pause menu is open                                           |
| `Config.HideInInventory`  | `true`                      | Hide the watermark while the `ox_inventory` inventory is open                             |
| `Config.AnnouncementHide` | see below                   | How long the watermark hides for txAdmin announcements                                    |

## Announcement hide timing

When a txAdmin announcement appears, the watermark hides for a duration that scales with the message length:

```lua theme={null}
Config.AnnouncementHide = {
    baseMs = 2500,     -- base duration
    perCharMs = 90,    -- added per character of the message
    minMs = 5000,      -- never shorter than this
    maxMs = 20000,     -- never longer than this
}
```

Duration = `baseMs + (message length × perCharMs)`, clamped between `minMs` and `maxMs`.

<Info>
  The hide duration for txAdmin **direct messages** is configured in the in-game editor, not in `config.lua`.
</Info>

## Locales

Every notification and editor label lives in `locales/<code>.json` (`en` and `es` ship out of the box). To add a language:

1. Copy `locales/en.json` to `locales/<code>.json`.
2. Translate the values — keep the keys.
3. Set `Config.Locale = '<code>'` in `config.lua`.

Missing keys fall back to English.