ʜᴀʀᴅᴄᴏʀᴇ ᴘʟɪꜱᴛ/ꜱʙꜰ ɢᴜɪᴅᴇ
Cooking in Hell's Kitchen™ Edition
Citations: .trappu's PList guide absolutetrash's bot creation guide
Quick Start Resources
- Single Character Template
- Multiple Character Template
- Scenario Template
- JanitorAI Frontend Settings
- Advanced/Custom Prompts
- Common LLM Trait Stereotypes (Infographic version)
- Generation Parameters/Settings (ELI5)
Core Concepts
Basic Rules
- Include a space after dashes and colons
- Omit spaces before semicolons
- Place descriptors in parentheses
- Insert commas between multiple items
Delimiter Guide
Delimiter | Format Rule | Purpose | Example |
---|---|---|---|
[ and ] |
Wrap entire PList; no line breaks between brackets and content | Contains all character information | [- Name: John ... ] |
- |
Start each category, space after | Improves JLLM processing and readability | - Age: 25; |
: |
Follow category name, space after | Separates category name from content | Name: John |
; |
End each category, no space before | Marks category end | Hobby: painting; |
( and ) |
No spaces after opening or before closing, can nest | Adds/Reinforce contextual and descriptive details | tall(6'2") , nervous(childhood trauma(bullying)) |
, |
Space after; between items | Separates list items or traits | Hobbies: reading, writing, art; |
Capitalization | Optional for categories, just keep it consistent | Aids identification | Name: , Age: , Personality: |
Why Bullet Points?
While not required, bullet points offer several advantages:
- Enhanced chatbot processing
- Clear, structured details
- Consistent formatting
- Token efficiency
- Easy updates
- Logical grouping
- Clear relationship mapping
See also: PList/SBF vs. Natural Language.
Machine Readability
Parser-Friendly Guidelines
- Limit descriptions to 2-3 descriptors
- Keep descriptions concise
- Use logical grouping
- Maintain consistent structure
How Many Descriptors Are Too Many?
Depends on which LLM you're using, but we'll stick to the general principle of "shorter is better." These thresholds should be taken as general guidelines rather than strict rules.
- 5+ words: Reduces parsing efficiency
- 7+ words: Impairs scanning ability
- 10+ words: Disrupts logical flow
Format Examples
Structure Comparison
❌ Wrong | ✅ Right |
---|---|
* name: John Smith | - Name: John Smith; |
- age:25 | - Age: 25; |
Descriptor Length Comparison
❌ Wrong | ✅ Right |
---|---|
- Personality: kind(always helps others no matter what and goes out of their way...) | - Personality: kind(puts others first, self-sacrificing); |
TL;DR
Long descriptors risk being ignored. LLMs filter out complex or excessive information as processing noise.
Category System
SFW
- Basic Info: Name, Age, Gender, Ethnicity
- Appearance: Appearance, Hair, Eyes, Clothes
- Personality: Personality, Habits, Flaws, Quirks
- Background: Occupation, Hobbies, Likes, Dislikes
NSFW
- Kinks
- Behavior During Sex
- Genitalia
Difference Between Kinks & Behavior During Sex
Kinks | Behavior During Sex |
---|---|
Sexual interests or fantasies | Actions done during sex |
Personal desires | Physical or emotional acts |
Often recurring preferences | Can change with mood or partner |
BDSM, role-play, fetishes, etc... | Kissing, specific positions, etc... |
Can have emotional or symbolic meaning | Usually more practical or spontaneous |
Genitalia (and secondary sexual characteristics)
AFAB | AMAB |
---|---|
Vulva, clitoris, vagina | Penis, scrotum |
Uterus, ovaries | Prostate, seminal vesicles |
Breasts | Facial hair |
Wider hips | Broader shoulders |
Less body hair | More body hair |
Efficiency
Token Management (150-token framework)
Core (50 tokens)
Focus on character foundation.
Depth (60 tokens)
Build depth and interaction patterns. Pair visible traits with underlying motivations.
Details (40 tokens)
Add richness and context by revealing motivations, behaviors, and backstories.
TL;DR
While being concise is important, being too vague with character details can create inconsistencies if you have a specific backstory in mind. Creating clear connections between backstory elements, personality traits, and behaviors helps the AI maintain a more consistent and believable character. This structured approach to character definition helps maintain characterization throughout roleplay sessions, as the AI has clearer guidelines for character behavior and motivation.
👍 Good | ✅ Better |
---|---|
- Personality: brave, kind, helpful, caring; | - Personality: brave(mentor's legacy, contrast to past), kind(unseen personal cost, inspired by own hardship), helpful(fear of abandonment), caring(fawn survival mechanism); |
- Background: military, trauma; | - Background: military(compartmentalized emotions, combat PTSD), trauma(drives empathy); |
- Quirks: smokes, drinks coffee; | - Quirks: smokes(habit from highschool, memory of youth), drinks coffee(Turkish heritage, grounding ritual); |
- Occupation: doctor(works in hospital, treats patients) | - Occupation: doctor(emergency medicine, prior combat field experience) |
𝑫𝒐𝒎𝒂𝒊𝒏 𝑬𝒙𝒑𝒂𝒏𝒔𝒊𝒐𝒏™
Barrier Advanced Techniques ༼✷ɷ✷༽
Trait Chaining
ICARUS TERRITORY
Don't exceed 3 levels of nesting.
Contextual Responses
- Category: base state, trigger(response(immediate action, follow up));
Master Categories
A master category is like a label on a file folder - it tells you what's inside before you open it.
Basic Structure
Examples
- Single Character:
- Group Information:
- Scene Setting:
- Tracking Game Status
- Showing Relationships
When to Use Them
- Managing several characters
- Organizing group info
- Setting up scenes
- Showing connections
Troubleshooting
Issue | Error | Correction | Why/Solution |
---|---|---|---|
Nested confusion | Team Alpha[ |
[Team: Alpha:...; Beta:... |
Add : between nested levels |
Category bleed | Multiple categories in one PList | Separate PLists | Use distinct PLists for different category groups |
Content mixed up | Category info bleeding into others | Clear category boundaries | Ensure each category is properly closed with ; |
When to Start Fresh
- More than 3 nested levels
- Very similar categories
- Mixed information
- Unclear boundaries
GOAL:
Making your life easier, not harder. If they're causing confusion, break details into their own categories to avoid excessive nesting!
Complete Character Examples
The Professional
The Creative
The Counselor
Final Checklist
Format Rules
- Use square brackets around everything.
- Semicolons and commas in the right places.
- Descriptors in parentheses.
Quality Standards
- Each detail shows behavior, motivation, or backstory.
- Character traits fit together logically.
- Relationships are clear.
- Tokens are used efficiently.
Change Logs
Date | Change | Reason | Notes |
---|---|---|---|
20 NOV 2024 | Category capitalization now optional | Improves trait association due to LLM training patterns | Trappu's full notes |
20 NOV 2024 | Master categories now nested in [ ] |
Reduces redundancy and improves cohesion | Keep SBF list as single cohesive unit |
20 NOV 2024 | Added complete examples | Better demonstrates instructions | |
24 NOV 2024 | Efficiency TL;DR | Clarification and adds rationale | |
24 NOV 2024 | Quick Start Resources | Added Generation Parameters/Settings (ELI5) |