Documentation

Creating Content

Guide to creating new cards, packs, and expanding your trading card collection

Configuration lives in configs_settings/ — primarily configcards.lua for cards and configbooster.lua for packs/boxes. Use the Card Creator on this site to export ready-to-paste Lua.

🎨 Create a Card

Add entries in Config.Cards. The key must match your inventory item name exactly.

Required Fields

  • • name - Card name (matches inventory item)
  • • description - Card description text
  • • image - Filename in config (CDN loads by default) or full https:// URL; optional override in ui/i/
  • • rarity - Card rarity (Normal, Uncommon, Rare, Epic, Legendary, Holo, OriginalArt) or Auto (v1.1.7)
  • • brand - Card brand (must match booster pack brand)
  • • CardPositions - Position in binder (1–120 depending on brand)

Optional Fields

  • • style - Card style (Normal or OriginalArt for alternate art variants)
  • • effectType - Visual effect, or Auto for random holo roll (v1.1.7)
  • • stats - Card stats (level, hp, attack, defense - MAX 999)
  • • colors - Card colors (color1, color2, etc.)

Available Effect Types

Choose from 11 available effect types:

Common Effects

  • • Common_Uncommon
  • • Holofoil_Rare
  • • Cosmos_Holofoil
  • • Radiant_Holofoil

Special Effects

  • • VMax
  • • VStar
  • • Trainer_Holo
  • • Rainbow_Rare

Premium Effects

  • • Secret_Rare
  • • Trainer_Gallery
  • • Shiny_Vault

Available Brands

Your brand must match your booster pack branding:

JG Brands

  • • jg_warlords
  • • jg_shin_genesis
  • • jg_void_ether
  • • jg_sands_of_eternity

Other Brands

  • • ammunation_elite
  • • full_throttle
  • • ls_legends
  • • ls_landmark

Example Card Configuration

Config.Cards = {
  ['card_grizzlethorn'] = {
    name = 'grizzlethorn',
    description = 'Thorned brute from bristled wilds',
    image = 'card_grizzlethorn.webp',   -- CDN by default; drop in ui/i/ to override
    rarity = 'Normal',
    brand = 'jg_warlords',             -- Must match pack brand
    CardPositions = 1,                -- Position in binder
    effectType = 'Common_Uncommon',       -- Visual effect type
    stats = { level = 50, hp = 150, attack = 100, defense = 80 }, -- MAX 999
    colors = { color1 = '#a1d8f0', color2 = '#8ab6d6' } -- UI colors
  }
}

🎨 Create Booster Packs

Packs are defined in configs_settings/configbooster.lua. Each pack has its own rarityRules — see the full guide at Booster Packs & Rarity.

Pack Types

  • • Regular Packs: jg_[brand]_pack — lower packGate odds for Rare+
  • • Mythic Packs: jg_[brand]_pack_mythic — improved Rare/Epic/Legendary odds
  • • Legendary Packs: jg_[brand]_pack_legendary — best odds; may include guaranteedcards

Individual Pack Configuration

Each pack type has its own rarity distribution rules:

{ 
  item = 'jg_warlords_pack', 
  enabled = true, 
  brand = 'jg_warlords',
  rarityRules = {  -- Custom rules for this specific pack
    Normal    = { max = 6, chance = 12, packGate = false },
    Uncommon  = { max = 3, chance = 5, packGate = false },
    Rare      = { max = 1, chance = 0.02, packGate = true },   -- 1 in 5000
    Epic      = { max = 1, chance = 0.02, packGate = true },   -- 1 in 5000
    Legendary = { max = 1, chance = 0.0167, packGate = true }, -- 1 in 6000
    Holo      = { max = 1, chance = 0.0167, packGate = true }, -- 1 in 6000
    OriginalArt = { max = 1, chance = 0.0143, packGate = true } -- 1 in 7000
  },
  images = { 
    top = 'jg_warlords_trading_cards_pack_top.webp',
    bottom = 'jg_warlords_trading_cards_pack_open.webp' 
  }
}

📦 Create Booster Boxes

Booster boxes contain multiple packs and provide bulk value.

Booster Box Configuration

Config.BoosterBoxes = {
  -- Each box contains 6 packs of the specified type
  { 
    item = 'jg_warlords_booster_box',                     -- Box item name
    image = 'jg_warlords_trading_cards_booster_box.webp',    -- Box image
    packItem = 'jg_warlords_pack',                        -- Pack item inside
    packimage = 'jg_warlords_trading_cards_pack.webp'       -- Pack image for display
  },
  { 
    item = 'jg_warlords_booster_box_mythic',              -- Mythic box
    image = 'jg_warlords_trading_cards_booster_box_mythic.webp',
    packItem = 'jg_warlords_pack_mythic',
    packimage = 'jg_warlords_trading_cards_pack_mythic.webp'
  },
  { 
    item = 'jg_warlords_booster_box_legendary',           -- Legendary box
    image = 'jg_warlords_trading_cards_booster_box_legendary.webp',
    packItem = 'jg_warlords_pack_legendary',
    packimage = 'jg_warlords_trading_cards_pack_legendary.webp'
  }
}

Box Features

  • • 24 Total Boxes: 8 brands × 3 pack types each
  • • Automatic Contents: Each box contains 6 packs
  • • Visual Display: Shows pack type and quantity
  • • Brand Consistent: Box branding matches pack branding
  • • Economy Value: Bulk pricing vs individual packs

📚 Binder System

Binder Features

  • • Brand-Specific Collections: Each binder holds one brand only
  • • 18 Available Themes: Dark, Colorful, and Special themes
  • • Duplicate Prevention: Config.BindersDuplicatesCheck
  • • Collection Tracking: Config.BindersChecklistEnabled
  • • Auto-Positioning: Config.BindersAutoPosition
  • • Brand Enforcement: Config.BindersEnforceBrand

Binder Configuration

Config.Binders = {
  { 
    item = 'jg_warlords_book',           -- Binder item name
    themebook = 'Dark',               -- Visual theme
    brand = 'jg_warlords',            -- Brand restriction
  },
  { 
    item = 'jg_shin_genesis_book',       
    themebook = 'Neon_Cyan',          
    brand = 'jg_shin_genesis',       
  },
  { 
    item = 'jg_void_ether_book',         
    themebook = 'Forest_Green',         
    brand = 'jg_void_ether',       
  }
  -- ... 8 total binders for all brands
}

-- Global binder settings
Config.BindersDuplicatesCheck = true      -- Prevent duplicate cards
Config.BindersChecklistEnabled = true     -- Show collection progress
Config.BindersEnforceBrand = true         -- Single brand enforcement
Config.BindersAutoPosition = true         -- Auto-slot positioning

Available Themes (18 Total)

Dark Themes

  • • Dark, Dark_Blue, Midnight_Purple
  • • Steel_Grey, Crimson_Black

Colorful Themes

  • • Vibrant, Vibrant_Pink, Neon_Cyan
  • • Sunset_Orange, Forest_Green, Ocean_Teal

Special Themes

  • • Light, Gold_Black, Azure_Black
  • • Sandstone, Glacier_Blue, Plum_Rose, Emerald_Stone

🏆 CVG Grading System (Card Vault Grading)

CVG Grading Features

  • • CVG-Style Grading: Numeric scores + professional labels
  • • Protective Cases: Layered images with case_pack, case_label, case_texture
  • • Value Multipliers: Grade affects sell price and collectibility
  • • Time-Based System: Higher rarity = longer grading wait time
  • • Fee Structure: Pricing varies by rarity (Normal: 500, OriginalArt: 9000)
  • • Alternative Use: empty_grading_case item works standalone when shop disabled

Grading Case Configuration

Config.GradingCase = {
  case_pack = 'jim_g_trading_cards_grading_pack.webp',      -- Main case image
  case_label = 'jim_g_trading_cards_grading_pack_label.webp', -- Grade label overlay
  case_texture = 'jim_g_trading_cards_grading_pack_t.webp'   -- Texture overlay
}

CVG Grading Process

  1. 1. Submit raw card + grading fee to CVG grading shop
  2. 2. Wait for grading period (6-15 seconds based on rarity)
  3. 3. Receive graded card in protective CVG case
  4. 4. CVG grade affects value multiplier and collectibility

CVG Grading Benefits

  • • Increased Value: Higher sell prices based on CVG grade
  • • Protection: Cards protected from condition degradation
  • • Visual Prestige: Professional CVG graded case appearance
  • • Unique Serial: Each graded card gets unique tracking number

🌐 Online Card Creator

Use the Card Creator on this website for live card creation with:

  • • Live preview of card effects and styling
  • • Local cache saving for work‑in‑progress
  • • Exportable configs ready for servers
  • • Effect testing (holo and visual effects)
  • • Color coordination tools
  • • Metadata validation to ensure completeness

Creator Features

  • • Drag‑and‑drop image upload
  • • Real‑time rarity color preview
  • • Effect type testing (Holo, VStar, Rainbow, etc.)
  • • Brand organization and management
  • • Export directly to config format

Post‑Creation Steps

  1. 1. Create card in online editor
  2. 2. Export configuration
  3. 3. Add to Config.Cards in configs_settings/configcards.lua
  4. 4. Add basePrice to Config.SellShop.items in configshop.lua
  5. 5. Optional: add .webp to ui/i/ to override CDN, or use a full URL in config
  6. 6. Add inventory item to ox/qb install list
  7. 7. Test in‑game
Continue to Debugging & Tools →← Back to Collector System