> For the complete documentation index, see [llms.txt](https://reddev-development.gitbook.io/reddev-development-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://reddev-development.gitbook.io/reddev-development-docs/qbcore.md).

# Installation

## Overview

Use this page for QBCore servers installing the full REDDEV resource set.

## Base Ensure Order

```cfg
ensure qb-core
ensure oxmysql
ensure ox_lib
ensure xsound
ensure bob74_ipl
ensure screenshot-basic

ensure reddev_devtablet
ensure reddev_music
ensure drug_creator
ensure garage_creator
ensure doors_creator
ensure ammo_boxes
ensure reddev-bodybag
ensure vehicle_radio_disabler
ensure reddev_housecreator_props
ensure reddev_housecreator

ensure PolyZone
ensure qb-target
ensure qb-inventory
ensure reddev-shops
```

## SQL

* REDDEV Development Tablet: import `reddev_devtablet/install/reddev_devtablet.sql`.
* REDDEV garage metadata: import `reddev_devtablet/install/reddev_garage_system.sql` if using the REDDEV garage metadata system.
* Garage Creator: import `garage_creator/install/run-qb.sql`.
* Door Creator: run `doors_creator/sql/doors.sql` and `doors_creator/sql/doors_buildings.sql` if auto-creation is blocked.
* Drug Creator: import `drug_creator/sql/drug_creator.sql`.
* House Creator: run `[sql]/first_run_database_schema/reddev_housecreator_qb_all_in_one_RUN_FIRST.sql`.

## Items

* Add `devtablet` from `reddev_devtablet/install/qbcore_item.lua`.
* Add `boombox` from `reddev_music/ITEMS.md`.
* Add Drug Creator items from `drug_creator/ITEMS.md`.
* Add Ammo Boxes items from `ammo_boxes/install/items/items.lua`.
* Add Bodybag items from `reddev-bodybag/README.md`.
* Add House Creator items from `reddev_housecreator/[sql]/second_run_inventory_items/README_ITEMS.md`.
* For REDDEV Shops, make sure sellable items exist in `qb-core/shared/items.lua` or your active inventory item database. Keep `Config.HideMissingItems = true` to hide missing items from live shop menus.

## Permissions

```cfg
add_ace group.admin reddev_admin.open allow
add_ace group.admin reddev_admin.admin allow
add_ace group.admin doors_creator allow
add_ace group.admin reddev_door_creator allow
add_ace group.admin reddev-shops.admin allow
```

Also review each resource page for job/gang access settings.

## REDDEV Shops Notes

Only run `reddev-shops` for the unified shop system. Do not also run old shop, riddle, delivery, or `qb-shops` resources beside it.

Low-end servers can tune startup batching in `reddev-shops/config.lua`:

```lua
Config.Performance.spawnBatchSize = 1
Config.Performance.spawnBatchDelay = 200
Config.Performance.lazyPedSpawning = true
Config.Performance.lazyPedSpawnPerScan = 1
```

Random riddle ped movement, the arrival watermark, and riddle lazy ped spawning are configured in `reddev-shops/modules/riddles/config.lua`:

```lua
RiddleConfig.Performance.lazyPedSpawning = true
RiddleConfig.Performance.lazyPedSpawnPerScan = 1
RiddleConfig.Performance.lazyPedScanWait = 1500
```

Shop XP can be disabled for purchases in `reddev-shops/config.lua`:

```lua
Config.UseXpSystem = false
```

Players can view shop XP with `/xp`. The display uses a small REDDEV NUI card by default. Position, duration, accent color, and optional persistent watermark are configured under `Config.XpDisplay`.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://reddev-development.gitbook.io/reddev-development-docs/qbcore.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.