🛒Shops

🛒 Overview

• Each entry defines one store used by day/night robberies.

• Minimal required fields only: name, ShopCoords, Manager, Cashier, cleanupSpot, ChestCoords, cashRegisterCoords, Customer, CrashSpawns, AccidentCoords.

---

🧾 Shop Template

{
  name = "Store Name",
  ShopCoords = vector3(x, y, z),

  Manager = vector4(x, y, z, heading),
  Cashier = vector4(x, y, z, heading),

  cleanupSpot = vector3(x, y, z),

  AccidentCoords = vector3(x, y, z),
  ChestCoords = vector3(x, y, z),

  cashRegisterCoords = {
    vector3(x, y, z),
    -- optionally more registers
  },

  CrashSpawns = {
    vector4(x, y, z, heading),
    -- 2-3 spawns recommended
  },

  Customer = {
    vector4(x, y, z, heading),
    -- minimum 6 recommended
  }
}

---

🔎 Field Quick Reference

Field	Required	Notes
name	✅	Unique readable name (matches cinematic angles keys)
ShopCoords	✅	Store center used for checks
Manager	✅	vector4 spawn + heading
Cashier	✅	vector4 spawn + heading
cleanupSpot	✅	Player must be near this to finish cleanup
AccidentCoords	✅ for night	Where cashier walks to investigate
ChestCoords	✅	Chest loot position
cashRegisterCoords	✅	vector3 or {vector3,...}
CrashSpawns	Recommended	Car spawn points for night crash
Customer	✅	Minimum 6 recommended; vector4 positions

---

⚠️ Practical Notes

• Customer should have spread positions so peds don’t overlap.

• Cashier AccidentCoords must be outside the store.

• CrashSpawns must have clear vehicle space and correct headings.

• name string must match cinematic angles if you want custom camera angles.

---

✅ Add / Edit Example (Grove Street)

-- append a shop
Shops[#Shops + 1] = {
  name = "My New 24/7",
  ShopCoords = vector3(123.4, -456.7, 78.9),
  Manager = vector4(125.0, -452.0, 78.9, 180.0),
  Cashier = vector4(121.5, -456.0, 78.9, 90.0),
  cleanupSpot = vector3(121.0, -450.0, 78.9),
  AccidentCoords = vector3(119.0, -458.0, 78.5),
  ChestCoords = vector3(122.0, -453.5, 78.4),
  cashRegisterCoords = { vector3(122.5, -455.0, 78.9) },
  CrashSpawns = {
    vector4(118.0, -460.0, 78.5, 270.0),
    vector4(116.0, -461.0, 78.5, 270.0)
  },
  Customer = {
    vector4(123.0, -454.0, 78.9, 200.0),
    vector4(124.5, -455.5, 78.9, 230.0),
    vector4(125.0, -453.0, 78.9, 180.0),
    vector4(122.0, -452.0, 78.9, 160.0),
    vector4(121.0, -456.0, 78.9, 90.0),
    vector4(124.0, -457.0, 78.9, 45.0)
  }
}

---

🔁 Quick Checklist (after editing)

• name is unique and matches cinematic (if custom)

• Manager & Cashier positions are inside the store and oriented correctly

• cleanupSpot is reachable by players

• AccidentCoords is outside the store for night robberies

• CrashSpawns have vehicle clearance + correct headings

• At least 6 Customer positions present

• Save file and restart server