Studios
Card Albumshouse-3.jpg

Configuration

SoonCard AlbumsQBCore · Qbox · ESX
PAGE 03 OF 06  ·  INSTALLATION → CONFIGURATION → EXAMPLESdocs.glitchstudios.dev
Browse docs

Everything is in config.lua, which stays unencrypted.

Option Default Meaning
Locale en Language file in locales/.
ShowDistance 5.0 Metres a shown card reaches.
ShowSeconds 8 How long a shown card stays on screen (clamped to 1-15 on the client).
ShowCooldown 5 Seconds between show-offs per player.
ActionCooldownMs 250 Minimum gap between open and action requests per player.
CacheSeconds 60 How long pack odds and the masked card list are cached.
ImageBase nui://ox_inventory/web/images/ Where card artwork is loaded from. Use an https URL ending in / to serve it from a CDN.
ImageAllowed {} Extra URL prefixes accepted for image overrides stored in item metadata.
FallbackOdds per rarity Pull rates in percent per card, used by the built-in opener and the card backs when glitch-lootBox is not running.
HideRarities { mythic = true } Rarities masked as ??? until owned, used when glitch-lootBox is not running.
BuiltInPacks true Turns the built-in pack opener on or off.
PackLog true Logs every built-in pack pull to the console and to lib.logger.
Collections two sets Album item, pack item, card prefix, label and the 12 cards with rarities.

Text is in locales/en.lua. To add a language, copy the file to locales/<code>.lua, translate the values and set Config.Locale. Text inside the card view itself is in html/app.js.

Artwork#

No card, pack or album image is included: you supply the PNGs. Whenever a card image is missing or fails to load, the album view draws a styled placeholder card with the collection, number, name and a rarity-coloured frame, so a server without art still works. Hidden (mystery) cards use the generic card back in html/cardback.svg. Add your own art for the real look: each item needs a PNG named after it (soccer_card_album.png, card_fb_torvane.png and so on), placed in ox_inventory/web/images, or hosted on a CDN with Config.ImageBase pointing at it. Square images around 512px with a transparent background fit the frames best. A card can also carry its own picture in item metadata (imageurl or image), as long as the address starts with the image base, nui:// or a prefix in ImageAllowed.

Image filenames

One PNG per item, named after the item id, in ox_inventory/web/images (or at Config.ImageBase):

Albums and packs: soccer_card_album.png, basketball_card_album.png, soccer_card_pack.png, basketball_card_pack.png

Cards: card_fb_torvane.png, card_fb_calderra.png, card_fb_vantaa.png, card_fb_marchetti.png, card_fb_kjellmark.png, card_fb_reinholt.png, card_fb_oduya.png, card_fb_alcantar.png, card_fb_hartwell.png, card_fb_draycott.png, card_fb_zelenko.png, card_fb_gary.png, card_bb_dellacroix.png, card_bb_holloway.png, card_bb_ashcroft.png, card_bb_brandvold.png, card_bb_varga.png, card_bb_kerner.png, card_bb_lindqvist.png, card_bb_anselm.png, card_bb_brennan.png, card_bb_pruitt.png, card_bb_santangelo.png, card_bb_airball.png

Adding a collection#

Add an entry to Config.Collections with an album item, a pack item, a card prefix, a label and 12 { 'name', 'rarity' } pairs, then add the matching item definitions. Rarities are mythic, legendary, epic, very-rare, rare, uncommon and common.

Configuration reference#

These settings come from the inspected package. Tables contain nested fields; edit them using the examples in the supplied file. Keep secrets in server-only configuration.

config.lua defaults#

Setting Default / editing guidance
Config.Collections Table; fields and examples are in the supplied configuration file.