查看“荣誉头衔模组制作”的源代码

{{version|2.7}}

[[Minor titles]] can be given out for prestige or opinion modifiers. They are defined in the files contained in the <code>/common/minor_titles/</code> folder.

Note that minor titles are ''always'' scoped to the liege's main title, so it's not possible to give a title to a character that resides in a different court.

== Basic minor title ==

You can make a basic [[minor title]] in a really easy way. Add a '''.txt''' file to your mod's <code>/common/minor_titles/</code> folder. As long as it does not have the same name as the files in the base game's <code>/common/minor_titles/</code> folder it will add to the list of minor titles.

<pre>
title_houndmaster = {
    dignity = 0.10
    grant_limit = 1
    opinion_effect = 5

    monthly_salary = 0.1
    monthly_prestige = 0.15

    is_unique = yes

    allowed_to_hold = {
        is_adult = yes
        NOT = { trait = incapable }
    }
    allowed_to_grant = {
        AND = {
            is_feudal = yes
            OR = {
                has_landed_title = k_lalaland
                has_landed_title = k_timbuktu
            }
        }
    }
}
</pre>

The example above will add a minor title that can be granted to any adult who is not incapable. It can only be granted in the kingdoms of lalaland and timbuktu, and they must be feudal.

== Properties ==

{| class="wikitable sortable"
|-
!Name 
!Value
!Effect
!Example
|-
|is_high_prio
|bool
|Displays an alert when the title is vacant.
|<code>is_high_prio = yes</code>
|-
|show_as_title
|bool
|The minor title will be displayed as the holder's main title, overriding other titles such as Count, Duke, etc.
|<code>show_as_title = yes</code>
|-
|realm_in_name
|bool
|Appends the name of the country after the title (Queen [of Sweden])
|<code>realm_in_name = yes</code>
|-
|is_voter
|bool
|Whether the holder has a seat on the council. See [[Councillor modding]].
|<code>is_voter = yes</code>
|-
|dignity
|number
|Adds the specified amount of dignity to the title holder.
|<code>dignity = 0.10</code>
|-
|attribute
|attribute
|The optional main attribute that will improve the efficiency of the holder. When opening the UI the candidates will be sorted using this attribute by default.
|<code>attribute = martial</code>
|-
|grant_limit
|integer
|Maximum number of holders for this title.
|<code>grant_limit = 1</code>
|-
|opinion_effect
|integer
|Opinion from the holder of title to his liege. 5 would be a +5 opinion.
|<code>opinion_effect = 5</code>
|-
|monthly_salary
|number
|The amount the holder will earn by holding this minor title in one month.
|<code>monthly_salary = 0.1</code>
|-
|monthly_prestige
|number
|The amount of prestige accrued each month by the holder of this minor title.
|<code>monthly_prestige = 0.15</code>
|-
|is_unique
|bool
|Whether this title can be cumulated with another honorary title or not.
|<code>is_unique = yes</code>
|-
|allowed_to_hold
|[[conditions]] (character scope)
|Determines which characters are eligible to hold this minor title. ROOT is the character being checked. FROM is the liege granting the title.
|<pre>
allowed_to_hold = {
    is_adult = yes
    NOT = { trait = incapable }
}
</pre>
|-
|allowed_to_grant
|[[conditions]] (character scope)
|Determines who is allowed to grant this title. This might be restricted by religion, culture, traits, or simply limited to one kingdom or duchy.
|<pre>
allowed_to_grant = {
    has_landed_title = k_lalaland
}
</pre>
|-
|gain_effect
|[[commands]] (character scope)
|Fires when the title is granted
|
|-
|revoke_trigger
|[[conditions]] (character scope)
|
|
<pre>
revoke_trigger = {
  FROM = {
    primary_title = {
      NOT = { 
        AND = {
          has_law = succession_voting_power_1
          ROOT = { is_powerful_vassal = yes }
        }
      }
    }
  }
}
</pre>
|-
|lose_effect
|[[commands]] (character scope)
|Fires when a title is lost if <code>allowed_to_hold</code> evaluates to false
|<pre>
lose_effect = {
  opinion = { 
    who = FROM
    modifier = opinion_fired_from_council
  }
}
</pre>
|-
|retire_effect
|[[commands]] (character scope)
|
|
|-
|death_effect
|[[commands]] (character scope)
|Fires when a character dies while holding this title
|
|-
|message
|bool
|Fires a message to the its owner when set
|
|-
|patrician_heir
|bool
|Special title that determines the heir of a Patrician
|<code>patrician_heir = yes</code>
|-
|counts_as_purple_born
|bool
|Holder of the title counts as born-in-the-purple for Byzantine Empire succession.
|<code>counts_as_purple_born = yes</code>
|-
|<other fields>
|character [[modifiers]]
|Modifiers applied to the holder of the title.
|
|}

== Localisation ==

You want the minor title to be named and described properly in the game, so we need to add some localisation. So create a new file in the '''/localisation/''' folder of your mod. It must be a [[Wikipedia:Comma-separated values|CSV]] file, so the name could be something like '''00_Minor_titles.csv'''.

 #CODE;ENGLISH;FRENCH;GERMAN;;SPANISH;;;;;;;;;x
 title_houndmaster;Houndmaster;;;;;;;;;;;;;x
 title_houndmaster_desc;An honorary title granted to the finest master of canines in the land.;;;;;;;;;;;;;x

Note that the code for the description is simply the code for the minor title with '''_desc''' at the end.

[[Category:Modding]]
{{ModdingNavbox}}