查看“宝物模组制作”的源代码

{{version|2.7}}

[[Artifacts]] are part of free [[patch 2.7]] and don't actually require [[Monks and Mystics]] expansion (though most vanilla artifacts are part of the expansion).

They allow classical-RPG concepts of treasury (stash) and equipable slots (inventory). 

==Artifacts==

{| class="wikitable sortable"
!Variable
!Type
!Description
!Example
|-
|quality
|int
|
|<code>quality = 2</code>
|-
|flags
|List<string>
| Flags that can be checked with <code>has_artifact_flag</code> condition.
|<code>flags = { chest hermetics very_rare }</code>
|-
|active
|Character [[conditions]]
| Conditions for the artifact to be usable by a character. See <code>is_artifact_active</code> condition.
* An artifact with an active trigger but without owner will never be considered active
* An artifact without an active trigger will always be considered active, even if not owned.
|<pre>
active = {
  is_adult = yes
}
</pre>
|-
|allowed_gift
|Character [[conditions]]
|Conditions for the trigger <code>artifact_can_be_gifted_to</code>.
|-
|stacking
|bool
|If no, can only have a single copy of this artifact in one's possession. Defaults to "yes".
|<code>stacking = no</code>
|-
|indestructible
|bool
|Whether <code>destroy_artifact</code> has any affect. Defaults to "no".
|<code>indestructible = yes</code>
|-
|picture
|gfx
| Defines the gfx name, typically GFX_<artifact_name>
2 images are needed:
*118x118px for GFX_<artifact_name>
*59x59px for GFX_<artifact_name>_small
|<code>picture = "GFX_strange_chest"</code>
|-
| ''<modifier>''
| Character [[modifiers]]
| Modifiers given by the artifact when it is equipped.
|
<pre>
martial = 2
monthly_character_piety = -2
tech_growth_modifier = 0.05
combat_rating = 2
</pre>
|-
|slot
|string
|Associated slot to equip the artifact. New slots can be added dynamically.
|<code>slot = crown</code>
|-
|}

Localization:
*'''<artifact_name>''': name of the artifact
*'''<artifact_name>_desc''': description of the arftifact
*'''<slot>''': name of the equipment slot

Pictures:
* The pictures are set in gfx/interface/inventory/artifacts
* The link between the GFX code and the picture is in Vanilla file interface/domestic_treasury.gfx
* You can use artifact backgrounds (arti_bg.dds, arti_bg_glow.dds, arti_bg_small.dds, and arti_bg_glow_small.dds) in gfx/interface/inventory/artifacts to make artifacts that follow the style of the vanilla artifacts

==Slots==

Artifacts can be equipped or unequipped. Number of equipped artifacts are limited by dynamic "slots":

<pre>
slots = {
	weapon = 1
	ceremonial_weapon = 1
	scepter = 1
	crown = 1
	wrist = 1
	neck = 1
	torso = 1
	library = 4
}
</pre>

==Artifact spawns==

Determines the generation of artifacts at the begining of a game.

{| class="wikitable sortable"
!Variable
!Type
!Description
!Example
|-
|max_amount
|int
|How many artifacts do we hand out? Default is 4,294,967,295
|<code>max_amount = 1</code>
|-
|spawn_date
|date
|What date should it claim to have been created? Note that this could be in the future; the spawn chance should be handled in spawn_chance. If a date at or before 1.1.1 is used, it'll state "Unknown Date".
|<code>spawn_date = -1.1.1</code>
|-
|spawn_chance
|[[MTTH]]
|Decides whether an artifact spawn should execute or not. Range is 0-100. Default behaviour is to always spawn.
|<pre>
# 50% chance to execute an artifact spawn
spawn_chance = {
	value = 50
}
</pre>
|-
|weight
|[[MTTH]]
|Character scope, evaluates a potential artifact holder score, which is then used for randomizing who gets an artifact. Default behavior is for everyone to have the same chance.
|
<pre>
# Only christians have a chance of getting an artifact
weight = {
	value = 0
	additive_modifier = {
		value = 100
		religion_group = christian
	}
}
</pre>
|-
|artifacts
|clause
|List of keys and [[MTTH]] for which artifact is spawned.
|<pre>
# 50% chance that the person will get a golden_platypus
artifacts ={
	golden_platypus = {
		value = 1
	}
	crystal_platypus = {
		value = 1
	}
}
</pre>
|-
|}

==Migrate from traits==

Here is the equivalence to replace traits into artifacts:

{| class="wikitable"
!Behavior
!Trait
!Artifact
|-
|Possession
|has_trait = xxx
|has_artifact = xxx
|-
|Creation
|add_trait = xxx
|add_artifact = xxx
|-
|Destruction
|remove_trait = xxx
|destroy_artifact  = xxx
|-
|Transfer
|
<pre>
FROM = {
	remove_trait = xxx
}
ROOT = {
	add_trait = xxx
}
</pre>
|
<pre>
random_artifact = {	
	artifact_type = xxx
	transfer_artifact = {
		from = FROM
		to = ROOT
	}
}
</pre>
|-
|Uniqueness
|<code>xxx = { cached = yes }</code> trait, and xxx = { always = yes }
|?
|-
|}

==References==

<references/>

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