查看“死亡模组制作”的源代码

{{version|2.6}}

As of [[patch 2.6]], death reasons and text displayed on [[succession]] screen have become moddable.

==Death reasons==

Death reasons are defined in folder <code>common/death/</code>.

The format is:

<pre>
<death_reason> = {
	long_desc = DEATH_REASON_DESC
	sound_list = {
		female = {
			"female_violent_death_01"
		}
		male = {
			"male_violent_death_01"
		}
	}
}
</pre>

All are optionals, except for <code>long_desc</code>:

{| class="wikitable sortable"
|-
!Configuration key
!Type
!Description
|-
|violent
|bool
|
|-
|long_desc
|key
|Localization key. Ex: DEATH_BY_MURDER_UNKNOWN (died under suspicious circumstances).
* In case a killer is specified(e.g. <code>death = { death_reason = death_battle killer = FROM}</code>), the variable $KILLER$ will have its name.
* <code>death_trait</code> is a bit special, as it will inject variable $TRAIT_DEATH$ in localization, with the <code><trait_name>_death</code> text, defined for traits that reduce heath.
|-
|can_nokiller
|bool
|
|-
|murder_unknown
|bool
|
|-
|sound
|bool
|If set to no, killing someone with that reason will not cause a death sound.
|-
|sound_list
|list<sfx>
|Female and male lists of death sounds.
*For custom death sounds, sound files are placed in the sound folder and referenced by sound.sfx, within the interface folder.
|-
|execution
|bool
|
|-
|death_date_desc
|key
|Changes the text shown when hovering over someone's age. Useful for death reasons like "Went to China" that aren't really outright dying.
|-
|}

== Execution methods ==

When executing someone, an execution method is randomly determined from the execution methods defined in the <code>common/execution_methods</code> folder.
They are written in <code>execution_method</code> blocks. Each execution method must contain a [[#Death reasons|death reason]] defining the sound and description of the death. They also contain a weight multiplier to determine which of the available death reasons are used.
Finally, they contain a trigger. If the trigger evaluates to false, the execution method is not available.

Within the <code>weight_multiplier</code> and <code>trigger</code> blocks, FROM is the executioner and ROOT is the executed.

=== Example ===

<pre>execution_method = {
    death = death_execution_bear
    weight_multiplier = {
        factor = 50
        modifier = {
            factor = 8
            FROM = { trait = hunter }
        }
        modifier = {
            factor = 3
            FROM = { trait = cruel }
        }
    trigger = {
        FROM = {
            capital_scope = {
                NOR = {
                    region = world_india
                    region = world_africa
                }
            }
        }
    }
}</pre>

==Succession screen==

Some flavor text appears on succession screen with:
*an epitaph of deceased ruler
*a presentation of the heir

This is configured in <code>common/death_text</code> and <code>common/heir_text</code> respectively.

<pre>
death_text_proud = {
	weight_multiplier = {
		factor = 10
	
		modifier = {
			factor = 0
			OR = {
				NOT = { trait = proud }
				is_wicked = no
			}
		}
	}
}
</pre>

<pre>
heir_text_traits_falconer = {
	weight_multiplier = {
		factor = 25
	
		modifier = {
			factor = 0
			is_adult = no
		}
		modifier = {
			factor = 0
			NOT = {
				trait = falconer
			}
		}
	}
}
</pre>


[[Category:模组制作]]
{{ModdingNavbox}}