Skyrim Special Edition
0 of 0

File information

Last updated

Original upload

Created by

powerofthree

Uploaded by

powerofthree

Virus scan

Safe to use

About this mod

SKSE plugin that can be used to add spells/perks/items/shouts/packages/outfits/keywords/factions to every NPC in the game, using config files.

Requirements
Permissions and credits
Changelogs
SPELL PERK ITEM DISTRIBUTOR



Requirements 

SKSE64
Skyrim SE 1.5.39 onwards
meh's Address Library for SKSE Plugins

Description

SKSE utility plugin that allows modders to add spells/perks/items/shouts/packages/outfits/keywords to every NPC actorbase in the game, at startup.

How To Use

Note:  konkeranto has graciously made xEdit scripts that automate all of this, check it out here : 
Spell Perk Item Distributor xEdit Scripts

List of distributable types

Spell
Perk
Item
Shout
LevSpell
Package
Outfit
Keyword
DeathItem
Faction


Distributed records should be written to an ini file containing the suffix "_DISTR", in the Data folder (for example, MyMod_DISTR.ini).

They should follow this general format:

Spell = formID~esp(OR)editorID|strings|formIDs(OR)editorIDs|min/max level,skill(min/max)|gender/unique/summonable|NONE|chance

Items have their own specialized format:

Item = formID~esp|strings|formIDs(OR)editorIDs|min/max level,skill(min/max)|gender/unique/summonable|itemCount|chance

Main

  • FormID is the formID of the distributable record with leading zero digits removed (eg. 0x12345)
  • esp is the name of the mod containing the record (MyMod.esp). This is not necessary for Skyrim and DLC records.

  • EditorID is the form editorID of the record displayed in CK or xEdit.

  • KywdName is the name (editor ID) of the keyword.

Filtering

Filters are for distributing to only specific groups of NPCs. Filters that you're not using can be marked as NONE or left blank.

NOTE: Combining multiple filters will progressively restrict the pool of NPCs that can be distributed to.
Distribute the same record multiple times to add it to different types of NPCs.


  • Strings
Keyword editorIDs  (eg. ActorTypeNPC)
Actorbase names (eg. Balgruuf)
Actorbase editorIDs (eg. BalgruufTheGreater

Multiple strings should be separated using a comma.  All keyword strings, names and editorIDs (vanilla and modded) are supported.

  • FormIDs/EditorIDs
FormIDs/EditorIDs of specific forms used by actors, like factions/race/class (eg. 0x12345 or MyRecordEditorID).

List of valid filter form types
Spoiler:  
Show


Multiple entries should be separated using a comma.
Mod added filter formIDs are supported (0x101~MyFactionMod.esp,0x223~MyRaceMod.esl)
EditorIDs can now be used in place of formIDs.

Pattern Matching
Spoiler:  
Show


  • Actor Level is minimum/maximum actor level. Records will be distributed to NPCs with levels within this range. 
This filter is skipped for NPCs that level up with the player.

  • Skill Level (OneHanded, Lockpicking, ect) range from 0 - 17, followed by the min and max Skill Level required. Supports pattern matching.
eg. for Destruction skill level 50 - 100, it's 14(50/100)

List of Skills
Spoiler:  
Show


  • Traits
Gender : M/F
Unique : U
Summonable : S

Traits can be combined (eg. M/U/F to get all male unique summonable NPCs)
Traits can be negated (eg. -U to get all non-unique NPCs)

  • Chance 
Percentage chance that records will be distributed to NPCs 
Value is from 0.0 -100.0, default chance is 100 if left blank or NONE. 

Notes regarding distributable types

Items


All items (that can be added to NPC inventory) are accepted.

Leveled Items are included under Item.

  • itemCount is the amount of items that should be added. Default is 1 if no count is specified

Packages

Packages are added to the top of the actorbase package stack, so they will probably take priority over everything else, excluding quest alias and scene packages.

Keywords

Keywords can either be distributed as normal, using formids from other mods, or you can assign your own custom keyword to NPCs

Keyword = ActorTypeRich|Nazeem,Maven Black Briar

These keywords should be checked in-game using SKSE's HasKeywordString function.

Keywords will be applied first, so you could distribute a keyword to NPCs, and then check if it exists when distributing other things

Keyword = ActorTypeGhost|*Ghost

Spell = 0x123~SpookyGhostSpell.esp|ActorTypeGhost

Examples

;this will add 3000 gold to everyone except Nazeem
Item = 0xF~Skyrim.esm|ActorTypeNPC,-Nazeem|NONE|NONE|NONE|3000 

;this has a 50% chance to add a perk from test.esp to all NPCs from Test faction
Perk = 0x9DE80~test.esp|NONE|0x1BCC0~test.esp|NONE|NONE|NONE|50

;this will add Flames to all female NPCs between actor levels 25 and 50
Spell = 0x12FCD~Skyrim.esm|NONE|NONE|25/50|F

;this will add Flames to all male unique NPCs who have a minimum Destruction skill of 10 
Spell = 0x12FCD~Skyrim.esm|NONE|NONE|14(10)|M/U

;this will add Unrelenting Force to all NPCs that are vampire ghosts
Shout = 0x13E07~Skyrim.esm|ActorTypeGhost+Vampire 

;this will add a custom keyword, ActorTypePoor to Brenuin
Keyword = ActorTypePoor|Brenuin

Notes

Check po3_SpellPerkItemDistributor.log file in My Games/Skyrim Special Edition/SKSE, for more information about the process.

Installation


  • Install as normal with a mod manager. 

Credits

  • Ryan (SniffleMan) for CommonLibSSE
  • SimpleINI for INI code and directory access