Updating from v1 to 2.0 — Trading Cards | Quasar Store

Trading Cards 2.0 keeps the resource name (qs-tradingcards), the item names and the album table, so it installs over 1.x rather than beside it. What changes is where things live: the catalogue moves from config files into the database and the in-game creator, and grading moves from an item to an NPC.

What Carries Over#

What	In 2.0
Albums	Kept. `qs_tradingcard_stashes` is the same table, and each album keeps its id. An album from an older build that still carried its cards inside the item's metadata is moved into the table the first time it is opened.
Cards players own	Kept. Every card carries its own data as metadata, and 2.0 reads the old field names too, so cards pulled under 1.x open, show and store like new ones.
Card, pack and album items	Same names: `tradingcard_basic`, `tradingcard_rare`, `tradingcard_legendary`, `tradingcard_booster_pack`, `tradingcard_booster_legends`, `tradingcard_stash`.
Card artwork as the item icon	Fixed. Older cards stored the artwork where inventories look for the icon, so some showed a broken image. When such a card goes through the album or the grader it is rewritten to keep the normal item icon.

What Changed#

1.x	2.0
Cards listed in `shared/config.lua`	Cards live in `qs_tradingcards_cards` and are made in `/cardcreator`. Old config files are not read.
Rarity colours in `Config.CardColors`	Rarities are rows you create, recolour and reweight in game, each with its own item.
One card look	A theme editor and three built-in themes.
The `tradingcard_psa` item and the PSA wait	A grader NPC inspects the card in front of you and writes the rating onto the card itself.
`/givecards`	The Give button on a card in the creator hands it to any online player by server id.
One shop NPC from `Config.Locations`	Shop, grader and trader NPCs placed in game, each with its own stock or settings.
`Config.CardBoosters`	Booster packs live in `qs_tradingcards_boosters`.
ESX, QBCore or Qbox required	Also runs standalone, with `ox_inventory` or `qs-inventory`.
`locales/*.lua`	`locales/*.json`, 41 languages, chosen with the `qs:locale` convar.

Updating Step by Step#

Back up the database
Export at least qs_tradingcard_stashes. 2.0 never drops it, but a backup costs nothing.
Replace the resource
Stop the server, delete the old qs-tradingcards folder and copy in the new one, plus tradingcards_props if you did not already have it. Do not keep a renamed copy of the old folder in your resources — the script refuses to run under any other name.
Replace the item definitions
Swap your 1.x item blocks for the ones in [items] (see Installation). The 1.x ox_inventory blocks pointed the items at exports — openPsa no longer exists, and the others are not needed any more.
Remove the PSA item
Delete tradingcard_psa from your inventory's item list and its icon. Nothing in 2.0 uses it, so any left in inventories do nothing.
Import the starter cards
Start the server once so the tables are created, then import database/sql.sql for the 82 starter cards and the built-in themes — or skip it and build your own catalogue in the creator.
Place your NPCs
Open /cardcreator → Peds and place a shop, and a grader and trader if you want them. A fresh 2.0 server has no NPCs until you do.

Players do not lose anything they hold. A card or album item that was in an inventory before the update is still there, and still works, afterwards.

What Carries Over#

What	In 2.0
Albums	Kept. `qs_tradingcard_stashes` is the same table, and each album keeps its id. An album from an older build that still carried its cards inside the item's metadata is moved into the table the first time it is opened.
Cards players own	Kept. Every card carries its own data as metadata, and 2.0 reads the old field names too, so cards pulled under 1.x open, show and store like new ones.
Card, pack and album items	Same names: `tradingcard_basic`, `tradingcard_rare`, `tradingcard_legendary`, `tradingcard_booster_pack`, `tradingcard_booster_legends`, `tradingcard_stash`.
Card artwork as the item icon	Fixed. Older cards stored the artwork where inventories look for the icon, so some showed a broken image. When such a card goes through the album or the grader it is rewritten to keep the normal item icon.

What Changed#

1.x	2.0
Cards listed in `shared/config.lua`	Cards live in `qs_tradingcards_cards` and are made in `/cardcreator`. Old config files are not read.
Rarity colours in `Config.CardColors`	Rarities are rows you create, recolour and reweight in game, each with its own item.
One card look	A theme editor and three built-in themes.
The `tradingcard_psa` item and the PSA wait	A grader NPC inspects the card in front of you and writes the rating onto the card itself.
`/givecards`	The Give button on a card in the creator hands it to any online player by server id.
One shop NPC from `Config.Locations`	Shop, grader and trader NPCs placed in game, each with its own stock or settings.
`Config.CardBoosters`	Booster packs live in `qs_tradingcards_boosters`.
ESX, QBCore or Qbox required	Also runs standalone, with `ox_inventory` or `qs-inventory`.
`locales/*.lua`	`locales/*.json`, 41 languages, chosen with the `qs:locale` convar.

Updating Step by Step#

Back up the database
Export at least qs_tradingcard_stashes. 2.0 never drops it, but a backup costs nothing.
Replace the resource
Stop the server, delete the old qs-tradingcards folder and copy in the new one, plus tradingcards_props if you did not already have it. Do not keep a renamed copy of the old folder in your resources — the script refuses to run under any other name.
Replace the item definitions
Swap your 1.x item blocks for the ones in [items] (see Installation). The 1.x ox_inventory blocks pointed the items at exports — openPsa no longer exists, and the others are not needed any more.
Remove the PSA item
Delete tradingcard_psa from your inventory's item list and its icon. Nothing in 2.0 uses it, so any left in inventories do nothing.
Import the starter cards
Start the server once so the tables are created, then import database/sql.sql for the 82 starter cards and the built-in themes — or skip it and build your own catalogue in the creator.
Place your NPCs
Open /cardcreator → Peds and place a shop, and a grader and trader if you want them. A fresh 2.0 server has no NPCs until you do.

Players do not lose anything they hold. A card or album item that was in an inventory before the update is still there, and still works, afterwards.

What Carries Over#

What	In 2.0
Albums	Kept. `qs_tradingcard_stashes` is the same table, and each album keeps its id. An album from an older build that still carried its cards inside the item's metadata is moved into the table the first time it is opened.
Cards players own	Kept. Every card carries its own data as metadata, and 2.0 reads the old field names too, so cards pulled under 1.x open, show and store like new ones.
Card, pack and album items	Same names: `tradingcard_basic`, `tradingcard_rare`, `tradingcard_legendary`, `tradingcard_booster_pack`, `tradingcard_booster_legends`, `tradingcard_stash`.
Card artwork as the item icon	Fixed. Older cards stored the artwork where inventories look for the icon, so some showed a broken image. When such a card goes through the album or the grader it is rewritten to keep the normal item icon.

What Changed#

1.x	2.0
Cards listed in `shared/config.lua`	Cards live in `qs_tradingcards_cards` and are made in `/cardcreator`. Old config files are not read.
Rarity colours in `Config.CardColors`	Rarities are rows you create, recolour and reweight in game, each with its own item.
One card look	A theme editor and three built-in themes.
The `tradingcard_psa` item and the PSA wait	A grader NPC inspects the card in front of you and writes the rating onto the card itself.
`/givecards`	The Give button on a card in the creator hands it to any online player by server id.
One shop NPC from `Config.Locations`	Shop, grader and trader NPCs placed in game, each with its own stock or settings.
`Config.CardBoosters`	Booster packs live in `qs_tradingcards_boosters`.
ESX, QBCore or Qbox required	Also runs standalone, with `ox_inventory` or `qs-inventory`.
`locales/*.lua`	`locales/*.json`, 41 languages, chosen with the `qs:locale` convar.

Updating Step by Step#

Back up the database
Export at least qs_tradingcard_stashes. 2.0 never drops it, but a backup costs nothing.
Replace the resource
Stop the server, delete the old qs-tradingcards folder and copy in the new one, plus tradingcards_props if you did not already have it. Do not keep a renamed copy of the old folder in your resources — the script refuses to run under any other name.
Replace the item definitions
Swap your 1.x item blocks for the ones in [items] (see Installation). The 1.x ox_inventory blocks pointed the items at exports — openPsa no longer exists, and the others are not needed any more.
Remove the PSA item
Delete tradingcard_psa from your inventory's item list and its icon. Nothing in 2.0 uses it, so any left in inventories do nothing.
Import the starter cards
Start the server once so the tables are created, then import database/sql.sql for the 82 starter cards and the built-in themes — or skip it and build your own catalogue in the creator.
Place your NPCs
Open /cardcreator → Peds and place a shop, and a grader and trader if you want them. A fresh 2.0 server has no NPCs until you do.

Players do not lose anything they hold. A card or album item that was in an inventory before the update is still there, and still works, afterwards.

What Carries Over#

What	In 2.0
Albums	Kept. `qs_tradingcard_stashes` is the same table, and each album keeps its id. An album from an older build that still carried its cards inside the item's metadata is moved into the table the first time it is opened.
Cards players own	Kept. Every card carries its own data as metadata, and 2.0 reads the old field names too, so cards pulled under 1.x open, show and store like new ones.
Card, pack and album items	Same names: `tradingcard_basic`, `tradingcard_rare`, `tradingcard_legendary`, `tradingcard_booster_pack`, `tradingcard_booster_legends`, `tradingcard_stash`.
Card artwork as the item icon	Fixed. Older cards stored the artwork where inventories look for the icon, so some showed a broken image. When such a card goes through the album or the grader it is rewritten to keep the normal item icon.

What Changed#

1.x	2.0
Cards listed in `shared/config.lua`	Cards live in `qs_tradingcards_cards` and are made in `/cardcreator`. Old config files are not read.
Rarity colours in `Config.CardColors`	Rarities are rows you create, recolour and reweight in game, each with its own item.
One card look	A theme editor and three built-in themes.
The `tradingcard_psa` item and the PSA wait	A grader NPC inspects the card in front of you and writes the rating onto the card itself.
`/givecards`	The Give button on a card in the creator hands it to any online player by server id.
One shop NPC from `Config.Locations`	Shop, grader and trader NPCs placed in game, each with its own stock or settings.
`Config.CardBoosters`	Booster packs live in `qs_tradingcards_boosters`.
ESX, QBCore or Qbox required	Also runs standalone, with `ox_inventory` or `qs-inventory`.
`locales/*.lua`	`locales/*.json`, 41 languages, chosen with the `qs:locale` convar.

Updating Step by Step#

Back up the database
Export at least qs_tradingcard_stashes. 2.0 never drops it, but a backup costs nothing.
Replace the resource
Stop the server, delete the old qs-tradingcards folder and copy in the new one, plus tradingcards_props if you did not already have it. Do not keep a renamed copy of the old folder in your resources — the script refuses to run under any other name.
Replace the item definitions
Swap your 1.x item blocks for the ones in [items] (see Installation). The 1.x ox_inventory blocks pointed the items at exports — openPsa no longer exists, and the others are not needed any more.
Remove the PSA item
Delete tradingcard_psa from your inventory's item list and its icon. Nothing in 2.0 uses it, so any left in inventories do nothing.
Import the starter cards
Start the server once so the tables are created, then import database/sql.sql for the 82 starter cards and the built-in themes — or skip it and build your own catalogue in the creator.
Place your NPCs
Open /cardcreator → Peds and place a shop, and a grader and trader if you want them. A fresh 2.0 server has no NPCs until you do.

Players do not lose anything they hold. A card or album item that was in an inventory before the update is still there, and still works, afterwards.

Updatingfrom v1

What Carries Over#

What Changed#

Updating Step by Step#

Back up the database

Replace the resource

Replace the item definitions

Remove the PSA item

Import the starter cards

Place your NPCs

Updatingfrom v1

What Carries Over#

What Changed#

Updating Step by Step#

Back up the database

Replace the resource

Replace the item definitions

Remove the PSA item

Import the starter cards

Place your NPCs

Updatingfrom v1

What Carries Over#

What Changed#

Updating Step by Step#

Back up the database

Replace the resource

Replace the item definitions

Remove the PSA item

Import the starter cards

Place your NPCs

Updatingfrom v1

What Carries Over#

What Changed#

Updating Step by Step#

Back up the database

Replace the resource

Replace the item definitions

Remove the PSA item

Import the starter cards

Place your NPCs