Capri Desktop mods & skins
Skins, outfits, colour sets, game skills and code mods: where to find them, how to install them, what is safe and how to publish your own.
- Mods window since 0.8.3
- Skins on every platform
- Code mods: Windows
Since 0.8.3 Capri has a Mods window with its own directory: previews, downloads, ratings and one-click installs. Mods change her settings, her look, what she knows about a game, or, with code mods, what she can do. Everything here comes from the README, the release notes and the capri-mods repository.
Open the Mods window
- Open the Capri Mainframe (right-click Capri or the tray icon).
- In the CAPRI band, press Mods, then Browse mods.
- Pick a mod to see its preview and rating, and install it with one click. Your installed mods can be searched by name or author.
The five kinds of mod
| Kind | File | What it does |
|---|---|---|
| Settings mod | .capri-mod | Changes only her settings. Works on Windows, Mac and Linux. |
| Skin | .capri-skin | Changes how she looks: outfits, hair, effects. Works everywhere; skins with their own idle keep it. |
| Colour set | mod | Recolours her. Make your own with Hair, Accents, Eyes, Edges or Body on the Mods page. |
| Skill | mod (0.8.4) | Know-how for one game that she follows whenever she plays it, on every platform. |
| Code mod | .capri-code | Runs code on your PC, so she asks before one runs and again if it is edited. Windows only for now. |
Skins and outfits
Skins are the closest thing to custom outfits. The directory listed these in the release notes for 0.8.4 and 0.8.5:
- Outfits: Maid Suit (Vocyn), Business Suit, Arasaka, MaxTac, Santa Hat in Black and Crimson.
- Hair and effects: Cat Ears, Halo, Neon Sign, Sakura, Galaxy Hair (Aurora, Ember, Nebula), Fire (Blaze, Bluefire, Witchfire).
- Vocyn’s colour skins: Aurora Borealis, Cherry Blossom, Deep Sea and Ember.
Her new 24 fps stand in 0.8.6 broke some skins; Settings › CAPRI › Legacy stand brings back the 0.8.5 stand straight away, and colour mods work on both. Skins that carry both stands are an open request (#212).
The nine starter mods
0.8.3 shipped nine mods, all by Vocyn: four colour sets (Bubblegum, Cyber Cyan, Royal, Toxic), Custom Names, Sharper Ears, Hearing Log, Hello Code and Startup Intros. Startup Intros has three intros, Hijack, Shatter and Wake: say “intro shatter” to lock one in or “intro shuffle” to mix them.
Skills and code mods
Skills arrived in 0.8.4: a skill is know-how for a game she follows whenever she plays it. The first was Lachy’s BTD6 plan, with tower picks and a round-by-round guide for Bloons TD 6. Since 0.8.6 she plays a game until you stop her, so a skill matters more.
Code mods added in 0.8.5 include Issei’s Holocall, Desktop Weather, Dice & Decider, Sleep Timer, Touch Grass, Voice Trivia, Potato’s Wardrobe and Mirit0’s MK001 Dice Roller. They run code on your PC and are Windows only. More hooks for them (mod API 3) are being discussed in #182 and #179.
Recolour her yourself
On the Mods page press Hair, Accents, Eyes, Edges or Body and pick colours. She saves the result as a My Colors mod you can share. The Mainframe itself has colour themes too since 0.8.4: Night City, Black, White or Grey under Settings › CAPRI › Mainframe colours.
Change her personality
Her character lives in personality.md: Settings › YOU › Her personality › Edit personality.md, or the File editor in 0.8.6. Reset to her default puts her back. Her safety rules are not in the file; they are fixed in her code, and the project asks people building on her to keep them. A pull request can suggest a change to her default for everyone.
Share your own mod
- Fork lachydotmcg/capri-mods on GitHub.
- Add a folder with the mod file, a README and a
preview.png. - Open a pull request. Every mod is checked for malware before it goes up. The full format and code mod API are documented at capriai.app/mods.
Frequently asked questions
How do I install Capri Desktop mods?
Press Mods in the CAPRI band of the Capri Mainframe, then Browse mods. The directory shows previews, downloads and ratings; one click installs a mod. You can also import a mod file you were given.
Can I change Capri’s outfit?
Yes, with skins (.capri-skin). The directory includes outfits such as the Maid Suit, Business Suit, Arasaka, MaxTac and Santa Hat, plus hair and effect skins like Cat Ears, Halo, Galaxy Hair and Fire. Since 0.8.6, if a skin breaks with her new stand, Settings › CAPRI › Legacy stand brings back the old one.
Are Capri mods safe?
The project says every mod in its directory is checked for malware before it goes up. Settings mods and skins cannot run code. Code mods can, which is why Capri asks before running one and again after any edit. Only import mod files from people you trust.
Can I change her personality?
Yes. Edit personality.md from Mainframe › Settings › YOU, or with the file editor added in 0.8.6. Her safety rules are fixed in her code right after the personality and are not part of the file. Personality mods for the directory are a feature request (#203).
Do mods work on Mac and Linux?
Mac and Linux get the Mods window, the directory, settings mods, colour sets, skins and skills. Code mods are Windows only for now.
How do I publish my own mod?
Fork lachydotmcg/capri-mods, add a folder with the mod, a README and a preview.png, and open a pull request. The mod documentation at capriai.app/mods/ covers every kind of mod, the file formats and the code mod API.