Template:Area/doc: Difference between revisions

From Path of Exile Wiki
Jump to navigation Jump to search
>Qetuth
(→‎Parameters: added removed areas to list of types)
>OmegaK2
(parameters for the lua module)
Line 1: Line 1:
{{documentation subpage}}
{{documentation subpage}}


The '''area''' template is used to show a area [[Template:Infocard|info card]].
{{lua|Module:Area}}


==Parameters==
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.
 
==Module area call==
 
===Parameters===
 
{| class="wikitable sortable"
! Parameter
! Value
! Required
! PyPoE<br>Export
! Property
! Description
|-
| main_page
| str
| {{no}}
| {{no}}
| [[Property:Has main page|Has 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
| {{no}}
| {{yes}}
| [[Property:Is area id|Is area id]]
| Internal game id of the area (don't make this up).
|-
| name
| str
| {{no}}
| {{yes}}
| [[Property:Has name|Has name]]
| Name of the area as visible in game
|-
| act
| int
| {{no}}
| {{yes}}
| [[Property:Has act|Has act]]
| [[Act]] associated with the area
|-
| area_level
| int
| {{no}}
| {{yes}}
| [[Property:Has area level|Has area level]]
| level of the area
|-
| level_restriction_max
| int
| {{no}}
| {{yes}}
| [[Property:Has area level|Has area level]]
| 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]
| {{no}}
| {{yes}}
| [[Property:Has area type tags|Has area type tags]]
| comma-separated list of [[tags]] associated with an area denoting the type of the area.
|-
| tags
| list[str]
| {{no}}
| {{yes}}
| [[Property:Has tags|Has tags]]
| comma-separated list of [[tags]] associated with an area
|-
| loading_screen
| str
| {{no}}
| {{yes}}
| [[Property:Has loading screen image|Has loading screen image]]
| Name of the loading screen file; file path will be automatically generated from this.
|-
| connection_ids
| list[str]
| {{no}}
| {{yes}}
| [[Property:Has connection ids|Has connection ids]]
| comma-separated list of area ids this area is connected to
|-
| parent_area_id
| str
| {{no}}
| {{yes}}
| [[Property:Has parent area id|Has 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]
| {{no}}
| {{yes}}
| [[Property:Has modifier ids|Has 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]
| {{no}}
| {{yes}}
| [[Property:Has monsters ids|Has monsters ids]]
| comma-separated list of monsters metadata ids
|-
| boss_monster_ids
| list[str]
| {{no}}
| {{yes}}
| [[Property:Has boss monsters ids|Has boss monsters ids]]
| comma-separated list of boss monsters metadata ids
|-
| entry_text
| str
| {{no}}
| {{yes}}
| [[Property:Has entry text message|Has entry text message]]
| Message that is shown when the area is entered
|-
| entry_npc
| str
| {{no}}
| {{yes}}
| [[Property:Has entry text message|Has entry text message]]
| 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
| list[str]
| {{no}}
| {{yes}}
| [[Property:Has vaal area ids|Has vaal area ids]]
| comma-separated list of vaal area ids
|-
| vaal_area_spawn_chance
| int
| {{no}}
| {{yes}}
| [[Property:Has vaal area spawn chance|Has vaal area spawn chance]]
| Percent chance for an [[vaal side area]] to appear
|-
| strongbox_spawn_chance
| int
| {{no}}
| {{yes}}
| [[Property:Has strongbox spawn chance|Has strongbox spawn chance]]
| Percent chance for a [[strongbox]] to appear
|-
| strongbox_max_count
| int
| {{no}}
| {{yes}}
| [[Property:Has maximum number of strongboxes|Has maximum number of strongboxes]]
| Maximum number of strongboxes that naturally can appear in this area
|-
| strongbox_max_count
| list[4x int]
| {{no}}
| {{yes}}
| [[Property:Has normal rarity strongbox weight|Has normal rarity strongbox weight]]
[[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
List is <code>normal, magic, rare, unique</code> in that order
|-
| is_map_area
| bool
| {{no}}
| {{yes}}
| [[Property:Is map area|Is map area]]
| Whether the area is a [[map]] area
|-
| is_unique_map_area
| bool
| {{no}}
| {{yes}}
| [[Property:Is unique map area|Is unique map area]]
| Whether the area is a unique [[map]] area
|-
| is_town_area
| bool
| {{no}}
| {{yes}}
| [[Property:Is town area|Is town area]]
| Whether the area is a [[town]]
|-
| is_hideout_area
| bool
| {{no}}
| {{yes}}
| [[Property:Is hideout area|Is hideout area]]
| Whether the area is a [[hideout]]
|-
| is_vaal_area
| bool
| {{no}}
| {{yes}}
| [[Property:Is vaal area|Is vaal 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
| bool
| {{no}}
| {{yes}}
| [[Property:Is labyrinth area|Is labyrinth area]]
| Whether the area is a [[labyrinth]] area
|-
| is_labyrinth_airlock_area
| bool
| {{no}}
| {{yes}}
| [[Property:Is labyrinth airlock area|Is labyrinth airlock area]]
| Whether the area is a [[labyrinth]] airlock area
|-
| is_labyrinth_boss_area
| bool
| {{no}}
| {{yes}}
| [[Property:Is labyrinth boss area|Is labyrinth boss area]]
| Whether the area is a [[labyrinth]] boss area
|-
| has_waypoint
| bool
| {{no}}
| {{yes}}
| [[Property:Has waypoint|Has waypoint]]
| Whether the area has a waypoint
|}
 
==Legacy area call==
 
===Parameters===
All parameters except for '''name''' are optional. They can be excluded or left blank.
All parameters except for '''name''' are optional. They can be excluded or left blank.


Line 34: Line 281:
|}
|}


==Code templates==
===Code templates===
Copy and paste a code template to get started.
Copy and paste a code template to get started.


===Act area===
====Act area====
<pre><nowiki>{{area
<pre><nowiki>{{area
| name                  =  
| name                  =  
Line 50: Line 297:
}}</nowiki></pre>
}}</nowiki></pre>


===Other areas===
====Other areas====
<pre><nowiki>{{area
<pre><nowiki>{{area
| name                  =  
| name                  =  

Revision as of 22:54, 16 July 2017

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
Property Description
main_page str
Has 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
Is area id Internal game id of the area (don't make this up).
name str
Has name Name of the area as visible in game
act int
Has act Act associated with the area
area_level int
Has area level level of the area
level_restriction_max int
Has area level 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]
Has area type tags comma-separated list of tags associated with an area denoting the type of the area.
tags list[str]
Has tags comma-separated list of tags associated with an area
loading_screen str
Has loading screen image Name of the loading screen file; file path will be automatically generated from this.
connection_ids list[str]
Has connection ids comma-separated list of area ids this area is connected to
parent_area_id str
Has 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]
Has 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]
Has monsters ids comma-separated list of monsters metadata ids
boss_monster_ids list[str]
Has boss monsters ids comma-separated list of boss monsters metadata ids
entry_text str
Has entry text message Message that is shown when the area is entered
entry_npc str
Has entry text message NPC who sends the message shown upon entering the area
entry_text str
Has entry text message Message that is shown when the area is entered
vaal_area_ids list[str]
Has vaal area ids comma-separated list of vaal area ids
vaal_area_spawn_chance int
Has vaal area spawn chance Percent chance for an vaal side area to appear
strongbox_spawn_chance int
Has strongbox spawn chance Percent chance for a strongbox to appear
strongbox_max_count int
Has maximum number of strongboxes Maximum number of strongboxes that naturally can appear in this area
strongbox_max_count list[4x int]
Has normal rarity strongbox weight

Has magic rarity strongbox weight Has rare rarity strongbox weight Has unique rarity strongbox weight

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
Is map area Whether the area is a map area
is_unique_map_area bool
Is unique map area Whether the area is a unique map area
is_town_area bool
Is town area Whether the area is a town
is_hideout_area bool
Is hideout area Whether the area is a hideout
is_vaal_area bool
Is vaal area Whether the area is a vaal side area
is_master_daily_area bool
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 bool
Is labyrinth area Whether the area is a labyrinth area
is_labyrinth_airlock_area bool
Is labyrinth airlock area Whether the area is a labyrinth airlock area
is_labyrinth_boss_area bool
Is labyrinth boss area Whether the area is a labyrinth boss area
has_waypoint bool
Has waypoint Whether the area has a waypoint

Legacy area call

Parameters

All parameters except for name are optional. They can be excluded or left blank.

Parameter Description
name Name of the area
pagename Name of the area's wiki page, if different than name
type Type of the area – Possible values are: Act, Corrupted, Hideout, Map, Mission, Descent, Descent: Champions, and Removed.
act Act the area belongs to, if type is set to Act
icon Area icon – Predefined icons for values: Normal, Waypoint, and Town.
difficulty The difficulty of the area, if type is set to Descent or Descent: Champions. Possible values are Normal, Cruel, and Merciless.
mlvl1 Monster level for the area; for Normal difficulty if type is set to Act
mlvl2 Monster level for Cruel difficulty if type is set to Act
mlvl3 Monster level for Merciless difficulty if type is set to Act
image Area screenshot – Defaults to name zone screenshot.jpg
flavourtext Flavour text for the area
tileset Tileset for the area

Code templates

Copy and paste a code template to get started.

Act area

{{area
| name                   = 
| type                   = Act
| act                    = 
| icon                   = normal
| mlvl1                  = 
| mlvl2                  = 
| mlvl3                  = 
| flavourtext            = 
| tileset                =
}}

Other areas

{{area
| name                   = 
| type                   = 
| difficulty             = 
| mlvl1                  = 
| tileset                =
}}