Skip to content

Commit bd1312c

Browse files
Minor adjustments
1 parent 6b7fcf7 commit bd1312c

5 files changed

Lines changed: 397 additions & 404 deletions

File tree

docs/slp/api-reference.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -745,6 +745,6 @@ endIf
745745

746746
## Additional Resources
747747

748-
- See [SexLabThreadHook.psc](../environment-setup/) for blocking hook implementation
749-
- See [SLSB Scene Format](/slsb/converting-animations/) for animation definitions
748+
- See [SexLabThreadHook.psc](https://github.com/Scrab-NSFW/SexLab/blob/animation/Source/Scripts/SexLabThreadHook.psc) for blocking hook implementation
749+
- See [Converting Animations](/slsb/converting-animations/) for animation definitions
750750
- Visit the [Discord](https://discord.gg/JPSHb4ebqj) for API support

docs/slp/why-pplus.md

Lines changed: 78 additions & 58 deletions
Original file line numberDiff line numberDiff line change
@@ -6,99 +6,119 @@ permalink: /slp/why-pplus/
66

77
# Why Choose SexLab P+?
88

9-
Already using vanilla SexLab and wondering why you should switch? This guide explains the improvements and answers common migration concerns.
9+
Already using vanilla SexLab and wondering why you should switch? This guide explains the practical improvements and answers common migration concerns.
1010

1111
---
1212

13-
## The Problems with Vanilla SexLab
13+
## Quick Comparison
1414

15-
Vanilla SexLab, while revolutionary for its time, has significant limitations:
15+
For a detailed feature-by-feature comparison, see [Feature Comparison](../comparison/).
1616

17-
### Performance Issues
18-
- **Slow animation registration** - Loading animations takes a long time
19-
- **Scene startup delays** - Noticeable pauses when starting scenes
20-
- **Script lag** - Heavy Papyrus load during scenes
17+
### The Main Differences
2118

22-
### Technical Limitations
23-
- **1000 animation cap** - Can't register more than 1000 human + 1000 creature animations
24-
- **Manual registration** - Must register animations through MCM each game
25-
- **Settings tied to saves** - MCM settings don't persist across saves
26-
27-
### Maintenance
28-
- **Requires addon mods** - Need SLSO, SLAS, etc. for common features
29-
- **Outdated codebase** - Harder for mod authors to work with
19+
| Aspect | Vanilla SL | SLP+ |
20+
|--------|-----------|------|
21+
| **Animation Registration** | Manual in MCM, ~5-10 min per pack | Automatic at startup, instant |
22+
| **Animation Limit** | 1000 human + 1000 creature | Unlimited |
23+
| **Settings Persistence** | Per-save only | Save-agnostic (auto-loads all saves) |
24+
| **Required Addon Mods** | SLSO, SLAS, SLGP, etc. | Built-in equivalents |
25+
| **Setup Effort** | High (configure each save) | Low (configure once) |
3026

3127
---
3228

33-
## What P+ Fixes
29+
## Common Migration Concerns
3430

35-
### Improved Performance
31+
### "My current setup works fine"
3632

37-
| Operation | Vanilla SL | SexLab P+ |
38-
|-----------|-----------|-----------|
39-
| Animation Registration | Minutes | Near-instant |
40-
| Scene Startup | Noticeable delay | Immediate |
41-
| Animation Search | Slow | Extremely fast |
33+
It probably does! But you may be missing benefits:
4234

43-
P+ completely rewrites the registration and animation systems for modern performance.
35+
- **Automation** - No more MCM registration clicking per save
36+
- **Settings persistence** - Configure once, apply to all saves automatically
37+
- **Unlimited content** - More animation packs without technical limits
38+
- **Less addon dependency** - P+ includes features previously requiring 4+ separate mods
4439

45-
### Unlimited Animations
40+
### "Will my other mods break?"
4641

47-
P+ removes the animation limit by itself. The only limit is Skyrim's engine.
42+
**Most mods work fine with P+.** Backwards compatibility is maintained for:
43+
- Scene detection events (HookAnimationStart, HookAnimationEnd, etc.)
44+
- API calls for starting scenes (StartScene, StartSceneEx, etc.)
45+
- Animation tag filtering and selection
46+
- Third-party mod compatibility hooks
4847

49-
> **Note:** Mods using the legacy API (sslBaseAnimation) are still limited to accessing the first 1000 animations. Most modern mods work with the full library.
48+
**Exceptions exist** - See [Incompatible Mods](../incompatible-mods/) for specific conflicts and workarounds.
5049

51-
### Automatic Everything
50+
### "What about my animations?"
5251

53-
- **Auto-registration** - Animations register at game startup, no MCM clicking
54-
- **Persistent settings** - MCM configuration is save-agnostic and auto-loads
55-
- **No maintenance** - Set it up once, forget about it
52+
Your SLAL packs work with P+ using **SLSB conversion patches**:
53+
- **Good news:** Most popular packs already have conversions available
54+
- **How it works:** Install both the original SLAL pack (for meshes) and the conversion patch (for registration)
55+
- **Easy:** Just drop files in your mod manager, restart game
56+
- **Automatic:** No MCM registration needed
5657

57-
### Built-in Features
58+
See [Animation Packs](../animation-packs/) for available conversions or [Converting Animations](../../slsb/converting-animations/) to create your own.
5859

59-
P+ includes functionality that previously required separate mods:
60+
### "Will I lose my MCM settings?"
6061

61-
| Built Into P+ | Previously Required |
62-
|---------------|---------------------|
63-
| Separate Orgasm logic | SLSO |
64-
| Fast animation search | SLAS |
65-
| Grass clipping fix | SLGP |
66-
| Smooth expressions | SL Smooth Expressions |
62+
Yes, you'll need to reconfigure. However:
63+
- P+ uses a different settings format (`Settings.yaml` instead of `SexLab.ini`)
64+
- **Better:** Your settings auto-save and persist across all saves automatically
65+
- **No more setup per save:** Configure once, apply everywhere
66+
- **Easier:** You won't have to redo settings for each new playthrough
6767

68-
---
68+
See [Settings Reference](../settings-reference/) for all available options.
6969

70-
## Common Migration Concerns
70+
### "Is there a risk switching between versions?"
7171

72-
### "My current setup works fine"
72+
**Low risk if you follow migration steps:**
7373

74-
It probably does! But you may not realize what you're missing:
74+
1. Complete your current playthrough on vanilla (or backup that save)
75+
2. Create a completely new save after installing P+
76+
3. Your existing vanilla saves will still work if you reinstall vanilla
7577

76-
- You might be experiencing script lag you've normalized
77-
- Your animation slots might be nearly full
78-
- You're maintaining multiple mods that P+ consolidates
78+
We recommend **testing on a new character first** to ensure compatibility with your other mods before committing a main playthrough.
7979

80-
### "Will my other mods break?"
80+
---
8181

82-
**Most mods work fine.** P+ maintains backwards compatibility for:
83-
- Scene detection events
84-
- API calls for starting scenes
85-
- Animation tags and filtering
82+
## What P+ Includes (Built-in)
8683

87-
See [Incompatible Mods](../incompatible-mods/) for the known exceptions.
84+
P+ consolidates functionality that previously required separate mods:
8885

89-
### "What about my animations?"
86+
| Feature | Vanilla SL | SLP+ | Previously Needed |
87+
|---------|-----------|------|-------------------|
88+
| Separate Orgasm System | Manual SLSO mod | Built-in | [SL Separate Orgasm](https://www.loverslab.com/files/file/5929-sexlab-separate-orgasm-se/) |
89+
| Fast Animation Search | Manual SLAS mod | Made redundant | [SLAS](https://www.loverslab.com/files/file/25350-slas-sexlab-anim-searcher/) |
90+
| Grass Clipping Fix | Manual SLGP mod | Made redundant | [SLGP](https://www.loverslab.com/files/file/25455-slgp-sexlab-grass-patch/) |
91+
| Smooth Expressions | Manual mod | Built-in | [SL Smooth Expressions](https://www.loverslab.com/files/file/31585-sexlab-smooth-expressions/) |
9092

91-
Your SLAL packs will need **SLSB conversion patches**. The good news:
92-
- Most popular packs already have conversions available
93-
- The conversion process is automated for pack developers
94-
- You install both the original pack (for meshes) and the conversion patch
93+
---
9594

96-
### "Will I lose my MCM settings?"
95+
## Getting Started with P+
9796

98-
P+ uses a different settings system, so you'll need to reconfigure. However, once set up, your settings are saved to `Settings.yaml` and persist across all saves automatically.
97+
Ready to switch? Follow these steps:
98+
99+
1. **Backup your saves** - Always keep backups before major mod changes
100+
2. **Install P+** - See [Installation](../installation/) guide
101+
3. **Convert your animations** - Install SLSB conversion patches (or convert them yourself)
102+
4. **Configure MCM** - Set up your preferences (you only do this once!)
103+
5. **Test on a new character** - Verify everything works before committing
99104

100105
---
101106

107+
## Still Have Questions?
108+
109+
- **General help** - Check [FAQ](../../faq/)
110+
- **Technical issues** - See [Troubleshooting](../../troubleshooting/)
111+
- **Live support** - Join the [Discord](https://discord.gg/JPSHb4ebqj)
112+
113+
---
114+
115+
## See Also
116+
117+
- [Feature Comparison](../comparison/) - Detailed feature-by-feature breakdown
118+
- [Installation Guide](../installation/) - Step-by-step setup
119+
- [Incompatible Mods](../incompatible-mods/) - Known conflicts
120+
121+
102122
## What You Gain
103123

104124
**Performance** - Dramatically faster in all operations

0 commit comments

Comments
 (0)