Installation

1. Installation

1. Download or Clone this resource (folder name, e.g., merryweather_heist).

2. Place the merryweather_heist folder into your FiveM server’s resources directory.

3. Add the following line to your server’s server.cfg:

   cfgZkopírovatUpravitensure merryweather_heist

4. Restart your server or use the refresh and start merryweather_heist commands in your server console.

Dependencies

• ox_target For interactive zones (e.g., initiating the heist or hacking boxes).

• boii_minigames For the hacking/puzzle minigames that the player completes to unlock boxes.

• cd_dispatch (Optional) For police alerts if you want authorities notified automatically.

---

2. Resource Structure

Your folder might contain:

luaZkopírovatUpravitmerryweather_heist/
  |-- client.lua
  |-- server.lua
  |-- config.lua
  |-- locales.lua (if you use separate localization)
  |-- fxmanifest.lua
  ...

• client.lua Manages client-side logic: NPC spawn, hack interactions, notifs, etc.

• server.lua Handles server logic: cooldown checks, dispatch triggers, giving rewards.

• config.lua Main configuration file (cooldowns, NPC weapon loadouts, box spawn coords).

• locales.lua (optional) Text for notifications in multiple languages (if implemented).

• fxmanifest.lua The manifest that declares scripts, resource info.

---

3. Basic Usage

1. Start Heist A player uses ox_target on a designated zone or NPC to initiate the Merryweather Heist. The script checks cooldowns and police presence.

2. Defend & Hack Armed Merryweather mercenaries spawn. Player must fight them off while also completing hacking minigames (boii_minigames) at designated boxes.

3. Rewards Upon successful hack of each box, the script grants random loot (money, items, weapons). If the entire heist is completed, a personal and/or global cooldown is set.

4. (Optional) Police Dispatch If cd_dispatch is configured, a PD alert is automatically sent out when the heist begins