Path of Exile 2 Wiki:Troubleshooting known issues

Issues on this wiki that are known to the admins/sysops and possible solutions on how to fix it. Consider the talk page if you want something added.

Templates/module issues specific to this wiki

Item

The {{Item}} template uses the Cargo database to store data so it can be queried and displayed in tables automatically.

Items not showing up or is out of sync in lists, item tables and other places

Can occur due to:

1. caching issues
2. invalid queries
3. template errors

Fixing item caching issues

Please see Path of Exile Wiki:Known issues#Fixing caching issues - changes (if needed) should be applied to the item's main page and the page(s) not showing the items.

Fixing invalid queries

The general process here is to check whether your query uses the correct conditions.

Some tips:

• Start by null editing the source page and the list page.
• If the query is performed by the template you're using and not by yourself, make sure to check the template's documentation first
• If an item isn't included in the query, but you think it should be check the item's page values. Adjust your query if needed or check for caching issues
• Adjust the query terms to be more broader or more precise
• If hitting query limits, consider creating a concept or simplifying the query
• You can also query for queries on a page to troubleshoot/identify the problem

Fixing template errors

Template errors will prevent the templates from performing correctly. In some cases there are shown on purpose to avoid people using invalid data, but may also be caused by errors in the template itself.

If you can't fix the error right away, check the documentation of the template.

If the error appears in the code of the template itself and if you're unable to fix it , please create a new section on the template talk page and/or notify the template authors/wiki admins on their user pages.

Mediawiki

Page is not added to transcluded categories from pages with <includeonly>

The symptom is generally that the page shows the category correctly at the bottom, but is not actually added to it.

Solution:

• Null edit the page the category is transcluded to.

Fixing caching issues

Prior to attempt to fix caching issues, please note there are multiple caches deployed:

• Cache of your browser (i.e. client-side)
• Intermediate cache from Cloudflare
• Cache used by the Mediawiki software and addons

Client-side cache issues should require no action on the wiki. Consider clearing your browser's cache or using a different browser to verify it's not client-side.

Issues with the Cloudflare will fix themselves eventually; if you preview a page you will get the current version. If you perform a null edit and you still see a version different from the version you just saved, don't worry about it - you're seeing a cached version which will be eventually updated to the saved version. Please note that if you have a gamepedia PRO subscription you'll see the live version of pages instead, bypassing the cloud flare cache.

Mediawiki and addon related caching issues can be generally resolved by null edit the affected pages. Please note you may need to null edit other pages if you're transcluding content from other pages or are fetching semantic values (from Semantic MediaWiki). If the edits are still not being applied, consider doing a dummy edit.

Extensions

Scribunto (Modules/Lua)

The Scribunto extension allows for embedding scripting languages in MediaWiki. Currently the only supported scripting language is Lua. For a reference manual see the Lua reference manual.

mw.text.split is very slow

Solution:

• If possible use string.split instead

Cargo

Cargo is a type of database used to store interesting values in various items, mods, versions etc. as rows in cargo tables. The syntax is very similar to MySQL or SQL because it uses MySQL at its core.

Missing rows

Cargo sometimes misses pages when it repopulates the tables. Null editing each page works most of the time.

Duplicate rows

When updating pages cargo sometimes does not remove the old rows. So the old row values would still be there and show up in queries. Recreating data clears that but data recreation misses rows instead. group by helps clean up duplicates but there is no guarantee that you will get latest version.

One template declares/attaches to multiple cargo tables

Cargo tables can become quite large with a lot fields. Since multiple tables can be joined together and queried for it is more elegant to move the fields to other tables instead. The caveat is that the templates need to be split as well otherwise cargo bugs out. 1 template per cargo table.

Errors during previews

Cargo doesn't handle incorrect cargo queries gracefully and sometimes throws major errors that forces you to go back a page. Copy the source before submitting/previewing so your work doesn't get lost.

HOLDS doesn't work as expected

Cargo bug. Instead of using HOLDS try, *__full instead. The lists then becomes a ordinary string and can be queried as such.

Example:

• Replace skill_gems.gem_tags HOLDS "Aura" with skill_gems.gem_tags__full LIKE "%Aura%"
• Use regexp for more advanced queries: events.id__FULL REGEXP "(, |^)SSF Abyss(, |$)".
  • The delimiter in this case is ,
  • Replace | with {{!}} in normal wikitext.

Case sensitivity

Cargo is case insensitive. Use BINARY instead. Read more here.

Recreation jobs are queued?

It's possible to see if a cargo data recreation job is active. See this page

Number can't be used in #expr

• #cargo_query returns integers/floats with thousand separator. Not surprisingly this will break most calculators. Wrap CONCAT() around the number field to remove thousand separators.
• #cargo_query sometimes returns the numbers with hidden characters as well. Use no html to remove those.