6. Tracker Cards

Creating Tracker Cards

Tracker cards are created by adding special JSON code blocks to your SillyTavern messages. Here's how to structure your data.

Basic Structure

Every tracker card requires JSON data in a specific format:

{
  "worldData": {
    "current_date": "YYYY-MM-DD",
    "current_time": "HH:MM"
  },
  "characters": [
    {
      "name": "Character Name",
      "field1": "value1",
      "field2": "value2"
    }
  ]
}

Required Elements

World Data

You must include world data with the current date and time:

"worldData": {
  "current_date": "2025-08-10",  // Required: YYYY-MM-DD format
  "current_time": "14:30"        // Required: 24-hour HH:MM format
}

Characters Array

Each character you want to track needs an entry:

"characters": [
  {
    "name": "Alice",    // Required: Character's name
    "hp": 75,           // Example field
    "mp": 50            // Example field
  }
]

Example Cards

Simple RPG Tracker

{
  "worldData": {
    "current_date": "2025-08-10",
    "current_time": "14:30"
  },
  "characters": [
    {
      "name": "Eldrin the Wizard",
      "class": "Wizard",
      "level": 5,
      "hp": 75,
      "mp": 50,
      "xp": 1250
    }
  ]
}

Dating Sim Tracker

{
  "worldData": {
    "current_date": "2025-08-10",
    "current_time": "14:30"
  },
  "characters": [
    {
      "name": "Alice",
      "ap": 75,  // Affection Points
      "dp": 60,  // Desire Points
      "tp": 80,  // Trust Points
      "cp": 20   // Contempt Points
    }
  ]
}

Adventure Game Tracker

{
  "worldData": {
    "current_date": "2025-08-10",
    "current_time": "14:30"
  },
  "characters": [
    {
      "name": "Explorer",
      "health": 85,
      "stamina": 70,
      "location": "Dark Forest",
      "objectives": "Find the ancient temple"
    }
  ]
}

Data Types

You can use various data types in your fields:

Numbers

"level": 5,
"experience": 1250.5,
"gold": 100

Text

"name": "Alice",
"class": "Warrior",
"status": "Poisoned"

Booleans

"isActive": true,
"isInCombat": false,
"hasQuestItem": true

Arrays

"inventory": ["Sword", "Shield", "Potion"],
"skills": ["Fireball", "Heal"],
"statusEffects": ["Poisoned", "Blessed"]

Customization Fields

Background Color

Set a custom color for each card:

"bg": "#6a5acd"  // Purple color

Inactive Characters

Mark characters as inactive:

"inactive": true,
"inactiveReason": 1  // 1=Asleep, 2=Comatose, etc.

Tips for Success

1. Always include worldData with date and time
2. Every character needs a name field
3. Use consistent field names across characters
4. Keep data relevant to your story
5. Test your JSON if cards aren't appearing

Troubleshooting

If your cards aren't showing up:

1. Check that your JSON is valid (no missing commas, quotes, etc.)
2. Verify you're using the correct code block format: ```sim
3. Ensure worldData includes both current_date and current_time
4. Make sure each character has a name field
5. Try editing and resending the message