🍪Crumbly Cookie!

Installation Guide

This guide will walk you through setting up the Crumbly Cookie script for your FiveM server. Follow each step carefully.

---

1. Requirements

• xmmx_bridge (Included or download from the free category on Tebex.)

• ox_lib (Download latest version from Here.)

• DJ's Collection (Cookies and Brownies Props, get them Here.)

• Crumbly Cookie MLO (Not Included! Purchase Here.)

---

2. Configuration Files

config.lua

Adjust these important settings:

• Version Check & Debug:

  Version = true
  Debug = true

• Images & Menu:

  Images = "ox_inventory/web/images/"
  Menu = "ui" -- or "xm" if using xMaddMackx's menu
  MenuTxt = "Keep it Bubbly!"
  MenuScheme = "#b14f4f"
  iconColor = "#b14f4f"

• Storage Options:

  TraySize = 10
  TrayWeight = 20000
  StorageSize = 100
  StorageWeight = 1000000

• Special Buffs:

  SpeedBuff = true
  ArmorBuff = true

• Optional:

  SocietyFunds = true -- Should funds go to business society config in xmmx_bridge
  ToggleHud = true -- Should hud be toggled when a UI is open?
  Receipts = true -- Should customer receive a receipt? limited inventory support.

---

3. Location Setup (location.lua)

• Enable Location:

  Enabled = true -- enable the location functions?

• Job Permissions:

  JobName = "crumbly" -- job used for the location
  BossGrade = 4 -- boss grade to access boss menu in office?
  CheckDuty = true -- require on duty to access menus? Only workd for QB and Qbox.

• Blips: Customize map blip settings:

  blipLabel = "Crumbly Cookie"
  blipCoords = vector3(374.41, 95.81, 103.13)

• DUI Zone: If using the DUI monitor:

  DUIZone.Enabled = true
  propModel = "v_med_cor_ceilingmonitor"
  propCoord = vector4(370.523, 95.648, 104.815, -123.0)

• Interaction Zones: Add or modify entries under CustomerMenu, Registers, Supplies, Prep, etc.

---

4. Items & Pricing

All menu items are set in config.lua under CashierItems:

• Categories: Cookies, Icecream, Specials, Drinks

• Example Entry:

  { id = 1, name = 'crumbly_macadamia', category = 'Cookies', price = 300.00 }

---

5. Localization (locales.lua)

Set custom text and prompts:

• Notifications:

  Notify.must_wash = "You must wash your hands first!"
  Notify.order_paid = "$%s was Paid to Crumbly Cookie!"

• Progress Descriptions:

  Progress.uniform_on = "Putting on uniform..."
  Progress.opening_combo = "Opening "

---

6. Consumables (consumables.lua)

• Items use animations, props, and buffs when consumed.

• Speed Buff Items: Includes large cookies like crumbly_lrgchocchunk

• Armor Buff Items: Includes drinks like crumbly_wholemilk

Buffs last 10 seconds by default and can be configured.

---

7. Inventory Images

Make sure all item icons exist in: • Copy the images from the .INSTALL/images folder. • Copy the items from .INSTALL/items folder.

ox_inventory/web/images/

Filenames must match item names from CashierItems.

---

8. Troubleshooting

• Missing Icons: Ensure correct image path and filenames.

• Menu Doesn’t Open: Confirm menu type matches (ui, xm, etc.).

• Props Not Spawning: Check DUIZone.Enabled and propCoord format.

---

9. Additional Tips

• Adjust prices as needed per economy.

• Enable/disable buffs depending on server balance.

• Use Debug = true for troubleshooting zones and props.

---

This guide covers the basics for getting Crumbly Cookie running on your server. For support or updates please open a ticket via discord.