Religion modding

From Crusader Kings II Wiki
Jump to: navigation, search
Religions and religion groups are defined within the /common/religions folder.

Religion group[edit]

Each religion belongs to a religion group, for instance:

  • Catholic and Orthodox religions belong to the Christian group,
  • Sunni and Shiite religions belong to the Muslim group.

Note that interfaces and some behaviors are hardcoded based on vanilla religion groups:

  • pagan_group: reformation button in religion interface, unreformed Pagans cannot demand religious conversion

The religion group is defined as a group tag with an alphanumerical ID. A religion group must have graphical_culture defined, and one or more religion.

An example of a religion group definition (with religions) would be:

zoroastrian_group = {
	has_coa_on_barony_only =yes
	graphical_culture = muslimgfx
	#religions go here

Below is a list of all parameters that can be set for religion groups.

Attribute Type Description Example
color color The color used for the coalitions -per religion group- map mode color = { 0.25 0.5 0.75 }
graphical_culture ID Only used for the display of CoA frames on the map. graphical_culture = norsegfx
has_coa_on_barony_only boolean This line determines whether or not the religion will utilise random graphics for their COAs above barony level:
  • has_coa_on_barony_only = yes: Generate random CoA for baronies, but use gfx/flags/ for higher tiers.
  • has_coa_on_barony_only = no: Generate random CoA for all tiers, and ignore completely gfx/flags/.

Note that this only works on religion group, and cannot be overriden for a specific religion.

has_coa_on_barony_only = yes
hostile_within_group bool Decides if holy orders will fight other religions within the same group
crusade_cb ID Defines whether a religion group can have crusades/jihads. In vanilla CKII, this only applies to the Christian and Muslim religion groups. crusade_cb = crusade
playable boolean Defines whether characters of this religion are playable. Does not apply to the "muslim" group, as it can only be enabled by Sword of Islam playable = yes
ai_peaceful boolean Will make Hordes lose their super aggressiveness, upon conversion to this religion ai_peaceful = yes
ai_fabricate_claims boolean ai_fabricate_claims = no


Below is a list of all parameters that can be set for religions. Note that everything from investiture and below is optional.

Attribute Type Description Example
ai_convert_same_group int Determines if AI sends court chaplain to proselytize on religions of same religious group:
  • 0: never try to convert
  • 1: try to convert if ai_zeal is high
  • 2: always try to convert
ai_convert_same_group = 2
ai_convert_other_group int Determines if AI sends court chaplain to proselytize on religions of other religious groups:
  • 0: never try to convert
  • 1: try to convert if ai_zeal is high
  • 2: always try to convert
ai_convert_other_group = 1
graphical_culture ID Only used for the display of CoA frames on the map. graphical_culture = norsegfx
icon int Defines which icon will be used for the religion in-game. The value is ignored for heresies (unless the heresy becomes mainstream religion), and the heresy_icon of the parent religion will be used instead. icon = 1
color color The color used when drawing the religion map mode
RGB format with a range of 0.0–1.0. To determine a value from the RGB, simply divide by 255, e.g. 180 ÷ 255 = 0.7
color = { 0.25 0.5 0.75 }
crusade_name key Defines a localization key for the name of the religion's crusade. Only applicable to religion group groups with crusade_cb = crusade defined. crusade_name = "CRUSADE"
scripture_name key Defines a localization key for the religion's holy text. scripture_name = THE_BIBLE
god_names list<key> Defines localization keys for the religion's deity or deities, within curly brackets and separated by spaces. god_names = { GOD_GOD GOD_THE_LORD }
high_god_name key Localization key for high god high_god_name = GOD_GOD
evil_god_names list<key> Defines localization keys for the religion's evil deity or deities, within curly brackets and separated by spaces. evil_god_names = { SATAN LUCIFER THE_DEVIL }
piety_name key Defines localization keys for the religion's piety. piety_name = KARMA
priest_title key Defines localization key for temple holders priest_title = PRIEST
investiture bool Determines if it is possible to appoint bishops. Is modified by Investiture law investiture = yes
can_excommunicate bool Determines if the religious head can excommunicate members of the religion can_excommunicate = yes
can_grant_divorce bool Determines if the religious head can grant divorces to members of the religion can_grant_divorce = yes
can_grant_invasion_cb cb Determines if the religious head can grant the invasion Casus Belli can_grant_invasion_cb = invasion
can_grant_claim bool Determines if the religious head can grant claims (actually not working) can_grant_claim = yes
can_hold_temples bool Feudal characters can hold temple holdings without penalty. can_hold_temples = yes
can_call_crusade bool Determines if the religious head can call crusades can_call_crusade = yes
can_have_antipopes bool Activates Antipope can_have_antipopes = yes
can_retire_to_monastery bool Activates order to take the vows diplomatic action can_retire_to_monastery = yes
parent religion Makes the religion a heresy of its parent religion. The parent religion must be defined before. Note: reformed pagans can have heresies, but they need to be defined after both reformed and unreformed religions. parent = catholic
priests_can_marry bool Determines if the clergy can get married priests_can_marry = yes
priests_can_inherit bool Whether priests are excluded from succession priests_can_inherit = no
feminist bool Nullifes the negative opinion modifier that vassals normally get if the ruler is female or has female heir feminist = yes
pacifist bool Denotes religions with decreased aggression and stable realms. Only works on Jain religion if player does not own Rajas of India. pacifist = yes
bs_marriage bool Allows brother-sister marriages bs_marriage = yes
pc_marriage bool Allows parent-child marriages pc_marriage = yes
psc_marriage bool Disallow uncle-niece and aunt-nephew marriages psc_marriage = no
cousin_marriage bool Disallow cousin marriages cousin_marriage = no
matrilineal_marriages bool Disallow matrilineal marriages matrilineal_marriages = no
intermarry religion Specifies if members tend to marry those of specific other religions/religion group intermarry = norse_pagan_reformed
max_wives int Determines the max number of wives members of the religion can have. As well as the number of potential wives automatically generated for the court. max_wives = 4
allow_viking_invasion bool Allows the "Prepare Invasion" diplo action allow_viking_invasion = yes
allow_looting bool Allows looting allow_looting = yes
seafarer bool A.I. will prefer coastal provinces when raiding. seafarer = yes
allow_rivermovement bool Allows river navigation allow_rivermovement = yes
female_temple_holders bool Allows female temple vassals female_temple_holders = yes
short_reign_opinion_year_mult integer Opinion penalty multiplier to short reign years. Override the define SHORT_REIGN_OPINION_MULT = 2. short_reign_opinion_year_mult = 3
aggression double AI aggression factor aggression = 1.5
max_consorts int Max number of consorts / concubines max_consorts = 3
religious_clothing_head int Index of frames to use for the religious head cloths & headgear. See portrait modding. religious_clothing_head = 3
religious_clothing_priest int Index of frames to use for priest cloths & headgear. See portrait modding. religious_clothing_priest = 3
secondary_event_pictures [Verification needed] secondary_event_pictures = norse_pagan
autocephaly bool Autocephaly behavior autocephaly = yes
divine_blood bool Sacred Xwedodah close-kin marriage mechanics divine_blood = yes
has_heir_designation bool Allows to designate heir has_heir_designation = yes
defensive_attrition bool Defensive attrition in provinces defensive_attrition = yes
ignores_defensive_attrition bool Used for religions that do not have defensive attrition, but will still not get the penalty towards such religions. ignores_defensive_attrition = yes
heresy_icon int Heresy icon. Note that this has to be set in the parent religion, not at heresy level. heresy_icon = 7
independence_war_score_bonus int Overrides define CONTESTED_TITLE_OCCUPIED_WARSCORE_BONUS_INDEP independence_war_score_bonus = 30
peace_prestige_loss bool Lose Prestige while at peace peace_prestige_loss = yes
peace_piety_gain double Gain piety while at peace (piety per month) peace_piety_gain = 1.0
raised_vassal_opinion_loss bool Determines whether raised vassal levies cause negative opinion overtime against the liege. raised_vassal_opinion_loss = no
reformed religion Note: the reformed religion needs to precede the unreformed religion in the file. reformed = aztec_reformed
reformer_head_of_religion bool Make the character that reforms this religion the head of the new reformed faith. Must be set on the non-reformed religion.
  • The title of the reformed religion (d_<religion_reformed>) must NOT have primary = yes, otherwise it will cause game over. landless = yes may not be an issue [?]
  • You also need to do some government modding otherwise character will get nogovernment. In government potentials replace NOT = { religion = norse_pagan_reformed } into the more generic NOT = { primary_title = { is_landless_type_title = no } }
reformer_head_of_religion = yes
pre_reformed bool Makes the pagan religion pre-reformed. Note that these religions won't appear in the ledger. pre_reformed = yes
unit_modifier unit modifiers Modifiers for units
unit_home_modifier unit modifiers Modifiers for units on home territory
character_modifier character modifiers Modifier for all characters of this religion character_modifier = { learning = 4 }
expel_modifier modifiers [Verification needed] expel_modifier = expelled_jewish
landed_kin_prestige_bonus bool Gives a prestige bonus for having landed 'kings as vassal. landed_kin_prestige_bonus = yes
allow_in_ruler_designer bool Prevents the religion from appearing in Ruler Designer, typically pagan reformed religions. allow_in_ruler_designer = no
dislike_tribal_organization bool Vassals of this religion will disapprove and form factions if their liege increases tribal organization. Typically used for unreformed pagans, that should first convert to a Monotheistic religion before attempting to go feudal. dislike_tribal_organization = yes
uses_decadence bool Decadence will be used if the religion AND government of a character is scripted to use decadence. uses_decadence = yes
uses_jizya_tax bool uses_jizya_tax = yes
attacking_same_religion_piety_loss bool attacking_same_religion_piety_loss = yes


christian = {
    has_coa_on_barony_only = yes
    graphical_culture = westerngfx
    crusade_cb = crusade
    playable = yes
    ai_peaceful = yes # Will make Hordes lose their super aggressiveness
    catholic = {
         graphical_culture = westerngfx
         icon = 1
         color = { 0.8 0.8 0.6 }
         crusade_name = "CRUSADE"
         scripture_name = THE_BIBLE
         god_names = {
         investiture = yes
         can_excommunicate = yes
         can_grant_divorce = yes
         can_grant_invasion_cb = invasion
         can_grant_claim = yes
         can_call_crusade = yes

Adding icons[edit]

Adding new religious icons is a fairly simple process. First you will need to modify the files and within CKII\gfx\interface. In, expand the canvas of the image to the right by 32 pixels for each new icon, and in religion_icon_strip_small expand it by 20 pixels for each new icon. Once you have added your new icons, you will need to edit the file "generalstuff.gfx" within the CKII\interface folder (. Increase the noOfFrames = line by the number of icons you have added. Once done, you can then use your new icons in your religions, from left to right is 1-X.

	spriteType = {
		name = "GFX_religion_icon_strip"
		texturefile = "gfx\\interface\\religion_icon_strip.tga"
		noOfFrames = 10

	spriteType = {
		name = "GFX_religion_icon_strip_small"
		texturefile = "gfx\\interface\\religion_icon_strip_small.tga"
		noOfFrames = 10

Religious head[edit]

Religious heads can be established via the landed titles entries. You must first create a title of any rank, and add the variable controls_religion = X into that title's entry. For example;

k_coptic = {
   capital = 1
   religion = monophysite
   controls_religion = monophysite

The holder of the above title will thus appear as the Religious head for the Monophysite religion/heresy. The religion = monophysite line is also recommended to ensure any/all random characters generated for that title will be of the same religion, without it, if the province within which the capital = variable is set is catholic, you may end up with a Catholic Religious Head of the Monophysite Faith.

Holy sites[edit]

Holy sites are flagged at county level via the landed titles entries.

c_koln = {
  holy_site = catholic

For maintenance it is preferable to override only the counties and flag the holy sites via a separate file under /common/landed_titles/, without duplicating landed_titles.txt

It is also possible to define holy sites for heresies, though the game will fallback to the one of parent religion if not used.

Crusade target weights[edit]

Crusade target weights are set inside landed titles entries.

k_lotharingia = {
  catholic = 5000

Note that the A.I. will never start a crusade in case there are no targets weights for that religion.

Papal succession[edit]

Adding a religion to succ_papal_succession succession laws, and defining some religious titles, will cause the game to CTD when opening the religion tab.

A bit of interface modding is required so that it works.


In case a religion is not in pagan_group, it will not inherit from the hardcoded reformation mechanics (reform button in religion screen).

A workaround is to create a decision that does something similar, see this tutorial: [Tutorial] Religion Reformation Work Around For Non-Pagans.

See also[edit]

DefinesGame rulesReligionCultureTraitsTechnologyLawsBuildingsCasus BelliObjectivesGovernmentsDiseaseDeathMinor titles