Unlock the Power of SillyTavern: A Complete Guide to Building Character Cards from Scratch with JSON and W++

Unlock the Power of SillyTavern: A Complete Guide to Building Character Cards from Scratch with JSON and W++

Creating a truly immersive character in SillyTavern is an art form. While downloading pre-made cards from the MiniTavern Character Card Market is quick and convenient, crafting a character from scratch gives you total control over their personality, backstory, and behavior. In this tutorial, we’ll walk through the entire process of building a custom character card using the two most powerful tools in the creator’s toolkit: raw JSON and the W++ personality description format. Our featured card will be Luna the Starweaver, a mystical astronomer who charts the constellations of forgotten worlds.

Whether you’re a novice or a seasoned user of the SillyTavern ecosystem, this guide will help you master the character card creator workflow. Let’s dive in.

Why Build Character Cards from Scratch?

Pre-made cards are fantastic for instant fun, but building from scratch offers distinct advantages:

• Total Customization: You control every detail, from the character’s deepest secrets to their speech patterns.
• Optimized Behavior: JSON allows you to fine-tune advanced parameters like token limits, greeting messages, and scenario triggers.
• W++ Precision: The W++ format organizes personality traits in a structured, machine-readable way, helping the AI stay consistent across long conversations.
• Portability: Your card works seamlessly across the SillyTavern web app, iOS/Android apps, and even the MiniTavern Chrome extension.

Understanding the Anatomy of a Character Card

A SillyTavern character card is essentially a JSON object wrapped around a structured text file. The core components are:

• Character Name: The name the AI will use.
• Description: A short, natural-language summary.
• Personality (W++): A formatted block that defines traits, likes, dislikes, and quirks.
• Scenario: The initial setting or context for the roleplay.
• First Message: The character’s opening line.
• Example Messages: Optional but highly recommended for teaching the AI how to speak.
• Advanced Definitions: JSON fields for token limits, system prompts, and custom variables.

The W++ format is the secret sauce. It uses a simple, bracket-based syntax like [trait: value] to describe attributes. This structured approach prevents the AI from forgetting key details during long sessions.

Step-by-Step: Building Luna the Starweaver

Let’s create Luna from scratch. Open your text editor or the built-in SillyTavern character card creator interface.

1. Start with the JSON Skeleton

Every card begins with a JSON structure. Here’s the minimal foundation:

{
  "name": "Luna the Starweaver",
  "description": "",
  "personality": "",
  "scenario": "",
  "first_mes": "",
  "mes_example": "",
  "metadata": {
    "version": 1,
    "created": "2025-04-01",
    "creator": "Your Name"
  }
}

This skeleton holds all the fields you’ll populate. You can expand it later with advanced options like system_prompt or post_history_instructions.

2. Write a Compelling Description

The description field is a short, natural-language summary. Keep it concise—the AI will use this to quickly grasp the character’s essence.

Luna the Starweaver is an ethereal astronomer who lives in a crystal observatory atop a floating island. She speaks in riddles and poetic metaphors, and she can see the threads of fate in the stars.

3. Craft the W++ Personality Block

This is where the magic happens. W++ uses a simple syntax: [trait: value] or [category: {subcategory: value}]. Each trait should be clear and specific.

For Luna, we might write:

[Name: Luna the Starweaver]
[Species: Human (star-touched)]
[Age: Appears mid-20s, actually centuries old]
[Appearance: Long silver hair woven with starlight, pale blue eyes that shimmer like galaxies, flowing robes of midnight blue]
[Personality: Mystical, patient, curious, slightly melancholic]
[Likes: Stargazing, ancient tomes, quiet conversations, solving cosmic riddles]
[Dislikes: Loud noises, hasty decisions, those who mock the stars]
[Abilities: Can read star charts to see possible futures, weaves light into physical shapes, speaks to celestial beings]
[Quirks: Often pauses to look at the sky mid-sentence, hums ancient melodies, collects meteorite fragments]
[Backstory: Born from a dying star, raised by the Council of Constellations, now guards the Starweaver’s Observatory]
[Speech: Poetic, uses metaphors, occasionally speaks in riddles, voice is soft and melodic]
[Behavior: Prefers to listen before speaking, touches her star pendant when thinking deeply]

The key is to be thorough but not redundant. Each trait should add a unique dimension to the character.

4. Define the Scenario

The scenario field sets the initial context. For Luna:

You are a traveler who has stumbled upon the Starweaver’s Observatory. Luna is currently charting a new constellation. She notices your presence and turns to greet you.

5. Write the First Message

This is the character’s opening line. It should establish tone, setting, and relationship instantly.

“Ah, a wanderer beneath the celestial canopy. I sensed your approach—the stars whispered of a curious soul drawn to the threads of fate. Tell me, do you seek a story written in the heavens, or have you come to weave your own?“

6. Add Example Messages (Optional but Powerful)

Example messages teach the AI how to respond in character. Use a simple format: <START> followed by alternating user and character lines.

<START>
{{user}}: What is that constellation you’re studying?
{{char}}: *She gestures with a slender hand, and the stars seem to glow brighter.* That is the Serpent of Echoes—a pattern that appears once every thousand years. It foretells a time of great change.
{{user}}: Change? Should I be worried?
{{char}}: *A soft, knowing smile crosses her face.* Worry is a cage, traveler. The stars do not judge—they simply reveal. What you do with that knowledge is your own tapestry.

This example shows Luna’s poetic speech, her knowledge, and her calming demeanor.

Advanced JSON Tweaks for the Creator

Once your basic card is ready, you can open the JSON directly in the SillyTavern character card creator to add advanced settings:

• system_prompt: Add instructions like “Always speak in poetic metaphors” or “Never break character.”
• post_history_instructions: Remind the AI of key traits after long conversations.
• token_limit: Set a maximum for responses (e.g., 500 tokens) to keep replies concise.
• custom_variables: Store metadata like “Luna’s star pendant is a plot device.”

Here’s an expanded JSON snippet:

{
  "name": "Luna the Starweaver",
  "description": "An ethereal astronomer...",
  "personality": "[Name: Luna...]",
  "scenario": "You are a traveler...",
  "first_mes": "Ah, a wanderer...",
  "mes_example": "<START>\n{{user}}:...",
  "system_prompt": "Always respond in poetic, metaphorical language. Never use modern slang.",
  "post_history_instructions": "Remember Luna’s star pendant is important to her. She touches it when thinking.",
  "metadata": {
    "version": 1,
    "created": "2025-04-01",
    "creator": "Your Name"
  }
}

Testing and Refining Your Card

After creating your card, import it into the SillyTavern web app or your preferred MiniTavern app. Start a conversation and watch for consistency issues. Common problems include:

• The AI forgets traits: Add more W++ entries or use post_history_instructions.
• Responses are too long: Adjust the token_limit.
• Speech doesn’t match: Revise mes_example to show the desired tone.

Don’t be afraid to iterate. The best cards are refined over several sessions.

Why Use the MiniTavern Ecosystem?

Once your card is perfected, you’ll want to share it or use it across devices. The MiniTavern ecosystem makes this seamless:

• iOS and Android Apps: Take Luna with you on the go. The apps support full JSON import and W++ parsing.
• Web App: The SillyTavern web app is perfect for desktop roleplay and advanced editing.
• Chrome Extension: Instantly load your card while browsing or use it in other AI interfaces.
• Character Card Market: Upload your finished card to the market and share it with the community. You can even sell your creations or download others’ work for inspiration.

The market is especially useful for seeing how other creators structure their W++ blocks and JSON metadata.

Conclusion: Your Card, Your Universe

Building a character card from scratch with JSON and W++ is the ultimate way to bring your vision to life. Luna the Starweaver is just one example—you can create anything from a gritty detective to a whimsical fairy. The tools are in your hands.

Ready to start crafting? Try the MiniTavern web app for desktop editing, or download the iOS/Android app for on-the-go creation. Don’t forget to explore the Character Card Market for inspiration and to share your own masterpieces. And if you’re a browser user, the Chrome extension makes loading and testing cards effortless.

The stars are waiting—weave your character today.