Documentation

Images Setup

Inventory item icons can be generated with the debug screenshot command and saved to ui/inv_images/ — copy those into your inventory images folder. Card artwork for the in-game UI is loaded automatically from Jim G's built-in CDN; you only need ui/i/ if you want to override or add custom images.

WEBP Image Format

All card images, inventory icons, and UI assets have been converted to WEBP format for optimal performance and reduced file sizes.

Benefits

  • • 25–35% smaller file sizes than PNG
  • • Faster UI load times for card views and shops
  • • Lossless quality preservation
  • • Supported by all modern NUI browsers

Included Assets

  • • Card artwork (all brands)
  • • Inventory icons (200×200)
  • • Booster pack & box images
  • • Grading case & slab images
  • • Binder & deck box images

Jim G Cloudflare CDN (built-in)

Card artwork is hosted on Jim G's Cloudflare CDN and works out of the box. You do not need to host or upload card images yourself — stock cards, packs, boxes, and UI art load automatically when the resource starts.

How images are loaded

  1. Full URL in config — if you set https://... on a card, that link is used (your own host or CDN)
  2. Local ui/i/ folder — if the file exists in the resource, it is used first (.webp, .png, or .jpg)
  3. Jim G CDN — if nothing local is found, the script loads the image from Jim G's CDN automatically

Override tip: drop a .webp with the same filename as a stock card into ui/i/ and your local copy is used instead — no config change needed.

Default setup (most servers)

  • • Install the resource and go — CDN handles all stock art
  • • No files needed in ui/i/ for default cards
  • • Faster loads, less bandwidth on your server

Custom / mixed setup

  • • New custom cards: add .webp to ui/i/ or use a full https:// URL in config
  • • Replace one stock card: same filename in ui/i/ overrides the CDN version
  • • Host everything yourself: put all images in ui/i/ with matching filenames

Local images (ui/i/)

Optional folder inside the resource for .webp (or .png/.jpg) overrides. Checked before the CDN — so a local file with the same name always wins.

  • • Card config image field is usually just a filename, e.g. card_grizzlethorn.webp
  • • Or set a full URL in configcards.lua for external hosting
  • • Inventory icons (200×200) are separate — generate with /testjimgcardscreenshot (debug mode) or add manually to your inventory image folder

Auto-Capture Screenshot System

When debug mode is enabled, the script can automatically capture 200×200 inventory icons for every card and save them to the ui/inv_images/ folder.

Screenshot Process

  • • Uses html2canvas to render the card UI
  • • Captures at 200×200 resolution for inventory compatibility
  • • Saves as Base64-decoded image files server-side
  • • Can send captures to a Discord webhook for review
  • • Only runs in debug mode — never in production

🎯 Next Steps

After setting up images:

Continue to Configuration →← Back to Installation