Template:Area/doc: Difference between revisions

From Path of Exile Wiki
Jump to navigation Jump to search
>OmegaK2
(parameters for the lua module)
 
(15 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{documentation subpage}}
{{Documentation subpage}}


{{lua|Module:Area}}
{{Lua|Module:Area}}


The '''area''' template is used to show a area [[Template:Infocard|info card]]. It currently calls [[Module:Area]] from within the [[Area]] namespace, but provides legacy support for old templates when called from the main name space.
The '''area''' template is used to show a area [[Template:Infocard|info card]]. It currently calls [[Module:Area]] from within the [[Area]] namespace, but provides legacy support for old templates when called from the main name space.
Line 14: Line 14:
! Required
! Required
! PyPoE<br>Export
! PyPoE<br>Export
! Property
! Field
! Description
! Description
|-
|-
Line 21: Line 21:
| {{no}}
| {{no}}
| {{no}}
| {{no}}
| [[Property:Has main page|Has main page]]
| areas.main_page
| A valid wiki page that serves as the base page for this area entry (i.e. holds version history, descriptions, etc.)
| A valid wiki page that serves as the base page for this area entry (i.e. holds version history, descriptions, etc.)
|-
|-
Line 28: Line 28:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Is area id|Is area id]]
| areas.id
| Internal game id of the area (don't make this up).
| Internal game id of the area (don't make this up).
|-
|-
Line 35: Line 35:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has name|Has name]]
| areas.name
| Name of the area as visible in game
| Name of the area as visible in game
|-
|-
Line 42: Line 42:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has act|Has act]]
| areas.act
| [[Act]] associated with the area
| [[Act]] associated with the area
|-
|-
Line 49: Line 49:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has area level|Has area level]]
| areas.area_level
| level of the area
| level of the area
|-
|-
Line 56: Line 56:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has area level|Has area level]]
| areas.level_restriction_max
| Maximum player level allowed to enter. Defaults to 100.
| Maximum player level allowed to enter. Defaults to 100.
This is used in pvp arenas for example to restrict higher level players from entering low level pvp arenas.
This is used in pvp arenas for example to restrict higher level players from entering low level pvp arenas.
Line 64: Line 64:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has area type tags|Has area type tags]]
| areas.area_type_tags
| comma-separated list of [[tags]] associated with an area denoting the type of the area.
| comma-separated list of [[tags]] associated with an area denoting the type of the area.
|-
|-
Line 71: Line 71:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has tags|Has tags]]
| areas.tags
| comma-separated list of [[tags]] associated with an area
| comma-separated list of [[tags]] associated with an area
|-
|-
Line 78: Line 78:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has loading screen image|Has loading screen image]]
| areas.loading_screen
| Name of the loading screen file; file path will be automatically generated from this.
| Name of the loading screen file; file path will be automatically generated from this.
|-
|-
Line 85: Line 85:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has connection ids|Has connection ids]]
| areas.connection_ids
| comma-separated list of area ids this area is connected to
| comma-separated list of area ids this area is connected to
|-
|-
Line 92: Line 92:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has parent area id|Has parent area id]]
| areas.parent_area_id
| Parent area of this area (i.e. the area the player [[character]] would respawn in if he dies))
| Parent area of this area (i.e. the area the player [[character]] would respawn in if he dies))
|-
|-
Line 99: Line 99:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has modifier ids|Has modifier ids]]
| areas.modifier_ids
| comma-separated list of implicit [[modifiers]] associated with this area.
| comma-separated list of implicit [[modifiers]] associated with this area.
Please note only implicit modifiers are counted, do modifiers from maps for example would '''not''' be included.
Please note only implicit modifiers are counted, do modifiers from maps for example would '''not''' be included.
Line 107: Line 107:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has monsters ids|Has monsters ids]]
| areas.monster_ids
| comma-separated list of monsters metadata ids
| comma-separated list of monsters metadata ids
|-
|-
Line 114: Line 114:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has boss monsters ids|Has boss monsters ids]]
| areas.boss_monster_ids
| comma-separated list of boss monsters metadata ids
| comma-separated list of boss monsters metadata ids
|-
|-
Line 121: Line 121:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has entry text message|Has entry text message]]
| areas.entry_text
| Message that is shown when the area is entered
| Message that is shown when the area is entered
|-
|-
Line 128: Line 128:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has entry text message|Has entry text message]]
| areas.entry_npc
| NPC who sends the message shown upon entering the area
| NPC who sends the message shown upon entering the area
|-
| entry_text
| str
| {{no}}
| {{yes}}
| [[Property:Has entry text message|Has entry text message]]
| Message that is shown when the area is entered
|-
|-
| vaal_area_ids
| vaal_area_ids
Line 142: Line 135:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has vaal area ids|Has vaal area ids]]
| areas.vaal_area_ids
| comma-separated list of vaal area ids
| comma-separated list of vaal area ids
|-
|-
Line 149: Line 142:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has vaal area spawn chance|Has vaal area spawn chance]]
| areas.vaal_area_spawn_chance
| Percent chance for an [[vaal side area]] to appear
| Percent chance for an [[vaal side area]] to appear
|-
|-
Line 156: Line 149:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has strongbox spawn chance|Has strongbox spawn chance]]
| areas.strongbox_spawn_chance
| Percent chance for a [[strongbox]] to appear
| Percent chance for a [[strongbox]] to appear
|-
|-
Line 163: Line 156:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has maximum number of strongboxes|Has maximum number of strongboxes]]
| areas.strongbox_max_count
| Maximum number of strongboxes that naturally can appear in this area
| Maximum number of strongboxes that naturally can appear in this area
|-
|-
Line 170: Line 163:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has normal rarity strongbox weight|Has normal rarity strongbox weight]]
| areas.strongbox_max_count
[[Property:Has magic rarity strongbox weight|Has magic rarity strongbox weight]]
[[Property:Has rare rarity strongbox weight|Has rare rarity strongbox weight]]
[[Property:Has unique rarity strongbox weight|Has unique rarity strongbox weight]]
| comma-separated list of weights denoting which rarity a strongbox may be spawned in
| comma-separated list of weights denoting which rarity a strongbox may be spawned in
List is <code>normal, magic, rare, unique</code> in that order
List is <code>normal, magic, rare, unique</code> in that order
Line 181: Line 171:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Is map area|Is map area]]
| areas.is_map_area
| Whether the area is a [[map]] area
| Whether the area is a [[map]] area
|-
|-
Line 188: Line 178:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Is unique map area|Is unique map area]]
| areas.is_unique_map_area
| Whether the area is a unique [[map]] area
| Whether the area is a unique [[map]] area
|-
| is_legacy_map_area
| bool
| {{no}}
| {{no}}
| areas.is_legacy_map_area
| Whether the area is a legacy map area. Defaults to true for map areas from Original, The Awakening, and Atlas of Worlds map series; otherwise false.
|-
|-
| is_town_area
| is_town_area
Line 195: Line 192:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Is town area|Is town area]]
| areas.is_town_area
| Whether the area is a [[town]]
| Whether the area is a [[town]]
|-
|-
Line 202: Line 199:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Is hideout area|Is hideout area]]
| areas.is_hideout_area
| Whether the area is a [[hideout]]
| Whether the area is a [[hideout]]
|-
|-
Line 209: Line 206:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Is vaal area|Is vaal area]]
| areas.is_vaal_area
| Whether the area is a [[vaal side area]]
| Whether the area is a [[vaal side area]]
|-
| is_master_daily_area
| bool
| {{no}}
| {{yes}}
| [[Property:Is master daily area|Is master daily area]]
| Whether the area is a master daily area. Please note this '''only''' applies to the area the master spawns in after he creates a portal, not the quest area created (i.e. doesn't apply to vagan area, tora sink hole, haku cave, etc.)
|-
|-
| is_labyrinth_area
| is_labyrinth_area
Line 223: Line 213:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Is labyrinth area|Is labyrinth area]]
| areas.is_labyrinth_area
| Whether the area is a [[labyrinth]] area
| Whether the area is a [[labyrinth]] area
|-
|-
Line 230: Line 220:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Is labyrinth airlock area|Is labyrinth airlock area]]
| areas.is_labyrinth_airlock_area
| Whether the area is a [[labyrinth]] airlock area
| Whether the area is a [[labyrinth]] airlock area
|-
|-
Line 237: Line 227:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Is labyrinth boss area|Is labyrinth boss area]]
| areas.is_labyrinth_boss_area
| Whether the area is a [[labyrinth]] boss area
| Whether the area is a [[labyrinth]] boss area
|-
|-
Line 244: Line 234:
| {{no}}
| {{no}}
| {{yes}}
| {{yes}}
| [[Property:Has waypoint|Has waypoint]]
| areas.has_waypoint
| Whether the area has a waypoint
| Whether the area has a waypoint
|-
| screenshot_ext
| str
| {{no}}
|
| default file type is <code>jpg</code>, specify to override to .png or any acceptable upload file format
|}
|}


==Legacy area call==
==Finding the area id==
 
<section begin=area_id/>Browse to it using [[Special:CargoTables]] or use a query similar to this:
===Parameters===
<pre>
All parameters except for '''name''' are optional. They can be excluded or left blank.
{{#cargo_query:
tables = areas
|fields = areas._pageName, areas.id, areas.name, areas.main_page
|where = id LIKE "%"
|limit=5000
}}
</pre><section end=area_id />


==Cargo==
{| class="wikitable"
{| class="wikitable"
! Parameter !! Description
! Table !! Declared by !! Attached by
|-
| '''name''' || Name of the area
|-
| '''pagename''' || Name of the area's wiki page, if different than '''name'''
|-
| '''type''' || Type of the area&nbsp;– Possible values are: <code>Act</code>, <code>Corrupted</code>, <code>Hideout</code>, <code>Map</code>, <code>Mission</code>, <code>Descent</code>, <code>Descent: Champions</code>, and <code>Removed</code>.
|-
| '''act''' || Act the area belongs to, if '''type''' is set to <code>Act</code>
|-
| '''icon''' || Area icon&nbsp;– Predefined icons for values: <code>Normal</code>, <code>Waypoint</code>, and <code>Town</code>.
|-
| '''difficulty''' || The difficulty of the area, if '''type''' is set to <code>Descent</code> or <code>Descent: Champions</code>. Possible values are <code>Normal</code>, <code>Cruel</code>, and <code>Merciless</code>.
|-
| '''mlvl1''' || Monster level for the area; for Normal difficulty if '''type''' is set to <code>Act</code>
|-
| '''mlvl2''' || Monster level for Cruel difficulty if '''type''' is set to <code>Act</code>
|-
| '''mlvl3''' || Monster level for Merciless difficulty if '''type''' is set to <code>Act</code>
|-
| '''image''' || Area screenshot&nbsp;– Defaults to <code>'''name''' zone screenshot.jpg</code>
|-
| '''flavourtext''' || Flavour text for the area
|-
|-
| '''tileset''' || Tileset for the area
| [[Special:CargoTables/areas|areas]]
| {{tl|Area/cargo/areas/declare}}
| {{tl|Area/cargo/areas/attach}}
|}
|}


===Code templates===
{{Documentation categories|
Copy and paste a code template to get started.
<!-- Categories and interwikis go here. -->
 
[[Category:Data templates]]
====Act area====
<pre><nowiki>{{area
| name                  =
| type                  = Act
| act                    =
| icon                  = normal
| mlvl1                  =
| mlvl2                  =
| mlvl3                  =
| flavourtext            =
| tileset                =
}}</nowiki></pre>
 
====Other areas====
<pre><nowiki>{{area
| name                  =
| type                  =
| difficulty            =
| mlvl1                  =
| tileset                =
}}</nowiki></pre>
 
<includeonly>
<!-- CATEGORIES AND INTERWIKIS HERE, THANKS -->
[[Category:Infocard templates]]
[[Category:Infocard templates]]
</includeonly>
[[de:Vorlage:Area]]
}}

Latest revision as of 17:46, 15 July 2022

This subpage provides documentation for Template:Area.

Lua logo

This template uses the following modules:

The area template is used to show a area info card. It currently calls Module:Area from within the Area namespace, but provides legacy support for old templates when called from the main name space.

Module area call

Parameters

Parameter Value Required PyPoE
Export
Field Description
main_page str
areas.main_page A valid wiki page that serves as the base page for this area entry (i.e. holds version history, descriptions, etc.)
id str
areas.id Internal game id of the area (don't make this up).
name str
areas.name Name of the area as visible in game
act int
areas.act Act associated with the area
area_level int
areas.area_level level of the area
level_restriction_max int
areas.level_restriction_max Maximum player level allowed to enter. Defaults to 100.

This is used in pvp arenas for example to restrict higher level players from entering low level pvp arenas.

area_type_tags list[str]
areas.area_type_tags comma-separated list of tags associated with an area denoting the type of the area.
tags list[str]
areas.tags comma-separated list of tags associated with an area
loading_screen str
areas.loading_screen Name of the loading screen file; file path will be automatically generated from this.
connection_ids list[str]
areas.connection_ids comma-separated list of area ids this area is connected to
parent_area_id str
areas.parent_area_id Parent area of this area (i.e. the area the player character would respawn in if he dies))
modifier_ids list[str]
areas.modifier_ids comma-separated list of implicit modifiers associated with this area.

Please note only implicit modifiers are counted, do modifiers from maps for example would not be included.

monster_ids list[str]
areas.monster_ids comma-separated list of monsters metadata ids
boss_monster_ids list[str]
areas.boss_monster_ids comma-separated list of boss monsters metadata ids
entry_text str
areas.entry_text Message that is shown when the area is entered
entry_npc str
areas.entry_npc NPC who sends the message shown upon entering the area
vaal_area_ids list[str]
areas.vaal_area_ids comma-separated list of vaal area ids
vaal_area_spawn_chance int
areas.vaal_area_spawn_chance Percent chance for an vaal side area to appear
strongbox_spawn_chance int
areas.strongbox_spawn_chance Percent chance for a strongbox to appear
strongbox_max_count int
areas.strongbox_max_count Maximum number of strongboxes that naturally can appear in this area
strongbox_max_count list[4x int]
areas.strongbox_max_count comma-separated list of weights denoting which rarity a strongbox may be spawned in

List is normal, magic, rare, unique in that order

is_map_area bool
areas.is_map_area Whether the area is a map area
is_unique_map_area bool
areas.is_unique_map_area Whether the area is a unique map area
is_legacy_map_area bool
areas.is_legacy_map_area Whether the area is a legacy map area. Defaults to true for map areas from Original, The Awakening, and Atlas of Worlds map series; otherwise false.
is_town_area bool
areas.is_town_area Whether the area is a town
is_hideout_area bool
areas.is_hideout_area Whether the area is a hideout
is_vaal_area bool
areas.is_vaal_area Whether the area is a vaal side area
is_labyrinth_area bool
areas.is_labyrinth_area Whether the area is a labyrinth area
is_labyrinth_airlock_area bool
areas.is_labyrinth_airlock_area Whether the area is a labyrinth airlock area
is_labyrinth_boss_area bool
areas.is_labyrinth_boss_area Whether the area is a labyrinth boss area
has_waypoint bool
areas.has_waypoint Whether the area has a waypoint
screenshot_ext str
default file type is jpg, specify to override to .png or any acceptable upload file format

Finding the area id

Browse to it using Special:CargoTables or use a query similar to this:

{{#cargo_query:
tables = areas
|fields = areas._pageName, areas.id, areas.name, areas.main_page
|where = id LIKE "%"
|limit=5000
}}

Cargo

Table Declared by Attached by
areas {{Area/cargo/areas/declare}} {{Area/cargo/areas/attach}}