Traits are a major part of CKII and thus also for any overhaul mod. This article will explain everything you need to know about trait modding. Notepad++ is strongly recommended for modding traits, but Notepad or other plain text editors can also be used.
Definition
Traits must be defined in the folder common/traits/. To make the trait, you will first need to tell the game what effects it has. That will be done here. For this tutorial, a 'selfish' trait will be used as an example. To start off, give the trait a name:
selfish = { }
Type
After defining the trait itself, you'll want to define its flags. The flags you can use are listed below.
The trait icons are grouped by type in-game, from left to right: education
, caste_tier
, undefined, lifestyle
, personality
, is_health
.
Inside a group, the order is based on the order the traits have been added to the character.
代碼名稱 | Value | 描述 | 例子 | 代碼 |
---|---|---|---|---|
agnatic | bool | 有這種特質的父親的孩子總是會繼承這種特質。 | agnatic = yes | |
birth | int | 10000個出生的角色中帶有這種特質的個數。(例如,100 = 1%) | birth = 100 | |
blinding | bool | The trait reflects permanent blinding of the character while imprisoned. In some cultures, this disinherits them. | blinding = yes | |
cached | bool | All characters that have this trait will be cached for more efficient event trigger evaluation (should be a limited number).
Then the character scope |
cached = yes | |
can_hold_titles | bool | 此特質禁止角色持有任何頭銜。 | can_hold_titles = no | |
cannot_inherit | bool | 此特質禁止角色繼承任何頭銜。 | cannot_inherit = yes | |
cannot_marry | bool | 此特質禁止角色結婚。查看詞條can_marry 。不會禁止納妾。
|
cannot_marry = yes | |
caste_tier | int | 此特質是種姓特質,caste_tier定義了種姓的順序。 | caste_tier = 3 | |
customizer | bool | 如果為非,該特質不會在角色設計器中可供選擇。 | customizer = no | |
education | bool | 此特質是一種教育特質。 | education = yes | |
attribute | attribute | 主要屬性,如教育特質。 | attribute = intrigue | |
enatic | bool | 有這種特質的母親的孩子總是會繼承這種特質。 | enatic = yes | |
hidden | bool | 隱藏特質不會在角色介面顯示。 | hidden = yes | |
immortal | bool | 一旦擁有此特質,角色既不會衰老也不會自然死亡(但會死於處決或效果死亡)。參見詞條永生。 | immortal = yes | |
in_hiding | bool | 此特質會激活「藏匿中」(in_hiding )效果。 | in_hiding = yes | |
inbred | bool | 此特質表明該角色是近親繁殖的,會影響後代、生育能力及自然死亡原因。 | inbred = yes | |
incapacitating | bool | 這個角色很虛弱且需要攝政 | incapacitating = yes | |
inherit_chance | int | 新生兒可以從父母那裡繼承這種特質的概率(可選);如果父母雙方都有這種特質,則為兩次相同概率之和。 | inherit_chance = 15 | |
both_parent_has_trait_inherit_chance | int | both_parent_has_trait_inherit_chance = 50
| ||
is_epidemic | bool | The trait is given by an epidemic outbreak. See has_epidemic condition.
|
is_epidemic = yes | |
is_health | bool | The trait affects the health of a character, usually restricting certain events that require full health. See health_traits condition.
|
is_health = yes | |
is_illness | bool | The trait is a regular disease. See is_ill condition and cure_illness effect.
|
is_illness = yes | |
leader | bool | The trait is a command/leadership trait. See can_have_more_leadership_traits condition.
|
leader = yes | |
leadership_traits | int | The character automatically receives X number of leadership traits (army command traits). | leadership_traits = 1 | |
childhood | bool | The trait is a childhood trait. | childhood = yes | |
lifestyle | bool | The trait is a lifestyle choice. See lifestyle_traits condition.
|
lifestyle = yes | |
opposites | List<trait> | List of traits that cannot be held simultaneously with this trait | opposites = { imbecile quick genius } | |
personality | bool | The trait is a personality trait (see trigger personality_traits = <min. count>) | personality = yes | |
prevent_decadence | bool | The trait prevents the Muslim character from accumulating decadence | prevent_decadence = yes | |
priest | bool | The trait implies a theological education. See is_priest condition)
|
priest = yes | |
pilgrimage | bool | The character is temporarily away and will need a regent but does not lose any wards | pilgrimage = yes | |
random | bool | With random = no , the trait will not be given to randomly-generated characters (when the game starts or when characters are spawned other than by being born). random = yes is the default. Specific semantics vary with the general trait type.
|
random = no | |
rebel_inherited | bool | Used for peasant leader and heresiarch in vanilla. When characters with such traits win the revolt war and die without an heir the successor also gains the peasant leader/heresiarch trait. | rebel_inherited = yes | |
religious | bool | The trait is religious in nature and should be automatically discarded upon religion change. Note: it will also be discarded upon pagan reformation. | religious = yes | |
religious_branch | religion | The trait identifies a sect of that religion. This will also make the children inherit the trait on birth. | religious_branch = jain | |
ruler_designer_cost | int | Sets a custom cost (in years of ruler's age, positive or negative) for this trait in the Ruler Designer. | ruler_designer_cost = -20 | |
tolerates_<religion_group> | bool | The character tolerates characters of that religion group and is tolerated by them. <religion_group> is dynamic and may be a group not present in vanilla. | tolerates_christian = yes tolerates_jewish_group = yes | |
same_trait_visibility | bool | The trait will only be visible on other characters if the player also has it. Handy for things like secret societies, cults, and secret bears.
This is a shortcut for: is_visible = { OR = { character = FROM has_trait = <trait> } } |
Not used in vanilla | same_trait_visibility = yes |
hidden_from_others | bool | The trait will only be visible to the player who has the trait, even other players with the same trait won't see it.
This is a shortcut for |
hidden_from_others = yes | |
is_visible | conditions | Conditions for the trait to be visible:
Typically a character should see their own traits, so at least |
is_visible = { OR = { character = FROM society_member_of = secret_religious_society_catholic AND = { is_close_relative = FROM trait = secretly_catholic } } } | |
vice | bool | vice = yes
| ||
virtue | bool | virtue = yes
| ||
succession_gfx | bool | succession_gfx = yes
| ||
is_symptom | bool | is_symptom = yes
|
In the case of the 'selfish' trait, a personality flag would be used. Do note that it is possible to use multiple flags for a trait.
selfish = { personality = yes }
Modifiers
- 主條目:Modifiers
After setting the trait's flags, you'll likely want to give it some character modifiers and/or a command modifier.
For 'selfish', a stewardship benefit and a diplomacy penalty would be appropriate.
selfish = { personality = yes
stewardship = 2 # The CKII engine doesn't recognize '+', simply write the number when giving positive numbers diplomacy = -1 }
Regarding relations, no one likes someone who is selfish, so in our case, we would have to add an opposite for charitable and a general_opinion:
selfish = { personality = yes
stewardship = 2 # The CKII engine doesn't recognize '+', simply write the number when giving positive numbers diplomacy = -1
opposites = { trait = charitable }
opposite_opinion = -30 general_opinion = -10 }
Regarding AI Weights, which affect how non-player characters will act (most of which primarily affect strategic considerations), for the 'selfish' trait, an ai_rationality would be good.
selfish = { personality = yes
stewardship = 2 # The CKII engine doesn't recognize '+', simply write the number when giving positive numbers diplomacy = -1
opposites = { trait = charitable }
opposite_opinion = -30 general_opinion = -10
ai_rationality = -10 }
Potential
The potential section defines who can randomly start with the trait on campaign start, be randomly generated with the trait (for example via the employment decisions), or gain it randomly when coming of age. It does however not affect the outcomes of events giving the trait; even if the character does not meet the potential conditions he can still get the trait via events.
The potential section is simply one or more conditions. It is put immediately after the opening bracket of the trait. We might for example want to prevent the game from generating selfish children.
selfish = { potential = { age = 16 #This prevents anyone from under 16 being generated with the trait } personality = yes
stewardship = 2 # The CKII engine doesn't recognize '+', simply write the number when giving positive numbers diplomacy = -1
opposites = { trait = charitable } opposite_opinion = -30 general_opinion = -10
ai_rationality = -10 }
Compliments
Since Way of Life it is possible to define localisation keys for compliments and insults which will appear in letters from other characters, or in any other localised text via the [GetRootFromCompliment] and [GetRootFromInsult] (etc.) localisation commands. These keys will need to be localised.
Flag | Description | Code |
---|---|---|
male_compliment female_compliment |
Compliments in a letter to a man/woman | male_compliment = COMPL_SCHOLAR |
male_compliment_adj female_compliment_adj |
Positive Adjectives in a letter to a man/woman | male_compliment_adj = COMPL_LEARNED |
male_insult female_insult |
Insults in a letter to a man/woman | male_insult = INSULT_TORTURER |
male_insult_adj female_insult_adj |
Negative Adjectives in a letter to a man/woman | male_insult_adj = INSULT_EVIL |
child_compliment | Compliments in a letter written by a child, used instead of the adult ones | child_compliment = COMPL_SMARTY |
child_compliment_adj | Positive adjectives in a letter written by a child, used instead of the adult ones | child_compliment_adj = COMPL_CLEVER |
child_insult | Insults in a letter written by a child, used instead of the adult ones | child_insult = INSULT_PEABRAIN |
child_insult_adj | Negative Adjectives in a letter written by a child, used instead of the adult ones | child_insult_adj = INSULT_STUPID |
selfish = { potential = { age = 16 } personality = yes stewardship = 2 diplomacy = -1 opposites = { trait = charitable } opposite_opinion = -30 general_opinion = -10 ai_rationality = -10 male_insult = INSULT_SELFCENTERED female_insult = INSULT_SELFCENTERED male_insult_adj = INSULT_SELFISH female_insult_adj = INSULT_SELFISH }
Icon
Icons make traits easily recognizable to the player. An icon can be made in Photoshop or another image editor. It needs to be 24x24 pixels, and saved as a .dds or .tga file.
When you have your icon, save it in <yourmodfolder>\gfx\traits. Now create a file at <yourmodofolder>\interface\<yourmod>.gfx. You will use this file to tell the game where the icon is stored.
Start by adding this to the file:
spriteTypes = { spriteType = { } }
Make sure that you never repeat the spriteTypes
block! You should instead be adding spriteType
(no "s" on the end) items inside its opening and closing { curly brackets/braces }.
Now, add a line for the name:
spriteType = { name = "GFX_trait_<nameofthetrait>" }
Now you should add a line to tell the game where the icon is stored:
spriteType = { name = "GFX_trait_<nameofthetrait>" texturefile = "gfx/traits/<nameofthetraiticon>.tga" }
Add some standard lines at the end:
spriteType = { name = "GFX_trait_<nameofthetrait>" texturefile = "gfx/traits/<nameofthetrait>.tga" noOfFrames = 1 norefcount = yes effectFile = "gfx/FX/buttonstate.lua" }
For our 'selfish' trait, this would look like this:
spriteType = { name = "GFX_trait_selfish" texturefile = "gfx/traits/selfish.tga" noOfFrames = 1 norefcount = yes effectFile = "gfx/FX/buttonstate.lua" }
Save the file, and your trait should now have an icon.
Localisation
- 主條目:Localisation
Traits require the following localization keys:
- <trait_name> : name of the trait
- <trait_name>_desc : description of the trait
- <trait_name>_death : in case the trait reduces heath (
health = -1
), used to describe the cause for premature "death by trait" (death_reason = death_trait). For instance:
ill_death;after a period of illness;d'une grave maladie;nach einer Zeit der Krankheit;;después de un período de enfermedad;;;;;;;;;x
If we do this with the selfish trait, we will get this:
selfish;Selfish;Égoïste;Selbstsüchtig;;Egoísta;;;;;;;;;x selfish_desc;This character is Selfish and only thinks about himself;Ce personage est Égoïste et ne pense qu'a lui;German;;Spanish;;;;;;;;;x
Save the localisation as a .csv file. Once you have done that, you are done and you now have yourself a new trait!
See also
- Event modding, as traits are mostly given out by events.
歷史 | 角色 • 家族 • 省份 • 頭銜 • 劇本 |
腳本 | 指令 • 條件 • 作用域 • 修正 • 事件 • 決議 |
常規 | 定義 • 遊戲規則 • 另類開局 • 宗教 • 文化 • 政體 • 特質 • 血脈 • 科技 • 法律 • 建築 • 宣戰理由 • 朝貢國 • 單位 • 目標 • 疾病 • 死亡 • 榮譽頭銜 • 社團 • 寶物 • 地圖外政權 • 內閣成員 • 貿易路線 • 繼承 • 奇觀 • 稱號 |
圖像/音效/本地化 | 地圖 • 圖形 • 盾徽 • 肖像 • 介面 • 小地圖 • 音樂 • 本地化 |
其他 | 故障排除 • 驗證器 • 控制台指令 • 編輯遊戲存檔 • Steam創意工坊 • EU4轉檔器模組製作 |