Object Categorization Framework (or OCF) is a framework mod that categorizes items and other base objects into groups that can be easily used as conditions by other mods. It does this by distributing hundreds of new Keywords (using Keyword Item Distributor and Spell Perk Item Distributor) and FormLists (using FormList Manipulator) to base objects from hundreds of mods.



OCF categorizes objects using keywords when possible (when the form type accepts keywords). For an organized list of keywords, see the Keyword Reference on OCF's wiki. When keywords can't be used, FormLists are used instead. For an organized list of FormLists, see the FormList Reference on OCF's wiki.

For the vast majority of categorization support, I have to manually add each object (item, spell, etc.) to my INIs, apart from the few places I use general variables, like string wildcards or model names. The process for "supporting" a new mod can take anywhere from a couple minutes to several hours depending on the mod's size and complexity. I also may have to come back to it later if I change OCF's categories or add new categories, especially for new form types.

If you're wondering what mods OCF currently supports, that's not an easy question to answer. A detailed list would be difficult and a pain to maintain. As was just explained, each object is usually added manually, so mods may require retouching when I add new categories. At least to give you an idea, I have categorized thousands of objects from vanilla, Anniversary Edition/the Creation Club, and hundreds of other mods from Nexus and other sources. If you're curious if a specific mod is supported already, check the INIs, changelog, or ask me.

If you are a user who wants me to add support in OCF for a new mod, update a partially categorized mod, or fix incorrectly categorized objects, feel free to leave a comment in either this discussion thread or just in the posts section with your request. Include at least the mod name and link. If you're requesting an update for a partially/incorrectly categorized mod, please also include what parts of the mod you think need another look.

If you want to try your hand at helping to add support for more mods, I appreciate any effort! I only have so much time I can spend on this project, so the more people that help out, even a little, the sooner peoples' favorite mods will be supported. If you're at all interested, contact me on Discord or Nexus to talk or make a patch on your own and send it to me on Discord, with a pull request to OCF's Github, or just on Nexus. No pressure of course. Even just sending requests for unpatched mods helps out the project.

If you're a mod author who's interested in utilizing OCF's Keywords or FormLists in their mod, feel free to contact me on Discord or Nexus. I can try to answer any questions you might have. I'm also open to taking suggestions, such as adding new Keywords or FormLists. If you're considering making a new keyword resource, please consider contacting me first, as adding the desired keywords to OCF might be easier for everyone, and even if they don't fit I'd be happy to share anything I could.

If you have any other questions or suggestions feel free to leave a comment or otherwise contact me. Enjoy! :)



Install this mod normally, with MO2, Vortex, or another mod manager that supports FOMOD installers.

Requirements:

• Keyword Item Distributor (KID) (v3.4.0+).
• FormList Manipulator (FLM) (v1.7.0+).
• Spell Perk Item Distributor (SPID) (v6.6.0+). You may or may not be able to use older versions.
  

Optional Requirements:

• Keyword Patch Collection – I strongly recommended it for the fixes it makes to other mods' KID files that may otherwise interact poorly with OCF.
• MergeMapper – Only if you use zMerge. MergeMapper will help ensure FormIDs in plugins that have been zMerged can still be found correctly by FLM/KID/SPID.
  

A few mods that utilize OCF:

• Aura's Inventory Tweaks - Overhauls some of SkyUI's features using OCF keywords including item icons, types, sorting, and more.
• FormList Patch Collection - Patches some mods to benefit from OCF categories and mod support and includes other FormList related patches, fixes, and tweaks.
• I4 Weapon Icons Overhaul - Adds new icons for weapons tailored to OCF keywords.
• Immersive Activate SKSE - Simplifies the activate text with support for OCF keywords.
• Injected Animated Armoury - Adds Animated Armoury animations using OAR to weapons supported by OCF.
• Keyword Patch Collection - Patches some mods to benefit from OCF categories and mod support and includes other keyword related patches, fixes, and tweaks.
• Soulsy HUD - Quick equip HUD mod with support for OCF keywords.
• Weapon Speed - IPM - Allows you to dynamically change the attack speed of weapons based on weapon type keywords, with support for OCF keywords.
  

Q1: What Skyrim versions are supported?

• This mod is not directly dependent on any specific Skyrim version.
• It does require mods that are version dependent, so you'll have to install the correct versions of those mods for your Skyrim version.
• When everything is installed properly, it should work on any modern version of Skyrim (SE/AE/1.5.x/1.6.x/Steam/GOG/VR), although it hasn't been tested on every version.
• I do not directly support Oldrim/LE or console, but you're welcome to try to port it yourself (see permissions).
  

Q2: What types of plugins are used?

• All plugins included are .esp/.esl/.esm with the ESL flag. This means the plugins count towards the ~4096 ESL limit, not the ~255 ESP limit. If you are on VR, you will need VR ESL Support to make use of the ESL flag.
• Plugin header version is 1.70. This means BEES for SE v1.5.97-1.6.659 (never required on v1.6.1130+) or VR ESL Support for VR are not required to load the plugins in this mod.
  

Q3: Does installing/updating/uninstalling on an existing save work?

• As far as I know it should be fine. However, when changing any mods at all mid-playthrough, consider following good modding practices such as making backups, using tools like ReSaver, and using bugfix/stability mods like Save Unbaker (VR).
  

• powerofthree for creating KID and SPID and adding some features I suggested, which made this framework possible!
• MaskedRPGFan for creating FLM and adding some features I suggested, which made this framework possible!
• Ashingda, NickaNak, LeonardoVAC, TateTaylorOH, Admiral30, V3cta, and others, whose mods inspired this framework in the first place!
• Komegaki/Genskicc, Horf/PRieST47, and everyone else on Discord and Nexus who've helped me with patches, suggestions, and feedback!
  

> > > Check Out My Other Mods! < < <