Documentation

Visual Effects & Styling

Complete guide to card visual effects, rarity colors, and styling options

Visual Effects System

Complete visual effects system with 11 unique effect types, configurable rarity colors, and toggle controls for performance optimization.

Effects Configuration

Global Effects Toggle

Enable or disable all visual effects system-wide for performance control.

Config.EffectsEnabled = true  -- Set false to disable all effects

High Rarity Effects

Control which rarities receive enhanced visual effects.

Config.HighRarity = {
  ['Normal'] = false,
  ['Uncommon'] = false,
  ['Rare'] = true,
  ['Epic'] = true,
  ['Legendary'] = true,
  ['Holo'] = true,
  ['OriginalArt'] = true,
}

Effect Types (11 Available)

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

Effect Assignment Example

Config.Cards = {
  ['card_legendary_dragon'] = {
    name = 'Legendary Dragon',
    rarity = 'Legendary',
    effectType = 'Rainbow_Rare',  -- Premium rainbow effect
    -- ... other properties
  },
  ['card_shiny_pokemon'] = {
    name = 'Shiny Pokemon',
    rarity = 'Holo',
    effectType = 'Shiny_Vault',    -- Special shiny effect
    -- ... other properties
  }
}

Rarity Color System

Each rarity has a unique color scheme for UI elements, borders, and visual indicators.

Standard Rarities

  • • Normal: #9ca3af (Gray)
  • • Uncommon: #22c55e (Green)
  • • Rare: #3b82f6 (Blue)
  • • Epic: #a855f7 (Purple)

Premium Rarities

  • • Legendary: #ffd700 (Gold)
  • • Holo: #60a5fa (Light Blue)
  • • OriginalArt: #232527ff (Black)

Color Configuration

Config.RarityColors = {
  ['Normal'] = '#9ca3af',
  ['Uncommon'] = '#22c55e',
  ['Rare'] = '#3b82f6',
  ['Epic'] = '#a855f7',
  ['Legendary'] = '#ffd700',
  ['Holo'] = '#60a5fa',
  ['OriginalArt'] = '#232527ff'
}

Binder Visual Themes (18 Available)

Each binder can use one of 18 visual themes for unique collection presentation.

Dark Themes

  • • Dark
  • • Dark_Blue
  • • Midnight_Purple
  • • Steel_Grey
  • • Black
  • • 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

Theme Assignment Example

Config.Binders = {
  { 
    item = 'jg_warlords_book', 
    themebook = 'Dark_Blue',           -- Dark blue theme
    brand = 'jg_warlords' 
  },
  { 
    item = 'jg_shin_genesis_book', 
    themebook = 'Neon_Cyan',           -- Bright cyan theme
    brand = 'jg_shin_genesis' 
  },
  { 
    item = 'jg_void_ether_book', 
    themebook = 'Forest_Green',        -- Nature theme
    brand = 'jg_void_ether' 
  }
}

TC Machine (Vending Machine)

The TC Machine is an interactive vending machine prop for buying packs and selling cards. It runs independently from shop/sell/grading NPCs — each has its own enabled flag (v1.1.6+).

Machine Features

  • • Custom prop: jim_g_trading_cards_vending_machine (requires jim_g_trading_cards_props)
  • • 12 predefined locations across the map
  • • Buy from Config.Shop.items; sell from Config.SellShop.items
  • • Bulk sell: Sell All Cards / Sell All CVG (v1.1.8)
  • • Bridge target or drawtext interaction

Configuration

Config.TcMachine = {
  enabled = false,  -- disabled by default
  prop = 'jim_g_trading_cards_vending_machine',
  locations = {
    vector4(25.74, -1347.28, 29.5, 271.22),
    vector4(-48.62, -1757.04, 29.42, 45.74),
    -- ... 12 total locations
  }
}

Show Player Button

The Show Player feature lets players share their cards with nearby players in real-time, enabling social card trading interactions.

How It Works

  • • Enabled via Config.ShowPlayerButton = true
  • • When viewing a card, a "Show Player" button appears
  • • Sends the card view to nearby players within range
  • • Recipient sees the full card with effects, condition, and metadata
  • • Each show degrades the card condition by Config.Condition.degradeAmount (if enabled)

Performance Optimization

Effects Control

  • • Toggle all effects with Config.EffectsEnabled
  • • Selective effects via Config.HighRarity
  • • Performance mode for low-end systems
  • • Individual card effect customization

Best Practices

  • • Use EffectsEnabled = false for performance
  • • Limit HighRarity to reduce visual load
  • • Test effects on target hardware
  • • Consider player preferences