> For the complete documentation index, see [llms.txt](https://docs.cdev.shop/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.cdev.shop/fivem/cdev-citytour.md).
# cDev Citytour
### Introduction
{% hint style="info" %}
**CDEV City Tour board game with Fun, Real, and Singleplayer modes, VIP stakes, ranking, luck cards, and spectator sync for FiveM.**
Place a 32-space world board, sit 2โ4 players (or one human vs AI), buy cities and beaches, collect rent, upgrade houses and hotels, and finish with last standing or a host-selected win condition. Supports QBox, QBCore, ESX Legacy, and multiple inventories.
{% endhint %}
### Purchase the Script
{% embed url="" %}
### Showcase Video
Soon
### **Features**
Features List
* ๐๏ธ **Custom City Tour Props** โ Board, colored pawns, dice, city houses 1โ3, hotel, and beach house (`cdev_citygame_*`) with `stream/` + `cdev_citygame.ytyp`.
* ๐ช **Furniture Kit Mode** โ Place board-only or with a full table + chairs kit (toggle with **G** while placing).
* ๐ **Physical Boards** โ Place tables using the `citytour_board` inventory item or via admin commands (`/citytourplace`).
* ๐ฎ **Pre-Game Lobby** โ Host picks Fun / Real / Singleplayer, seat count (2โ4), color, timer, luck deck, bail-roll toggle, and win-condition toggles. Joiners pick color and pay the Real entry when enabled.
* ๐ฐ **Fun, Real & Singleplayer** โ Fun uses in-game capital only. Real takes an entry (cash / bank / VIP) into a pot split 1st / 2nd / 3rd. Singleplayer is one human vs AI, no rank and no real money.
* ๐ **VIP Currency Bridge** โ Real mode can charge `vip` via `public/bridge/vip/server.lua` (default Qbox/QB `crypto`).
* ๐ **Cities, Beaches & Hotels** โ Buy land, build houses, hotels on cities, house 1 on paradise beaches. Full color set doubles rent. After paying rent on a rival **city**, you can repurchase it (not beaches, not hotels).
* ๐ **Luck Cards** โ Chance spaces draw from an equal-weight deck. Host can use Default or Custom cards. Holdable cards (rent ร2, rent รท2, Freed from Lost Island, Protection) play on your turn.
* ๐๏ธ **Lost Island, Tax & Specials** โ Three doubles or landing on the island space sends you to Lost Island. Tax charges **10%** of cash + property value (configurable). World Championships collects 50,000 from each other player. World Tour lets you pick any other space and travel there.
* ๐ค **AI Opponents** โ NPC bots with configurable names, ped models, think delay, and buy/upgrade aggression. Used in Singleplayer and as fillers in Fun/Real.
* ๐ **Rating & Badge System** โ Competitive points (default 1000โ6000) with win / loss / forfeit deltas and rank badges (Rookie โ Grandmaster). Fun and Real change rating. Singleplayer does not.
* ๐ **Gaming Hub** โ Profile (display name + avatar), paginated ranking, match history, money stats, and in-hub rules via `/citytourgaming`.
* ๐ฌ **Cinema Camera** โ Free orbit cam while playing: **W/S** elevate, **A/D** rotate, **scroll** zoom. Ped stays visible at the table. Match windows use header arrows (not the mouse wheel).
* ๐ **Spectator Sync** โ Nearby players (interest radius) see pawns, dice, cash stacks, buildings, and lobby dress without opening the NUI.
* ๐ต **Cash Stacks** โ In-match cash piles spawn at seats by capital tiers (`prop_cash_pile_02`).
* โฑ **Turn Timer** โ Optional host-enabled turn timeout with presets (30โ120s by default) and disconnect pause. Timeout rolls and buys empty land only.
* ๐ **Multi-Framework Compatibility** โ QBox (`qbx_core`), QBCore, and ESX Legacy with automatic detection. Inventories, target, and notifications via bridges or custom bridge .
* ๐ฏ **Flexible Interaction** โ `ox_target` / `qb-target` or built-in DrawText (`[E]` play ยท `[G]` pick up).
* ๐จ **UI Themes** โ Official `default` look + documented `custom` overrides via `public/shared/themes.json`.
* ๐ **Admin Tools** โ `/citytouradmin` panel (list / teleport / delete), `/citytourplace`, `/citytourdelete`, and `/citytourbalance` layout calibrator.
* ๐ **Locales** โ English and Portuguese out of the box (`en`, `pt`).
* ๐ **Buyer Economy File** โ Prices, rent, and repurchase live in `public/shared/property_economy.lua` (numbers only).
### Installation Guide & Others
{% content-ref url="/pages/wDQUdQNx2d0gSsP69fkJ" %}
[Features Preview](/fivem/cdev-citytour/features-preview.md)
{% endcontent-ref %}
{% content-ref url="/pages/aMUeszsEorui8eDMjjC3" %}
[Installation Guide](/fivem/cdev-citytour/installation-guide.md)
{% endcontent-ref %}
{% content-ref url="/pages/EK758g5Qu57HAbKLoqXk" %}
[Configurations](/fivem/cdev-citytour/configurations.md)
{% endcontent-ref %}
{% content-ref url="/pages/XhU2hgYT37kW0wF30GDG" %}
[Commands](/fivem/cdev-citytour/commands.md)
{% endcontent-ref %}
{% content-ref url="/pages/wi8f3Xn7hUF5Oi6Sjq7m" %}
[Exports](/fivem/cdev-citytour/exports.md)
{% endcontent-ref %}
{% content-ref url="/pages/1VQjOCzGqqoOto6zRBfO" %}
[Integrations](/fivem/cdev-citytour/integrations.md)
{% endcontent-ref %}
{% content-ref url="/pages/LisSS1u4DmQddWWxkhLY" %}
[FAQs](/fivem/cdev-citytour/faqs.md)
{% endcontent-ref %}
***
