dd-cards · Getting started
Installation
Dependencies, start order, the database tables and the locale convar — five steps, none of which require editing the resource itself.
Nothing here requires editing files inside dd-cards. Every step is either a server file you already own or a config option.
1. Dependencies
dd-cards needs the standard set covered in Requirements — ox_lib,
oxmysql, one framework (qbx_core or qb-core) and one inventory (ox_inventory or
qb-inventory). If your server already runs other resources of mine, you have all of it.
Optional. dd-cards detects these and uses them if they are running, and works without any of them:
ox_target,qb-target— third-eye interaction with the fabric ped. With neither installed, a walk-up prompt is used instead.qb-menu— menu style, if you would rather not use ox_lib's context menu.lb-phone,npwd,qb-phone— delivers "your order is ready" as a phone mail instead of an on-screen notification.
2. The resource
Drop the dd-cards folder into your resources directory and start it after ox_lib, oxmysql,
your framework and your inventory:
ensure ox_lib
ensure oxmysql
ensure qbx_core # or qb-core
ensure ox_inventory # or qb-inventory
ensure dd-cards
Warning
Start order matters. dd-cards resolves its framework and inventory bridges at boot by checking
which resources are already started. If it starts first it will error out with
no supported framework found even though the framework is in your server.cfg.
3. Database
Nothing to do by default. Config.AutoInsertSql is true, so dd-cards creates its two tables
on first start.
To import by hand instead, run install/sql/dd-cards.sql against your database and set
AutoInsertSql = false in config/server.lua.
Either way it is safe to repeat — the file contains only CREATE TABLE IF NOT EXISTS, so it never
touches, resets or migrates data that is already there. See Database for the schema.
4. Items and images
dd-cards does not register items itself; they belong to your inventory. Open the file for the inventory you run and follow it:
install/inventory/ox_inventory.txtinstall/inventory/qb-inventory.txt
Both also need the six images from install/inventory/images copied into your inventory's image
folder, or the items show as broken icons.
The full item definitions are reproduced on the Items & images page.
5. Configuration
Every option is commented in place inside the resource, and documented here:
| File | Covers |
|---|---|
config/client.lua | Fabric locations, peds, blips, interaction method, menu style, walk-up prompt |
config/shared.lua | Materials, prices, job fees, rush, printing time, box sizes, item names |
config/server.lua | Database, freehand drawing, payment, notifications |
Locales
Player-visible text lives in locales/en.json. dd-cards follows ox_lib's locale convar, so set it if
you are not running English:
setr ox_locale "en"
Adding a language is covered on the Localization page.