8. Custom Fields

Custom fields let you track exactly what matters for your roleplay scenario. You can add, remove, and modify fields to match your needs.

What Are Custom Fields?

Custom fields are the variables that appear in your tracker card JSON data and templates. Each field represents something you want to track about your characters.

Managing Custom Fields

Adding Fields

1. Open Silly Sim Tracker settings
2. Scroll to "Custom Sim Data Fields"
3. Click "Add Field"
4. Enter a field key and description
5. Click outside to save

Removing Fields

1. Find the field you want to remove
2. Click the "Remove" button next to it
3. Confirm if needed

Editing Fields

1. Click directly on a field key or description to edit
2. Make your changes
3. Click outside to save

Field Key Rules

Field keys must follow these rules:

• No spaces (use underscores: magic_points)
• No special characters (stick to letters, numbers, underscores)
• Case sensitive (hp and HP are different)
• Should be descriptive but concise

Example Fields for Different Scenarios

RPG Tracking

Key: hp          Description: Health Points (0-100)
Key: mp          Description: Magic Points (0-50)
Key: level       Description: Character Level (1-20)
Key: xp          Description: Experience Points
Key: gold        Description: Currency Amount

Dating Sim

Key: ap          Description: Affection Points (0-200)
Key: dp          Description: Desire Points (0-150)
Key: tp          Description: Trust Points (0-150)
Key: cp          Description: Contempt Points (0-150)
Key: relationship_status  Description: Relationship Level Text

Adventure Game

Key: health      Description: Health Status (0-100)
Key: stamina     Description: Stamina Level (0-100)
Key: location    Description: Current Location
Key: objectives  Description: Active Quest Objectives
Key: inventory   Description: Carried Items

Survival Game

Key: hunger      Description: Hunger Level (0-100)
Key: thirst      Description: Thirst Level (0-100)
Key: warmth      Description: Warmth Level (0-100)
Key: health      Description: Health Status (0-100)
Key: resources   Description: Available Resources

Using Custom Fields

In JSON Data

Once you define a field, use it in your JSON:

{
  "worldData": {
    "current_date": "2025-08-10",
    "current_time": "14:30"
  },
  "characters": [
    {
      "name": "Alice",
      "hp": 75,
      "mp": 50,
      "level": 5,
      "xp": 1250,
      "gold": 100
    }
  ]
}

In Templates

Access custom fields in templates with {{stats.fieldName}}:

<div>Health: {{stats.hp}}</div>
<div>Level: {{stats.level}}</div>
<div>Gold: {{stats.gold}}</div>

In System Prompts

The {{sim_format}} macro automatically includes your custom fields:

{{sim_format}}

This generates an example showing all your defined fields.

Best Practices

1. Plan Before Adding

Think about what you really need to track before adding fields.

2. Use Consistent Naming

✅ hp, mp, xp, gold
❌ health, Magic_Points, exp, $$

3. Include Data Ranges

In descriptions, note valid value ranges:

Key: level  Description: Character Level (1-20)
Key: hp     Description: Health Points (0-100)

4. Start Simple

Begin with basic fields and add complexity as needed.

5. Match Your Prompts

Keep your custom fields in sync with your system prompt requirements.

Troubleshooting

Fields Not Appearing

1. Check that field keys match exactly in JSON and templates
2. Verify the field is defined in settings
3. Ensure the {{sim_format}} macro reflects your fields

Template Display Issues

1. Make sure you're using {{stats.fieldName}} format
2. Check that the field exists in your JSON data
3. Verify template syntax is correct

Prompt Integration

1. Update system prompts when changing fields
2. Use {{sim_format}} to show current field structure
3. Test with sample JSON data

Advanced Tips

Field Organization

Group related fields together in your settings for easier management.

Documentation

Use descriptions as quick reference for what each field tracks.

Backup Configurations

Keep notes of your field setups for different campaign types.

Custom fields are the heart of flexible tracking. Take time to set them up thoughtfully for the best experience.