Consumables Creator

Description

🔌 Ecosystem & Compatibility Support

• Supported Frameworks:

  • QBCore

  • Qbox

  • ESX Legacy

• Supported Inventories (10+):

  • ox_inventory, qb-inventory, qs_inventory, codem_inventory, tgiann_inventory, core_inventory, origen_inventory, ak47_qb_inventory, ak47_inventory, jpr_inventory

• Multi-Language Support (13 Languages):

  • English (en), Arabic (ar), French (fr), Spanish (es), German (de), Portuguese (pt), Chinese (zh), Polish (pl), Dutch (nl), Italian (it), Russian (ru), Turkish (tr), Swedish (sv)

📦 Asset Package Contents

• 35 Free Custom Props:

  • 15 Drink Props (Custom 3D models with pre-configured attachments).

  • 20 Food Props (Custom 3D models with pre-configured attachments).

• 35 Pre-configured Animations: Hand-crafted animations mapped with clean, human-readable labels in the UI.

🛠️ In-Game Consumable Creator (Admin UI)

• Bulk Item Registration: Select single or multiple unregistered items simultaneously to apply universal configurations instantly.

• Smart Dropdown Auto-Fetch: Automatically reads registered items from your active inventory into a clean dropdown. Filters out items already configured in this script to prevent duplicate entries.

• Fine-Tuned Animation Selector: Pick from 35 custom animations with full label integration.

• Custom Status Effects & Adjustments:

  • Duration: Custom consumption speed (1–120 seconds).

  • Progress Bar Label: Fully customizable action text (e.g., "Drinking...", "Eating...").

  • Status Sliders: Precise controls for Hunger, Thirst, Stress, Health, and Armor (0–100 range).

  • Item Removal Toggle: Flexible checkbox to toggle whether items are consumed/removed upon usage.

• Live Registered Item Management:

  • Update Effects: Live UI editor to modify any existing consumable's animation or status values on the fly.

  • Delete Consumable: Instantly removes usable item logic and clears database records.

  • Test Spawn: One-click feature to spawn selected items directly into the admin’s inventory for instant live testing.

🛒 Integrated In-Game Shop System

• Admin Shop Manager:

  • Bulk-add registered items with dynamic price tags directly from an in-game UI.

  • Modify prices or remove items from shops live without needing server restarts.

• Player Shop Interface:

  • Interacts with customizable PED spawns placed via coordinates in config.lua.

  • Clean UI displaying full item lists, descriptions, and dynamic prices.

  • Payment & Bulk Options: Allows players to select purchase quantities and pay via Cash or Bank account.

🛡️ Admin Audit & Webhook Logging System

• Discord Webhook Support: Integrated Discord logging to track all admin actions and shop transactions in real time.

• Detailed Log Events:

  • Consumable Management: Logs when an admin registers, updates, or deletes a consumable item (including selected stats, duration, and animations).

  • Item Spawning: Logs whenever an admin uses the "Spawn Item" test feature (includes Admin Name, Identifiers, Item Name, and Quantity).

  • Shop Changes: Logs when items/prices are added or removed from the admin shop menu.

  • Purchases: Logs player shop transactions (Player Name, Identifier, Item Bought, Quantity, Total Cost, and Payment Method).

⚙️ Core Technical Architecture

• Auto SQL Setup: Fully automated database table registration on first boot—zero manual SQL imports required.

• Dynamic Usable Item Handler: Automatically registers or unregisters usable items with the active core framework on the fly.

• Conflict Prevention Engine:

  • Scans for usable item conflicts during resource startup.

  • If an item is already handled by another resource, this script automatically yields and unregisters it to prevent framework crashes, errors, or duplicate actions.