Issue with lua-api.factorio.com navigation - Redirects to Introduction page

Place to post guides, observations, things related to modding that are not mods themselves.
kuangzhixian
Manual Inserter
Manual Inserter
Posts: 2
Joined: Thu Oct 16, 2025 5:23 am
Contact:

Issue with lua-api.factorio.com navigation - Redirects to Introduction page

Post by kuangzhixian »

Hello,

I would like to report a potential bug with the Lua API documentation website (lua-api.factorio.com).

I am trying to check the API changes for version 2.0. However, no matter which version link I click on the website, I am always redirected to the generic "Introduction" page. I cannot access the specific changelogs, classes, or concepts for the selected version.

It seems like the navigation links are broken or the page is not rendering the specific version content correctly. Could you please check this?

Thank you.
eugenekay
Filter Inserter
Filter Inserter
Posts: 871
Joined: Tue May 15, 2018 2:14 am
Contact:

Re: Issue with lua-api.factorio.com navigation - Redirects to Introduction page

Post by eugenekay »

You can open the same page in different tabs for different versions, eg RollingStockPrototype in version 2.0.7 versus 1.1.110. These pages do provide different information - the elevated_collision_mask property is even highlighted as new since it was added in that version.

Do you mean that the “Version X.Y.Z” link in the top-right does not behave like a dropdown (which is my expected behavior, as it uses the a downward-arrow graphic); but is actually a direct link to the top-level document https://lua-api.factorio.com/ ? This seems like intended behaviour, since each API page is not guaranteed to exist in all versions. If you want to quickly navigate between versions you can just edit the URL in the browser window.
kuangzhixian
Manual Inserter
Manual Inserter
Posts: 2
Joined: Thu Oct 16, 2025 5:23 am
Contact:

Re: Issue with lua-api.factorio.com navigation - Redirects to Introduction page

Post by kuangzhixian »

eugenekay wrote: Thu Nov 20, 2025 2:26 am You can open the same page in different tabs for different versions, eg RollingStockPrototype in version 2.0.7 versus 1.1.110. These pages do provide different information - the elevated_collision_mask property is even highlighted as new since it was added in that version.

Do you mean that the “Version X.Y.Z” link in the top-right does not behave like a dropdown (which is my expected behavior, as it uses the a downward-arrow graphic); but is actually a direct link to the top-level document https://lua-api.factorio.com/ ? This seems like intended behaviour, since each API page is not guaranteed to exist in all versions. If you want to quickly navigate between versions you can just edit the URL in the browser window.
Thank you for the clarification on the intended behavior of the version link—I understand now that it is designed to simply link back to the documentation root, rather than serving as a version switcher.

However, this highlights a significant navigational gap for mod and scenario developers. Since we cannot easily jump between comprehensive changelogs, and manually editing the URL is required to compare specific classes:

I would like to suggest a quality-of-life improvement for the documentation:

Could the team please consider adding a persistent link (perhaps in the footer or in the auxiliary navigation section) that redirects users directly to the Factorio Wiki's Version History page?

The Wiki's history page contains the human-readable, categorized list of Scripting and API changes (e.g., for version 2.0.0). Adding this direct link would provide mod developers with a clear and easy path to the definitive master list of changes needed for migration, which is much more efficient than manually comparing every class.

Thank you for considering this suggestion for improving developer workflow.
Post Reply

Return to “Modding discussion”