Path of Exile Wiki

Please consider helping keep the wiki up to date. Check the to-do list of updates needed for version 3.14.0.

Game data exports will becoming later as the technical changes in addition to regular changes take some more time.

READ MORE

Path of Exile Wiki
Register
Advertisement

In Path of Exile there are quite a few items dropping in various places, some are random and some are restricted to certain areas. As the number of items and areas where it drops increases the harder it is to maintain multiple pages with the same information. To minimize the number of pages to manually edit it's been decided to store drop restriction information on the item pages only. Other pages then have to query for that information from a database. This will reduce repetitive edits across the wiki and increase accuracy for less popular pages.

What's the mechanic?[]

{{Item acquisition}} is supposed to show various ways the item can be obtained, if the {{item}}:

  • only drops in a specific area then add the area id to |drop_areas=
  • is obtained through other items such as prophecy rewards, divination card rewards or vendor recipes use |upgraded_from_set<i>_group<j>_<item_page/amount>= (do not use this for generic recipes)
  • drops from certain monsters use |drop_monsters=.
  • drops from another mechanic, use |drop_text=.
  • it will also add quest and vendor reward information based on the data in Module:Quest reward.

For items that follow regular drop mechanics, no changes to the item template are required.

See {{Item}} for more information about how the parameters are used.

Editing & retrieving area id[]

When to edit the area id[]

Drop restrictions for the area id should only be used for cases the item can only specifically appear in a particular area.

This means if it is obtained from specific monsters found in specific areas, that information should go to drop_text and not drop_areas. Likewise, for items that just happen to have a high drop level requirement, this parameter should not be used.

At the time of writing only Divination cards and atlas base items have drop area restrictions.

Get the area id[]

Before being able to specify how an item is acquired (say from a map), you will need to make note of the place's area id.

It can be found on the wiki page for the area, in an infobox beside the Id column. For example, for Graveyard Map (Ritual) inventory iconGraveyard MapGraveyard MapMap Level: 70
Map Tier: 3
Guild Character: N
Unknown legacies.
Untold stories.
Travel to this Map by using it in a personal Map Device. Maps can only be used once.
Graveyard Map (Ritual) inventory icon
the id is MapWorldsGraveyard.

Graveyard id

You cannot add the item into the area, instead you add the area to the item.

Please note that area ids for War for the Atlas and newer map series are identical.

Edit the item page[]

To add or modify where an item is acquired, you must edit the {{Item}} infobox on that item's page (e.g. Divination card inventory iconHer MaskHer Mask card artDivination card frameHer Mask4Sacrifice FragmentTo her beauty you submit,
lest your neck the great Queen slit.
Divination card inventory icon
).

First edit the page using Edit Source or Edit (make sure to switch it to Source Editing in the editor dropdown menu)

Her mask edit buttons

Edit the Item infobox data[]

Find the section starting with {{Item, and the first line that reads drop_areas =.

This is a comma separated list of area ids. Add the new area id you made note of above (say MapWorldsGraveyard for the Graveyard Map) to the list. Do not replace old areas, they're still relevant for old areas. The tables will filter them out instead in the future.

Her mask drop areas edit

Save your changes[]

Save your changes, specifying where you got the information in the Summary box (e.g. Personal drop)

Thank you for contributing to the wiki!

Adding vendor recipes and upgrade paths[]

Vendor recipes and upgrade paths can be added as parameter to the {{Item}} template by using the |upgraded_from_... set of parameters. Those parameters must be edited on the page the vendor recipe or upgrade path produces, and not the ingredients. After the recipe has been correctly added, it will show up on all ingredient pages accordingly using the {{item acquisition}} template.

For example, Hyrri's Bite inventory iconHyrri's BiteHyrri's Bite
Sharktooth Arrow Quiver
Requires Level 10+(3-4) Life gained for each Enemy hit by your Attacks+(15-25) to Strength
+(35-45) to Dexterity
+(15-25) to Intelligence
Adds 10 to 20 Cold Damage to Attacks
(7-10)% increased Attack Speed
+(2-3) Life gained for each Enemy hit by your Attacks
10% increased Area of Effect
A Karui woman's place was not the
battlefield, but the hearth.
Hyrri changed all of that.
Hyrri's Bite inventory icon
can be created by selling a normal Sharktooth Arrow Quiver inventory iconSharktooth Arrow QuiverSharktooth Arrow QuiverRequires Level 10+(3-4) Life gained for each Enemy hit by your AttacksSharktooth Arrow Quiver inventory icon, a rare Onyx Amulet inventory iconOnyx AmuletOnyx AmuletRequires Level 20+(10-16) to all AttributesOnyx Amulet inventory icon, a Rain of Arrows inventory iconRain of ArrowsRain of ArrowsAttack, AoE, Projectile, Bow
Level: (1-20)
Cost: (7-11) Mana
Attack Damage: (48-60)% of base
Effectiveness of Added Damage: (48-60)%
Radius: 24
Requires Level 12Fires multiple arrows into the air, to land in sequence after a delay, starting at the targeted location and spreading outwards in all directions. Each arrow deals damage in an area around it. Half of the arrows will land directly on targets if there are targets in their range.Per 1% Quality:1Superior2Anomalous3Divergent4Phantasmal0.5% increased Area of Effect0.25% chance to fire an additional sequence of arrowsFires 0.2 additional Arrows0.5% chance to Maim on HitDeals (48-60)% of Base Attack Damage
Fires (17-21) additional Arrows
Place into an item socket of the right colour to gain this skill. Right click to remove from a socket.
Rain of Arrows skill icon
Rain of Arrows inventory icon
with at least 1% quality and an Orb of Chance inventory iconOrb of ChanceOrb of ChanceStack Size: 20Upgrades a normal item to a random rarityRight click this item then left click a normal item to apply it.
Shift click to unstack.
Orb of Chance inventory icon
. It can however also be obtained via the divination card Divination card inventory iconJack in the BoxJack in the Box card artDivination card frameJack in the Box4ItemTurn the crank,
close your eyes,
and pray to the gods
for a pleasant surprise.
Divination card inventory icon
as random draw.

Sets[]

This means we'll have two sets to add to the upgraded_from_parameters. Naturally we start each set at 1 and increment by one for each:

|upgraded_from_set1
|upgraded_from_set2

The sets will appear in the order given here, so set1 will appear before set2 in the {{Item acquisition}} template. Generally we go from most-specific to least-specific here, meaning that we add the vendor recipe first (because it's specific to Hyrri's Bite) and the divination card last (because it can drop any unique item with just a tiny chance of one of those being a Hyrri's Bite),

Groups[]

Groups are used to for each particular ingredient in a recipe. The vendor recipe for hyrri's bite has 4 ingredients:

|upgraded_from_set1_group1
|upgraded_from_set1_group2
|upgraded_from_set1_group3
|upgraded_from_set1_group4
|upgraded_from_set2

Now we need to tell the template which items we're looking for. There 3 ways to do this;

  • by item name using _item_name
  • by the page on the wiki using _page
  • by the metadata id using _metadata_id

Generally speaking the name works as long there is only one item with a name. If there isn't, we need to use page (for cases like Two-Stone Rings for example, which has 3 variants). In our case we don't have any pages with duplicates, so we can simply use the name:

|upgraded_from_set1_group1_item_name = Sharktooth Arrow Quiver
|upgraded_from_set1_group2_item_name = Onyx Amulet
|upgraded_from_set1_group3_item_name = Rain of Arrows
|upgraded_from_set1_group4_item_name = Orb of Chance
|upgraded_from_set2

The template now knows which items are being used, but now how many of them. Now we just add the amount with the _amount parameter for each group:

|upgraded_from_set1_group1_item_name = Sharktooth Arrow Quiver
|upgraded_from_set1_group1_amount    = 1
|upgraded_from_set1_group2_item_name = Onyx Amulet
|upgraded_from_set1_group2_amount    = 1
|upgraded_from_set1_group3_item_name = Rain of Arrows
|upgraded_from_set1_group3_amount    = 1
|upgraded_from_set1_group4_item_name = Orb of Chance
|upgraded_from_set1_group4_amount    = 1
|upgraded_from_set2

There are some special conditions for some of items we haven't covered yet. The conditions are just additional text that is displayed to the user for additional information about the recipe. Those are added with the _notes parameter. These arguments can also contain other templates, for example the colour template {{c}}.

It's easier for people to recognize that we mean normal and rare items when we use the colour. Compare:

  • normal vs normal {{c|normal|normal}}
  • rare vs rare {{c|rare|rare}}

There is nothing noteworthy about the Orb of Chance so we just leave the parameter out.

With all that in mind, we can now add the notes:

|upgraded_from_set1_group1_item_name = Sharktooth Arrow Quiver
|upgraded_from_set1_group1_amount    = 1
|upgraded_from_set1_group1_notes     = {{c|normal|normal}}
|upgraded_from_set1_group2_item_name = Onyx Amulet
|upgraded_from_set1_group2_amount    = 1
|upgraded_from_set1_group2_notes     = {{c|rare|rare}}
|upgraded_from_set1_group3_item_name = Rain of Arrows
|upgraded_from_set1_group3_amount    = 1
|upgraded_from_set1_group3_notes     = 1%+ quality
|upgraded_from_set1_group4_item_name = Orb of Chance
|upgraded_from_set1_group4_amount    = 1
|upgraded_from_set2

We're done with the first set at this point. Next we add Jack in the Box, similar to above we fill out the parameters. This is set 2 and the groups naturally start at 1 again with Jack in the Box being the only item being added.

|upgraded_from_set1_group1_item_name = Sharktooth Arrow Quiver
|upgraded_from_set1_group1_amount    = 1
|upgraded_from_set1_group1_notes     = {{c|normal|normal}}
|upgraded_from_set1_group2_item_name = Onyx Amulet
|upgraded_from_set1_group2_amount    = 1
|upgraded_from_set1_group2_notes     = {{c|rare|rare}}
|upgraded_from_set1_group3_item_name = Rain of Arrows
|upgraded_from_set1_group3_amount    = 1
|upgraded_from_set1_group3_notes     = 1%+ quality
|upgraded_from_set1_group4_item_name = Orb of Chance
|upgraded_from_set1_group4_amount    = 1
|upgraded_from_set2_text             = random {{c|unique|unique}} item
|upgraded_from_set2_group1_item_name = Jack in the Box
|upgraded_from_set2_group1_amount    = 4

That's it! Now we just need to place that within the {{Item}} template on the page. See also Path of Exile Wiki:How to edit item acquisition#Edit the item page

Common issues[]

  • When previewing pages, templates that queries data cannot display data that hasn't already been stored to the database. Make sure the page edit is correct and save the page anyway.
  • Sometimes pages that queries data doesn't update immediately. Null edit the page to force an immediate update.
Advertisement