> For the complete documentation index, see [llms.txt](https://ayccoes-assets.gitbook.io/ayccoes-assets/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ayccoes-assets.gitbook.io/ayccoes-assets/ayc-hud/custom-data.md).

# Custom Data

The following admin commands allow you to create, edit, and remove custom status entries. All changes are automatically saved and synchronized with every connected player.

***

### `/cs_add`

Creates a new custom status.

**Syntax**

```
/cs_add id | Label | Value | Color(optional)
```

**Parameters**

| Parameter            | Description                            |
| -------------------- | -------------------------------------- |
| `id`                 | Unique numeric or string identifier.   |
| `Label`              | The title displayed for the status.    |
| `Value`              | The status value.                      |
| `Color` *(optional)* | Hex color code. Defaults to `#d9d7d7`. |

**Example**

```
/cs_add priority | Priority | Available | #00ff00
```

> **Note:** If a status with the same ID already exists, the command will be rejected.

***

### `/cs_set`

Creates a new status or overwrites an existing one.

**Syntax**

```
/cs_set id | Label | Value | Color(optional)
```

**Parameters**

| Parameter            | Description                            |
| -------------------- | -------------------------------------- |
| `id`                 | Status identifier.                     |
| `Label`              | Display label.                         |
| `Value`              | Display value.                         |
| `Color` *(optional)* | Hex color code. Defaults to `#d9d7d7`. |

**Example**

```
/cs_set aop | Area of Play | Los Santos | #d7d8d9
```

Unlike `/cs_add`, this command will replace an existing status if the ID already exists.

***

### `/cs_update`

Updates a single field of an existing status.

**Syntax**

```
/cs_update id | label/value/color | new value
```

**Editable Fields**

* `label`
* `value`
* `color`

**Examples**

```
/cs_update aop | value | Los Santos
```

```
/cs_update activity| label | Current Activity
```

```
/cs_update priority | color | #ff0000
```

Only the specified field is modified; all other values remain unchanged.

***

### `/cs_remove`

Deletes a custom status by its ID.

**Syntax**

```
/cs_remove id
```

**Example**

```
/cs_remove priority
```

***

### `/cs_clear`

Removes **all** custom statuses.

**Syntax**

```
/cs_clear
```

This command clears the entire custom status list and immediately synchronizes the empty list with all connected clients.

***

### Notes

* All commands require **administrator permissions**.
* Command parameters are separated using the `|` (pipe) character.
* Color values must be valid hexadecimal color codes (for example, `#00ff00` or `#ff4444`).
* Every successful change is automatically saved and synchronized with all connected players.
* By default, this component is displayed as **Custom Data** in the settings menu. You can rename it by editing the translation file located at `shared/translation.lua`.

  **Example:**

  ```lua
  customData = "Custom Data"
  ```

  Change it to:

  ```lua
  customData = "Server Status"
  ```

  This will update the name shown in the settings menu without affecting the functionality of the system.