The Complex Sorter from FallUI Item Sorter Mod. Automatically add item tags to all items. Highly versatile and completely configurable: custom processing rules, custom tag sets, custom naming rules. You can just change anything to your liking. Standard rules support most custom mods out-of-the-box.
Other user's assetsAll the assets in this file belong to the author, or are from free-to-use modder's resources
Upload permissionYou are not allowed to upload this file to other sites under any circumstances
Modification permissionYou must get permission from me before you are allowed to modify my files to improve it
Conversion permissionYou are not allowed to convert this file to work on other games under any circumstances
Asset use permissionYou must get permission from me before you are allowed to use any of the assets in this file
Asset use permission in mods/files that are being soldYou are not allowed to use assets from this file in any mods/files that are being sold, for money, on Steam Workshop or other platforms
Asset use permission in mods/files that earn donation pointsYou are not allowed to earn Donation Points for your mods if they use my assets
Console modding permissionThis mod will not be available on Bethesda.net for console users
Author notes
You are NOT ALLOWED to redistribute, upload or share the original or modified scripts. Please always refer to this site if you like to spread Complex Sorter. You are ALLOWED to modify the scripts according to your personal needs. You are ALLOWED to share/upload your created or modified INI files of this mod (as long as you dont remove credits). This includes processing rules, dynamic naming rules, tag sets and plugins. You are ALLOWED to share/upload your created ESP files. This includes the INNR rules of Ruddy88 INNR ESP (He kindly give the permission for that). So you are allowed to use this for creating your files. Note: This permission doesn't include the redistribution of the original files. (So only share your created ESP, not the source esp files.) Make sure you have using permission for all other mods you possible include in your files. Also always give credits to the people making your sources.
File credits
Ruddy88's (Author of Ruddy88's Simple Sorter) The F04Edit team Bethesda
Donation Points system
This mod is opted-in to receive Donation Points
Changelogs
Version 1.10
Added new feature: Automatic output file partitioning - Completely overhauled the patch output file building process. All records are deep-analysed to determine their real required masters. Then an optimized output patch plan will be created. The plan also distribute records automatically to multiple files, if necessery. This should prevent the master-limit-reached problem completely.
Added new feature: Automatic tag injection via keywords in INNR. (Prevents things like "White [Helm] Helmet")
Added new feature: Record scripts - Apply advanced record modification through the new TagIdent "SPECIAL:RecordScript:...".
Added new feature: INNR scripting - Now you can completeley modify an INNR to anything you like (move/delete/rename entries, add/remove keywords and add whole new rulesets/entries)
Added new feature: Grouped batch processing by task groups. Allows multiple processing lines (prefilter+processing) to be executed independend and parallel.
Added special plugin "Item Sorter Tags", which allows to disable whole item tagging (for those who just want use the other patch plugins)
Added new plugin: ECO/Armor Clothing Overhaul Patcher - Patches records for use with ECO/ACO.
Added new plugin: ECO/Crafting Framework Workbench Patcher - Moving recipes to the Crafting Framework stations
Added new plugin: Immersive Animation Framework Patcher - Add animation via keywords to ingestibles.
Added new plugin: PANPC Patcher - Excludes various NPC from PANPC scripting to save ressources.
Added new plugin: Perk Magazine Numbers - Add #numbers to perk magazines names, like "Grognak the Barbarian #09".
Added mod rules for ECO, Project Mojave, Modern Firearms and Modern Armors
Added new rule capability: Allow multiple SPECIAL-TagIdents (functions) in one rule, seperated by comma.
Added new condition compare operation "hasKeyword"
Added new condition special identifier "SPECIAL:WinningOverrideESP" (analog to SPECIAL:MasterESP)
Added warning for sorter patch files in record history
Added new optional plugin properties: requiredRecordTypes and requiredFiles- Mark required record types and required plugin files
Change separated tag configuration as own optional file, so it can be directly installed by a Mod Organizer.
Change increased plugin processing speed (Especially for the ones with many options)
Change default for pre-filter is is now IGNORE instead of KEEP
Fixed Nuka DLC's "Rifle Rifle" and double subtitle "Western Revolver"
Version 1.9
Added plugin: Quest Tags (Just like Radio Tags, but for quests)
Added plugin: AWKCR Workbenches (Moves recipes to the awkcr workbenches)
Added new rule assistant: Simple Item Tag - Directly tag one specific item
Added "Test rules" feature to see how the current processing rules work for a given mod file and specific record
Added QOL feature: If you select an output filename with included record types, you will be asked if you like to use those.
Added full ACO compatibility by mod processing rules for ACO (works for all biped versions).
Added many more mod-specific rules for more compatibility and better tagging (SS2, CombinedArmsNV,...)
Added help links to many main function in CS menu
Added notice on startup if AWKCR is found and AWKCR Compatibility isn't activated yet.
Added system for utilizing processing rules in the FO4 data folder (Allowing them to be organized by a Mod Organizer)
Added FO4Data location for mod processing rules: [FO4Data]\Complex Sorter\Rules (Mods)\[ESP basename].ini
Added FO4Data location for plugins: [FO4Data]\Complex Sorter\Plugins\[Plugin name].ini
Added FO4Data location for TagIdent definitions: [FO4Data]\Complex Sorter\Rules (Tag Configuration)\tags.ini - All tag sets will be merged. Priority: USER > FO4Data > Default
Added processing rule record modifier TagIdent: SPECIAL:SetFieldValue:[Field name/path]:[New value]. Directly modify a record to a fixed value. (Like fo4edit function "SetElementEditValues")
Added processing rule compare operation: endsWith
Added processing rule for dynamically resolving linked records, e.g. CNAM:link:"Record Header\Signature"
Added plugin section type: [PluginReplaceInnrRules:*] - Replaces the full naming rules section instead of adding entries.
Added new INNR processing method by instructions sets: MODIFICATION_INSTRUCTIONS, e.g.: "MODIFICATION_INSTRUCTIONS = check:9,13,7,39,105 neworder:3,4,2,R|1,C0" (reordering, remove existing tags+add pipe prefix in #1, delete #0)
Included MXPF library in Complex Sorter package, so you don't need to download it separately from the Skyrim Nexus.
Change user rules priority to be above CS plugins, so the user can override plugin rules.
Change new optional parameter for processing TagIdent SPECIAL:AddKeyword: target keyword field, e.g.: SPECIAL:AddKeyword:FNAM:AEC_cm_Other_Recipe
Change optimization for some processing rules
Change all mod processing rules for the current load order will be loaded, not only for the current selected esp for processing. (To fix missing rules for "required" esp)
Change renamed plugin "AWKCR" to "AWKCR Compatibility"
Fixed problems with INNR injection for custom mods
Version 1.8
Added better update mode: Detect changed records and will update them instead of just skipping existing records. (Note: Update will still never remove any records)
Added settings profiles (Let you save and restore the whole Complex Sorter configuration as a named profile)
Added plugin: AWKCR - Changes apparel tag method from "full-name"-tags to INNR-tags
Added plugin: Radio Tags - Tag radio stations and transmission signals
Added plugin: Short Component Names (VR) - For use with Fallout4 VR and vanillaHUD
Added plugin: Immersive Sound Patcher plugin (more a "demo" for how to make individual dynamic patching plugins)
Added output tag set: VIS-G - You can select it under advanced options
Added record type MESG and ACTI (needed for the plugin Radio Tags)
Added range control for All/None-buttons for esp selection with many files (So you can easy split your mods into parts if you reach the 255-limit)
Added automatic object templates naming for ARMO records too (by tagging processing rules)
Added text font scale option
Added option to hide plugins from main menu gui
Added processing rule special identifier "SPECIAL:LeveledItemReference:*" for matching referenced LVLI records
Added processing rule special TagIdent "SPECIAL:FindCustomTagLVLI:*" for processing leveled item referenced records
Added processing rule record modifier TagIdent: SPECIAL:SetFieldRecRef:[Field name/path]:[Record signature]:[EDID of referenced record]. e.g.: SPECIAL:SetFieldRecRef:YNAM:SNDR:PlayerPickupMisc
Added Plugin section type: [PluginRulesBeforeAll:*] - Adds processing rules before all other rules
Added Plugin section type: [PluginRulesBeforeMain:*] - Adds processing rules between mod and main rules
Added Plugin section type: [PluginAddInnrRules:*] - Add rules to a section in dynamic naming rules
Change New weight modifier option for plugin Weightless (Let you specify how much less a item should weight - Value 0 is weightless as before)
Change Display of purge/update mode as its own mode setting in GUI.
Change If the target patch file exists, but isn't loaded, there will be an option to delete and recreate the file.
Change Mod rules are now applied for overriden records too. The rules applied in order from winning override to master.
Change Adding appropiate tags for weapons and apparel on leveled items (instead of the generic [Unique])
Change New default tags for "Add Components plugin" to cover more tags
Change Adjusted rules to tag blood pack as aid
Fixed error message for missing tags now showing the source TagIdent correctly
Fixed range selection overlapping with other elements in esp list
Version 1.7.1
Added new EDID selection assistant for Rule Editor. Allows to pick a EDID from a file by just a click.
Added All/None buttons for esp-files selection
Added "Standard" button for record types selection
Added "QUST" record types for a possible usage in a possible feature in a possible future
Added security confirm box when trying to process INNR records without R88_SimpleSorter included
Added "edit plugin" link in plugin settings
Change Overhauled the multi selection/option window prompt for a better overall usability. Search will automatically available for more than 20 entries.
Fixed translations couldn't get extracted when using mods which extends vanilla INNRs
Version 1.7
Overhaul complete overhaul of the GUI - Looks much more clear now
Added PLUGINS
Added new cache system for greatly increase generation performance. Comes in three tastes: ConditionCheckCache, RuleResultCache and PlusinScriptResultCache.
Added INNR processing for custom mod support
Added brand new integrated Processing Rules Editor! Edit the rules directly in the GUI
Added progress window while generating showing progress and stats
Added processing rule action: SPECIAL:AddKeyword:* - Allows you to add any keyword you like to a record
Added processing rule action: SPECIAL:RemoveINRD - Remove the INRD of record so the item isn't named by INNR rules anymore (and you can set the name of item directly)
Added processing rule action: SPECIAL:PregReplace:[Field]:[Preg]:[String] - Perform string replaces on any record fields. You can rename things, replace things ...
Version 1.6.1
Added custom user processing files - Now your own rules are safe in case of updates. All user rules have highest priority, so you can change everything.
Added custom mods user processing files - Also you can add your own custom mod rules, which automatically adds/overwrite the predefined mod rules
Added user tags.ini file. This file extend the default file.
Added dummy template files for user files.
Fixed a bug from 1.5.2 which prevented INNR record from beeing processed
1.6.1 Fixed LVLI rule
Version 1.5.2
1.5.2 Added support for custom-rules configurable by specific esp. Should make custom mod configuration much simplier.
1.5.2 Added support for configurable prefilter processing rules. Allows custom mods to override the standar rules for their files.
1.5.1 Fixed exception for some weightless items
Added complete customizable dynamic processing rules system! Now you can configure anything you like.
Added QoL features like saving the last selected ESP target patch file, optional selecting of all ESP files at startup and so on
Added option to turn off purging of records before start.
Refactored and cleaned up the code base
Included FallUI - Item Sorter Mod - tag configuration
Changed GUI to be more comfortable
Added various processing rules and naming rules for more custom made items from mods.
Some bug fixes and slight upgrades here and there
Version 1.4
Added many new internal identifier for better support of custom mods
Added heuristic matching rules (configurable through ini file)
Added dynamic injection of heuristic naming rules to INNR files
Added dynamic appliance of heuristic naming rules for weapons without INNR
Added possibility to apply tags to object templates (like used for unique weapons)
Added more configuration options
Added target esp file selection
Fixed bugs and some more minor adjustments
Version 1.3.2
Fixed modified innr wasn't included when not using option "include all innr"
Version 1.3.1
Fixed INNR rules for dlc3/dlc4 weapons
Version 1.3
Used record types are now configurable via GUI
Used tag set is configurable via GUI
Added button for direct opening tags.ini
Updated tag set Ruddy88 Simple Sorter Tags to be more matching original script
M8r98a4f2's Complex Sorter
The Complex Sorter from FallUI Item Sorter Mod. Automatically add item tags to all items. Highly versatile and completely configurable: custom processing rules, custom tag sets, custom naming rules. You can just change anything to your liking. Standard rules support most custom mods out-of-the-box.
I have build the Complex Sorter for the prepared Item Sort shipped with FallUI. And a few users asked for the script. So here it is! It has grown in the meanwhile... Now you can customize just anything. Just take a look at the screenshots.
(Uses parts of Ruddy88's Simple Sorter - Usage permission is granted by Ruddy88. Uses MXPF library by Mator, usage is granted via MXPF license)
Usage as player Add Item Sorting tags to all items in all mods (vanilla and downloaded). You don't need endless item sorting patch files anymore, just one for all. The default configuration will create an ESP exactly like the ones in the "FallUI Item Sorter Mod" packages, but with all your items from all your mods! Just lean back and let the script do the work.
Usage as mod author It also allows you to create specific patch files for any mod(s) you like, which you can upload to Nexusmods. This allows you to create ready-to-use files for players which don't use FO4Edit. You can also automate steps with the processing rules, which elsewhere must be done manually. In fact: All FallUI Item Sorter Mod pre-built EPSs are created with Complex Sorter without any manual ESP editing!
A warning If F04Edit is unknown to you and you haven't the intention to learn a bit more about Fallout 4's modding, this mod is probably nothing for you. It is intended for FO4Edit users. This script is highly automated, but you still need to start it. If you just want a ready-to-go package, you find many pre-built packages on the FallUI Item Sorter Mod page.
Features
Spoiler:
Show
All the good stuff you know from Ruddy88's Simple Sorter
Automatically tags all items in your loaded ESPs, creating a patched ESP with all items in your game configuration
Can be re-executed for a new mod setup at any time
Automatic added components tags
Language independent (Uses your game language for all your generated files - Including automatic translation of Ruddy88s INNR rules)
Complete customizable dynamic processing rules - You can change everything, starting by the filter conditions, over the classification rules till the final tag set.
Allows easy adding of individual custom-mod processing rules. If the automatic detection miss some items - just add a processing rule to fix it!
Included graphical Processing Rules Editor with new-rule-assistant. Just click together your perfect tagging!
You can define rules globally for all records or just for one specific mod. The rules are processed in an easy intuitive order: First the mod specific, then the global ones. Additionally all rules you define have higher priority than the standard rules, so you can adjust everything to fit your mod list.
PLUGINS
Plugins can change nearly everything from just injecting processing rules to modifying records field by a complex control script.
The plugins have own user settings, that you simple define in one line in your plugin file. The setting is then available to the user in the main GUI. Available settings types: bool, int, float, string
Plugins can have complex scripting, which allows to perform nearly any possible action on the record. For more details please look at the topic "Documentation: Plugin system" on this page.
Plugins are defined as INI files. Most F04-users know the ini basics, so even non-programmers can perform simpler changes by them-self.
Adds a wide range of weapon type tags automatically to vanilla and custom mod weapons. Supports multiple methods to cover all possible namings: Injecting in INDR-INNR record, writing item name in record and writing item name in unique item templates.
Adds many apparel tags based on damage resistance and body part coverage just by the standard rule set. Also adds more ammunition classification tags and more misc item tags.
Includes rules for all vanilla weapon item tags. Complete tagging for all Fallout 4 items and most custom mods.
Injects heuristic INNR rules to custom mods for precise item tagging
Automatic detection of weapon type through heuristic classification rules, allowing to tag custom mod weapon correctly
Supports multiple output tag sets like FallUI, Ruddy88's or VIS-G tag set. You can also create your own custom tag set (via tags.ini). The selected output tag set will automatically used by all processing rules. So you can generate appropriate tags for different Item Sorters with just a drop-down change.
All heuristic naming rules and injected INNR rules can be configured. (rules-innr.ini)
Intelligent caching system greatly speed up the processing - especially on the second run. Auto-detect rules and settings changes and renew the cache on-demand.
Fast update-mode - If you just added mods you can just add the missing items. Greatly reduces needed patching time. (Won't work for mod removals)
Save previous selected settings in ini file. This will be pre-selected on next script start.
Multiple setting profiles: Save all Complex Sorter menu settings as a named profile and restore it at any time.
Copy the Complex Sorter files from this mod's zip folder "FO4Edit\Edit Scripts\" to your FO4Edit's folder "...\F04Edit\Edit Scripts\".
Start Complex Sorter via right click on any esp in F04Edit and select "Apply Script". Then select "M8r_ComplexSorter".
Quick start Here is a quick start to get your first patch with a 99% item coverage in most cases.
Spoiler:
Show
TL;DR: Install. Start CS script in FO4Edit. Set your wanted settings in the GUI. Press "Generate Patch".
Quick start step by step
1) Preparations
Install this mod according to above installation instructions.
Put R88_SimpleSorter.esp (R88SimpleSorter_INNR in optional section from Ruddy88's Simple Sorter) to the end of your plugin list.
If you currently use a pre-built FallUI Item Sorter ESP (e.g. M8r_Item_Tags_Vanilla.esp), uninstall or disable it - You will build your own!
Make sure you have a Item Sorter tag configuration installed. You don't need this for Complex Sorter, but later for the game. For FallUI Item Sorter you can use the optional file on this page or the included tag configuration in the FallUI Inventory installer.
2) Start
Start FO4Edit as normal. (If you're using MO2, make sure you run FO4Edit through MO2)
Right-click on any esp in the left list and select "Apply Script...". Then select "M8r_ComplexSorter" and click OK.
3) Generation
Watch the "Input ESPs" list. This defaults to include all mods. If you want some mod to be not processed simply remove it from the list.
Check the plugins for your personal preference (Weightless items, radio tags, quest tags, ...)
Click on "Generate Patch" and watch the magic
Tips
Spoiler:
Show
All standard configuration is for FallUI's Item Sorter Mod. So be sure to check the configuration if you like to use it with any other Item Sorting Mod.
Use shift+click for esp selection at F04Edit to greatly speedup start time. (This turn off reference building, which isn't needed for the script)
Add "-nobuildrefs" to your FO4Edit start arguments to automate that shift-click!
Add "-autoload" to your FO4Edit start arguments to bypass the first mod selection box (This will load plugins according to your plugins.txt like the game)
Start Complex Sorter with hotkey Ctrl+Y in F04Edit (Requires one manual start once)
Check the other plugins for your personal preferences (like [Valueable] tag, armor body slots, armor body part tags etc.)
If you like to disable R88_SimpleSorter.esp afterwards, activate "Include all R88 INNR records" in advanced options.
If you want weightless items, enable the plugin Weightless Items. (You can configure its settings too if you like)
If you want radio and station tags, enable the plugin Radio Tags. For radio tags you also have to enable ACTI and MESG record types.
TIP for LOOT users: Define item sorting mod ESP as "Dynamic patch", so it will be sorted to the end automatically!
TIP for Vortex users: Go to plugins list. Double click the CS output file. Choose "Dynamic Patches" from the drop down group tab. Now Vortex will sort it automatically at the bottom properly! (Thanks to shrad1994 for this tip)
