编辑“Leader modding”

{{version|3.0}}

This page is about modding the [[Leaders]].

== Overview ==
Leader Classes are defined at "common/leader_classes/xxx.txt".

Actually, a leader can have separated set of traits for each leader class and will switch between them if their leader class is changed. A leader that becomes the empire ruler receives a new set of ruler traits, overwritting its previous traits and not even traits that increase the leader lifespan can affect the leader for now, before it's elected out from the seat and return to its previous class.

You must understand that:
* There are 6 kinds of {{yellow|hard-code classes}}, namely Ruler, Governor, Scientist, Admiral, General and Envoy, and 6 kinds of {{green|shell classes}} to define some moddable characteristics.
* Everywhere else that referencing to a leader class are referencing to {{yellow|hard-code classes}}, not the {{green|shell classes}}.
* Adding more {{green|shell classes}} doesn't make sense because they are never called by the game engine.
* Removing the {{green|shell classes}} doesn't crash the game but this kind of leaders can't be generated.

This article is talking about the modding of {{green|shell classes}}. There is no way to mod {{yellow|hard-code classes}}.

== Data Structure ==
{| class="wikitable mw-collapsible"
|-
! width="30%" | Property
! width="70%" | Description
|- 
| '''max_trait_points = <int>'''
| The number of trait points. Leader traits have "costs" that a newly generated leader can't have more trait points than the number specified here.

All vanilla leader traits that can be given to a newly generated leader have trait cost 1.

Rulers have 2 trait points, making them to be generated with 2 traits.

Envoys have 0, making them to have no traits upon generation.

Other leader classes have 1.
|- 
| '''resources'''
| An [[Economy_modding#Economy_Units|Economy Unit]] to define the hiring cost and upkeep of this leader. Though vanilla unused, leaders can also produce resourced.
|- 
| '''default_category'''
| A newly generated leader of this {{green|shell class}} will fall into the specified {{yellow|hard-code class}} by default.
|- 
| '''can_govern_planet = <yes/no>'''<br>'''can_research = <yes/no>'''<br>'''can_lead_navy = <yes/no>'''<br>'''can_lead_army = <yes/no>'''<br>'''can_rule_empire = <yes/no>'''<br>'''can_be_envoy = <yes/no>'''
| Defines what kind of tasks can this leader be assigned to.

Making a leader to do something that's usually not its job will switch its {{yellow|hard-code class}} and it receives a new set of traits for that class if it doesn't have yet.
|}

There is a few practical we can do with leader classes, for example:
* Modify the trait points of leaders to make them spawn with more traits.
* Add "produces" with "potential" to the economy units to implement something that make leaders to produce resources.

== Dynamic Modding ==
=== How to scope to a leader ===
Use scopes like <code>leader</code> and <code>ruler</code> to scope to the leader that's leading something.

Use scopes like <code>every_owned_leader</code> and <code>every_pool_leader</code> to evaluate some Effects through all leaders in an Empire that meet some conditions. Envoys can't be scoped this way.

Since Stellaris v2.7.1, a few more statements have been implemented for Envoys.
* <code>any/every/random/count_envoy</code> can be used to scope to Envoys.
* <code>has_envoy_task = { task = harm_relations/improve_relations/galactic_community/federation (optional: who = country) }</code> to check Envoy assignment.
* <code>envoy_location_country</code> can be used on Envoys to scope to the Empire this Envoy is harming / improving relation with.
* <code>has_envoy_cooldown = yes/no</code> to check if an Envoy is at cooldown,

=== How to make leaders spawn with a trait, like Psychic ===
Use the On-Actions <code>on_leader_spawned</code>, <code>on_ruler_set</code> and <code>on_ruler_back_to_pre_ruler_class</code> to manually add and remove traits of Leaders. See [[Event modding]] for details.

=== How to modify leader starting age ===
These can be modified through species classes and species traits. See [[Species modding]] and [[Traits modding]] for details.


{{ModdingNavbox}}
[[Category:模组制作]]
说明	输入内容	输出结果
斜体	''斜体文字''	斜体文字
粗体	'''粗体文字'''	粗体文字
粗斜体	'''''粗斜体文字'''''	*粗斜体文字*