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

# Overview

> On-screen server watermark for FiveM with an in-game admin editor, drag-to-move positioning, and server-wide sync.

`nexdev_watermark` puts a clean, configurable watermark on every player's screen — your server name, logo, and colors — managed entirely in game. Open the editor with a command, style the watermark live, drag it anywhere on screen, and save: the new look is pushed to every connected player instantly and persists across restarts.

The UI ships **ready to use** — there is no build step. The only dependency is `ox_lib`.

## Features

* **In-game editor** — edit text, logo, colors, scale, opacity, rounding, and blink from a single panel. No file editing for visuals.
* **Two display modes** — **Logo with text** (badge card) or **Logo only** (just the image at a fixed height, width keeps the aspect ratio).
* **Drag-to-move** — enter drag mode and reposition the watermark by dragging it on screen.
* **Server-wide sync** — saving pushes the config to every connected player, and new joiners receive it on connect.
* **Server-authoritative** — the server validates the permission, sanitizes every field, saves, and broadcasts. Clients cannot forge changes.
* **Smart auto-hide** — fades out during the pause menu, the `ox_inventory` inventory, txAdmin announcements, and txAdmin direct messages.
* **Logo upload** — optional FiveManage integration for uploading a logo image from the editor.
* **Console control** — `nexwm show|hide|reset` works from the server console and RCON.
* **Localized** — every notification and editor label lives in `locales/<code>.json` (`en` and `es` ship out of the box).

## Requirements

| Requirement                                 | Notes                                                  |
| ------------------------------------------- | ------------------------------------------------------ |
| FiveM server                                | Any recent artifacts                                   |
| [`ox_lib`](https://overextended.dev/ox_lib) | Required. Must start **before** this resource          |
| [FiveManage](https://fivemanage.com)        | Optional. Only needed for logo uploads from the editor |

<Info>
  The watermark is standalone — no framework and no database required. Visual settings persist to `data/config.json` inside the resource.
</Info>

## How it works

The server owns the watermark config. When an admin saves changes in the editor, the server checks the `nexdev_watermark.manage` permission, sanitizes every field, writes `data/config.json`, and broadcasts the new config to all players. Players joining later receive the current config on connect, so everyone always sees the same watermark.

## In this section

* [Installation](/nexdev_watermark/installation) — drag-and-drop install, `server.cfg` order, and convars
* [Configuration](/nexdev_watermark/configuration) — the `config.lua` options and locales
* [Usage](/nexdev_watermark/usage) — the editor, drag mode, and console commands
* [Exports](/nexdev_watermark/exports) — show/hide the watermark from your own resources
* [Troubleshooting](/nexdev_watermark/troubleshooting) — common issues and fixes