Getting Started
Introduction
What Alamo Market is and what it can do.
Alamo Market is a framework-agnostic shop / store system for FiveM. It lets players walk up to a marker, press a key, browse a modern NUI catalog, fill a cart, and pay by cash or card. Items are added to their inventory through the framework.
Highlights
- Works with QBox, QBCore and ESX — the framework is auto-detected, you do not configure it.
- 20 pre-configured shops — LTD Gasoline, Rob's Liquor and 24/7 Markets are ready to sell out of the box.
- Catalog system — define an item list once and share it across many locations.
- Job & grade restrictions — lock a shop to specific jobs and minimum grades.
- Per-shop payment methods — allow cash, card, or both.
- Multi-language — English, German and Turkish included; add your own.
- Fully theme-able UI — recolor everything from a single CSS file.
What you can edit
This resource is built so that only two files ever need to be touched by you:
config.lua
All gameplay settings: shop locations, items, prices, blips, markers, jobs, payments, notifications and language.
html/assets/css/variables.css
The color scheme of the NUI. Swap accent colors, danger colors and panel styling.
Everything else (the gamemode logic, NUI markup, framework bridge) is handled for you and is encrypted on release builds. You never need to edit it.
How it works (high level)
- On resource start,
shared/shops.luareads your catalogs and locations fromconfig.luaand builds the liveConfig.Shopstable. - The client draws blips + markers and opens the NUI when a player presses the interaction key in range.
- On checkout, the client sends the cart to the server.
- The server re-validates everything (shop exists, job access, payment method, distance, prices, amounts), charges the player and grants the items.
All money and item logic is validated server-side. The client is never trusted.
Continue to Requirements.