Heroes
TaleWorlds.CampaignSystem.Hero Class Reference 1.2.7
Hero.MainHero // player
Hero.OneToOneConversationHero // Hero you are talking to in the dialog
Skills/Attributes/Focus/Xp
Changes
Hero.HeroDeveloper.SetInitialSkillLevel(DefaultSkills.OneHanded, 265);
Hero.MainHero.HeroDeveloper.AddAttribute(DefaultCharacterAttributes.Vigor, 1, false);
Hero.MainHero.HeroDeveloper.AddFocus(DefaultSkills.TwoHanded, 1, false);
Hero.MainHero.HeroDeveloper.ChangeSkillLevel(DefaultSkills.OneHanded, 10, true);
Hero.MainHero.HeroDeveloper.AddSkillXp(DefaultSkills.OneHanded, 100, true, true);
Hero.MainHero.AddSkillXp(DefaultSkills.Charm, MBRandom.RandomFloatRanged(10, 50)); // no learning rate applied
Get
int skillXP = hero.HeroDeveloper.GetSkillXpProgress(DefaultSkills.Athletics); // skill XP
int skillValue = hero.GetSkillValue(DefaultSkills.Roguery); // skill level
int intelligence = hero.GetAttributeValue(DefaultCharacterAttributes.Intelligence); // skill attribute
DefaultCharacterAttributes
- Vigor
- Control
- Endurance
- Cunning
- Social
- Intelligence
DefaultSkills
- OneHanded
- TwoHanded
- Polearm
- Bow
- Crossbow
- Throwing
- Riding
- Athletics
- Crafting
- Tactics
- Scouting
- Roguery
- Charm
- Leadership
- Trade
- Steward
- Medicine
- Engineering
Renown
GainRenownAction.Apply(Hero.MainHero, MBRandom.RandomFloatRanged(1f, 3f), false);
Traits
TaleWorlds.CampaignSystem.CharacterDevelopment.DefaultTraits
int Hero.GetTraitLevel(TraitObject trait)
void Hero.SetTraitLevel(TraitObject trait, int value)
void Hero.ClearTraits()
Personality traits
- Mercy - Mercy represents your general aversion to suffering and your willingness to help strangers or even enemies. Cruel tag if Mercy < 0.
- Valor - Valor represents your reputation for risking your life to win glory or wealth or advance your cause.
- Honor - Honor represents your reputation for respecting your formal commitments, like keeping your word and obeying the law. Devious tag if Honor < 0.
- Generosity - Generosity represents your loyalty to your kin and those who serve you, and your gratitude to those who have done you a favor.
- Calculating - Calculating represents your ability to control your emotions for the sake of your long-term interests.
Other traits
Political:
- Egalitarian
- Oligarchic
- Authoritarian
Voice:
- PersonaCurt
- PersonaEarnest
- PersonaIronic
- PersonaSoftspoken
Profession?
- Surgery
- Siegecraft
- Blacksmith
- Fighter
- Commander
- Politician
- Manager
- Trader
- Thug
- Thief
- Gambler
- Smuggler
Skills:
- ScoutSkills
- RogueSkills
- SergeantCommandSkills
- KnightFightingSkills
- CavalryFightingSkills
- HorseArcherFightingSkills
- HopliteFightingSkills
- ArcherFIghtingSkills
- CrossbowmanStyle
- PeltastFightingSkills
- HuscarlFightingSkills
- BossFightingSkills
Equipment:
- WandererEquipment
- GentryEquipment
Body build:
- MuscularBuild
- HeavyBuild
- LightBuild
- OutOfShapeBuild
Hair:
- RomanHair
- FrankishHair
- CelticHair
- RusHair
- ArabianHair
- SteppeHair
NPC99: Approx relationship between Lord traits and skills:
Health
bool IsHealthFull()
void Heal(int healAmount, bool addXp=false)
void MakeWounded(Hero killerHero=null, KillCharacterAction.KillCharacterActionDetail deathMarkDetail=KillCharacterAction.KillCharacterActionDetail.None)
int MaxHitPoints [get]
int HitPoints [get, set]
How to increase max health (MaxHitPoints) of the hero?
Power
float hero.Power
void hero.AddPower (float value)
Defines how powerfull a notable is (Regular [0..99], Influential [100..199], Powerful [200+])
![](/pics/LggRpKJ.png)
private DefaultNotablePowerModel.NotablePowerRank[] NotablePowerRanks = new DefaultNotablePowerModel.NotablePowerRank[]
{
new DefaultNotablePowerModel.NotablePowerRank(new TextObject("{=aTeuX4L0}Regular", null), 0, 0.05f),
new DefaultNotablePowerModel.NotablePowerRank(new TextObject("{=nTETQEmy}Influential", null), 100, 0.1f),
new DefaultNotablePowerModel.NotablePowerRank(new TextObject("{=UCpyo9hw}Powerful", null), 200, 0.15f)
};
A lof of stuff done in NotablePowerModel (DefaultNotablePowerModel Class), example:
int Campaign.Current.Models.NotablePowerModel.RegularNotableMaxPowerLevel
Occupation
hero.SetNewOccupation(Occupation.Special); // spawns in the keep hero.SetNewOccupation(Occupation.Wanderer); // spawns in the tavern, engine relocates to random town once a week
Occupation list
- NotAssigned
- Tavernkeeper
- Mercenary
- Lord
- GoodsTrader
- ArenaMaster
- Villager
- Soldier
- Townsfolk
- RansomBroker
- Weaponsmith
- Armorer
- HorseTrader
- TavernWench
- TavernGameHost
- Bandit
- Wanderer
- Artisan
- Merchant
- Preacher
- Headman
- GangLeader
- RuralNotable
- PrisonGuard
- Guard
- ShopWorker
- Musician
- Gangster
- Blacksmith
- BannerBearer
- CaravanGuard
- Special
Check for occupation:
- hero.IsGangLeader
- hero.IsMerchant
- hero.IsArtisan
- hero.IsLord
- hero.IsPreacher
- hero.IsWanderer
- hero.IsRuralNotable
- hero.IsUrbanNotable
- hero.IsHeadman
- hero.IsMinorFactionHero
- hero.IsNotable
Equipment
Equipment equipment = Hero.MainHero.BattleEquipment;
Equipment equipment = Hero.MainHero.CivilianEquipment;
Relations
CharacterRelationManager.SetHeroRelation(Hero.MainHero, otherHero, -25);
void CharacterRelationManager.SetHeroRelation(Hero hero1, Hero hero2, int value)
int CharacterRelationManager.GetHeroRelation(Hero hero1, Hero hero2)
int relation = notable.GetRelation(clan.Leader);
ChangeRelationAction.ApplyRelationChangeBetweenHeroes(notable, clan.Leader, -20, true);
Are we at war?
Culture
Hero.Culture
Check: if (hero.Culture.StringId == "sturgia") ..
States
CharacterStates
- NotSpawned
- Active
- Fugitive
- Prisoner
- Released
- Dead
- Disabled
- Traveling
Attributes
- IsKnown - we checked him in Encyclopedia, met him
- HasMet - we actualy met him (participated in dialog)
- LastMeetingTimeWithPlayer - last time we met him
- Hero.EncyclopediaText = new TextObject("Alive and kicking!"); - Encyclopedia text
Voice
Can be set in the lords.xml file:
Voice types:
- curt
- earnest
- ironic
- softspoken
Also depends on the culture.
Kill Character
Other ways to kill
- ApplyByOldAge // did not work in console cmd test
- ApplyByWounds
- ApplyByBattle // did not work in console cmd test
- ApplyByMurder
- ApplyInLabor
- ApplyByExecution
- ApplyByRemove // worked
- ApplyByDeathMark
- ApplyByDeathMarkForced
- ApplyByPlayerIllness
Based on how the hero was killed, Hero.DeathMark is created
Hero.DeathMark values
public enum KillCharacterActionDetail
{
None,
Murdered,
DiedInLabor,
DiedOfOldAge,
DiedInBattle,
WoundedInBattle,
Executed,
Lost
}
An obituary in the Encyclopedia depends on it (he died of natural causes/was killed/disappeared/etc):
victim.EncyclopediaText = KillCharacterAction.CreateObituary(victim, actionDetail);
Also Hero.DeathMarkKillerHero points to the killer Hero if applicable (public void AddDeathMark).
Not-wounded party heroes list
List<Hero> heroList = (from characterObject in Hero.MainHero.PartyBelongedTo.MemberRoster.GetTroopRoster()
where characterObject.Character.HeroObject != null && !characterObject.Character.HeroObject.IsWounded
select characterObject.Character.HeroObject
).ToList<Hero>();
Special Items
public List<ItemObject> SpecialItems
Conversation Tags
TaleWorlds.CampaignSystem.Conversation.Tags
List
- AlliedLordTag
- AmoralTag
- AnyNotableTypeTag
- ArtisanNotableTypeTag
- AseraiTag
- AttackingTag
- AttractedToPlayerTag
- BattanianTag
- CalculatingTag
- CautiousTag
- ChivalrousTag
- CombatantTag
- ConversationTag
- ConversationTagHelper
- CruelTag
- CurrentConversationIsFirst
- DefaultTag
- DeviousTag
- DrinkingInTavernTag
- EmpireTag
- EngagedToPlayerTag
- FirstMeetingTag
- FriendlyRelationshipTag
- GangLeaderNotableTypeTag
- GenerosityTag
- HeadmanNotableTypeTag
- HighRegisterTag
- HonorTag
- HostileRelationshipTag
- ImpoliteTag
- ImpulsiveTag
- InHomeSettlementTag
- KhuzaitTag
- LowRegisterTag
- MerchantNotableTypeTag
- MercyTag
- MetBeforeTag
- NoConflictTag
- NonCombatantTag
- NonviolentProfessionTag
- NpcIsFemaleTag
- NpcIsLiegeTag
- NpcIsMaleTag
- NpcIsNobleTag
- OldTag
- OnTheRoadTag
- OutlawSympathyTag
- PersonaCurtTag
- PersonaEarnestTag
- PersonaIronicTag
- PersonaSoftspokenTag
- PlayerBesiegingTag
- PlayerIsAffiliatedTag
- PlayerIsBrotherTag
- PlayerIsDaughterTag
- PlayerIsEnemyTag
- PlayerIsFamousTag
- PlayerIsFatherTag
- PlayerIsFemaleTag
- PlayerIsKinTag
- PlayerIsKnownButNotFamousTag
- PlayerIsLiegeTag
- PlayerIsMaleTag
- PlayerIsMotherTag
- PlayerIsNobleTag
- PlayerIsRulerTag
- PlayerIsSisterTag
- PlayerIsSonTag
- PlayerIsSpouseTag
- PreacherNotableTypeTag
- RogueSkillsTag
- RomanticallyInvolvedTag
- SexistTag
- SturgianTag
- TribalRegisterTag
- UncharitableTag
- UnderCommandTag
- UngratefulTag
- ValorTag
- VlandianTag
- VoiceGroupPersonaCurtLowerTag
- VoiceGroupPersonaCurtTribalTag
- VoiceGroupPersonaCurtUpperTag
- VoiceGroupPersonaEarnestLowerTag
- VoiceGroupPersonaEarnestTribalTag
- VoiceGroupPersonaEarnestUpperTag
- VoiceGroupPersonaIronicLowerTag
- VoiceGroupPersonaIronicTribalTag
- VoiceGroupPersonaIronicUpperTag
- VoiceGroupPersonaSoftspokenLowerTag
- VoiceGroupPersonaSoftspokenTribalTag
- VoiceGroupPersonaSoftspokenUpperTag
- WandererTag
- WaryTag
Hero XML
Add an entry into heroes.xml
<Hero id="lord_lit_1_1" faction="Faction.clan_lit_1" spouse="Hero.lord_lit_1_2" father="Hero.lit_1_0" mother="Hero.lit_1_00" alive="false" text="Encyclopedia text for the hero" />
- id - heroe's ID by which it will be referenced in other files
- faction - clan, in a format: Faction.CLAN_ID
- spouse - Hero.SPOUSE_HERO_ID
- father - Hero.FATHER_HERO_ID
- mother - Hero.MOTHER_HERO_ID
- alive - default true, set to false for dead hero
- text - Encyclopedia text
How to properly make a lord dead in XML?
alive="false" makes him dead, but in description it writes: HERO_NAME is member of ...
Lord XML
Add an entry into lords.xml