KPPVIP/renzu_shops-main

renzu_shops

Fivem Advanced Shops with stocks and player owned shops using ox_inventory , ox_lib.

Features

• Support All types of Shops
• Categorized Shop
• Player Owned Shops
• Shop Management - Stock management, employee management, finance management, item data mangement, item orders manage.
• Shop Owner can Order Bulk items from Suppliers with preconfigured discounts.
• Shop Owner can Deposit or Withdraw items from Store Inventory.
• Support Multiple Currency. money , black_money or your custom item.
• Support Preconfigured Item Metadas type. ( eg. sell burger, Cheese Burger, Double Bart Burger with one item 'burger')
• Support Item Customisation using Metadatas. ( Semi Advanced Usage ) ( example: Donut can have toppings. Burger can have cheese, lettuce addons) each addons can have effects. as for weapon customisation its defaults is Attachements.
• Movable Shops - preconfigured. 'Chihuahua Hot Dogs', 'Beefy Bills Burger Bar', 'Attack A Taco' (van)
• Ondemand Shop Selling - Sell Items to Random Locals Orders. (soon player based ondemand as this is currently WIP)
• Shipping Jobs - Store Owner Bulk Orders will be redirected to Shipping Job. its mean this script does not do Self Delivery like the other stock shops script. while owner can still do shipping job on their own. as shipping job is open for all and no job requirement at the moment.)
• Cashier System - All New Sales income money will be redirected to Cashier. Store Owner or Any OnDuty Clerk can Withdraw the money from Cashier.
• Store Robbery - a Simple store robbery with Skill Check. Every Cashier can be Robbed with a default 30minutes cooldown.
• Item Custom Effects on use. ( from item customisation or Preconfigured Metadatas ex.status)
• Admin Store Management - Manage Store Stocks and everything, Add New Store Via Menu from preconfigured Shop Ownable types.
• and more.

Commands

• /stores - Open Admin store manage
• /addstock - @param ShopName : string: ex: General @param ShopIndex : number: ex: 1 @param Amount : number: ex: 100 @extraparam ItemName : string: ex: burger

Preconfigured Shops

• General 24 / 7 Stores
• Ammunation
• Black markets
• Vehicle Shops ( Boat, Helis, Vehicles )

Shared Options - can be found config/init.lua

• shared.framework - @value : string ex 'ESX' or 'QBCORE'
• shared.oxShops - @value Boolean ( Allow you to use Ox Shops UI instead of Builtin UI ) Integrated Majority of Shop management Feature.
• shared.allowplayercreateitem - @value Boolean - Allow you to Add new Custom Item to to Any Stores (exluding vehicleshop) Default false (only admin)
• shared.target = Enable use of ox_target
• shared.defaultStock = @value Boolean - Declare how much the Initial Stock upon Store Purchase.

Dependency

• ox_inventory (latest)
• ox_lib (latest)
• ox_target (optional) can be configured init.lua (default is marker zone type)
• ESX Legacy / QBCORE

Note

• this resource will overide/disable ox inventory shops if config.oxShops is false

• if you want to fully test the resource. you need to install all the items required here. to ox_inventory/data/items.lua , items can be found in data/install_items.lua.

• Shop Images Used from \ox_inventory\web\images/{$item}.png

• TO use Item Effects from Customisation @ data/item-customisation.lua

• You need to Insert the export , export = 'renzu_shops.ItemUse', once you use this export. this will override your config from data/items.lua on ox.

• Example

['burger'] = {
		label = 'Burger',
		weight = 0,
		client = {
			anim = 'eating',
			prop = 'burger',
			usetime = 2500,
			notification = 'You ate a delicious burger',
			export = 'renzu_shops.ItemUse'
		},
	},

• Some Experimental Feature to Use like ox inventory Shop UI are required to use my forked version of ox_inventory. (Optional)
• https://github.com/renzuzu/ox_inventory
• to USE Full support of qbcore. you need my forked of qb-inventory -
• https://github.com/renzuzu/qb-inventory

DEMO IMAGES

• General Store

• Ammunation

• Vehicle Shop

• Ondemand Selling

• Store

• Movable Shop

• Store Manage

TASKS or can be contributed from Forking.

• ✅ Create Item Datas for ox_inventory data/items.lua format. ( for default samples preconfigured items ) (easy)
• ✅ Create Admin Menus to manage player shops. ( intermediate )
• ✅ Add Transfer Ownership to Store Management ( normal )
• ✅ Tweak Shipping Job Missions. fix or optimise zones, Trailer Spawning properly and etc.. (normal)
• Enhance or Add more Effects to data/item-customisation.lua ( intermediate )
• Change Blip Sprites. (very easy)
• ✅ Support Multiple Frameworks. (easy)
• Support Item Customisation to Movable Shops correctly. (intermediate)
• ✅ replace scenario based when cooking to TaskPlay (easy)
• ✅ Add Job based Access to Store Managing
• ✅ Supports Ox_inventory Shop Default UI (experimental)
• ✅ Support Adding New Item to store via Store Manage Menu (optional admin or player)
• Store Logs