Modhold
Skyrim SE
Get Pass Join
ToolFreeMade without the Creation Kitv1.6

ROLLO - Outfit Management System

A System for distributing outfits across skyrim, and having NPC change outfits automatically, comes with Outfit Creator, with live preview, Generate Outfit collections for patches, SPID, SKYPATCHER, see the outfit as you make it, Collection

Reaper3 @reaper1369
Sign in to download One-click install into MO2 and Wabbajack with the free Modhold app. Get the app
Add to loadout Report
Share
X Facebook Reddit

Sign in to get 25 XP when someone opens your link.

0Unique downloads
0Downloads
2Views
1Vouches
10.01 scoreScore
ROLLO - Ultimate Outfit Distribution System
Build an NPC database from your own load order, organise outfits into collections, and create an outfit patch (ESP, SPID or SkyPatcher) for the NPCs you choose.
READ THIS FIRST
  • ROLLO is an early test version (0.1.0). Use it on a COPY of your profile first.
  • Disable any old ROLLO NPC plugins (the old ROLLO NPC ESPs - not the _Collection plugins) before you run NPC LOOKUP. Otherwise their NPC records are stored as well and old ROLLO plugins can end up as masters of your new patch.
  • ROLLO never modifies your plugins. It reads them, keeps its own database, and writes only the patch files you ask for, into the folder you choose.
  • The patch files (ESP / SPID / SkyPatcher) have been checked numerous times, but mistakes can happen. Open the result in xEdit and test in game before you trust it with a long playthrough.
  • Skyrim Special Edition / Anniversary Edition plugins only for patch writing (form version 44).
  • Windows 10 / 11, 64-bit.
WHAT ROLLO DOES
  1. NPC LOOKUP - scans every enabled plugin in your load order and stores every actor (NPC) in a local database: name, race, class, factions, stats, inventory, default outfit and more. It also records every plugin that has a record for the NPC and which one wins the load order. The database keeps a complete copy of each record, so the patch never has to re-read your plugins.
  2. NPC VIEW / EDIT - filter and browse the database (Hold, Sub-hold, Race, Class, Gender, Age, Follower, Profession, Noble) and edit an actor's details in ROLLO's database.
  3. COLLECTIONS - organise outfits into collections, either Default Outfit Collections or Sleep Outfit Collections. Import old-style "_Collection" plugins, share collections as small text files, rename and edit outfits.
  4. CREATE OUTFIT - build a new outfit from armour pieces, with 3D previews (male and female).
  5. CREATE PATCH - define "expressions" (which NPCs get outfits from which collections) and write a patch: a full ESP, or an outfit-only ESP plus a SPID or SkyPatcher distribution file. Optionally NPCs change clothes every few days (outfit rotation).
  6. SETTINGS - folders, patch options, interface themes.
REQUIREMENTS
  • Skyrim Special Edition / Anniversary Edition (the NPC database also reads LE and VR plugins).
  • Windows 10 or 11, 64-bit. A graphics card with Direct3D 11 is recommended for the 3D previews; without one ROLLO draws them on the processor.
  • Mod Organizer 2 is the tested setup (see Installation). Other managers work if your Data folder contains your mods.
  • For SPID mode: SPID (Spell Perk Item Distributor) and SKSE. For SkyPatcher mode: SkyPatcher and SKSE.
  • No internet connection is used by ROLLO.
INSTALLATION
  1. Download and extract ROLLO anywhere you like (for example C:\Tools\ROLLO). It is a single standalone program: ROLLO.exe. Nothing is installed into Skyrim.
  2. Mod Organizer 2 users (important): add ROLLO.exe to MO2's executables and START ROLLO FROM MO2. This lets ROLLO see MO2's virtual Data folder, which contains the files of all your enabled mods. This is how the 3D previews find the meshes and textures.

    [list]
  3. In MO2 click the executables drop-down (gear icon) > Edit... > + > Add from file...
  4. Choose ROLLO.exe, give it the title ROLLO, press Apply, then run it from the executables drop-down.
  • Other managers (Vortex etc.): start ROLLO normally and use your real Skyrim Data folder.
  • To uninstall, delete the ROLLO folder and, if you want to remove its data, the folders %APPDATA%\ROLLO and %LOCALAPPDATA%\ROLLO.
[/list]
FIRST START
When ROLLO starts and a folder is missing, a short setup asks for the following. You can change all of it later in SETTINGS.
  1. Profile folder - the folder that contains loadorder.txt. For MO2 this is ...\profiles\<your profile name>. ROLLO refuses a folder without loadorder.txt.
  2. Skyrim Data folder - the game's Data folder (the one that contains Skyrim.esm). This is also the folder ROLLO uses to find meshes and textures for the 3D previews.
  3. MO2 mods folder (optional) - normally found automatically from the profile folder (...\mods).
  4. Output folder (optional) - the default place where patch files are written.

If you cancel, ROLLO opens SETTINGS with a note instead. Nothing is saved until the profile folder has been chosen.

How ROLLO reads your load order: the order comes from loadorder.txt, enabled/disabled from plugins.txt in the same folder, and plugin files are found through modlist.txt (MO2) and then the Data folder. The official masters are always enabled. Creation Club plugins listed in Skyrim.ccc (in the folder above Data) are treated as enabled, as the game does.
1. NPC LOOKUP
Press NPC LOOKUP in the top row. Two scan buttons are on this page:
  • OVERWRITE - reads every enabled plugin and replaces the stored records of each plugin it reads. Use it the first time, after you change your load order, and after you change the exclusion lists. One plugin at a time is stored, all-or-nothing: a plugin that cannot be read keeps its previous data. At the end, plugins that are no longer enabled are removed and the winning record is recomputed for every NPC.
  • UPDATE - only adds NPCs that are new (a new originating plugin + FormID). NPCs already stored are skipped and none of their data changes, including your edits. Fast (seconds).
Vanilla, DLC and Creation Club plugins keep their names in string tables inside archives; ROLLO reads those while scanning and stores the real name, so these NPCs show their names too.

The status bar at the bottom shows NPCs:, Outfits: and Collections:. These are real counts from your database and are blank until there is data. During a scan the NPC count rises as actors are stored. CANCEL stops safely and only discards the plugin that was being read.

What is NOT added (applied while reading):
  • With the Settings option Only add NPCs of playable races on (default), creatures, ghosts, dogs, vampire variants and other non-playable races are left out.
  • Blacklists (editable in EDIT LISTS): blacklisted factions, races (Editor ID, Prefix* or plugin.esm|HEXID) and actors.
  • If an NPC is refused, its overrides in later plugins are refused too.
What is stored for every NPC record: Editor ID, name, race, flags and stats, factions with rank, keywords, inventory, default and sleep outfit, class, skin, template, voice, face/body data (head parts, tints, morphs), and the complete original record so nothing is lost.

Note: localized names are read from loose or archived .STRINGS tables (English). If a name cannot be found, the NPC shows its Editor ID only.
2. NPC VIEW / EDIT
Open it with the NPC VIEW / EDIT button on the NPC LOOKUP page.
  • Filters: Hold (Whiterun, Solitude, ...), Sub-hold (Riverwood, Rorikstead, ...), Race, Class, Gender, Age (Adult / Child), Follower, Profession, Noble, plus a text search (name or Editor ID). The list shows FormID, Full Name, Editor ID, Plugin, Race and Profession. Click a column header to sort by it: the first click sorts ascending, a second click on the same header descending. A FormID shown as "--" followed by six digits means the NPC's plugin has no slot in the active load order (disabled or missing); the status line under the list names those plugins.
  • Edit an NPC: click an actor. The edit window shows everything saved for it. You can change the name, level and calc range, speed, disposition, health / magicka / stamina offsets, bleedout, the Female / Essential / Unique / Protected / Respawn flags, race, class, default outfit, sleep outfit, profession, the noble flag, and the inventory (search the catalogued items, ADD with a count, SET COUNT, REMOVE). Factions and keywords are shown for reference. SAVE stores the changes; CANCEL just closes the window.
  • Your edits are written into the full patch (name, stats, flags, race, class, sleep outfit, inventory). They are not applied by the SPID / SkyPatcher modes, which only hand out outfits.
  • Plugins and the winner: the window lists every plugin that has the NPC, with the winning plugin highlighted. Face/body from lets you pick which plugin's face and body data a patch should use ((winning plugin) = default).
  • Edits live in ROLLO's database; plugin files are never touched. A later OVERWRITE replaces edited records of the plugins it re-reads (it asks first). UPDATE leaves your edits alone.
Faction search and profession hotkeys
  • The FACTION drop-down lists every faction in the database, with check boxes and a search bar. Tick one or more: the list shows the NPCs that belong to any of them.
  • Under the list are nine boxes, one for each of the keys 1-9. Choose a profession for each key you want to use.
  • Select one or more NPCs in the list and press a key: the NPC gets that key's profession (shown as "unsaved"). With a single NPC selected, the selection moves to the next row, so you can work down the list with the keys.
  • Press SAVE CHANGES to store all pending professions at once, or DISCARD CHANGES to drop them. Professions set this way are manual and are never overwritten by AUTO-ASSIGN.
Holds and sub-holds are not stored in the game's NPC records. ROLLO works them out from the Holds and Sub-holds lists in EDIT LISTS (faction FormIDs). The defaults cover the vanilla crime factions; add your own rules for towns such as Riverwood or Rorikstead. Nothing is guessed.

EDIT LISTS holds: Blacklists (factions / races / actors), Holds, Sub-holds, Follower factions, and Professions. IMPORT / EXPORT INI moves lists in and out as text. A scan never changes the lists. FormIDs: up to 6 hex digits means Skyrim.esm; write any other plugin as plugin.esm|HEXID.
3. PROFESSIONS
Skyrim stores no profession, so ROLLO suggests one by looking for a profession's match text in an NPC's faction names, Editor ID, default outfit and - only as a last hint - its class (a class never overrides a faction, Editor ID or outfit match). No match means no profession; ROLLO never guesses.
  • Edit the list in EDIT LISTS > Professions: add, select + CHANGE SELECTED, delete. A profession is a name plus a match text; one profession can have several match words separated by commas (for example WARRIORLIGHT = ARCHER,RANGER,1H, so a ranger class becomes WARRIORLIGHT). Longer match text wins.
  • In NPC VIEW press AUTO-ASSIGN PROFESSIONS to store suggestions for all NPCs. Manual choices are never overwritten.
  • In the NPC edit window, the Profession drop-down is "(automatic) -> suggestion" or a profession you choose.
  • Professions are stored per NPC identity, so they survive new scans.
  • NPCs whose profession is NOBLE get the Noble flag automatically (it can be set by hand too).
4. COLLECTIONS
A collection is a set of outfits. Outfit fields: Profession, Gender (MALE / FEMALE / UNISEX), Age (ADULT / CHILD), Noble (yes / no), UBE (yes / no), a Unique outfit name and up to three Sub outfit names, plus the armour pieces (ARMO records).

Import an old-style collection plugin
  1. Install the collection plugin so it is in your load order. Its file name must contain _Collection.
  2. Open COLLECTIONS, choose the plugin in the drop-down and press IMPORT SELECTED PLUGIN. The collection is named after the plugin file.
  3. ROLLO reads every leveled list named <prefix>_Outfit_<PROFESSION>[_<GENDER>]_<UNIQUE NAME>_<SUB>_<SUB>_<SUB> as one outfit. The gender tag (MALE / FEMALE) is optional; without it the outfit is UNISEX. Example: ROLLO_Outfit_DarkBrotherhood_Female_EllxeElvenAssassin_Outfit1 = profession DarkBrotherhood, FEMALE, unique name EllxeElvenAssassin, sub name Outfit1.
  4. Nested leveled lists are expanded. Other leveled lists are reported as helper lists. Malformed names are reported and skipped.
  5. Old plugins have no age or noble field: age is CHILD when the profession is CHILD, and noble is set when the profession is NOBLE. You can change both afterwards.
  6. While importing, ROLLO reads each piece's real ARMO record and saves its Editor ID and in-game name with the collection.

UBE: an NPC flagged UBE only gets UBE outfits, and a normal NPC only gets normal outfits. Click the UBE column of a collection's outfit list or of the NPC list to flip it, or highlight several rows and press U to flip them all.

Add armour to an outfit of a collection: open the outfit, pick plugins with SELECT PLUGINS, choose an armour in the drop-down and press ADD ITEM.

Share a collection: Highlight one or more collections (hold Ctrl or Shift while clicking) and press EXPORT SELECTED. It writes one .rollocol text file holding all of them and, next to it, one _mods.txt list with every mod they need, its Nexus page (taken from the mod's meta.ini) and the collection(s) it belongs to. The top of the list shows the total collections, total mods and total outfits. IMPORT SHARED FILE reads every collection in the file back. Only references are shared, never game assets. The file imports even when the other person lacks some of the plugins; when they create a patch, any outfit that needs a plugin that is not in their load order is skipped (it is listed in the patch notes), so only complete outfits are handed out.

Work with a collection: double-click it (or VIEW OUTFITS) to open its outfits, with filters and the pieces of the highlighted outfit. The name box at the top renames the collection (saved automatically). Double-click an outfit (or press Enter) to edit its fields and pieces; changes are saved automatically and two outfits in one collection cannot have identical fields. Each collection also remembers its master plugins, so a patch can add them.

Outfits per profession: press OUTFITS PER PROFESSION to see, for all collections together, how many outfits each profession has (default and sleep outfits counted apart, with a total row). Selecting a collection shows its own breakdown again.

Default and Sleep Outfit Collections
  • Every collection is either a Default Outfit Collection (the default) or a Sleep Outfit Collection. The Type column shows which. Select one or more collections and press SWITCH DEFAULT / SLEEP to change it.
  • The patch gives the outfits of a default collection to the NPC's default outfit and the outfits of a sleep collection to the NPC's sleep outfit. Both are distributed with the same rules.
  • Default and sleep collections cannot be merged. The kind is saved in shared .rollocol files.
5. CREATE OUTFIT
  1. Choose the collection (or <NEW COLLECTION> and type a name).
  2. Open SELECT PLUGINS (check boxes + search) and tick the plugins whose armour you want to use.
  3. Pick pieces in the ADD ITEM drop-down (type in SEARCH ITEMS to narrow it) and press ADD ITEM.
  4. Fill in profession, gender / age restriction, noble, unique and sub outfit names, then press SAVE OUTFIT. Nothing is created if saving fails.

The ITEM views show the highlighted piece (male and female); the COMPLETE OUTFIT views show all pieces together.

3D previews: drag to rotate (male and female turn together), mouse wheel to zoom, right-click to reset.
  • ROLLO reads each piece's model path from the plugin's ARMO / ARMA records and opens exactly that file inside your Data folder. Nothing else is searched.
  • Run ROLLO from MO2 so the virtual Data folder contains your mods.
  • If a pane says "Mesh missing / not built (run BodySlide?)", the model file does not exist yet. For BodySlide outfits, build them in BodySlide first, then click the outfit again.
  • Meshes and textures are also read from the plugin's own .bsa archives and the official Skyrim archives.
  • Previews load in the background so the window does not freeze, and are drawn on your graphics card (Direct3D 11) with an automatic fallback to the processor.
See the outfits as you peice them together:

View the outfit enlarged, to get a better idea of what it will look like in the game.
6. CREATE PATCH
Step 1 - Create expressions. An expression says "these NPCs may wear outfits from these collections". Press CREATE NEW EXPRESSION (double-click an existing one to edit it). Settings:
  • Name - unique.
  • Age - Adult, Child or All. Gender - Male, Female or Unisex (= both).
  • Followers - Everyone, Followers only, or Non-followers only. A follower is an NPC in one of the follower factions listed in EDIT LISTS (check them for your game).
  • Filters (drop-downs with check boxes; nothing ticked = any): Races, Factions, Holds, Sub holds, and Plugins. With plugins ticked, the expression only applies to NPCs that originate in those plugins. The Plugins list shows how many NPCs each plugin has.
  • Collections - tick at least one collection whose outfits the matching NPCs may wear. Tick default and sleep collections together if the NPCs should get both kinds.
  • Within one filter the entries are alternatives (an NPC needs ONE of the ticked races); different filters must all fit.
  • A noble child (child race with the Noble flag) gets outfits with age CHILD and Noble ticked, filed under profession CHILD or NOBLE.
  • MERGE COLLECTIONS (CREATE PATCH page) turns the armour of the ticked collections into one plugin: the armour records are copied into <patch name>_Merged.esp and the meshes, textures and other files of those mods are copied into the patch folder, so the patch needs one plugin instead of hundreds. Armour that cannot be copied (scripts, enchantments, special races) keeps its original plugin and is listed in the notes. Nothing in the original mods is changed.
  • PREVIEW RESULT shows, with the settings currently on screen, how many NPCs the expression finds per profession, how many are children, how many get a default or sleep outfit from the ticked collections, and how many have no fitting outfit (they stay unchanged). Use it to check an expression before making the patch.
  • SAVE stores it; CANCEL closes; DELETE EXPRESSION removes it.
Step 2 - Patch options (SETTINGS). Outfits per NPC (X) default 3, and Copies of each outfit (Y) default 2. Each is 1-50 and X times Y must not exceed 255.

Step 3 - Create the patch. Three buttons:
  • CREATE PATCH - writes one ESP containing the outfit leveled lists, one leveled list and outfit per NPC (named ROLLO_<NPC name>), and an override of each NPC record whose default outfit (and, with a sleep collection, sleep outfit) is set to it. The NPC record is rebuilt from the copy stored in the database, including your edits and the face/body plugin you chose. Masters are added in load-order order.
  • CREATE SPID FILES - writes an ESP with only the outfit leveled lists and outfits (no NPC records) plus <patch>_DISTR.ini. Put both into Data (or install the output folder as a mod). Sleep outfits get an extra SleepOutfit = ... line per NPC. Requires SPID + SKSE.
  • CREATE SKYPATCHER FILES - writes the same kind of ESP plus SKSE\Plugins\SkyPatcher\npc\<patch>\<patch>.ini. Sleep outfits get an extra outfitSleep line per NPC. Requires SkyPatcher + SKSE.
You are asked for a patch name (an extension is removed and .esp added; illegal characters are refused) and, if needed, an output folder. ROLLO asks before replacing an existing file. The patch is built on a background thread with progress and a CANCEL PATCH button. The file is written under a temporary name and moved into place only when complete, so a failure or cancel leaves nothing behind and never damages an existing file. Source plugins are never written, and an output path equal to a plugin in your load order is refused.

How outfits are chosen: an outfit fits an NPC when profession, gender (UNISEX fits both), age and noble flag match. The least used outfit is chosen first, an NPC never gets the same outfit twice, and different variants of one unique outfit are only used when nothing else fits. Default and sleep outfits are chosen separately with the same rules. NPCs without a profession or without a fitting default outfit are left unchanged and listed in the result; an NPC with no fitting sleep outfit keeps its own sleep outfit.

Big patches: a plugin can have at most 254 masters, so ROLLO starts another plugin before 220. If the new records do not fit into a light (ESL) plugin, ROLLO asks whether to split into several ESL plugins or write one normal plugin. Split patches are named Name.esp, Name_2.esp, ... - enable all of them.

Outfit rotation (optional, tick the box on the CREATE PATCH page). The patch also contains a quest with a script and a SkyUI MCM menu "ROLLO Outfits". NPCs change to the next of their outfits every X days (set in the MCM, 1-60, default 7; followers optional). An NPC is never moved straight back into the outfit it just took off. The MCM page shows how many NPCs the plugin handles and how many of each profession. Works with all three patch types; only default outfits rotate. Needs SKSE, SkyUI and Powerofthree's Papyrus Extender.

The summary screen opens when a patch is written (VIEW SUMMARY reopens the last one):
  • BY HOLD - for each hold and its sub-holds: NPCs in total, how many got outfits, how many did not. Each NPC is counted once.
  • BY PROFESSION - per profession: NPCs in total, with outfits, without, and the usable outfits of that profession in the collections used.
  • Both end with an ALL NPCS row. The summary is kept in memory only.
7. SETTINGS
  • Profile folder, Skyrim Data folder, MO2 mods folder, default output folder.
  • Only add NPCs of playable races (on by default).
  • Outfits per NPC (X) and copies of each outfit (Y).
  • LISTS: blacklists, holds, sub-holds, follower factions, professions.
  • Interface theme (changes immediately, remembered): Nordic Stone (default), Dwemer Brass, Frostfall Crystal, Imperial Leather, Blackreach Glow, Falkreath Timber, Fire, Dragon, Dragonborn, Smith, Dibella Priestess, Vampire, Dead.
  • Invalid or missing settings fall back to safe defaults.
KEYBOARD
  • Ctrl+1 ... Ctrl+5: the five pages. F6: focus the navigation row. F1: About.
  • Left / Right / Home / End / Enter / Space on the navigation row. Tab moves between controls.
WHERE ROLLO KEEPS ITS DATA
  • Database (NPCs, outfits, collections, expressions, lists): %LOCALAPPDATA%\ROLLO\ROLLO.db. Back this file up to keep your work. Older databases are upgraded automatically after a backup copy (.bak-v<number>) is made.
  • Settings and log: %APPDATA%\ROLLO\ (settings.ini, rollo.log).
  • Patch files: only in the output folder you choose.
TROUBLESHOOTING
"Mesh missing / not built" in a 3D preview
  • The model file the plugin names does not exist in your Data folder. For BodySlide outfits, build the outfit in BodySlide first.
  • Start ROLLO from MO2. If you start it normally, it only sees the real Data folder, not MO2's virtual one.
  • Check the Skyrim Data folder in SETTINGS. The log line starting 3D: resolver ready shows the folders ROLLO is using.
The NPC count is low or zero
  • Run NPC LOOKUP - OVERWRITE. Check that the profile folder contains loadorder.txt and plugins.txt.
  • "Only add NPCs of playable races" and the blacklists leave creatures out on purpose.
A plugin is skipped - the scan result lists plugins that could not be read (truncated or unsupported files). Their previous data is kept.

3D previews are slow or blank - open %APPDATA%\ROLLO\rollo.log. Lines starting 3D: explain each step. 3D: GPU renderer ready means the graphics card is in use; a 3D: GPU error line means ROLLO fell back to the processor.

Outfits did not change in game after patching
  • Make sure the patch (or SPID / SkyPatcher files and their plugin) is enabled and loads after the plugins that define the NPCs.
  • An NPC with a different outfit forced by another mod or by a script will keep that outfit.
  • In xEdit, check that the NPC override in the patch points to the intended outfit.
Reporting a problem - please include: the exact message, the last lines of rollo.log, your load order size, and whether you started ROLLO from MO2.
FAQ
Does ROLLO change my plugins? No. Plugins are only read.
Do I have to start it from MO2? Only for the 3D previews. Everything else works from the profile folder you give it.
Does it need the internet? No.
Can I share my collections? Yes, with EXPORT SELECTED (.rollocol). Only references are shared, so the other person needs the same plugins.
Why do some NPCs show no name? Their name could not be found in the string tables. Run NPC LOOKUP - OVERWRITE with the correct Data folder set in SETTINGS.
Are my NPC edits written to the patch? Yes, in the full patch (CREATE PATCH). The NPC record is rebuilt from the stored copy of the winning record (or the plugin you chose for face/body) with your edits applied. SPID and SkyPatcher files only hand out outfits.
Why does an NPC show -- instead of a FormID prefix? The NPC's plugin has no slot in the active load order (disabled, or not listed in loadorder.txt / plugins.txt / Skyrim.ccc).
Will it work with a modded load order of 1000+ plugins? The scan is designed for large load orders (in a synthetic test, 121,000 NPC records from 122 plugins were read in a few seconds). Light (ESL) and localized plugins are supported.
KNOWN LIMITATIONS
  • Patches support Skyrim SE / AE records only.
  • An NPC that uses a template for its traits is still given the outfit, but the game may use the template's appearance.
PERMISSIONS AND CREDITS
  • Author: Reaper
  • Uses: Windows' built-in SQLite, Direct3D 11 and GDI+. No third-party code is bundled.
  • Compatible with: SPID and SkyPatcher (optional, for distribution files).
  • Reuploads and modifications are strictly forbidden,
  • AL GUI Graphics, Buttons, Themes, generated using AI.. (Yes, I got lazy)

Permissions

List this mod as a required mod on your page, link it and credit me.