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. |