From 8dc93e8e5599db23777095f793fba95a11cea46c Mon Sep 17 00:00:00 2001 From: AnyOldName3 Date: Mon, 25 Aug 2025 01:04:20 +0100 Subject: [PATCH 1/2] Document Flatpak paths --- docs/source/reference/modding/paths.rst | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/docs/source/reference/modding/paths.rst b/docs/source/reference/modding/paths.rst index c0f7d4cea6..b9b09b6b96 100644 --- a/docs/source/reference/modding/paths.rst +++ b/docs/source/reference/modding/paths.rst @@ -27,6 +27,9 @@ Configuration files and log files | | Example | ``C:\Users\Username\Documents\My Games\OpenMW`` | +--------------+---------------+-------------------------------------------------------------------------------+ +.. note:: + Flatpak sets ``$XDG_CONFIG_HOME`` to ``$HOME/.var/app/$FLATPAK_ID/config``, so these files will be at ``$HOME/.var/app/org.openmw.OpenMW/config/openmw`` if you use the Flatpak. + Savegames --------- @@ -44,6 +47,9 @@ Savegames | | Example | ``C:\Users\Username\Documents\My Games\OpenMW\saves`` | +--------------+---------------+-------------------------------------------------------------------------------------+ +.. note:: + Flatpak sets ``$XDG_DATA_HOME`` to ``$HOME/.var/app/$FLATPAK_ID/data``, so saves will be at ``$HOME/.var/app/org.openmw.OpenMW/data/openmw/saves`` if you use the Flatpak. + Screenshots ----------- @@ -61,6 +67,9 @@ Screenshots | | Example | ``C:\Users\Username\Documents\My Games\OpenMW\screenshots`` | +--------------+---------------+-------------------------------------------------------------------------------------------+ +.. note:: + Flatpak sets ``$XDG_DATA_HOME`` to ``$HOME/.var/app/$FLATPAK_ID/data``, so screenshots will be at ``$HOME/.var/app/org.openmw.OpenMW/data/openmw/screenshots`` if you use the Flatpak. + Custom configuration directories ================================ @@ -184,6 +193,9 @@ Tokens are used in the `Default paths`_. | Windows | ``Documents\My Games\OpenMW\`` | +--------------+-----------------------------------------------------------+ +.. note:: + Flatpak sets ``$XDG_CONFIG_HOME`` to ``$HOME/.var/app/$FLATPAK_ID/config``, so ``?userconfig?`` will mean ``$HOME/.var/app/org.openmw.OpenMW/config/openmw/`` if you use the Flatpak. + :``?userdata?``: Platform-dependent: +--------------+--------------------------------------------------------------+ @@ -196,6 +208,9 @@ Tokens are used in the `Default paths`_. | Windows | ``Documents\My Games\OpenMW\`` | +--------------+--------------------------------------------------------------+ +.. note:: + Flatpak sets ``$XDG_DATA_HOME`` to ``$HOME/.var/app/$FLATPAK_ID/data``, so ``?userdata?`` will mean ``$HOME/.var/app/org.openmw.OpenMW/data/openmw/`` if you use the Flatpak. + :``?global?``: Platform-dependent: +--------------+-------------------------------------------------------------------+ From 44a14f9a8868a299cb1f454065ad230b75f8a751 Mon Sep 17 00:00:00 2001 From: AnyOldName3 Date: Mon, 25 Aug 2025 16:37:03 +0100 Subject: [PATCH 2/2] Fix #8681, too --- docs/source/reference/modding/paths.rst | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/source/reference/modding/paths.rst b/docs/source/reference/modding/paths.rst index b9b09b6b96..2fdedaa90e 100644 --- a/docs/source/reference/modding/paths.rst +++ b/docs/source/reference/modding/paths.rst @@ -21,9 +21,9 @@ Configuration files and log files | Mac | ``$HOME/Library/Preferences/openmw`` | +--------------+---------------+-------------------------------------------------------------------------------+ | Windows | File Explorer | ``Documents\My Games\OpenMW`` | -| | | | +| +---------------+-------------------------------------------------------------------------------+ | | PowerShell | ``Join-Path ([environment]::GetFolderPath("mydocuments")) "My Games\OpenMW"`` | -| | | | +| +---------------+-------------------------------------------------------------------------------+ | | Example | ``C:\Users\Username\Documents\My Games\OpenMW`` | +--------------+---------------+-------------------------------------------------------------------------------+ @@ -41,9 +41,9 @@ Savegames | Mac | ``$HOME/Library/Application\ Support/openmw/saves`` | +--------------+---------------+-------------------------------------------------------------------------------------+ | Windows | File Explorer | ``Documents\My Games\OpenMW\saves`` | -| | | | +| +---------------+-------------------------------------------------------------------------------------+ | | PowerShell | ``Join-Path ([environment]::GetFolderPath("mydocuments")) "My Games\OpenMW\saves"`` | -| | | | +| +---------------+-------------------------------------------------------------------------------------+ | | Example | ``C:\Users\Username\Documents\My Games\OpenMW\saves`` | +--------------+---------------+-------------------------------------------------------------------------------------+ @@ -61,9 +61,9 @@ Screenshots | Mac | ``$HOME/Library/Application\ Support/openmw/screenshots`` | +--------------+---------------+-------------------------------------------------------------------------------------------+ | Windows | File Explorer | ``Documents\My Games\OpenMW\screenshots`` | -| | | | +| +---------------+-------------------------------------------------------------------------------------------+ | | PowerShell | ``Join-Path ([environment]::GetFolderPath("mydocuments")) "My Games\OpenMW\screenshots"`` | -| | | | +| +---------------+-------------------------------------------------------------------------------------------+ | | Example | ``C:\Users\Username\Documents\My Games\OpenMW\screenshots`` | +--------------+---------------+-------------------------------------------------------------------------------------------+