Zone tier: Difference between revisions

2,931 bytes removed ,  18:24, 21 June 2022
no edit summary
(missing info)
No edit summary
Line 1: Line 1:
{{Missing info|Needs updated maps that include the Deep Jungle areas from the latest game version.}}
{{Missing info|Needs updated maps that include the Deep Jungle areas from the latest game version.}}
{{tocright}}
{{tocright}}
Each [[zone]] (or screen) that a player explores has a particular ''difficulty tier'' associated with, often referred to as the '''''{{name}}'''''.
Each [[zone]] (or screen) that a player explores has a particular ''difficulty tier'' typically referred to as the '''''{{name}}'''''.


Zone tier is one significant factor that contributes to the procedural generation of features in {{gamename}}, such as the level and difficulty of creatures that are found in a particular zone, or the items that can be obtained as random loot from a {{favilink|chest}} in that zone. Procedural generation is also influenced by other factors, such as the terrain type of the current zone, and whether or not the current zone is part of a village or a unique location.
Zone tier is one significant factor that contributes to the procedural generation of features in {{gamename}}, such as the level and difficulty of creatures that are found in a particular zone, or the items that can be obtained as random loot from a {{favilink|chest}} in that zone. Procedural generation is also influenced by other factors, such as the terrain type of the current zone and whether or not the current zone is part of a village or a unique location.


Zone tier is determined based on a combination of the following elements:
Zone tier is determined based on a combination of the following elements:
* The surface tier of the current [[world map]] {{parasang}}.
* The surface tier of the current [[world map]] {{parasang}}.
* The depth of the current zone, if it is underground.
* The depth of the current zone, if it is underground.
== Background ==
For historical reasons, the game uses two different systems to calculate zone tier. This can sometimes make determining the zone tier a bit tricky, because depending on which feature is using the zone tier, it may be calculated using one system or the other (even in the same single zone). For the purposes of this article, we'll give a name to each of those systems to help better distinguish them:
* '''Regional Zone Tier:''' This type of zone tier is the most commonly used. It is closely linked to the world map terrain type of the zone. For example, all {{favilink|Hills}} areas have a '''regional zone tier''' of 2, even the few '''Hills''' parasangs that are in the far upper-right corner of the world map, sandwiched between the Deathlands and the Mountains.
* '''Static Zone Tier:''' This type of zone tier appears to generally be an older type of zone tier system. It is based on static values that are defined in a configuration file<ref><code>Text.txt</code></ref> in the game directory. This system of zone tiers is used for fewer things, but it is still used frequently enough to be worth mentioning.
As a general rule, these two zone tier systems tend to be quite similar on the western half of the world map. They differ more significantly on the eastern half of the map.


== Tiers and Procedural Generation ==
== Tiers and Procedural Generation ==
Line 22: Line 15:
For example, in an area with a zone tier of 5, tier 5 creatures (such as {{favilink|dynamic turret tinker|plural}}) and tier 5 items (such as {{favilink|fullerite gauntlets}}) are more likely to be found. Note that zone tier is only one of several factors that affects the dynamic generation of creatures and objects in the world. Specific types of [[:Category:Terrain|terrain]], [[:Category:Biomes|biomes]], unique [[:Category:Locations|locations]] (such as [[historic site]]s or [[:Category:Dungeons|dungeons]]), or other factors can influence the objects and items that are generated in particular zones. This is why, for example, the surface levels of the {{favilink|Desert Canyons}} will always contain the same primary creatures, such as {{favilink|snapjaw scavenger|snapjaws}}, {{favilink|equimax|equimaxes}}, and {{favilink|giant dragonfly|giant dragonflies}} - this biome has its own unique population/encounter tables.
For example, in an area with a zone tier of 5, tier 5 creatures (such as {{favilink|dynamic turret tinker|plural}}) and tier 5 items (such as {{favilink|fullerite gauntlets}}) are more likely to be found. Note that zone tier is only one of several factors that affects the dynamic generation of creatures and objects in the world. Specific types of [[:Category:Terrain|terrain]], [[:Category:Biomes|biomes]], unique [[:Category:Locations|locations]] (such as [[historic site]]s or [[:Category:Dungeons|dungeons]]), or other factors can influence the objects and items that are generated in particular zones. This is why, for example, the surface levels of the {{favilink|Desert Canyons}} will always contain the same primary creatures, such as {{favilink|snapjaw scavenger|snapjaws}}, {{favilink|equimax|equimaxes}}, and {{favilink|giant dragonfly|giant dragonflies}} - this biome has its own unique population/encounter tables.


Most biomes have unique generation tables defined for their surface and levels 1-5 underground.<ref>Determined by review of <code>Worlds.xml</code>, <code>ZoneTemplates.xml</code>, and <code>PopulationTables.xml</code>.</ref> Once you descend to level 6 or lower in most areas, creature and item generation typically are more directly correlated to zone tier, creature tier, and item tier, and is less strictly defined by [[:Category:Terrain|terrain]]-specific spawning logic.
Most biomes have unique generation tables defined for their surface and levels 1-5 underground.<ref>Determined by review of <code>Worlds.xml</code>, <code>ZoneTemplates.xml</code>, and <code>PopulationTables.xml</code>.</ref> Once you descend to level 6 or lower in most areas, creature and item generation more directly correlates to zone tier and is less strictly defined by [[:Category:Terrain|terrain]]-specific spawning logic.


There is also an element of randomness at play. For example, the dynamic loot tables for each zone tier have a small chance to roll upward one tier higher. This effect can chain in succession (although at very low probability), sometimes resulting in loot several tiers higher than expected. For example, {{favilink|Elder Irudad}} may spawn with tier 8 {{favilink|zetachrome pumps}} in {{favilink|Joppa}} at the start of the game, even though Joppa has a very low zone tier.
There is also an element of randomness at play. For example, the dynamic loot tables for each zone tier have a small chance to roll upward one tier higher. This effect can chain in succession (although at very low probability), sometimes resulting in loot several tiers higher than expected. For example, {{favilink|Elder Irudad}} may spawn with tier 8 {{favilink|zetachrome pumps}} in {{favilink|Joppa}} at the start of the game, even though Joppa has a very low zone tier.


=== Creature Tier ===
=== Creature Tier ===
Creature tier is based on level. Creatures of levels 1-9 are tier 1 for the purposes of dynamic zone generation. A creature's tier increases by one for additional each five levels (creatures of levels 10-14 are tier 2, creatures of level 15-19 are tier 3, etcetera).
Creature tier is based on level and can be given as follows:


Note that this logic for creature tier varies slightly from how a creature's XP tier is calculated (XP tier can go as low as 0). For more information about XP tiers, refer to the [[Experience]] page.
<math>\text{Tier} = \text{Floor}(\frac{Level}{5})\text{, min 1}</math>
 
Note that this creature tier varies slightly from the tiering used to calculate XP, which can go as low as Tier 0. Refer to the [[Experience]] page for more information about XP tiers.


=== Item Tier ===
=== Item Tier ===
Item tier is manually specified for each item in the game's <code>ObjectBlueprints.xml</code>. You can view the tier of a particular item on its wiki page. For example, a {{favilink|flamethrower}} is a tier 4 item.
Item tier is manually specified for each item in the game's <code>ObjectBlueprints.xml</code>. You can view the tier of a particular item on its wiki page. For example, a {{favilink|flamethrower}} is a tier 4 item.


== Regional Zone Tier ==
== Surface Zone Tier ==
{{No Official Name|section|inline=true}}
{{No Official Name|section|inline=true}}
The following map shows the '''regional zone tier''' for all areas in {{gamename}}.
The following map shows the zone tier for all surface areas in {{gamename}}.


{{World map with zone tiers}}
{{World map with zone tiers}}


=== Features That Use Regional Zone Tier ===
== Underground Zone Tier==
Everything that is not explicitly listed as using '''static zone tier''' in the [[#Static_Zone_Tier|Static Zone Tier]] section of this page uses '''regional zone tier'''.


Some examples of things that are influenced by '''regional zone tier''':
To determine the zone tier for an underground zone:{{Code Reference|namespace=XRL.World|class=Zone|property=NewTier}}
* The generation of [[relic]] items.
* If the current zone is 6 strata or deeper underground:
* Turret generation of {{favilink|dynamic turret tinker|plural}}.<ref><code>ObjectBlueprints.xml</code></ref>{{Code Reference|class=TurretTinker}}
*# Calculate '''2 + Floor((Strata - 6) / 5)'''.
* The contents of {{favilink|cybernetics rack|plural}}.<ref><code>PopulationTables.xml</code></ref>
*# Modify the result to ensure it is a number between 1 and 8. The result is always constrained to the nearest number within the 1 to 8 range.
* The XP reward for visiting a new [[historic site]] if you have a quest to visit that site (250 * regional zone tier){{Code Reference|namespace=HistoryKit|class=HistoricEvent|method=AddQuestsForRegion}}
* Otherwise, for any zone higher than 6 strata underground:
* Legendary/merchant lairs, including procedurally generated creatures and legendary merchant stock{{Code Reference|namespace=XRL.World.WorldBuilders|class=JoppaWorldBuilder|method=AddLairAt}}
*# Take the surface zone tier at the location.
* Village generation{{Code Reference|namespace=XRL.Annals|class=InitializeVillage|method=Generate}}
*# Modify that value to ensure it is a number between 1 and 8. The result is always constrained to the nearest number within the 1 to 8 range.
* Most other forms of dynamic creature/item generation throughout the world.<ref>''Technical note: Includes {zonetier} stand-ins in all XML files other than ZoneTemplates.xml.</ref>{{Code Reference|namespace=XRL|class=ZoneTemplate}}{{Code Reference|namespace=XRL.World|class=GameObjectFactory}}{{Code Reference|namespace=XRL.World.Encounters|class=EncounterObject}}{{Code Reference|namespace=XRL.World.Encounters|class=EncounterPopulation}}{{Code Reference|namespace=XRL.World.Encounters|class=EncounterTableObject}}''
 
=== Calculating Regional Zone Tier ===
To determine the regional zone tier for a zone:{{Code Reference|namespace=XRL.World|class=ZoneManager|method=GetZoneTier}}
# Find the surface regional zone tier for the current parasang in the world map pictured above.
#* This is closely tied to terrain type - for example, all {{favilink|Mountains}} zones have a surface regional zone tier of 4.
# Next, modify that value based on the current depth:
#* The zone tier is unchanged for the surface level and levels 1-4 underground.
#* Otherwise, the zone tier is increased by '''Floor(Depth / 5)'''. Depth 5-9 increases the zone tier by 1, depth 10-14 increases the zone tier by 2, and so on.
#** As an example, if the player digs beneath a {{favilink|Jungle}} biome (regional zone tier 3), the zone tier at depth 17 will be '''6'''.
# Finally, modify the result to ensure it is a number between 1 and 8. If a calculation would result in a zone tier value lower than 1 or higher than 8, the result is always constrained to the nearest number within the 1 to 8 range.
 
== Static Zone Tier ==
{{No Official Name|section|inline=true}}
The following map shows the '''static zone tier''' for all areas in {{gamename}}.


{{World map with world tiers}}
===Zone tier exceptions===


=== Features That Use Static Zone Tier ===
Certain biomes and zones override the underground zone tier rules. See individual articles for details:
This list is intended to be exhaustive. If something is not explicitly listed here, you can assume that it most likely uses '''regional zone tier''' instead.
* [[Asphalt Mines#Zone tier|Asphalt Mines]]
* [[Bethesda Susa]]
* [[Ruins#Zone tier|Ruins]] and [[Baroque Ruins#Zone tier|Baroque Ruins]]


The following things are influenced by '''static zone tier''':
== Effects of Zone Tier ==


* [[Historic_site#World_Map_Location|historic site locations]]{{Code Reference|namespace=XRL.World.WorldBuilders|class=JoppaWorldBuilder|method=AddSultanHistoryLocations|name=AddSultanHistoryLocations}}
* [[Historic_site#World_Map_Location|historic site locations]]{{Code Reference|namespace=XRL.World.WorldBuilders|class=JoppaWorldBuilder|method=AddSultanHistoryLocations|name=AddSultanHistoryLocations}}
Line 82: Line 63:
* The level and quantity of cybernetics credit wedges rewarded in the relic chest at the bottom of a [[historic site]]{{Code Reference|namespace=XRL.World.ZoneBuildes|class=PlaceRelicBuilder|method=BuildZoneWithRelic}}
* The level and quantity of cybernetics credit wedges rewarded in the relic chest at the bottom of a [[historic site]]{{Code Reference|namespace=XRL.World.ZoneBuildes|class=PlaceRelicBuilder|method=BuildZoneWithRelic}}
* A small number of legendary creature zone spawns (legendary baboons, snapjaws, glow-wights, eyeless king crabs, and goatfolk) and minor zone generation features.{{Code Reference|namespace=XRL|class=ZoneTemplate|comment=Applies to anything that uses "{zonetier}" in <code>ZoneTemplates.xml</code>}}
* A small number of legendary creature zone spawns (legendary baboons, snapjaws, glow-wights, eyeless king crabs, and goatfolk) and minor zone generation features.{{Code Reference|namespace=XRL|class=ZoneTemplate|comment=Applies to anything that uses "{zonetier}" in <code>ZoneTemplates.xml</code>}}
 
* The generation of [[relic]] items.
=== Calculating Static Zone Tier ===
* Turret generation of {{favilink|dynamic turret tinker|plural}}.<ref><code>ObjectBlueprints.xml</code></ref>{{Code Reference|class=TurretTinker}}
To determine the static zone tier for a zone:{{Code Reference|namespace=XRL.World|class=Zone|property=NewTier}}
* The contents of {{favilink|cybernetics rack|plural}}.<ref><code>PopulationTables.xml</code></ref>
* If the current zone is 6 strata or deeper underground:
* The XP reward for visiting a new [[historic site]] if you have a quest to visit that site (250 * regional zone tier){{Code Reference|namespace=HistoryKit|class=HistoricEvent|method=AddQuestsForRegion}}
*# Calculate '''2 + Floor((Strata - 6) / 5)''', regardless of the world location.
* Legendary/merchant lairs, including procedurally generated creatures and legendary merchant stock{{Code Reference|namespace=XRL.World.WorldBuilders|class=JoppaWorldBuilder|method=AddLairAt}}
*# Modify the result to ensure it is a number between 1 and 8. The result is always constrained to the nearest number within the 1 to 8 range.
* Village generation{{Code Reference|namespace=XRL.Annals|class=InitializeVillage|method=Generate}}
* Otherwise, for any zone higher than 6 strata underground:
* Most other forms of dynamic creature/item generation throughout the world.<ref>''Technical note: Includes {zonetier} stand-ins in all XML files other than ZoneTemplates.xml.</ref>{{Code Reference|namespace=XRL|class=ZoneTemplate}}{{Code Reference|namespace=XRL.World|class=GameObjectFactory}}{{Code Reference|namespace=XRL.World.Encounters|class=EncounterObject}}{{Code Reference|namespace=XRL.World.Encounters|class=EncounterPopulation}}{{Code Reference|namespace=XRL.World.Encounters|class=EncounterTableObject}}''
*# Take the static zone tier value shown in the map above.
*# Modify that value to ensure it is a number between 1 and 8. The result is always constrained to the nearest number within the 1 to 8 range.


== References ==
== References ==
{{As of patch inline|2.0.201.58}}
{{As of patch inline|2.0.203.49}}
<references />
<references />


=== General Technical Notes ===
=== General Technical Notes ===
The following fields and methods return a "regional zone tier" value, based on the "RegionTier" tag on the World Map terrain object. These are the most commonly used methods in the codebase for obtaining zone tier:
The following fields and methods return a "zone tier" value based on the "RegionTier" tag on the World Map terrain object and a few overrides, and are used for most applications of the tier system:
* <code>XRL.World.Zone.Tier</code>
* <code>XRL.World.ZoneManager.GetZoneTier()</code>
* <code>XRL.World.ZoneManager.zoneGenerationContextTier</code>
* <code>XRL.World.ZoneManager.zoneGenerationContextTier</code>
* <code>XRL.World.Zone.NewTier </code>
Those fields and methods apply the overrides discussed in Zoning Exceptions:
*<code>WorldTerrain.xml, feature Tier</code>
*<code>XRL.World.ZoneManager.GetZoneProperty(), property "ZoneTierOverride"</code>


The following fields and methods return a "static zone tier" that is instead loaded from the game's <code>Text.txt</code> file.
The following methods utilize a “zone tier” value directly based on the “RegionTier” tag on the World Map terrain object without applying overrides:
* <code>XRL.World.ZoneManager.GetZoneTier()</code>
* <code>XRL.World.WorldBuilders.JoppaWorldBuilder.getLocationOfTier(int)</code>
* <code>XRL.World.WorldBuilders.JoppaWorldBuilder.getLocationOfTier(int)</code>
* <code>XRL.World.WorldBuilders.JoppaWorldBuilder.getLocationOfTier(int, int)</code>
* <code>XRL.World.WorldBuilders.JoppaWorldBuilder.getLocationOfTier(int, int)</code>
* <code>XRL.World.WorldBuilders.JoppaWorldBuilder.getLocationWithinNFromTerrainTypeTier()</code>
* <code>XRL.World.WorldBuilders.JoppaWorldBuilder.getLocationWithinNFromTerrainTypeTier()</code>
* <code>XRL.World.Zone.NewTier</code>: This is one of the most widely used for "static zone tier" and is the only method that takes z-level into account. It has peculiar logic for calculating below-ground tiers, which completely ignores the surface tier at strata 6 and below.
 
* <code>XRL.ZoneTemplateNode.VariableReplace()</code>
These methods are used for placing surface locations and village quests and historic site discovery XP; since no existing zone tier overrides apply to surface locations, not applying overrides here doesn’t change the game’s behavior.  


[[Category:Mechanics]][[Category:World]]
[[Category:Mechanics]][[Category:World]]
384

edits