# F.A.Q

> Frequently asked questions for ML Board

Category: BOARDS · Source: https://miciomods.it/docs/ml-board-faq · Last updated: 2026-07-28

## Setup

**How do I change the language?**

Set `Config.Locale` in `shared/config.lua`:

**shared/config.lua**

```lua
Config.Locale = 'en'
```

**Why are notes not rendering on the board?**

1. Check the F8 console for DUI errors
2. Verify `web/index.html` and `web/board.html` are present
3. Ensure the board is within `RenderDistance` (default 30m)

**Why are items not being consumed?**

1. Verify items from `_INSTALL/ox_items.lua` are in your ox_inventory
2. Check that `Config.UseItems = true`
3. Ensure the note variant's `items` list matches your inventory item names

## Notes

**What's the difference between postit and photo?**

- `postit`: Text-only notes. Players type a message.
- `photo`: Image notes. Requires a photo URL (from `ml_camera` or pasted manually).

**How do notes expire?**

Notes have a duration set between `Config.Duration.Min` and `Config.Duration.Max` (in hours). When the timer runs out, the note is automatically removed during the next cleanup cycle (`Config.Defaults.CleanupInterval`).

**Can I limit which note types are available on a board?**

Yes. Set `allowedVariants` in the board's location config. Only note variant IDs in that array will be selectable.

**How do players draw on a board?**

The pen lives in the board toolbar. Drawing on the board surface follows the draw permission, which is staff only unless a board opens it up:

**shared/config_locations.lua**

```lua
permissions = { draw = { 'police' } },
```

Drawing on a note follows the place permission instead, and is on by default:

**shared/config.lua**

```lua
Config.AllowNoteDrawing = true
```

**How do I add my own stamps?**

Add an entry to Config.Stamps. Give it a label and an ink colour, or an image URL to print your own artwork:

**shared/config.lua**

```lua
Config.Stamps = {
    { id = 'sealed', label = 'SEALED', color = '#37474f', size = 'medium' },
    { id = 'lspd',   label = 'LSPD',   image = 'https://your.cdn/lspd_stamp.png', size = 'large' },
}
```

**Can a photo sit inside my own poster artwork?**

Yes. A photo variant accepts a frame image plus the window the picture shows through and the box the caption is written in, both in percent of the artwork:

**shared/config_notes.lua**

```lua
{
    id      = 3,
    type    = 'photo',
    label   = 'Wanted Poster',
    items   = { 'photo' },
    frame   = 'https://your.cdn/wanted_poster.png',
    ratio   = 1.4,
    window  = { x = 18, y = 26, w = 64, h = 42 },
    caption = { x = 14, y = 74, w = 72, h = 14 },
}
```

**Do stamps and drawings follow a note when it is moved?**

Yes. A stamp pressed on a note and ink drawn across it are stored against that note, so moving or rotating the note carries them along. Deleting the note removes them with it.

## Dynamic Boards

**How do player-placed boards work?**

Players use a board item (e.g. `whiteboard_small`) from their inventory. They aim at a wall or surface and the board is placed. The board persists in the database until the owner picks it up.

**Who can pick up a dynamic board?**

Controlled by `Config.BoardPickupPolicy`:

- `'owner'`: Only the player who placed it
- `'anyone'`: Any player can pick it up

## Locations

**How do I add a static board?**

Add an entry to `Config.Locations` in `shared/config_locations.lua`:

**shared/config_locations.lua**

```lua
{
    id                = 'my_board',
    model             = 'hei_prop_hei_muster_01',
    coords            = vec4(x, y, z, heading),
    currentBackground = 'cork',
}
```

Restart the resource after adding locations.

**Can I restrict a board to specific jobs?**

Yes. Add `jobView`, `jobWrite`, and/or `jobClear` to the location config:

```lua
jobView  = nil,
jobWrite = { 'police', 'sheriff' },
jobClear = { 'police' },
```

`nil` means everyone. A table restricts to those jobs only.

## Updates

**How do I update the script?**

1. Download latest from CFX Portal
2. Backup `shared/config.lua`, `shared/config_notes.lua`, `shared/config_locations.lua`, and `server/config_server.lua`
3. Replace all files except config
4. Restart the resource

Board content and dynamic placements are stored in the database, so they survive updates.

**Do saved boards need converting?**

Boards written by an older release use a different surface layout. The console reports how many are left on start:

**server console**

```bash
/mlboard_migrate
```

Run it once from the server console, or in game with the admin permission. Boards already converted are skipped.