Targets and Scoring Guide - Revision history

Mindtheblob: /* Theme Eligibility */

2022-02-04T07:26:03Z

Theme Eligibility

← Older revision		Revision as of 07:26, 4 February 2022
Line 145:		Line 145:
	====Theme Eligibility====		====Theme Eligibility====

	'''Theme Eligibility''' is ubiquitous in almost any event where a [[theme]] (transformation, pet) is given. '''Theme eligibility''' ~~is quirky. The Content Editor blurb states~~:		'''Theme Eligibility''' is ubiquitous in almost any event where a [[theme]] (transformation, pet) is given. '''Theme eligibility''' imposes the following requirements:

	~~''Must be able to get~~ the ~~given theme (doesn't already~~ have the theme~~, no~~ conflicting themes~~, has~~ an ~~available~~ slot for ~~one of the theme pieces to go in, and no other heroes already have that~~ theme).''		*No member of the company may have the same theme.
			*The hero must not have [[Theme conflicts guide\|conflicting themes]].
			*The hero must have an empty slot for a theme piece.

	This means there are quite a few checks to pass when an '''Eligible for Theme''' is present in hero targeting.		This means there are quite a few checks to pass when an '''Eligible for Theme''' is present in hero targeting.
Line 164:		Line 166:
	::'''Eligible for Theme:''' bear		::'''Eligible for Theme:''' bear
	::'''Eligible for Theme Piece:''' tattoo		::'''Eligible for Theme Piece:''' tattoo
	::''For a hero to match this target role, no hero in the company must have the bear theme. The hero must not have conflicting themes with the bear theme ~~(wolf)~~, the hero must be eligible for a head slot theme piece.''		::''For a hero to match this target role, no hero in the company must have the bear theme. The hero must not have conflicting themes with the bear theme, the hero must be eligible for a head slot theme piece. A list of coded and practical conflicts for the bear theme: ({{Theme conflicts\|bear}})''

	====Forbidden Roles====		====Forbidden Roles====

Mindtheblob at 07:28, 3 February 2022

2022-02-03T07:28:46Z

← Older revision		Revision as of 07:28, 3 February 2022
Line 435:		Line 435:
	::''The '''lover''' and '''rival''' roles are optional roles with a '''score function''' and a '''score threshold'''. Note that these roles do not draw '''fromRoles:''' party. This means they will target any hero in the company who is a lover or rival of the '''romantic''' role. In this specific example, these two optional roles are only used in dialogue of the event, so comic panels will know the names of the lover and rival of the hero matched in the '''romantic''' role.''		::''The '''lover''' and '''rival''' roles are optional roles with a '''score function''' and a '''score threshold'''. Note that these roles do not draw '''fromRoles:''' party. This means they will target any hero in the company who is a lover or rival of the '''romantic''' role. In this specific example, these two optional roles are only used in dialogue of the event, so comic panels will know the names of the lover and rival of the hero matched in the '''romantic''' role.''
	\|}		\|}

			==Campaign Specific Event Blocks==

			Some campaigns block events. Most notably, the [[Troygan the Enchanger\|event]] for [[Mortificial Enhancements]] is blocked in [[The Enduring War\| the Enduring War]] campaign.

			Below is a list of campaign specific blocked events.

			=====All the Bones of Summer=====
			* [[The Abandoned]]
			* [[Terms of Endearment]]

			=====Eluna and the Moth=====
			* [[Peripheral Views]]
			* [[Necessary Evil]]
			* [[What May Hatch]]

			=====Monarchs Under the Mountain=====
			* [[By Hoof and Horn]]
			*[[Misgivings]]

			=====The Enduring War=====
			*[[Troygan the Enchanger]]
			*[[Threshing Machine]]
			*[[Mark of the Times]]
			*[[The Clockwork Tower]]
			*[[Pursuit Of Knowledge]]

	== Checking Event Failures ==		== Checking Event Failures ==

Mindtheblob: /* Conflicting Themes */

2022-02-02T20:50:35Z

Conflicting Themes

← Older revision		Revision as of 20:50, 2 February 2022
Line 154:		Line 154:

	=====Conflicting Themes=====		=====Conflicting Themes=====
	Perhaps the trickiest feature is that there is no way of telling which [[theme]]s conflict with each other ~~without referral to the game files~~.		{{Main\|Theme conflicts guide}}
			Perhaps the trickiest feature is that there is no way of telling which [[theme]]s conflict with each other. For example, themes may conflict because of defined [[Theme conflicts guide#Detailed Discussion: Forbid Combine With\|forbidden combinations]] in the game files. Or themes may be in practical conflict because events target the same theme slots. See the [[Theme conflicts guide\|theme conflicts guide]] for further information.
	~~The '''.json files''' for [[theme]]s are located in Wildermyth > assets > data >~~ themes.

	~~Each theme '''.json''' has a '''"forbidCombineWith":''' [] line that defines conflicting themes:~~

	~~'''Example:''' "forbidCombineWith": ["bear", "wolf", "crow", "fire", "skeleton"]~~
	~~::''This is an example~~ of ~~the '''tree.json''' (~~[[~~Elmsoul]]). It~~ conflicts ~~with [[beartouched~~]]~~, [[wolftouched]], [[crowtouched]], [[flamesoul]], and [[skeletal]] transformations.~~
	~~::''Note! The '''forbidCombineWith:''' is not~~ the ~~same as '''Eligible for Theme Piece'''~~. ~~Many~~ themes ~~are~~ in practical conflict ~~despite not being specified with the '''forbidCombineWith:'''~~ because ~~the~~ events ~~they are received in~~ target the same theme ~~slot, most commonly~~ the ~~head~~.

			Unlike [[aspect]]s, [[stat]]s, and [[relationship]]s, '''theme eligibility''' does not appear in '''score functions'''. It does appear along side of '''score functions''', similar to lists of aspects discussed above.


	Unlike [[aspect]]s, [[stat]]s, and [[relationship]]s, '''theme eligibility''' does not appear in '''score functions'''. It does appear along side of '''score functions''', similar to lists of aspects discussed above.
	=====Example of Hero Theme Eligibility=====		=====Example of Hero Theme Eligibility=====

Mindtheblob: /* Case Study: The Wolf Price */

2022-02-01T19:23:15Z

Case Study: The Wolf Price

← Older revision		Revision as of 19:23, 1 February 2022
Line 358:		Line 358:

	::''The '''hook''' role is an (optional) role, for a hero to match the role, the sum of the score of their hook_Wildheart (Wildheart hook) and hook_Mysterious (Mysterious hook) aspects must be greater than or equal to 1. Because the role is optional, the event can trigger without a hero being matched to it, but more on that later.		::''The '''hook''' role is an (optional) role, for a hero to match the role, the sum of the score of their hook_Wildheart (Wildheart hook) and hook_Mysterious (Mysterious hook) aspects must be greater than or equal to 1. Because the role is optional, the event can trigger without a hero being matched to it, but more on that later.
	::''The '''hook''' role must be eligible for the theme wolf. No other hero in the company may have the wolf transformation. The hero may not have conflicting themes with the theme ~~wolf (~~[[~~beartouched\|bear~~]], [[~~skeletal\|skeleton~~]]).		::''The '''hook''' role must be eligible for the theme wolf. No other hero in the company may have the wolf transformation. The hero may not have conflicting themes with the theme [[Wolftouched]]. A full list of themes that conflict with [[Wolftouched]] in unmodded games: ({{Theme conflicts\|wolf}}).
	::''The role '''volunteer''' is the first (required) role. The '''score function''' lacks a '''score threshold''' so the function will choose the highest scoring hero for the function. Note that for a hero with the class aspects hunter or warrior, a bonus of (301) or (101) is added to the sum with the LONER stat, respectively.		::''The role '''volunteer''' is the first (required) role. The '''score function''' lacks a '''score threshold''' so the function will choose the highest scoring hero for the function. Note that for a hero with the class aspects hunter or warrior, a bonus of (301) or (101) is added to the sum with the LONER stat, respectively.
	::''A hero matched to the role of '''volunteer''' must be eligible for the wolf theme (discussed above in the '''hook''' role). The hero matched to the '''volunteer''' role must also have a free head theme slot.		::''A hero matched to the role of '''volunteer''' must be eligible for the wolf theme (discussed above in the '''hook''' role). The hero matched to the '''volunteer''' role must also have a free head theme slot.

Mindtheblob: /* Case Study: Drifters */

2022-02-01T19:19:30Z

Case Study: Drifters

← Older revision		Revision as of 19:19, 1 February 2022
Line 400:		Line 400:
	:::'''notAlreadyMatchedAs:''' leader		:::'''notAlreadyMatchedAs:''' leader

	The '''coward''' role requires a hero with one of the stats of COWARD, BOOKISH, or LONER to be greater than or equal to 80. No one in the company may have the theme green (Sylvan ~~transformation~~). The hero must not have conflicting themes (~~'''wolf''', '''fire''', '''crow''', '''frog''', '''shadow''', '''skeleton'''~~). The hero must have an open head theme slot.		The '''coward''' role requires a hero with one of the stats of COWARD, BOOKISH, or LONER to be greater than or equal to 80. No one in the company may have the theme green ([[Sylvan]]). The hero must not have conflicting themes. A full list of themes that conflict with [[Sylvan]] in an unmodded game: ({{Theme conflicts\|sylvan}}). The hero must have an open head theme slot.

	The '''rival''' role ~~is otherwise similar~~, but instead of a STAT requirement, the '''rival''' role requires a hero that is the rival of the '''coward''' role (notice the '''score threshold''').		The requirements for the '''rival''' role are exactly the same, but instead of a STAT requirement, the '''rival''' role requires a hero that is the rival of the '''coward''' role (notice the '''score threshold''').

	The '''leader''' role prefers a hero with a high LEADER stat (notice the lack of a '''score threshold''').		The '''leader''' role prefers a hero with a high LEADER stat (notice the lack of a '''score threshold''').

Mindtheblob: /* Theme Eligibility */

2022-01-25T06:29:00Z

Theme Eligibility

← Older revision		Revision as of 06:29, 25 January 2022
Line 153:		Line 153:
	'''Important!''' No member of the company may have the theme that is tested for in '''Eligible for Theme'''.		'''Important!''' No member of the company may have the theme that is tested for in '''Eligible for Theme'''.

	Perhaps the trickiest feature is that there is no way of telling which [[theme]]s conflict with each other without referral to ~~the wiki or~~ the game files.		=====Conflicting Themes=====
			Perhaps the trickiest feature is that there is no way of telling which [[theme]]s conflict with each other without referral to the game files.

			The '''.json files''' for [[theme]]s are located in Wildermyth > assets > data > themes.

			Each theme '''.json''' has a '''"forbidCombineWith":''' [] line that defines conflicting themes:

			'''Example:''' "forbidCombineWith": ["bear", "wolf", "crow", "fire", "skeleton"]
			::''This is an example of the '''tree.json''' ([[Elmsoul]]). It conflicts with [[beartouched]], [[wolftouched]], [[crowtouched]], [[flamesoul]], and [[skeletal]] transformations.
			::''Note! The '''forbidCombineWith:''' is not the same as '''Eligible for Theme Piece'''. Many themes are in practical conflict despite not being specified with the '''forbidCombineWith:''' because the events they are received in target the same theme slot, most commonly the head.



	Unlike [[aspect]]s, [[stat]]s, and [[relationship]]s, '''theme eligibility''' does not appear in '''score functions'''. It does appear along side of '''score functions''', similar to lists of aspects discussed above.		Unlike [[aspect]]s, [[stat]]s, and [[relationship]]s, '''theme eligibility''' does not appear in '''score functions'''. It does appear along side of '''score functions''', similar to lists of aspects discussed above.

Mindtheblob: /* Example of Chapter Targeting */

2022-01-18T09:08:02Z

Example of Chapter Targeting

← Older revision		Revision as of 09:08, 18 January 2022
Line 18:		Line 18:
	The value for chapter is equal to the chapter of the game.		The value for chapter is equal to the chapter of the game.

	=====~~Example~~ of Chapter Targeting=====		=====Examples of Company and Chapter Targeting=====
	:'''Target (role): company'''		:'''Target (role): company'''
	::'''Aspects:''' chapterNumber >= 2		::'''Aspects:''' chapterNumber >= 2
	::''This threshold requires the aspect called chapterNumber to be greater than or equal to 2.''		::''This [[aspect]] threshold requires the aspect called chapterNumber to be greater than or equal to 2.''
	::''An event with this requirement will only trigger in Chapter 2 or above.''		::''An event with this requirement will only trigger in Chapter 2 or above.''

			:'''Target (role): company'''
			::'''Forbidden Aspects:''' seenEvent\|encounter_heroesArriveAtSite_answertoAusterity
			::''This forbidden aspect list forbids the aspect seenEvent\|encounter_heroesArriveAtSite_answertoAusterity. The seenEvent aspects are gained upon encountering events.''
			::''This particular aspect refers to the event [[Answer to Austerity]].
			::''If the company has seen the event, the '''company''' target role can not be matched, and the event will not be able to trigger.''

	==Overland Tile Biome and Site Targeting==		==Overland Tile Biome and Site Targeting==

Mindtheblob: /* Hero Targeting */

2022-01-18T08:44:53Z

Hero Targeting

← Older revision		Revision as of 08:44, 18 January 2022
Line 77:		Line 77:
	Note, to make matters more complicated, '''required roles''' may have optional targeting preferences, and '''optional roles''' may have required score thresholds.		Note, to make matters more complicated, '''required roles''' may have optional targeting preferences, and '''optional roles''' may have required score thresholds.

	This guide attempts to show both (required) and (optional) roles in the examples. They do, however, operate on the exact same principles.		This guide attempts to show both (required) and (optional) roles in the examples. They do, however, operate on the exact same principles. [[Targets_and_Scoring_Guide#Case_Study:_The_Wolf_Price\|Case Studies]] in the final section showcase some interesting examples.

	For current purposes, the sub-sections in this section will briefly explain '''hero scoring''', '''aspects''', '''tests''', and '''theme eligibility'''.		For current purposes, the sub-sections in this section will briefly explain '''hero scoring''', '''aspects''', '''tests''', and '''theme eligibility'''.

Mindtheblob: /* Example of Test, Aspect, and Score Function */

2022-01-18T08:38:11Z

Example of Test, Aspect, and Score Function

← Older revision		Revision as of 08:38, 18 January 2022
Line 134:		Line 134:
	::'''Aspects:''' theme_crow		::'''Aspects:''' theme_crow
	::'''Test:''' AGE <= 35		::'''Test:''' AGE <= 35
	::''This score function only targets the ~~Leader~~ stat, and has a score threshold of 50 or above. The Aspects lists a required Aspect called theme_crow (the aspect for the crow transformation). The Test requires the hero's age to be less than or equal to 35. Now, for a hero to match this role, they must have a LEADER stat of 50 or above, have the crow transformation, and be 35 years of age or younger.''		::''This score function only targets the LEADER stat, and has a score threshold of 50 or above. The Aspects lists a required Aspect called theme_crow (the aspect for the crow transformation). The Test requires the hero's age to be less than or equal to 35. Now, for a hero to match this role, they must have a LEADER stat of 50 or above, have the crow transformation, and be 35 years of age or younger.''
	::''Note that this '''hero''' role is now (optional), an event can trigger even if this role is not matched to a hero.		::''Note that this '''hero''' role is now (optional), an event can trigger even if this role is not matched to a hero.

Mindtheblob: /* Special Cases of Hero Targeting */

2022-01-18T08:37:22Z

Special Cases of Hero Targeting

← Older revision		Revision as of 08:37, 18 January 2022
Line 195:		Line 195:

	'''Important!''' This may result in confusion when interpreting hero targeting. There may be more '''required roles''', than there are '''required heroes'''.		'''Important!''' This may result in confusion when interpreting hero targeting. There may be more '''required roles''', than there are '''required heroes'''.

			Is it possible for an event to '''require more heroes''' than there are '''required roles'''? Yes. Circumstantially. ([[Targets_and_Scoring_Guide#Case_Study:_The_Wolf_Price\|Here is a Case Study]])

	Why is this? There are simply more mechanics involved to hero targeting. At the time of writing, the Wiki event targets do not account for definitions such as '''fromRoles''', '''notAlreadyMatchedAs''', and '''alreadyMatchedAs''' in Event Targeting, or the method by which a role chooses its target.		Why is this? There are simply more mechanics involved to hero targeting. At the time of writing, the Wiki event targets do not account for definitions such as '''fromRoles''', '''notAlreadyMatchedAs''', and '''alreadyMatchedAs''' in Event Targeting, or the method by which a role chooses its target.