-
Notifications
You must be signed in to change notification settings - Fork 8
FAQ
Frequently asked questions about the Silly Sim Tracker extension.
Silly Sim Tracker is a SillyTavern extension that creates visual tracker cards based on JSON data in your chat messages. It's perfect for tracking character stats, relationships, progress, and more.
Not at all! While advanced customization involves some HTML/CSS, the basic functionality works with simple copy-paste of JSON structures.
Yes! Silly Sim Tracker is completely free and open source.
- Download the extension files
- Place the folder in your SillyTavern extensions directory
- Enable it in the Extensions settings panel
- That's it!
It works on mobile browsers, but the experience is better on desktop due to screen size.
Yes, once installed it works completely offline.
The basic structure is:
{
"worldData": {
"current_date": "YYYY-MM-DD",
"current_time": "HH:MM"
},
"characters": [
{
"name": "Character Name",
"your_field": "value"
}
]
}
No! Each character can have different fields. Just make sure required fields (name, worldData) are present.
The extension will show an error message in the chat, and your card won't appear. Fix the JSON and resend the message.
Absolutely! You can choose from built-in templates or create completely custom designs with HTML and CSS.
For basic changes, no. You can start with the built-in templates and modify them. For advanced customization, some HTML/CSS knowledge helps.
Yes! Set a default color in settings, or specify colors per character in your JSON data.
Generally yes, but some DOM-manipulating extensions might conflict. If you have issues, try temporarily disabling other extensions.
Yes! Track multiple characters in the same message by adding more objects to the characters array.
Yes, it works alongside character books and other SillyTavern features.
It's designed to be lightweight. With normal usage (a few cards per chat), you won't notice any performance impact.
Technically unlimited, but for best performance, keep to 4 or fewer active characters per message.
Yes, the tracker data is part of your chat messages, so it's saved with your SillyTavern data.
Yes! Add any fields you want to track to your custom fields list and include them in your JSON.
In the extension settings, find "Custom Sim Data Fields" and click "Add Field" to create new tracking variables.
Yes, in settings you can change it to whatever you prefer (like "tracker" or "rpg").
- Is the extension enabled?
- Is your JSON valid?
- Are you using the right code block format (```sim)?
- Do you have the required worldData fields?
Look for the error message in chat, check for missing commas, quotes, or brackets. Use a JSON validator if needed.
For templates: Use the "Clear Custom" button to revert to built-in templates. For JSON: Edit the message to fix the data.
The modern format separates world data from character data, making it cleaner and more maintainable. The extension supports both.
Use the "Migrate to New Format" button in settings or the /sst-convert slash command.
The extension provides {{sim_tracker}}, {{last_sim_stats}}, and {{sim_format}} macros. Creating additional custom macros requires extension development.
Try the quick start guide with a simple example, then gradually add complexity as you get comfortable.
Plan your fields before adding them, use consistent naming, and include data ranges in descriptions.
Keep active characters to 4 or fewer, simplify complex templates, and clear old chats when they're no longer needed.
Still have questions? Check the other wiki pages for detailed guides or ask in the community!