📋Noticeboard

A lightweight noticeboard system for RedM designed to work with VORP. This page walks you through first setup, translations, and moderation.

---

⚡ First Start

Place noticeboards

Edit config.lua and define your board locations inside Config.Boards. Each board entry contains coordinates and optional blip settings:

• x, y, z → world position of the board.

• createBlips → show or hide a map blip for this board.

• blipsName → the blip name.

• blipsSprite → the blip icon (joaat hash).

Boards with the same ID (e.g : "boards-1") share the same set of announcements.

Prepare translations

In config.lua, two areas can be customized:

• UI texts in Config.Txt.

• UI language in Config.NUILang (supported: fr, en, de, it, es, pt).

---

🧩 Configuration

In config.lua, you will find the main settings:

Config.DEBUG = true                 -- Enable or disable debug logs
Config.SpamSeconds = 2              -- Cooldown between actions
Config.ExpireDays = 14              -- Auto-expiration time for ads
Config.OpenKey = keys["U"]          -- Key to open the board
Config.DiscordWebHook = "..."       -- Discord webhook for logs
Config.DiscordName = "BT_NOTICEBOARD"
Config.AdminsGroup = { "mod", "admin", "superadmin" }

Config.Objects = {                  -- Allowed board object models
  "mp005_p_mp_bountyboard01x",
  "mp005_p_mp_bountyboard02x",
}

Config.Boards = {
  ["boards-1"] = { -- boards ID -> Boards with the same ID share the same set of announcements.
    { x = -1801.97, y = -358.48, z = 163.82, createBlips = true, blipsName = "Notice Board", blipsSprite = joaat("blip_job_board") },
    { x = -767.01,  y = -1260.93, z = 43.58,  createBlips = true, blipsName = "Notice Board", blipsSprite = joaat("blip_job_board") },
  }
}

Config.NUILang = "en" -- Supported: fr, en, pt, it, es, de

---

🌍 UI Localization

Config.NUILang = "en"

Config.Txt = {
  OpenPrompt = "View the board",
  Board      = "Notice Board",
  Spam       = "Please do not spam.",
  Error      = "An error has occurred.",
  Already    = "Only one ad is allowed.",
  Published  = "Your ad has been published and will automatically be removed after " .. Config.ExpireDays .. " days.",
  Removed    = "Your ad has been deleted.",
  Right      = "You do not have the rights to do this.",
  AdminRight = "Your admin rights allow you to delete ads and create as many as you want."
}

• Config.NUILang selects the language used by the NUI.

• Config.Txt holds the text displayed to players.

---

🔒 Moderation & Admin Rights

• Player rules

  • By default, each player can only have one active announcement at a time.

  • Announcements are automatically removed after Config.ExpireDays.

• Admin privileges

  • Admins are defined in Config.AdminsGroup.

  • These groups can:

    • Create unlimited announcements.

    • Delete any player’s announcement instantly.

• Discord logging

  • Every publish or removal can be logged via Config.DiscordWebHook.

  • Webhook messages are sent as embeds, with the name defined in Config.DiscordName.

---

✅ Quick Checklist

• Boards configured in Config.Boards.

• Translations updated in Config.Txt.

• Config.NUILang set to the desired language.

• Discord webhook configured if you want logs.

• Admin groups set correctly in Config.AdminsGroup.

You’re ready to launch the script and start posting announcements on your noticeboards.