sphiratrioth666/SX-3_Characters_Environment_SillyTavern

SX-3: Character Cards Environment ~ by Sphiratrioth

Welcome to the new age of roleplaying. No more repetitive starting messages, no more fixed scenarios. Built-in mechanism for switching time of day/night & weather for a current scene, 50 selectable or rollable locations (city, countryside, fantasy, sci-fi), 50 SFW & 20 NSFW universal scenarios to roleplay in each location, 50 quick-start presets with everything set-up for your convenience, 300 clothing pieces to construct wardrobe of your characters. Highly customizable roleplay experience without editing the once finished cards nor any additional hassle.

Permissions: you are allowed to use it, generate your own characters & lorebooks in SX-3 format, mix and remix them. However, if you upload your characters online - you need to give me credits and attach a link to this exact repository. All the creations must be clearly credited as using SX-3 Character Cards Environment by Sphiratroth.

Here, you can buy me a Coffee. Just click on the banner above. All the work I do remains free - but I drink a lot of coffee, actually, haha - so it is very nice when you show support by fueling my caffeine addiction :-D As a bonus, you can also find a lot of my other, side (hobby) projects. Some Reshade presets for different games, my custom TTRPG system (soon), maybe other goodies in the future.

What is it?

SX-3 format cards are just the normal V2/V3 character cards but with a custom, especially crafted and embedded lorebook (~900 entries). It includes a lot of variables to pick up from or roll with natural language trigger-words. This way, we are able to construct a different scenario each time. Instructions in the lorebook will be sent to the LLM without appearing in chat but the starting message for your chosen scenario will be generated - different each time. Since it follows precise instructions from a lorebook, the starting message always reflects your choices so the scenario remains consistent but the starting message and the small surrounding details change. No roleplay feels the same - even for the same scenario. There is no boring repetition. On a top of that, if you follow a character description template of the SX-3 format, the character’s card itself remains just the universal avatar - personal information, body, personality, quirks, goals, skills etc. - while variables such as relationship with {{user}}, current mood, a setting that roleplay takes place in - can be also adjusted just the way you want - or - rolled! Last, but not least - different scenarios may be mixed. For example, if you want the scene to start with {{char}} drinking coffee in a shopping mall, you can keep it SFW, you can turn it NSFW or you can even add a supernatural horror/hunting flavor to it. You do not need to edit a card itself, you do not need different variants of the same card - it is all in the universal lorebook.

In other words - everything matches everything and anything may be picked up freely or rolled. I am a game designer for AAA games studio, I do it for living - thus - my roleplays also look and work just like that.

What it does?

it generates a different starting message from the list of hand-crafted, presemade scenarios, locations & presets - every single time (no more repetitive roleplays);

it automatically randomizes time & weather for a current scene;

it makes it possible to hot-swap the {{char}}'s relationship with {{user}}, {{char}}'s mood, residence and sexuality with each roleplay;

it allows picking up all those options from a normal chat window (no need to edit a character card itself, no need for multiple versions of the same character);

it guides characters in a specific way druing roleplay - to improve the experience (for instance, stops the LLM directly repeating what {{user}} did in {{char}}'s response, which personally - infuriates me);

it does not require any extensions nor special knowledge - just picking up the intuitive trigger words from the convenient lists presented in alternative starting messages (but you roleplay in the default starting message only - all the rest just serves as an easy way of presenting the options to choose from);

it allows randomly rolling almost all the available options or to choose, which ones you want to roll - for more fun and even less predictability.

SX-3 Format Character Cards

To provide the easy and smooth experience, I share a couple of my personal characters that use the SX-3 format environment. They are very fun and you can use them out of the box or you can create your own characters and embed the universal lorebooks available in the files repository of this post.

Realistic Setting: example characters to download:

Takashi Aika (Yakuza Heiress on a Run) (SX-3.0, not updated to 3.1),

Kim Seo-Yeon (Korean Mafia Heiress) (SX-3.0, not updated to 3.1),

Shiratori Chiasa (Misunderstood Artist) (SX-3.0, not updated to 3.1),

Matsuda Kurumi (Gyaru Delinquent) (SX-3.0, not updated to 3.1),

Yoshida Tomoe (Housemate Friend) (SX-3.0, not updated to 3.1),

Nicholas Quail (Cameo) (SX-3.0, not updated to 3.1) (accept my sincere appologies, all the ladies and gals out there - I make exclusively female characters, both for SFW & NSFW - so the best I am able to offer is my own persona converted into a male character :-P I'm terrible, I know - sorry for that - but it should be a fun character regardless! Feel free to edit the character, change a pic or whatever!)

Cyberpunk Setting: example characters to download:

Sylvia Blades (Mercenary) (SX-3.0, not updated to 3.1)

Fantasy Setting: example characters to download:

Ghorza Barg'nash (Adventurer) (SX-3.0, not updated to 3.1)

How to set it up?

I will not lie to you. All you see here works best with my personal, customized SillyTavern presets (https://huggingface.co/sphiratrioth666/SillyTavern-Presets-Sphiratrioth). You can theoretically try different presets as well - but as much as I always suggest trying them all out (I like the Marinara's and Virt-dude's ones myself) - this time, I sadly need to auto-promote. I tailored my presets to work exactly with this format here since that's how I am personally roleplaying since last summer (2024). Feel free to try it with other presets - but do not complain if something goes wrong!

Download Example Characters:

1. Navigate to the files section of this post and download the characters.
2. Import Characters in SillyTavern.
3. Click on the SX-3 Character on the list - it should ask you to import the embedded lorebook and to turn the attached REGEX on.

Character Set-Up:

1. Make sure that the character-attached REGEX is on under the SillyTavern tab Extensions/Regex/Scoped Scripts.

2. Make sure that the character embedded lorebook has been imported: click on the green globe button under the character tab to make sure that the embedded lorebook loads up properly. SillyTavern should ask if you're ant to import the embedded lorebook automatically - when you import a character and click on it for the first time. Thus, this step is just to make sure that everything works as intended.

How to use it?

Type the natural & intuitive trigger words into the chat window. There is a very simple structure, which may look intimidating at first but then - it becomes quick and easy to use. Time & Weather will be rolled randomly. You just need to follow a structure of prompting as presented below.

In practice, it becomes much easier than it seems. Look at the attached examples. That's literally all you need:

Custom Scenarios

In addition to all the prepared conditions to choose from, you can always just describe the fully imagined scenario in a plain language. It will work exactly the same - assuming that you keep it clear, strict and you go with simple instructions. Something like: “I am driving a car, you are sitting next to me, we are escaping Yakuza on a highway in Tokyo”. Proper entries in the embedded lorebook will be triggered to prompt the LLM to write a starting message based on your scenario. You just need to use the particular trigger words:

SCENARIO: description or SCENE: description or CUSTOM: description

TTRPG Mode

If you are using my SillyTavern presets, you can also use a TTRPG mode - so you are not a character in the roleplay but a game master - deciding where story goes and what happens. {{char}} will just follow your instructions. It is for those who are GM’ing the actual TTRPG games or for those who would like to try. Use simple trigger word:

TTRPG

Presets (SFW & NSFW)

If you do not want to think at all (or you are paralyzed by abundance of options), just pick up one of the SFW or NSFW presets with a more fleshed out scenario. LLM will generate the starting message for you - just like it does if you pick up the options manually.

Starting Messages

Default Starting Message (1/6): generic message to set-up a formatting and character’s way of speech - this is where you roleplay, this is where you type the trigger words in a standard chat window.

Swipe Left (6/6): list of scenes (premade scenarios) & optional conditions.

Swipe Left Again (5/6): list of locations.

Swipe Left Again (4/6): list of Presets (predefined SFW & NSFW roleplay scenes).

Swipe Left Again (3/6): list of clothes & the unique clothing system: Sphiratrioth's Boutique! Over 300 clothing pieces available for both male & female characters.

Swipe Right from a Default Message (2/6): quick-starter - generic scene to go anywhere without setting up anything, you can also roleplay here but do not add nor roll anything - it is just the standard, old-school roleplay with what is already in a character card - boring but good when you do not want to think about literally anything and just spend day with a character.

Tips & Tricks

• always roleplay in the default starting message - edit it to match the character’s personality better or just leave it the way it is. If you edit it personally, just remember that it needs to include a suggestion of roleplaying - so the LLM understands instructions from a lorebook properly and generates the actual starting message for a roleplay.
• all the BASIC set-up parts may be rolled or selected: SETTING, SCENARIO, LOCATION, USER LOCATION;
• most important BASIC set-up parts come with so called “quick triggers” aka the first letters of their words or two first letters to distinguish between them and prevent errors. A whole system works best with quick triggers and they are very easy to remember: SETTING: choice = S: choice, SC: choice has no full word option, LOCATION: choice = L: choice, USER: choice = U: choice.
• Fantasy, Cyberpunk & Sci-Fi scenarios do not come with quick triggers though. Select specific genre & NSFW scenarios with their separate category as a trigger word: FANTASY: choice/roll, SCIFI: choice/roll, CYBERPUNK: choice/roll, NSFW: choice/roll, HORROR: choice/roll.
• however, all of those additional genre scenarios may be treated as standalone scenes - you do not necessarily need to select the basic scenario to work with them - they will work on their own but a choice of location is highly advised whatever and wherever you do.
• scenarios cannot be triggered with a full word “scenario” but only with a quick trigger because the system needs a different trigger word for a custom scenario. I could go with consistency or convenience here. In testing, it turned out that people prefer triggering the custom scenario with a full word scenario and the scenarios from lists with quick triggers. Thus - use SC: choice for set-up scenarios of any kind, use SCENARIO: description for your fully custom scenarios.
• time & weather will be rolled automatically;
• ADDITIONAL CONDITIONS, such as relationship with {{user}} or {{char}}’s residence, sexuality etc. may be added optionally - they determine the things you may want to “swap” between the roleplays; of course, you can also decide those things in the character definitions - then, they become fixed.
• outfits & personal clothes/custom clothes come with quick triggers - namely O: choice, PC: choice, CC: choice. They are defined in a lorebook - so you can find the entries (around entry no. 615 in SillyTavern lorebook editor) - and then - trigger them for different scenes. Of course, you can just ignore the whole outfits system and define the outfit under character’s definitions as a fixed outfit for all the scenes.
• for numbered entries, you need to use double digit formats aka 05 instead of 5 etc. (technical limitation of trigger words);
• you need to always use a trigger or a quick trigger with a : sign and a space afterwards aka SC: choice, OUTFIT: choice etc.

Character Generator

As I said, I am working in game-dev and I will tell you one thing: characters in all the movies, games, books & roleplay scenarios are very simple. Seriously. There are between 10 and 20 typical archetypes, which cover all the possible personalities of all the memorable heroes, villains, NPC & support characters. Here, I provide you with presets that I am using at work - so - feel free to just describe your character's personal information, background, hair color and eyes color and then - use one of those presets to match their personality & body type. Personality comes with adjusted quirks, likes & dislikes. Body types come with a type of skin - light, tanned, dark. It really works and the descriptions are tailored for LLMs to roleplay those personalities perfectly. List includes 20 classical archetypes that match almost all the characters from all the genres. I assure you that you will find the archetype from the list, which matches the personality you want the existing character to have. Seriously - give it a try.

Hero/Heroine

Intelligent/Wise/Mentor

Cheerful

Laid-Back Tease

Seductive Tease

Serious (Supportive)

Motherly/Fatherly (Supportive)

Tomboy/Neighborhood Dude

Funny

Arrogant

Tsundere

Observer (Introverted)

Tired (Introverted)

Rebel/Delinquent

Villain/Villainess

Idol

Dark Hero/Heroine

Workaholic

Lazy

Slut

Detailed personalities, unique quirks, likes, dislikes, behavioral instructions for LLM on how to roleplay them. Trigger those presets like any other conditions - with trigger words: "PERSONALITY: choice", "P: choice" or "P: roll" and everything will be inserted right after the character's definitions in a character card. Body is triggered with a type of skin followed by body type aka "BODY: light/tanned/dark (followed by) petite/slim/curvy/fit/voluptuous" or "B: choice" or "B: roll". Additional conditions, such as relationship with {{user}}, sexuality, residence or mood may be still used normally together with a body & personality injector. It is the actual character generator built-in the embedded lorebook! Enjoy!

What is included?

Lorebook includes different options for you to choose and craft the roleplaying scenarios in SillyTavern chat.

Situational Conditions

Setting

Locations

Scenarios

Clothing System

- 5 Personal Clothing/Custom Clothing presets in the lorebook - you can find them and edit them manually in a lorebook for each character to pick them up later for a given roleplay (last 5 entries of the lorebook as counted by UID so around entry 615 in lorebook editor in SillyTavern (it cannot be helped, sorry, technical limitations of UID/order management of entries in such a massive project); - “Sphiratrioth’s Boutique” - you pick up the outfit TOP or the outfit BOTTOM as the main clothing style piece, you can also pick up a particular color, and the rest of outfit will be automatically adjusted to match that particular clothing piece. No crazy outfits will be generated.

It should look like this:

Female Clothes

Male Clothes

Character Creation:

All of my cards (and the embedded lorebooks) use a custom character template, which has been tested by more than 200 people of different genders already and the reports say that it works great with different models available. Personally, I can assure you that it works well with this particular method of injecting different parts into the context of the roleplay. Additionally - I also made a character generating prompt - which will auto-generate the characters for you in the API interface of your choice - such as Mistral Le Chat, GPT, Gemini etc. Take a look yourself (https://huggingface.co/sphiratrioth666/Character_Generation_Templates)

How is it even possible?!

This method inserts the instructions in a template {{"TAG"}}:{INSTRUCTION} into the context, at different depths, sometimes with a "sticky" parameter on - so the information such as clothes or a relationship with user stays in context forever, sometimes at depth 0 as system instructions aka "OOC on steroids", which is deleted from context when not needed anymore - like instructions to generate the starting message. You will not see the instructions nor information injected into the context in chat, so if you want to check what's happening underneath the hood, you perform a context inspection. You can do it easily in SillyTavern.

How to create your own characters in SX-3:

1. Download the MAN & WOMAN template lorebooks.
2. Import them into SillyTavern & clone them under a desired name.
3. Edit the clothing sets & entries that generate the messages. Use simple instructions - where {{char}} and {{user}} are, what's happening. Do not overdo it. Think of it as painting a picture for the starting message only - not the real scenario.
4. To add details, edit the entries that inject the "scenario" part into the context. There, you can add more instructions - like what's gonna happen - for instance, what kind of monster will live under the bridge. A red hot chilli pepper monster, a kappa or whatever you want.
5. Use the character edit options in SillyTavern to detach the linked (embedded) lorebooks and link (embed) your own.
6. Modify or delete REGEX (scoped). It exists so you can use a placeholder in the card's name - like - Sith warrior, Jedi Master - but auto-replace it with the actual {{char}}'s name in the chat. It is a subjective choice. I like having the archetype in the card's name but sadly - SillyTavern does not support it properly - thus - REGEX. Check on what the current antries do - they basically change what's in the brackets and the name. Brackets are deleted, name is replaced with the intended {{char}}'s name.

UPDATES

v.3.1

character generator in a card: 20 personalities, 5 body types, 3 skin colors, new instructions for LLM & new guides in character's card description

cleaned up trigger words (Slice of Life changed to DRAMA, added quick trigger: (Drama = D), new triggers & quick triggers for body & personality, new quick triggers for relationship state, weather, time & horror scenarios)

time & weather also selectable in custom scenarios - with triggers & quick triggers (but automatically rolled for normal scenarios & presets, just the way it was)

additional "slow burn" instructions for horror scenarios (so the monster is not introduced that fast and the atmosphere build up lasts for a couple of messages)

fixed some relationships (villainess/villain changed to neighbor - because villain/villainess is now a personality if you want it)

added more compatibility in lorebook instructions for the newest Mistral Small 3.1 with V7-Tekken template (it should not break Chat ML when tunes utilizing that hellish template appear, I've tried making it future-proof but it works much better with Mistral templates and Chat ML sucks anyway - subjectively :-P, while Drummer's Mistral tunes work well with Mistral templates, thankfully, even if he prefers training them on Chat ML)

v.3.1a (hotfix)

control lorebook: TTRPG - resolution mechanics like in a TTRPG game - success/failure at 50% chance - triggered with: "DC"

control lorebook: Horny Control - counter over-horniness - two modes available (read the lorebook)