Troubleshooting

Having issues with Silly Sim Tracker? Here are solutions to common problems.

Cards Not Appearing

Check the Basics

1. Is the extension enabled?

   • Look in Extensions settings
   • Toggle it off and on to refresh

2. Correct code block format?

   • Use triple backticks: ```sim
   • Include both opening and closing backticks
   • Check for the right identifier (default is "sim")

3. Valid JSON structure?

   • No missing commas
   • Proper quotes around strings
   • All brackets and braces closed

Test with Simple Data

Try this basic example:

{
  "worldData": {
    "current_date": "2025-01-01",
    "current_time": "12:00"
  },
  "characters": [
    {
      "name": "Test Character",
      "hp": 100
    }
  ]
}

JSON Errors

Common Syntax Issues

Missing Commas:

// Wrong
{
  "hp": 75
  "mp": 50
}

// Correct
{
  "hp": 75,
  "mp": 50
}

Quote Problems:

// Wrong
{ "name": "Alice's Stats" }

// Correct
{ "name": "Alice's Stats" }

Trailing Commas:

// Wrong
{
  "hp": 75,
  "mp": 50,
}

// Correct
{
  "hp": 75,
  "mp": 50
}

Validation Tools

Use online JSON validators if you're unsure:

• jsonlint.com
• jsonformatter.curiousconcept.com

Template Issues

Template Not Loading

1. Check markers: <!-- CARD_TEMPLATE_START --> and <!-- CARD_TEMPLATE_END -->
2. Verify Handlebars: Template must contain {{variables}}
3. CSS syntax: Look for unclosed style tags

Wrong Data Display

1. Variable names: Must match exactly ({{stats.hp}} not {{stats.HP}})
2. JSON structure: Field must exist in your data
3. Data types: Numbers shouldn't be in quotes

Performance Problems

Slow Rendering

1. Limit characters: Keep to 4 or fewer active characters per message
2. Simplify templates: Reduce complex HTML/CSS
3. Close other tabs: Free up browser resources

Browser Lag

1. Update browser: Use the latest version
2. Disable extensions: Other extensions might conflict
3. Clear cache: Refresh your browser

Migration Issues

Migration Fails

1. Check JSON validity: Invalid JSON can't be migrated
2. Look for errors: Notifications show which messages failed
3. Manual fix: Correct JSON errors first, then migrate

Partial Conversion

If some messages convert but others don't:

1. Check failed messages: Look for JSON syntax errors
2. Verify sim data: Ensure they contain tracker data
3. Edit individually: Fix problematic messages manually

Settings Problems

Changes Not Applying

1. Save settings: Some changes need a save/refresh
2. Toggle extension: Turn off/on to force refresh
3. Clear custom data: Remove custom templates/fields if problematic

Color Issues

1. Hex format: Use proper hex colors (#ff0000, #4ecdc4)
2. No named colors: "red" won't work, use "#ff0000"
3. Case insensitive: "#FF0000" same as "#ff0000"

Integration Conflicts

Other Extensions Interfering

1. Test isolation: Temporarily disable other extensions
2. Check console: Look for JavaScript errors
3. DOM conflicts: Other card systems might interfere

Debugging Tips

Enable Logging

In browser console (F12):

localStorage.debug = 'SST:*';
location.reload();

Check Console Errors

Look for [SST] prefixed messages and any red error messages.

Test Steps

1. Simple data first: Start with basic JSON
2. One change at a time: Isolate what's causing issues
3. Browser refresh: Clear cache and restart

Browser Compatibility

Supported Browsers

• Chrome/Chromium 80+
• Firefox 74+
• Edge 80+
• Safari 14+

Known Limitations

• Mobile Safari: Some advanced CSS might not work
• Old browsers: May lack modern JavaScript features

When to Seek Help

Try These First

1. Restart SillyTavern
2. Check all the basics above
3. Look in browser console for error messages
4. Test with simple examples

Where to Get Help

• GitHub issues page
• SillyTavern Discord community
• Extension documentation

What Information to Provide

• Extension version
• Browser and version
• Exact error messages
• Sample JSON that causes issues
• Steps to reproduce the problem

Most issues can be resolved by checking these common problems. If you're still stuck, the community is usually very helpful!