[img]https://i.imgur.com/SEUgiYL.png[/img]
A mod that adds more than 100 new persona weapon traits for persona weapons with custom code effects, adds a handful of other additions & QoL features relating to persona weapons and provides documentation for modders to create their own traits.
Persona (formally bladelink) weapons and their traits were only added in a major free update some time after Royalty's release, but was eclipsed by other changes in the same patch. As such, the feature flew under many people's radar, mine included. After learning about them and reading the book Warbreaker, I was inspired by a certain sword in the book to use these weapons more often in my own playthoughs, only to find them rather lacking in personality and a little repetitive. Fast forward 5 months and constant scope creep, I present to you this mod. See below for content details.
[img]https://i.imgur.com/HMMEzpy.png[/img]
Traits
This mod adds many, many new traits roughly broken down by archetype as seen below.
You can find a full trait list [url=https%3A%2F%2Fdocs.google.com%2Fspreadsheets%2Fd%2F1d6ocngYP6icuQ-9Jw9K9p4mWkMufZBVe9j4y9H4o7hI%2Fedit%3Fusp%3Dsharing]here[/url][docs.google.com].
[list]
[*] Added Damage effects: Adds traits which give your attacks with that weapon an extra damage type.
[*] On-Kill effects: Adds traits which have a chance of activating when a wielder kills with this weapon.
[*] Equipped stat effects: Adds passive effects (can be both positive and negative) to the wielder when they have the weapon equipped. These are mainly combat related stats.
[*] Bonded stat effects: Similarly to equipped stat effects, these traits offer passive effects but are active even when the bonded pawn does not have the weapon equipped. These are mainly non-combat related stats.
[*] Bonded thoughts: Adds situational thought effects to the bonded pawn. For example receiving a mood boost if it's raining.
[*] On-Hit Effects: Adds special effects that can trigger when the wielder of the weapon lands a hit with the weapon. These include but not limited to: applying plague to the receiver, applying plague to the attacker, spawning ash, filling needs and making the attacker feel bad for hitting things.
These on-hit effects also work with ranged persona weapons (if you have a mod that adds them) but at a reduced proc chance.
[/list]
Don't like some of these traits? You can disable them from spawning in the mod settings!
Non-Trait related additions
Weapons
Adds a persona variant for the eltex staff!
Items
No more useless masterwork persona monoswords! This mod adds non-craftable items which can be used manipulate the traits of your persona weapons in some way:
[list]
[*] Persona Bond Effector: Breaks the bond of a weapon and pawn without killing or destroying either.
[*] Persona Reformat Effector: Completely re-writes the weapon's traits
[*] Persona Extension Effector: Randomly adds a compatible trait to the weapon
[*] Persona Reduction Effector: Randomly removes a trait from the weapon
[*] And 3 extra rare Effectors which add [i]deterministic[/i] ways of changing your persona weapons
[/list]
These items can be found as quest rewards or bought from exotic goods traders.
Quest
In order to subtly increase the availability of persona weapons; a variant of the item cache quest, the Persona Weapon Cache, can now spawn! The cache will contain a single persona weapon.
Pawns
A new profession has been added to the Empire's elite ranks. The blademonk is lightly armoured but is guaranteed to wield a persona weapon and have high melee proficiency.
QoL Features
This mod also adds multiple QoL features:
[list]
[*] disable trait settings: adds a settings page that allows you to disable the traits you don't like!
[*] autolinks: links to traits from a persona weapon's description and also adding an item link from a pawn to the weapon for easy referencing.
[*] trait limit settings: adds a setting to increase the min and max number of traits a given weapon can have.
[*] more names: extended the name generation list for persona weapons.
[*] devmode tools: adds a suite a tools in the devmode menu to spawn and change traits of weapons, for testing purposes ;P.
[/list]
For Modders
Within the git repo, I've included templates and some documentation for other modders to create their own weapon trait mods or to extend this mod with addons using the extra functionality I added here as a base.
[img]https://i.imgur.com/goORJ6c.png[/img]
Q: Does this work on modded weapons?
A: Yes.
Q: Can it be added mid-save?
A: Yes.
Q: Can it be removed mid-save?
A: I'd never recommend removing a mod mid-save unless you know what you're doing. But yes, on the condition that you remove any items related to this mod and any weapons with this mod's traits on your maps first.
Q: Is this mod compatible with Vanilla Persona Weapons Expanded?
A: Yes.
Q: Is this mod compatible with Persona Bond Forge?
A: Yes. The ranged persona weapons added by that mod can also still trigger on-hit effects.
Q: CE compatible?
A: CE supports this from their side. Special thanks to those guys!
Q: How balanced is this mod?
A: I was very conservative, I balanced the mod around the level of availability of the benefits/downsides and compared them to the availability of other similar modifiers.
For example, in ideology preach health boosts natural healing but for a limited amount of time, so for the trait that boosts natural healing, the magnitude is comparably lower to preach health, but has much higher uptime. Similarly, the animal companion situational thoughts give a minor + mood boost, so the situational thoughts added by this mod provide a similar magnitude mood boost/decrease. The combat related stats that are tweaked by a trait consider similar modifiers and uptime, like gunlinks or clothing pieces with stat increases.
Q: Full traits list?
A: You can find a full trait list [url=https%3A%2F%2Fdocs.google.com%2Fspreadsheets%2Fd%2F1d6ocngYP6icuQ-9Jw9K9p4mWkMufZBVe9j4y9H4o7hI%2Fedit%3Fusp%3Dsharing]here[/url][docs.google.com].
Q: Updates?
A: I put a lot of work into this mod and plan on supporting it thoroughly.
Q: I have an idea/I found a bug, can you add/fix it?
A: Awesome! Maybe, hopefully. Please leave a comment and let me know.
Q: I heard documentation?
A: See the github. Message me if you have extra questions.
Q: Anything Cosmere or Brandon Sanderson related
A: For the benefit of everyone, please no spoilers :).
For any other and all things, please leave a comment, I read every single comment and try to get back to all of them.
[img]https://i.imgur.com/VkOnIDn.png[/img]
Links
[url=https%3A%2F%2Fgithub.com%2Fusers%2FLinnielDW%2Fprojects%2F1]Project Board[/url][github.com]
[url=https%3A%2F%2Fgithub.com%2FLinnielDW%2FMorePersonaTraits]Github[/url][github.com]
[url=https%3A%2F%2Fdocs.google.com%2Fspreadsheets%2Fd%2F1d6ocngYP6icuQ-9Jw9K9p4mWkMufZBVe9j4y9H4o7hI%2Fedit%3Fusp%3Dsharing]Full trait list[/url][docs.google.com]
Legal
C#, XML, trait descriptions and item sprites by me, Arquebus
Thumbnail and banners by my good friend woffleman
[b]What we do, we do for free.[/b] If you want to support us further you can support us on ko-fi.
[url=https%3A%2F%2Fko-fi.com%2Farquebus][img]https://storage.ko-fi.com/cdn/kofi2.png[/img][/url][ko-fi.com]
Thanks to Brrainz for Harmony which made this mod possible and to the VE team for releasing VPWE which gave me the motivation to finish this mod.
And special thanks to my friends for being my rubber ducks when I was stuck and to the Rimworld discord for giving me feedback.
Licensed under MIT License
