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

# CRD-TCG

A complete installation, configuration, and developer guide for the CRD‑TCG FiveM trading card system.

## Welcome to CRD‑TCG

CRD‑TCG is a complete trading card game resource developed for QBox FiveM servers.

Players can collect cards, open booster packs, build and save decks, grade cards, trade with other players, challenge NPC opponents, and participate in casual or ranked 1v1 battles.

### Main Features

* Booster packs with configurable card pools
* Binder and card collection interface
* Custom deck building and saved deck presets
* Casual player-versus-player battles
* Ranked PvP with MMR, wins, and losses
* Secure card trading between players
* NPC opponents with configurable decks and rewards
* Hidden card ratings and timed grading
* Configurable card shop for buying packs and selling cards
* Creature abilities and spell cards
* Custom card artwork
* Public card-showing system
* Automatically created database tables

### Supported Systems

CRD‑TCG is currently designed for:

* `qbx_core`
* `ox_lib`
* `oxmysql`
* `ox_inventory`
* `ox_target`

{% hint style="info" %}
CRD‑TCG requires all five dependencies to start before the resource.
{% endhint %}

### Getting Started

New server owners should follow these pages in order:

1. **Installation**
2. **Configuration**

### Player Commands

| Command         | Description                                                        |
| --------------- | ------------------------------------------------------------------ |
| `/tcgbinder`    | Opens the card collection, deck builder, and grading interface.    |
| `/tcgchallenge` | Challenges the nearest player to a casual battle.                  |
| `/tcgranked`    | Challenges the nearest player to a ranked battle that affects MMR. |
| `/tcgtrade`     | Sends a trade request to the nearest player.                       |

### Important Information

CRD‑TCG automatically creates its required database tables when the resource starts. A manual SQL import is not required.

Server owners must add the desired booster-pack items to `ox_inventory/data/items.lua`. Packs must also be distributed through a shop, loot table, admin command, or another server system.

{% hint style="info" %}
Always back up your server files and database before installing or updating CRD‑TCG.
{% endhint %}

### Support

If you encounter a problem that is not covered in this documentation, open a Technical Support ticket in the Cross Rhodes Development Discord.

Include the following information:

* Relevant server-console or client-console errors
* Screenshots or video of the issue
* The steps required to reproduce it
* Any configuration sections related to the problem

{% hint style="info" %}
Remove license keys, database credentials, webhooks, and other private information before sharing files or screenshots.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://crossrhodes-development.gitbook.io/crossrhodes-development-docs/crd-tcg.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.