Scripted trigger

artifact_region_trigger

artifact_region_trigger = { CHARACTER = … REGION = … }

game/common/scripted_triggers/00_artifact_triggers.txt, line 145 (67 lines). Parameters: $CHARACTER$ , $REGION$ .

artifact_region_trigger is a scripted trigger in Crusader Kings III, written at line 145 of its file. A call passes 2 parameters: CHARACTER and REGION. The game's script calls it in 129 places, among them book_cover_material_HSB_ivory (artifact), book_cover_material_velvet (artifact) and bow_string_hemp (artifact). Patch 1.20.1.2, from game/common/scripted_triggers/00_artifact_triggers.txt.

What it checks

If any in list › Any in list: Is in the $REGION$ region
Else, if (a hidden condition):
- $CHARACTER$ = { … }
Else, if (a hidden condition) › scope:artifact.artifact_owner:
- If a check the game hides passes: the same again (1 line)
  Their capital province: Is in the $REGION$ region
  Else if a check the game hides passes: the same again (1 line)
  Their location: Is in the $REGION$ region
Otherwise:
- If a check the game hides passes: the same again (1 line)
  Their capital province: Is in the $REGION$ region
  Else if a check the game hides passes: the same again (1 line)
  Their location: Is in the $REGION$ region

• the game's own tooltip text · ◦ our reading of the script line · code the script where neither exists

“They” is whatever it runs on (the scope it is called in). The scripted triggers and effects it calls link to their own pages; $PARAMETERS$ stay as written: each call fills them in.

The script as written (67 lines of game script)

artifact_region_trigger = {
	trigger_if = {
		limit = {
			any_in_list = {
				list = artifact_material_sources
				exists = this
			}
		}
		any_in_list = {
			list = artifact_material_sources
			geographical_region = $REGION$
		}
	}
	trigger_else_if = {
		limit = {
			exists = $CHARACTER$
		}
		$CHARACTER$ = {
			trigger_if = {
				limit = {
					exists = capital_province
				}
				capital_province = { geographical_region = $REGION$ }
			}
			trigger_else_if = {
				limit = { exists = location }
				location = { geographical_region = $REGION$ }
			}
			trigger_else = {
				#no location
			}
		}
	}
	trigger_else_if = {
		limit = { exists = scope:artifact.artifact_owner }
		scope:artifact.artifact_owner = {
			trigger_if = {
				limit = {
					exists = capital_province
				}
				capital_province = { geographical_region = $REGION$ }
			}
			trigger_else_if = {
				limit = { exists = location }
				location = { geographical_region = $REGION$ }
			}
			trigger_else = {
				#no location
			}
		}
	}
	trigger_else = {
		trigger_if = {
			limit = {
				exists = capital_province
			}
			capital_province = { geographical_region = $REGION$ }
		}
		trigger_else_if = {
			limit = { exists = location }
			location = { geographical_region = $REGION$ }
		}
		trigger_else = {
			#no location
		}
	}
}

As written in game/common/scripted_triggers/00_artifact_triggers.txt.

Where it is used

Every place in common/, events/ and history/ that calls artifact_region_trigger — the first 120 of 129.

Artifacts (60)

book_cover_material_HSB_ivory
book_cover_material_velvet
bow_string_hemp
bow_string_horse_hair
bow_string_rawhide
bow_string_silk

54 more

bow_string_sinew
box_material_ebony
box_material_hsb_ivory
box_material_pine
box_material_sycomore
box_material_teak
box_material_walnut
composite_horn_antelope
composite_horn_aurochs
composite_horn_bison
composite_horn_deer
composite_horn_gazelle
decoration_material_embroidery_cotton
decoration_material_embroidery_linen
decoration_material_embroidery_silk
decoration_material_gem_adventurine
decoration_material_gem_amber
decoration_material_gem_amethyst
decoration_material_gem_carnelian
decoration_material_gem_flourite
decoration_material_gem_jade
decoration_material_gem_lapis_lazuli
decoration_material_gem_moonstone
decoration_material_gem_opal
decoration_material_gem_peridot
decoration_material_gem_spinel
decoration_material_gem_turquoise
decoration_material_inlay_HSB_boar_tusk
decoration_material_inlay_HSB_camel_bone
decoration_material_inlay_HSB_deer_antler
decoration_material_inlay_HSB_ivory
decoration_material_inlay_HSB_mother_of_pearl
decoration_material_inlay_HSB_seashell
decoration_material_inlay_HSB_tortoiseshell
decoration_material_inlay_shakudo
decoration_material_inlay_shibuichi
generic_material_cloth_cotton
generic_material_cloth_fustian
generic_material_cloth_linen
generic_material_cloth_samite
generic_material_cloth_satin
generic_material_cloth_silk
generic_material_cloth_velvet
generic_material_cloth_worsted_wool
generic_material_cordage_cotton
generic_material_cordage_linen
glass_decoration_enamel_pattern
glass_decoration_etched_pattern
glass_decoration_mold_blowing_pattern
goblet_material_ivory
regalia_clothes_cloak
regalia_clothes_robe
regalia_seal_ink
regalia_seal_slate

Scripted effects (3)

Scripted triggers (57)

51 more

Source: game/common/scripted_triggers/00_artifact_triggers.txt and every file of common/, events/ and history/ that calls it, Crusader Kings III 1.20.1.2.