From 302d92561d946a32f0a90783f824041452245464 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Mon, 16 Jun 2025 15:36:43 -0700
Subject: [PATCH 01/44] docs - begin restructing docs

---
 apps/openmw/mwlua/README.md                   |   2 +-
 docs/requirements.txt                         |   3 +
 docs/source/_static/luadoc.css                |  60 ++++-
 docs/source/_static/theme.css                 |  11 +
 docs/source/conf.py                           |  29 ++-
 .../reference/lua-scripting/ai/combat.rst     |  36 +++
 .../reference/lua-scripting/ai/escort.rst     |  49 ++++
 .../reference/lua-scripting/ai/follow.rst     |  37 +++
 .../reference/lua-scripting/ai/pursue.rst     |  25 ++
 .../reference/lua-scripting/ai/travel.rst     |  28 +++
 .../reference/lua-scripting/ai/wander.rst     |  53 +++++
 .../reference/lua-scripting/aipackages.rst    | 225 ------------------
 docs/source/reference/lua-scripting/api.rst   |  55 +----
 .../lua-scripting/engine_handlers.rst         |  14 ++
 .../source/reference/lua-scripting/events.rst |   4 +-
 docs/source/reference/lua-scripting/index.rst |   6 +-
 .../lua-scripting/index_aipackages.rst        |  24 ++
 .../lua-scripting/index_auxpackages.rst       |  21 ++
 .../lua-scripting/index_interfaces.rst        |  25 ++
 .../lua-scripting/index_packages.rst          |  37 +++
 .../reference/lua-scripting/overview.rst      |   8 +-
 .../lua-scripting/setting_renderers.rst       |   4 +-
 .../lua-scripting/tables/aux_packages.rst     |  31 ++-
 .../lua-scripting/tables/interfaces.rst       |  79 +++---
 .../lua-scripting/tables/packages.rst         | 113 +++++----
 .../lua-scripting/user_interface.rst          |  96 ++++----
 .../reference/lua-scripting/version.rst       |   3 +-
 .../lua-scripting/widgets/container.rst       |  45 +++-
 .../reference/lua-scripting/widgets/image.rst |   2 +
 .../reference/lua-scripting/widgets/text.rst  |   2 +
 .../lua-scripting/widgets/textedit.rst        |   2 +
 .../lua-scripting/widgets/widget.rst          |   2 +
 docs/source/reference/modding/extended.rst    |   2 +-
 docs/source/reference/modding/index.rst       |   4 +-
 .../modding/texture-modding/index.rst         |   6 +-
 .../source/reference/postprocessing/index.rst |   6 +-
 files/data/scripts/omw/ai.lua                 |   2 +-
 files/data/scripts/omw/settings/player.lua    |   2 +-
 files/lua_api/openmw/ambient.lua              |   4 +-
 files/lua_api/openmw/animation.lua            |   3 +-
 files/lua_api/openmw/async.lua                |   3 +-
 files/lua_api/openmw/camera.lua               |   4 +-
 files/lua_api/openmw/core.lua                 |   4 +-
 files/lua_api/openmw/debug.lua                |   4 +-
 files/lua_api/openmw/input.lua                |   2 +-
 files/lua_api/openmw/interfaces.lua           |   1 +
 files/lua_api/openmw/markup.lua               |   3 +-
 files/lua_api/openmw/menu.lua                 |   3 +-
 files/lua_api/openmw/nearby.lua               |   4 +-
 files/lua_api/openmw/postprocessing.lua       |   4 +-
 files/lua_api/openmw/self.lua                 |   5 +-
 files/lua_api/openmw/storage.lua              |   3 +-
 files/lua_api/openmw/types.lua                |   3 +-
 files/lua_api/openmw/ui.lua                   |   4 +-
 files/lua_api/openmw/util.lua                 |   3 +-
 files/lua_api/openmw/vfs.lua                  |   3 +-
 files/lua_api/openmw/world.lua                |   4 +-
 57 files changed, 732 insertions(+), 485 deletions(-)
 create mode 100644 docs/source/_static/theme.css
 create mode 100644 docs/source/reference/lua-scripting/ai/combat.rst
 create mode 100644 docs/source/reference/lua-scripting/ai/escort.rst
 create mode 100644 docs/source/reference/lua-scripting/ai/follow.rst
 create mode 100644 docs/source/reference/lua-scripting/ai/pursue.rst
 create mode 100644 docs/source/reference/lua-scripting/ai/travel.rst
 create mode 100644 docs/source/reference/lua-scripting/ai/wander.rst
 delete mode 100644 docs/source/reference/lua-scripting/aipackages.rst
 create mode 100644 docs/source/reference/lua-scripting/index_aipackages.rst
 create mode 100644 docs/source/reference/lua-scripting/index_auxpackages.rst
 create mode 100644 docs/source/reference/lua-scripting/index_interfaces.rst
 create mode 100644 docs/source/reference/lua-scripting/index_packages.rst

diff --git a/apps/openmw/mwlua/README.md b/apps/openmw/mwlua/README.md
index ed911eb01d..a1cfeb1f1b 100644
--- a/apps/openmw/mwlua/README.md
+++ b/apps/openmw/mwlua/README.md
@@ -3,7 +3,7 @@
 This folder contains the C++ implementation of the Lua scripting system.
 
 For user-facing documentation, see
-[OpenMW Lua scripting](https://openmw.readthedocs.io/en/latest/reference/lua-scripting/index.html).
+[Lua scripting](https://openmw.readthedocs.io/en/latest/reference/lua-scripting/index.html).
 The documentation is generated from
 [/docs/source/reference/lua-scripting](/docs/source/reference/lua-scripting).
 You can find instructions for generating the documentation at the
diff --git a/docs/requirements.txt b/docs/requirements.txt
index f46cc5c95d..0e02883062 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -3,3 +3,6 @@ sphinx==7.1.2
 docutils==0.18.1
 jinja2==3.1.6
 sphinx_rtd_theme==3.0.1
+sphinx-design==0.6.1
+furo==2024.8.6
+sphinx-copybutton==0.5.2
\ No newline at end of file
diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index aa83013def..8a2e01c082 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -1,10 +1,9 @@
 #luadoc tt { font-family: monospace; }
 
-#luadoc p,
+/* #luadoc p,
 #luadoc td,
 #luadoc th { font-size: .95em; line-height: 1.2em;}
 
-#luadoc p,
 #luadoc ul
 { margin: 10px 0 0 10px;}
 
@@ -109,5 +108,60 @@
 
 #luadoc dl,
 #luadoc dd {margin: 0px; line-height: 1.2em;}
-#luadoc li {list-style: bullet;}
+#luadoc li {list-style: bullet;} */
 
+#luadoc pre.example {
+    background-color: #eeffcc;
+    border: 1px solid #e1e4e5;
+    padding: 10px;
+    margin: 10px 0 10px 0;
+    overflow-x: auto;
+}
+
+
+#luadoc pre.example code {
+    color: var(--color-content-foreground);
+    background-color: #eeffcc;
+    border: none;
+    white-space: pre;
+    padding: 0px;
+}
+
+#luadoc code {
+    /* background-color: inherit;
+    color: inherit;
+    border: none; */
+    font-family: monospace;
+}
+
+body[data-theme="dark"] #luadoc pre.example {
+    background-color: #eeffcc;
+}
+
+@media (prefers-color-scheme: dark) {
+    body:not([data-theme="light"]) #luadoc pre.example {
+        background-color: #eeffcc;
+    }
+}
+
+#luadoc a:not(:link) {
+    font-weight: bold;
+    color: var(--color-content-foreground);
+    text-decoration: none;
+    cursor: inherit;
+}
+
+#luadoc p em { font-family: 'monospace';}
+
+#luadoc a:link { font-weight: bold; color: var(--color-link);; text-decoration: none; }
+#luadoc a:visited { font-weight: bold; color: var(--color-link--hover); text-decoration: none; }
+#luadoc a:link:hover { text-decoration: underline; }
+
+.context-wrapper {
+    display: flex;
+    gap: 4px;
+}
+
+table.docutils {
+    width: 100%;
+}
\ No newline at end of file
diff --git a/docs/source/_static/theme.css b/docs/source/_static/theme.css
new file mode 100644
index 0000000000..2f0ef03b28
--- /dev/null
+++ b/docs/source/_static/theme.css
@@ -0,0 +1,11 @@
+.content {
+    width: 60em;
+}
+
+a.next-page, a.prev-page {
+    color: var(--color-link);
+}
+
+a.next-page:hover, a.prev-page:hover {
+    text-decoration: underline;
+}
\ No newline at end of file
diff --git a/docs/source/conf.py b/docs/source/conf.py
index fbce7975da..38c1b01033 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -37,6 +37,8 @@ extensions = [
     'sphinx.ext.coverage',
     'sphinx.ext.viewcode',
     'sphinx.ext.autosectionlabel',
+    'sphinx_design',
+    'sphinx_copybutton',
 ]
 
 #autosectionlabel_prefix_document = True
@@ -91,7 +93,14 @@ except Exception as ex:
 
 rst_prolog = f"""
 .. |luaApiRevision| replace:: {luaApiRevision}
+.. |luaApiRevisionBadge| replace:: :bdg-link-info-line:`API v{luaApiRevision} <openmw_core.html##(core).API_REVISION>`
+
 .. |ppApiRevision| replace:: {ppApiRevision}
+.. |bdg-ctx-menu| replace:: :bdg-warning:`menu`
+.. |bdg-ctx-global| replace:: :bdg-danger:`global`
+.. |bdg-ctx-player| replace:: :bdg-secondary:`local:player`
+.. |bdg-ctx-local| replace:: :bdg-info:`local`
+.. |bdg-ctx-all| replace:: :bdg-danger:`global` :bdg-warning:`menu` :bdg-info:`local`
 """
 
 # The language for content autogenerated by Sphinx. Refer to documentation
@@ -138,7 +147,7 @@ primary_domain = 'c'
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'sphinx_rtd_theme'
+html_theme = 'furo'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -146,14 +155,20 @@ html_theme = 'sphinx_rtd_theme'
 html_theme_options = {
     'navigation_with_keys': True,
     'flyout_display': 'attached',
+    'sidebar_hide_name': False,
+    'top_of_page_buttons': [],
 }
 
+html_css_files = [
+    "theme.css",
+    "luadoc.css",
+    "figures.css"
+]
+
 # Add any paths that contain custom themes here, relative to this directory.
 #html_theme_path = []
 
 def setup(app):
-    app.add_css_file('figures.css')
-    app.add_css_file('luadoc.css')
     try:
         subprocess.call(['bash', project_root + '/docs/source/generate_luadoc.sh'])
     except Exception as e:
@@ -161,19 +176,19 @@ def setup(app):
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
-#html_title = None
+html_title = 'OpenMW'
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
-#html_short_title = 'OpenMW Documentation'
+# html_short_title = 'OpenMW Documentation'
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-#html_logo = 'https://gitlab.com/OpenMW/openmw-docs/raw/master/docs/source/_static/images/openmw.png'
+html_logo = 'https://gitlab.com/OpenMW/openmw-docs/raw/master/docs/source/_static/images/openmw.png'
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
 # pixels large.
-#html_favicon = 'https://gitlab.com/OpenMW/openmw-docs/raw/master/docs/source/_static/images/favicon.png'
+html_favicon = 'https://gitlab.com/OpenMW/openmw-docs/raw/master/docs/source/_static/images/favicon.png'
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
diff --git a/docs/source/reference/lua-scripting/ai/combat.rst b/docs/source/reference/lua-scripting/ai/combat.rst
new file mode 100644
index 0000000000..06dd9c1452
--- /dev/null
+++ b/docs/source/reference/lua-scripting/ai/combat.rst
@@ -0,0 +1,36 @@
+Combat
+======
+
+.. include:: ../version.rst
+
+Attack another actor.
+
+**Arguments**
+
+.. list-table::
+  :header-rows: 1
+  :widths: 20 20 60
+
+  * - name
+    - type
+    - description
+  * - type
+    - string [required]
+    - the name of the package (see packages listed below)
+  * - cancelOther
+    - boolean [default=true]
+    - whether to cancel all other AI packages
+  * - target
+    - `GameObject <../openmw_core.html##(GameObject)>`_ [required]
+    - the actor to attack
+
+**Examples**
+
+.. code-block:: Lua
+
+    -- from local script add package to self
+    local AI = require('openmw.interfaces').AI
+    AI.startPackage({type='Combat', target=anotherActor})
+
+    -- via event to any actor
+    actor:sendEvent('StartAIPackage', {type='Combat', target=anotherActor})
diff --git a/docs/source/reference/lua-scripting/ai/escort.rst b/docs/source/reference/lua-scripting/ai/escort.rst
new file mode 100644
index 0000000000..fd9f2d05e5
--- /dev/null
+++ b/docs/source/reference/lua-scripting/ai/escort.rst
@@ -0,0 +1,49 @@
+Escort
+======
+
+.. include:: ../version.rst
+
+Escort another actor to the given location.
+
+**Arguments**
+
+.. list-table::
+  :header-rows: 1
+  :widths: 20 20 60
+
+  * - name
+    - type
+    - description
+  * - type
+    - string [required]
+    - the name of the package (see packages listed below)
+  * - cancelOther
+    - boolean [default=true]
+    - whether to cancel all other AI packages
+  * - target
+    - `GameObject <../openmw_core.html##(GameObject)>`_ [required]
+    - the actor to follow
+  * - destPosition
+    - `3d vector <../openmw_util.html##(Vector3)>`_ [required]
+    - the destination point
+  * - destCell
+    - Cell [optional]
+    - the destination cell
+  * - duration
+    - number [optional]
+    - duration in game time (will be rounded up to the next hour)
+  * - isRepeat
+    - boolean [optional]
+    - Will the package repeat (true or false)
+
+**Example**
+
+.. code-block:: Lua
+
+    actor:sendEvent('StartAIPackage', {
+        type = 'Escort',
+        target = object.self,
+        destPosition = util.vector3(x, y, z),
+        duration = 3 * time.hour,
+        isRepeat = true
+    })
diff --git a/docs/source/reference/lua-scripting/ai/follow.rst b/docs/source/reference/lua-scripting/ai/follow.rst
new file mode 100644
index 0000000000..ac6b70bcf7
--- /dev/null
+++ b/docs/source/reference/lua-scripting/ai/follow.rst
@@ -0,0 +1,37 @@
+Follow
+======
+
+.. include:: ../version.rst
+
+Follow another actor.
+
+**Arguments**
+
+.. list-table::
+  :header-rows: 1
+  :widths: 20 20 60
+
+  * - name
+    - type
+    - description
+  * - type
+    - string [required]
+    - the name of the package (see packages listed below)
+  * - cancelOther
+    - boolean [default=true]
+    - whether to cancel all other AI packages
+  * - target
+    - `GameObject <../openmw_core.html##(GameObject)>`_ [required]
+    - the actor to follow
+  * - destCell
+    - Cell [optional]
+    - the destination cell
+  * - duration
+    - number [optional]
+    - duration in game time (will be rounded up to the next hour)
+  * - destPosition
+    - `3d vector <../openmw_util.html##(Vector3)>`_ [optional]
+    - the destination point
+  * - isRepeat
+    - boolean [optional]
+    - Will the package repeat (true or false)
diff --git a/docs/source/reference/lua-scripting/ai/pursue.rst b/docs/source/reference/lua-scripting/ai/pursue.rst
new file mode 100644
index 0000000000..08385c57ae
--- /dev/null
+++ b/docs/source/reference/lua-scripting/ai/pursue.rst
@@ -0,0 +1,25 @@
+Pursue
+======
+
+.. include:: ../version.rst
+
+Pursue another actor.
+
+**Arguments**
+
+.. list-table::
+  :header-rows: 1
+  :widths: 20 20 60
+
+  * - name
+    - type
+    - description
+  * - type
+    - string [required]
+    - the name of the package (see packages listed below)
+  * - cancelOther
+    - boolean [default=true]
+    - whether to cancel all other AI packages
+  * - target
+    - `GameObject <../openmw_core.html##(GameObject)>`_ [required]
+    - the actor to pursue
diff --git a/docs/source/reference/lua-scripting/ai/travel.rst b/docs/source/reference/lua-scripting/ai/travel.rst
new file mode 100644
index 0000000000..06a47c868d
--- /dev/null
+++ b/docs/source/reference/lua-scripting/ai/travel.rst
@@ -0,0 +1,28 @@
+Travel
+======
+
+.. include:: ../version.rst
+
+Go to given location.
+
+**Arguments**
+
+.. list-table::
+  :header-rows: 1
+  :widths: 20 20 60
+
+  * - name
+    - type
+    - description
+  * - type
+    - string [required]
+    - the name of the package (see packages listed below)
+  * - cancelOther
+    - boolean [default=true]
+    - whether to cancel all other AI packages
+  * - destPosition
+    - `3d vector <../openmw_util.html##(Vector3)>`_ [required]
+    - the point to travel to
+  * - isRepeat
+    - boolean [optional]
+    - Will the package repeat (true or false)
diff --git a/docs/source/reference/lua-scripting/ai/wander.rst b/docs/source/reference/lua-scripting/ai/wander.rst
new file mode 100644
index 0000000000..fc702f12e2
--- /dev/null
+++ b/docs/source/reference/lua-scripting/ai/wander.rst
@@ -0,0 +1,53 @@
+Wander
+======
+
+.. include:: ../version.rst
+
+Wander nearby current position.
+
+**Arguments**
+
+.. list-table::
+  :header-rows: 1
+  :widths: 20 20 60
+
+  * - name
+    - type
+    - description
+  * - type
+    - string [required]
+    - the name of the package (see packages listed below)
+  * - distance
+    - float [default=0]
+    - the actor to follow
+  * - duration
+    - number [optional]
+    - duration in game time (will be rounded up to the next hour)
+  * - idle
+    - table [optional]
+    - Idle chance values, up to 8
+  * - isRepeat
+    - boolean [optional]
+    - Will the package repeat (true or false)
+
+**Example**
+
+.. code-block:: Lua
+
+    local idleTable = {
+        idle2 = 60,
+        idle3 = 50,
+        idle4 = 40,
+        idle5 = 30,
+        idle6 = 20,
+        idle7 = 10,
+        idle8 = 0,
+        idle9 = 25
+    }
+    actor:sendEvent('StartAIPackage', {
+        type = 'Wander',
+        distance = 5000,
+        duration = 5 * time.hour,
+        idle = idleTable,
+        isRepeat = true
+    })
diff --git a/docs/source/reference/lua-scripting/aipackages.rst b/docs/source/reference/lua-scripting/aipackages.rst
deleted file mode 100644
index 7a23d156f5..0000000000
--- a/docs/source/reference/lua-scripting/aipackages.rst
+++ /dev/null
@@ -1,225 +0,0 @@
-Built-in AI packages
-====================
-
-.. include:: version.rst
-
-Starting an AI package
-----------------------
-
-There are two ways to start AI package:
-
-.. code-block:: Lua
-
-    -- from local script add package to self
-    local AI = require('openmw.interfaces').AI
-    AI.startPackage(options)
-
-    -- via event to any actor
-    actor:sendEvent('StartAIPackage', options)
-
-``options`` is Lua table with arguments of the AI package.
-
-**Common arguments that can be used with any AI package**
-
-.. list-table::
-  :header-rows: 1
-  :widths: 20 20 60
-
-  * - name
-    - type
-    - description
-  * - type
-    - string [required]
-    - the name of the package (see packages listed below)
-  * - cancelOther
-    - boolean [default=true]
-    - whether to cancel all other AI packages
-
-Combat
-------
-
-Attack another actor.
-
-**Arguments**
-
-.. list-table::
-  :header-rows: 1
-  :widths: 20 20 60
-
-  * - name
-    - type
-    - description
-  * - target
-    - `GameObject <openmw_core.html##(GameObject)>`_ [required]
-    - the actor to attack
-
-**Examples**
-
-.. code-block:: Lua
-
-    -- from local script add package to self
-    local AI = require('openmw.interfaces').AI
-    AI.startPackage({type='Combat', target=anotherActor})
-
-    -- via event to any actor
-    actor:sendEvent('StartAIPackage', {type='Combat', target=anotherActor})
-
-Pursue
-------
-
-Pursue another actor.
-
-**Arguments**
-
-.. list-table::
-  :header-rows: 1
-  :widths: 20 20 60
-
-  * - name
-    - type
-    - description
-  * - target
-    - `GameObject <openmw_core.html##(GameObject)>`_ [required]
-    - the actor to pursue
-
-Follow
-------
-
-Follow another actor.
-
-**Arguments**
-
-.. list-table::
-  :header-rows: 1
-  :widths: 20 20 60
-
-  * - name
-    - type
-    - description
-  * - target
-    - `GameObject <openmw_core.html##(GameObject)>`_ [required]
-    - the actor to follow
-  * - destCell
-    - Cell [optional]
-    - the destination cell
-  * - duration
-    - number [optional]
-    - duration in game time (will be rounded up to the next hour)
-  * - destPosition
-    - `3d vector <openmw_util.html##(Vector3)>`_ [optional]
-    - the destination point
-  * - isRepeat
-    - boolean [optional]
-    - Will the package repeat (true or false)
-
-Escort
-------
-
-Escort another actor to the given location.
-
-**Arguments**
-
-.. list-table::
-  :header-rows: 1
-  :widths: 20 20 60
-
-  * - name
-    - type
-    - description
-  * - target
-    - `GameObject <openmw_core.html##(GameObject)>`_ [required]
-    - the actor to follow
-  * - destPosition
-    - `3d vector <openmw_util.html##(Vector3)>`_ [required]
-    - the destination point
-  * - destCell
-    - Cell [optional]
-    - the destination cell
-  * - duration
-    - number [optional]
-    - duration in game time (will be rounded up to the next hour)
-  * - isRepeat
-    - boolean [optional]
-    - Will the package repeat (true or false)
-
-**Example**
-
-.. code-block:: Lua
-
-    actor:sendEvent('StartAIPackage', {
-        type = 'Escort',
-        target = object.self,
-        destPosition = util.vector3(x, y, z),
-        duration = 3 * time.hour,
-        isRepeat = true
-    })
-
-Wander
-------
-
-Wander nearby current position.
-
-**Arguments**
-
-.. list-table::
-  :header-rows: 1
-  :widths: 20 20 60
-
-  * - name
-    - type
-    - description
-  * - distance
-    - float [default=0]
-    - the actor to follow
-  * - duration
-    - number [optional]
-    - duration in game time (will be rounded up to the next hour)
-  * - idle
-    - table [optional]
-    - Idle chance values, up to 8
-  * - isRepeat
-    - boolean [optional]
-    - Will the package repeat (true or false)
-
-**Example**
-
-.. code-block:: Lua
-
-    local idleTable = {
-        idle2 = 60,
-        idle3 = 50,
-        idle4 = 40,
-        idle5 = 30,
-        idle6 = 20,
-        idle7 = 10,
-        idle8 = 0,
-        idle9 = 25
-    }
-    actor:sendEvent('StartAIPackage', {
-        type = 'Wander',
-        distance = 5000,
-        duration = 5 * time.hour,
-        idle = idleTable,
-        isRepeat = true
-    })
-
-Travel
-------
-
-Go to given location.
-
-**Arguments**
-
-.. list-table::
-  :header-rows: 1
-  :widths: 20 20 60
-
-  * - name
-    - type
-    - description
-  * - destPosition
-    - `3d vector <openmw_util.html##(Vector3)>`_ [required]
-    - the point to travel to
-  * - isRepeat
-    - boolean [optional]
-    - Will the package repeat (true or false)
diff --git a/docs/source/reference/lua-scripting/api.rst b/docs/source/reference/lua-scripting/api.rst
index 82a860b355..adede0b0d6 100644
--- a/docs/source/reference/lua-scripting/api.rst
+++ b/docs/source/reference/lua-scripting/api.rst
@@ -7,54 +7,15 @@ Lua API reference
 .. toctree::
     :hidden:
 
-    engine_handlers
-    user_interface
-    aipackages
+    index_packages
+    index_auxpackages
+    index_aipackages
+    index_interfaces
+    UI <user_interface>
     setting_renderers
+    Engine Handlers <engine_handlers>
     events
-    openmw_ambient
-    openmw_animation
-    openmw_async
-    openmw_camera
-    openmw_core
-    openmw_debug
-    openmw_input
-    openmw_markup
-    openmw_menu
-    openmw_nearby
-    openmw_postprocessing
-    openmw_self
-    openmw_storage
-    openmw_types
-    openmw_ui
-    openmw_util
-    openmw_vfs
-    openmw_world
-    openmw_aux_calendar
-    openmw_aux_time
-    openmw_aux_ui
-    openmw_aux_util
-    interface_activation
-    interface_ai
-    interface_animation
-    interface_camera
-    interface_controls
-    interface_gamepadcontrols
-    interface_item_usage
-    interface_mwui
-    interface_settings
-    interface_skill_progression
-    interface_ui
-    interface_crimes
-    iterables
-
-
-- :ref:`Engine handlers reference`
-- :ref:`User interface reference <User interface reference>`
-- `Game object reference <openmw_core.html##(GameObject)>`_
-- `Cell reference <openmw_core.html##(Cell)>`_
-- :ref:`Built-in AI packages`
-- :ref:`Built-in events`
+    Iterables <iterables>
 
 **API packages**
 
@@ -66,7 +27,7 @@ Player scripts are local scripts that are attached to a player.
 
 .. include:: tables/packages.rst
 
-**openmw_aux**
+**Auxiliary packages**
 
 ``openmw_aux.*`` are built-in libraries that are itself implemented in Lua. They can not do anything that is not possible with the basic API, they only make it more convenient.
 Sources can be found in ``resources/vfs/openmw_aux``. In theory mods can override them, but it is not recommended.
diff --git a/docs/source/reference/lua-scripting/engine_handlers.rst b/docs/source/reference/lua-scripting/engine_handlers.rst
index ac6979a236..29b14aee55 100644
--- a/docs/source/reference/lua-scripting/engine_handlers.rst
+++ b/docs/source/reference/lua-scripting/engine_handlers.rst
@@ -7,6 +7,8 @@ Engine handler is a function defined by a script, that can be called by the engi
 
 **Can be defined by any script**
 
+|bdg-ctx-all|
+
 .. list-table::
   :widths: 20 80
 
@@ -16,6 +18,8 @@ Engine handler is a function defined by a script, that can be called by the engi
 
 **Can be defined by any non-menu script**
 
+|bdg-ctx-global| |bdg-ctx-local|
+
 .. list-table::
   :widths: 20 80
 
@@ -39,6 +43,8 @@ Engine handler is a function defined by a script, that can be called by the engi
 
 **Only for global scripts**
 
+|bdg-ctx-global|
+
 .. list-table::
   :widths: 20 80
 
@@ -61,6 +67,8 @@ Engine handler is a function defined by a script, that can be called by the engi
 
 **Only for local scripts**
 
+|bdg-ctx-local|
+
 .. list-table::
   :widths: 20 80
 
@@ -86,6 +94,8 @@ Engine handler is a function defined by a script, that can be called by the engi
 
 **Only menu scripts and local scripts attached to a player**
 
+|bdg-ctx-menu| |bdg-ctx-player|
+
 .. list-table::
   :widths: 20 80
 
@@ -140,6 +150,8 @@ Engine handler is a function defined by a script, that can be called by the engi
 
 **Only for local scripts attached to a player**
 
+|bdg-ctx-player|
+
 .. list-table::
   :widths: 20 80
 
@@ -152,6 +164,8 @@ Engine handler is a function defined by a script, that can be called by the engi
 
 **Only for menu scripts**
 
+|bdg-ctx-menu|
+
 .. list-table::
   :widths: 20 80
 
diff --git a/docs/source/reference/lua-scripting/events.rst b/docs/source/reference/lua-scripting/events.rst
index 282e3d1173..007e0e43d1 100644
--- a/docs/source/reference/lua-scripting/events.rst
+++ b/docs/source/reference/lua-scripting/events.rst
@@ -1,5 +1,5 @@
-Built-in events
-===============
+Events
+======
 
 .. include:: version.rst
 
diff --git a/docs/source/reference/lua-scripting/index.rst b/docs/source/reference/lua-scripting/index.rst
index f3764c4401..8db10bdae1 100644
--- a/docs/source/reference/lua-scripting/index.rst
+++ b/docs/source/reference/lua-scripting/index.rst
@@ -1,6 +1,6 @@
-####################
-OpenMW Lua scripting
-####################
+#############
+Lua scripting
+#############
 
 .. note::
     OpenMW Lua is not compatible with MWSE.
diff --git a/docs/source/reference/lua-scripting/index_aipackages.rst b/docs/source/reference/lua-scripting/index_aipackages.rst
new file mode 100644
index 0000000000..2b8b41bb08
--- /dev/null
+++ b/docs/source/reference/lua-scripting/index_aipackages.rst
@@ -0,0 +1,24 @@
+AI packages
+============
+
+.. include:: version.rst
+
+.. toctree::
+    :hidden:
+    :glob:
+
+    ai/*
+
+Starting an AI package
+----------------------
+
+There are two ways to start AI package:
+
+.. code-block:: Lua
+
+    -- from local script add package to self
+    local AI = require('openmw.interfaces').AI
+    AI.startPackage(options)
+
+    -- via event to any actor
+    actor:sendEvent('StartAIPackage', options)
diff --git a/docs/source/reference/lua-scripting/index_auxpackages.rst b/docs/source/reference/lua-scripting/index_auxpackages.rst
new file mode 100644
index 0000000000..e50fe45026
--- /dev/null
+++ b/docs/source/reference/lua-scripting/index_auxpackages.rst
@@ -0,0 +1,21 @@
+##################
+Auxiliary Packages
+##################
+
+.. include:: version.rst
+
+.. toctree::
+    :hidden:
+
+    aux_calendar <openmw_aux_calendar>
+    aux_time <openmw_aux_time>
+    aux_ui <openmw_aux_ui>
+    aux_util <openmw_aux_util>
+
+
+**Auxiliary packages**
+
+``openmw_aux.*`` are built-in libraries that are itself implemented in Lua. They can not do anything that is not possible with the basic API, they only make it more convenient.
+Sources can be found in ``resources/vfs/openmw_aux``. In theory mods can override them, but it is not recommended.
+
+.. include:: tables/aux_packages.rst
diff --git a/docs/source/reference/lua-scripting/index_interfaces.rst b/docs/source/reference/lua-scripting/index_interfaces.rst
new file mode 100644
index 0000000000..06f21ee7d5
--- /dev/null
+++ b/docs/source/reference/lua-scripting/index_interfaces.rst
@@ -0,0 +1,25 @@
+##########
+Interfaces
+##########
+
+.. include:: version.rst
+
+.. toctree::
+    :hidden:
+
+    activation <interface_activation>
+    ai <interface_ai>
+    animation <interface_animation>
+    camera <interface_camera>
+    controls <interface_controls>
+    gamepadcontrols <interface_gamepadcontrols>
+    item_usage <interface_item_usage>
+    mwui <interface_mwui>
+    settings <interface_settings>
+    skill_progression <interface_skill_progression>
+    ui <interface_ui>
+    crimes <interface_crimes>
+
+**Interfaces of built-in scripts**
+
+.. include:: tables/interfaces.rst
diff --git a/docs/source/reference/lua-scripting/index_packages.rst b/docs/source/reference/lua-scripting/index_packages.rst
new file mode 100644
index 0000000000..53a836519f
--- /dev/null
+++ b/docs/source/reference/lua-scripting/index_packages.rst
@@ -0,0 +1,37 @@
+########
+Packages
+########
+
+.. include:: version.rst
+
+.. toctree::
+    :hidden:
+
+    ambient <openmw_ambient>
+    animation <openmw_animation>
+    async <openmw_async>
+    camera <openmw_camera>
+    core <openmw_core>
+    debug <openmw_debug>
+    input <openmw_input>
+    markup <openmw_markup>
+    menu <openmw_menu>
+    nearby <openmw_nearby>
+    postprocessing <openmw_postprocessing>
+    self <openmw_self>
+    storage <openmw_storage>
+    types <openmw_types>
+    ui <openmw_ui>
+    util <openmw_util>
+    vfs <openmw_vfs>
+    world <openmw_world>
+
+**API packages**
+
+API packages provide functions that can be called by scripts. I.e. it is a script-to-engine interaction.
+A package can be loaded with ``require('<package name>')``.
+It can not be overloaded even if there is a lua file with the same name.
+The list of available packages is different for global and for local scripts.
+Player scripts are local scripts that are attached to a player.
+
+.. include:: tables/packages.rst
diff --git a/docs/source/reference/lua-scripting/overview.rst b/docs/source/reference/lua-scripting/overview.rst
index b889b09a9f..2061e4efe9 100644
--- a/docs/source/reference/lua-scripting/overview.rst
+++ b/docs/source/reference/lua-scripting/overview.rst
@@ -384,8 +384,8 @@ Player scripts are local scripts that are attached to a player.
 
 .. include:: tables/packages.rst
 
-openmw_aux
-----------
+Auxiliary packages
+------------------
 
 ``openmw_aux.*`` are built-in libraries that are themselves implemented in Lua. They can not do anything that is not possible with the basic API, they only make it more convenient.
 Sources can be found in ``resources/vfs/openmw_aux``. In theory mods can override them, but it is not recommended.
@@ -544,7 +544,7 @@ The protection mod attaches an additional local script to every actor. The scrip
 
 In order to be able to intercept the event, the protection script should be placed in the load order below the original script.
 
-See :ref:`the list of events <Built-in events>` that are used by built-in scripts.
+See :ref:`the list of events <Events>` that are used by built-in scripts.
 
 
 Timers
@@ -618,7 +618,7 @@ An example:
         }
     }
 
-Also in `openmw_aux`_ is the helper function ``runRepeatedly``, it is implemented on top of unsavable timers:
+Also in `Auxiliary packages`_ is the helper function ``runRepeatedly``, it is implemented on top of unsavable timers:
 
 .. code-block:: Lua
 
diff --git a/docs/source/reference/lua-scripting/setting_renderers.rst b/docs/source/reference/lua-scripting/setting_renderers.rst
index b85c7fbaab..f315615cb4 100644
--- a/docs/source/reference/lua-scripting/setting_renderers.rst
+++ b/docs/source/reference/lua-scripting/setting_renderers.rst
@@ -1,5 +1,5 @@
-Built-in Setting Renderers
-==========================
+Setting Renderers
+=================
 
 .. include:: version.rst
 
diff --git a/docs/source/reference/lua-scripting/tables/aux_packages.rst b/docs/source/reference/lua-scripting/tables/aux_packages.rst
index d0217ce202..d51949e1b2 100644
--- a/docs/source/reference/lua-scripting/tables/aux_packages.rst
+++ b/docs/source/reference/lua-scripting/tables/aux_packages.rst
@@ -1,12 +1,19 @@
-+---------------------------------------------------------+--------------------+---------------------------------------------------------------+
-| Built-in library                                        | Can be used        | Description                                                   |
-+=========================================================+====================+===============================================================+
-|:ref:`openmw_aux.calendar <Package openmw_aux.calendar>` | everywhere         | | Game time calendar                                          |
-+---------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw_aux.util <Package openmw_aux.util>`         | everywhere         | | Miscellaneous utils                                         |
-+---------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw_aux.time <Package openmw_aux.time>`         | everywhere         | | Timers and game time utils                                  |
-+---------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw_aux.ui <Package openmw_aux.ui>`             | by player and menu | | User interface utils                                        |
-|                                                         | scripts            |                                                               |
-+---------------------------------------------------------+--------------------+---------------------------------------------------------------+
+.. list-table::
+   :widths: 30 40 60
+   :header-rows: 1
+
+   * - Module
+     - Context
+     - Description
+   * - :doc:`calendar </reference/lua-scripting/openmw_aux_calendar>`
+     - |bdg-ctx-all|
+     - Game time calendar
+   * - :doc:`util </reference/lua-scripting/openmw_aux_util>`
+     - |bdg-ctx-all|
+     - Miscellaneous utils
+   * - :doc:`time </reference/lua-scripting/openmw_aux_time>`
+     - |bdg-ctx-all|
+     - Timers and game time utils
+   * - :doc:`ui </reference/lua-scripting/openmw_aux_ui>`
+     - |bdg-ctx-menu| |bdg-ctx-player|
+     - User interface utils
diff --git a/docs/source/reference/lua-scripting/tables/interfaces.rst b/docs/source/reference/lua-scripting/tables/interfaces.rst
index d8dfffe47d..bdf8104678 100644
--- a/docs/source/reference/lua-scripting/tables/interfaces.rst
+++ b/docs/source/reference/lua-scripting/tables/interfaces.rst
@@ -1,48 +1,43 @@
 .. list-table::
-  :widths: 20 20 60
+  :widths: 30 40 60
+  :header-rows: 1
 
   * - Interface
-    - Can be used
+    - Context
     - Description
-  * - :ref:`Activation <Interface Activation>`
-    - by global scripts
+  * - :doc:`Activation </reference/lua-scripting/interface_activation>`
+    - |bdg-ctx-global|
     - Allows to extend or override built-in activation mechanics.
-  * - :ref:`AI <Interface AI>`
-    - by local scripts
-    - Control basic AI of NPCs and creatures.
-  * - :ref:`AnimationController <Interface AnimationController>`
-    - by local scripts
-    - Control animations of NPCs and creatures.
-  * - :ref:`Camera <Interface Camera>`
-    - by player scripts
-    - | Allows to alter behavior of the built-in camera script
-      | without overriding the script completely.
-  * - :ref:`Controls <Interface Controls>`
-    - by player scripts
-    - | Allows to alter behavior of the built-in script
-      | that handles player controls.
-  * - :ref:`GamepadControls <Interface GamepadControls>`
-    - by player scripts
-    - | Allows to alter behavior of the built-in script
-      | that handles player gamepad controls.
-  * - :ref:`ItemUsage <Interface ItemUsage>`
-    - by global scripts
-    - | Allows to extend or override built-in item usage
-      | mechanics.
-  * - :ref:`SkillProgression <Interface SkillProgression>`
-    - by local scripts
-    - | Control, extend, and override skill progression of the 
-      | player.
-  * - :ref:`Settings <Interface Settings>`
-    - by player, menu, and global scripts
-    - Save, display and track changes of setting values.
-  * - :ref:`MWUI <Interface MWUI>`
-    - by player and menu scripts
-    - Morrowind-style UI templates.
-  * - :ref:`UI <Interface UI>`
-    - by player scripts
-    - | High-level UI modes interface. Allows to override parts
-      | of the interface.
-  * - :ref:`Crimes <Interface Crimes>`
-    - by global scripts
+  * - :doc:`ItemUsage </reference/lua-scripting/interface_item_usage>`
+    - |bdg-ctx-global|
+    - Allows to extend or override built-in item usage mechanics.
+  * - :doc:`Crimes </reference/lua-scripting/interface_crimes>`
+    - |bdg-ctx-global|
     - Commit crimes.
+  * - :doc:`AI </reference/lua-scripting/interface_ai>`
+    - |bdg-ctx-local|
+    - Control basic AI of NPCs and creatures.
+  * - :doc:`AnimationController </reference/lua-scripting/interface_animation>`
+    - |bdg-ctx-local|
+    - Control animations of NPCs and creatures.
+  * - :doc:`SkillProgression </reference/lua-scripting/interface_skill_progression>`
+    - |bdg-ctx-local|
+    - Control, extend, and override skill progression of the player.
+  * - :doc:`Camera </reference/lua-scripting/interface_camera>`
+    - |bdg-ctx-player|
+    - Allows to alter behavior of the built-in camera script without overriding the script completely.
+  * - :doc:`Controls </reference/lua-scripting/interface_controls>`
+    - |bdg-ctx-player|
+    - Allows to alter behavior of the built-in script that handles player controls.
+  * - :doc:`GamepadControls </reference/lua-scripting/interface_gamepadcontrols>`
+    - |bdg-ctx-player|
+    - Allows to alter behavior of the built-in script that handles player gamepad controls.
+  * - :doc:`UI </reference/lua-scripting/interface_ui>`
+    - |bdg-ctx-player|
+    - High-level UI modes interface. Allows to override parts of the interface.
+  * - :doc:`Settings </reference/lua-scripting/interface_settings>`
+    - |bdg-ctx-global| |bdg-ctx-menu| |bdg-ctx-player| 
+    - Save, display and track changes of setting values.
+  * - :doc:`MWUI </reference/lua-scripting/interface_mwui>`
+    - |bdg-ctx-menu| |bdg-ctx-player|
+    - Morrowind-style UI templates.
diff --git a/docs/source/reference/lua-scripting/tables/packages.rst b/docs/source/reference/lua-scripting/tables/packages.rst
index e66926e5e4..290b7d3507 100644
--- a/docs/source/reference/lua-scripting/tables/packages.rst
+++ b/docs/source/reference/lua-scripting/tables/packages.rst
@@ -1,49 +1,64 @@
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-| Package                                                    | Can be used        | Description                                                   |
-+============================================================+====================+===============================================================+
-|:ref:`openmw.ambient <Package openmw.ambient>`              | by player and menu | | Controls background sounds for given player.                |
-|                                                            | scripts            |                                                               |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.animation <Package openmw.animation>`          | by local and       | | Animation controls                                          |
-|                                                            | player scripts     |                                                               |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.async <Package openmw.async>`                  | everywhere         | | Timers and callbacks.                                       |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.camera <Package openmw.camera>`                | by player scripts  | | Controls camera.                                            |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.core <Package openmw.core>`                    | everywhere         | | Functions that are common for both global and local scripts |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.debug <Package openmw.debug>`                  | by player scripts  | | Collection of debug utils.                                  |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.input <Package openmw.input>`                  | by player and menu | | User input.                                                 |
-|                                                            | scripts            |                                                               |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.interfaces <Script interfaces>`                | everywhere         | | Public interfaces of other scripts.                         |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.markup <Package openmw.markup>`                | everywhere         | | API to work with markup languages.                          |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.menu <Package openmw.menu>`                    | by menu scripts    | | Main menu functionality, such as managing game saves        |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.nearby <Package openmw.nearby>`                | by local and       | | Read-only access to the nearest area of the game world.     |
-|                                                            | player scripts     |                                                               |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.postprocessing <Package openmw.postprocessing>`| by player scripts  | | Controls post-process shaders.                              |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.self <Package openmw.self>`                    | by local and       | | Full access to the object the script is attached to.        |
-|                                                            | player scripts     |                                                               |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.storage <Package openmw.storage>`              | everywhere         | | Storage API. In particular can be used to store data        |
-|                                                            |                    | | between game sessions.                                      |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.types <Package openmw.types>`                  | everywhere         | | Functions for specific types of game objects.               |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.ui <Package openmw.ui>`                        | by player and menu | | Controls :ref:`user interface <User interface reference>`.  |
-|                                                            | scripts            |                                                               |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.util <Package openmw.util>`                    | everywhere         | | Defines utility functions and classes like 3D vectors,      |
-|                                                            |                    | | that don't depend on the game world.                        |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.vfs <Package openmw.vfs>`                      | everywhere         | | Read-only access to data directories via VFS.               |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
-|:ref:`openmw.world <Package openmw.world>`                  | by global scripts  | | Read-write access to the game world.                        |
-+------------------------------------------------------------+--------------------+---------------------------------------------------------------+
+.. list-table::
+   :widths: 30 40 60
+   :header-rows: 1
+
+   * - Package
+     - Context
+     - Description
+   * - :doc:`core </reference/lua-scripting/openmw_core>`
+     - |bdg-ctx-all|
+     - Functions that are common for both global and local scripts
+   * - :doc:`async </reference/lua-scripting/openmw_async>`
+     - |bdg-ctx-all|
+     - Timers and callbacks.
+   * - :ref:`interfaces <Script interfaces>`
+     - |bdg-ctx-all|
+     - Public interfaces of other scripts.
+   * - :doc:`markup </reference/lua-scripting/openmw_markup>`
+     - |bdg-ctx-all|
+     - API to work with markup languages.
+   * - :doc:`storage </reference/lua-scripting/openmw_storage>`
+     - |bdg-ctx-all|
+     - Storage API. In particular can be used to store data between game sessions.
+   * - :doc:`types </reference/lua-scripting/openmw_types>`
+     - |bdg-ctx-all|
+     - Functions for specific types of game objects.
+   * - :doc:`util </reference/lua-scripting/openmw_util>`
+     - |bdg-ctx-all|
+     - Defines utility functions and classes like 3D vectors, that don't depend on the game world.
+   * - :doc:`vfs </reference/lua-scripting/openmw_vfs>`
+     - |bdg-ctx-all|
+     - Read-only access to data directories via VFS.
+   * - :doc:`world </reference/lua-scripting/openmw_world>`
+     - |bdg-ctx-global|
+     - Read-write access to the game world.
+   * - :doc:`menu </reference/lua-scripting/openmw_menu>`
+     - |bdg-ctx-menu|
+     - Main menu functionality, such as managing game saves
+   * - :doc:`animation </reference/lua-scripting/openmw_animation>`
+     - |bdg-ctx-local|
+     - Animation controls
+   * - :doc:`nearby </reference/lua-scripting/openmw_nearby>`
+     - |bdg-ctx-local|
+     - Read-only access to the nearest area of the game world.
+   * - :doc:`self </reference/lua-scripting/openmw_self>`
+     - |bdg-ctx-local|
+     - Full access to the object the script is attached to.
+   * - :doc:`camera </reference/lua-scripting/openmw_camera>`
+     - |bdg-ctx-player|
+     - Controls camera.
+   * - :doc:`debug </reference/lua-scripting/openmw_debug>`
+     - |bdg-ctx-player|
+     - Collection of debug utils.
+   * - :doc:`postprocessing </reference/lua-scripting/openmw_postprocessing>`
+     - |bdg-ctx-player|
+     - Controls post-process shaders.
+   * - :doc:`ambient </reference/lua-scripting/openmw_ambient>`
+     - |bdg-ctx-menu| |bdg-ctx-player|
+     - Controls background sounds for given player.
+   * - :doc:`input </reference/lua-scripting/openmw_input>`
+     - |bdg-ctx-menu| |bdg-ctx-player|
+     - User input.
+   * - :doc:`ui </reference/lua-scripting/openmw_ui>`
+     - |bdg-ctx-menu| |bdg-ctx-player|
+     - Controls :ref:`user interface <UI reference>`.
diff --git a/docs/source/reference/lua-scripting/user_interface.rst b/docs/source/reference/lua-scripting/user_interface.rst
index 9251538657..480aa82a93 100644
--- a/docs/source/reference/lua-scripting/user_interface.rst
+++ b/docs/source/reference/lua-scripting/user_interface.rst
@@ -1,5 +1,5 @@
-User interface reference
-========================
+UI reference
+============
 
 .. include:: version.rst
 
@@ -73,63 +73,65 @@ Events
    an event-specific value, and that widget's layout table.
 | See the Widget type pages for information on what events exist, and which first argument they pass. 
 
-Widget types
-------------
-
 .. toctree::
    :maxdepth: 1
+   :hidden:
 
-   Widget: Base widget type, all the other widgets inherit its properties and events. <widgets/widget>
-   Text: Displays text. <widgets/text>
-   TextEdit: Accepts text input from the user. <widgets/textedit>
-   Image: Renders a texture. <widgets/image>
-   Flex: Aligns children in a column/row <widgets/flex>
-   Container: Wraps around its children <widgets/container>
+   Widget <widgets/widget>
+   Text <widgets/text>
+   TextEdit <widgets/textedit>
+   Image <widgets/image>
+   Flex <widgets/flex>
+   Container <widgets/container>
 
 Example
 -------
 
-*scripts/clock.lua*
+.. tab-set::
 
-.. code-block:: Lua
+   .. tab-item:: scripts/clock.lua
 
-  local ui = require('openmw.ui')
-  local util = require('openmw.util')
-  local calendar = require('openmw_aux.calendar')
-  local time = require('openmw_aux.time')
+      .. code-block:: lua
 
-  local element = ui.create {
-    -- important not to forget the layer
-    -- by default widgets are not attached to any layer and are not visible
-    layer = 'HUD',
-    type = ui.TYPE.Text,
-    props = {
-      -- position in the top right corner
-      relativePosition = util.vector2(1, 0),
-      -- position is for the top left corner of the widget by default
-      -- change it to align exactly to the top right corner of the screen
-      anchor = util.vector2(1, 0),
-      text = calendar.formatGameTime('%H:%M'),
-      textSize = 24,
-      -- default black text color isn't always visible
-      textColor = util.color.rgb(0, 1, 0),
-    },
-  }
+         local ui = require('openmw.ui')
+         local util = require('openmw.util')
+         local calendar = require('openmw_aux.calendar')
+         local time = require('openmw_aux.time')
 
-  local function updateTime()
-    -- formatGameTime uses current time by default
-    -- otherwise we could get it by calling `core.getGameTime()`
-    element.layout.props.text = calendar.formatGameTime('%H:%M')
-    -- the layout changes won't affect the widget unless we request an update
-    element:update()
-  end
+         local element = ui.create {
+            -- important not to forget the layer
+            -- by default widgets are not attached to any layer and are not visible
+            layer = 'HUD',
+            type = ui.TYPE.Text,
+            props = {
+            -- position in the top right corner
+            relativePosition = util.vector2(1, 0),
+            -- position is for the top left corner of the widget by default
+            -- change it to align exactly to the top right corner of the screen
+            anchor = util.vector2(1, 0),
+            text = calendar.formatGameTime('%H:%M'),
+            textSize = 24,
+            -- default black text color isn't always visible
+            textColor = util.color.rgb(0, 1, 0),
+            },
+         }
 
-  -- we are showing game time in hours and minutes
-  -- so no need to update more often than once a game minute
-  time.runRepeatedly(updateTime, 1 * time.minute, { type = time.GameTime })
+         local function updateTime()
+            -- formatGameTime uses current time by default
+            -- otherwise we could get it by calling `core.getGameTime()`
+            element.layout.props.text = calendar.formatGameTime('%H:%M')
+            -- the layout changes won't affect the widget unless we request an update
+            element:update()
+         end
 
-*clock.omwscripts*
+         -- we are showing game time in hours and minutes
+         -- so no need to update more often than once a game minute
+         time.runRepeatedly(updateTime, 1 * time.minute, { type = time.GameTime })
 
-::
 
-  PLAYER: scripts/clock.lua
+   .. tab-item:: clock.omwscripts
+
+      .. code-block::
+
+         PLAYER: scripts/clock.lua
+
diff --git a/docs/source/reference/lua-scripting/version.rst b/docs/source/reference/lua-scripting/version.rst
index ad96ee456b..c835027334 100644
--- a/docs/source/reference/lua-scripting/version.rst
+++ b/docs/source/reference/lua-scripting/version.rst
@@ -1,2 +1 @@
-| `OpenMW version:` |version|
-| `core.API_REVISION:` |luaApiRevision| `* <openmw_core.html##(core).API_REVISION>`_
+| |luaApiRevisionBadge|
diff --git a/docs/source/reference/lua-scripting/widgets/container.rst b/docs/source/reference/lua-scripting/widgets/container.rst
index 6b15f25110..a990b55c6a 100644
--- a/docs/source/reference/lua-scripting/widgets/container.rst
+++ b/docs/source/reference/lua-scripting/widgets/container.rst
@@ -5,4 +5,47 @@ Wraps around its children. Convenient for creating border-type templates.
 
 Relative size and position don't work for children.
 
-For template children, relative size and position depend on the children's combined size.
\ No newline at end of file
+For template children, relative size and position depend on the children's combined size.
+
+Properties
+----------
+
+.. list-table::
+  :header-rows: 1
+  :widths: 20 20 60
+
+  * - name
+    - type (default value)
+    - description
+  * - position
+    - util.vector2 (0, 0)
+    - | Offsets the position of the widget from its parent's
+      | top-left corner in pixels.
+  * - size
+    - util.vector2 (0, 0)
+    - Increases the widget's size in pixels.
+  * - relativePosition  
+    - util.vector2 (0, 0)
+    - | Offsets the position of the widget from its parent's
+      | top-left corner as a fraction of the parent's size.
+  * - relativeSize
+    - util.vector2 (0, 0)
+    - Increases the widget's size by a fraction of its parent's size.
+  * - anchor
+    - util.vector2 (0, 0)
+    - | Offsets the widget's position by a fraction of its size.
+      | Useful for centering or aligning to a corner.
+  * - visible
+    - boolean (true)
+    - Defines if the widget is visible
+  * - propagateEvents
+    - boolean (true)
+    - Allows base widget events to propagate to the widget's parent.
+  * - alpha
+    - number (1.0)
+    - | Set the opacity of the widget and its contents.
+      | If `inheritAlpha` is set to `true`, this becomes the maximum alpha value the widget can take.
+  * - inheritAlpha
+    - boolean (true)
+    - | Modulate `alpha` with parents `alpha`.
+      | If the parent has `inheritAlpha` set to `true`, the value after modulating is passed to the child.
diff --git a/docs/source/reference/lua-scripting/widgets/image.rst b/docs/source/reference/lua-scripting/widgets/image.rst
index 49eaec79e0..df62251622 100644
--- a/docs/source/reference/lua-scripting/widgets/image.rst
+++ b/docs/source/reference/lua-scripting/widgets/image.rst
@@ -1,6 +1,8 @@
 Image Widget
 ============
 
+Renders a texture.
+
 Properties
 ----------
 
diff --git a/docs/source/reference/lua-scripting/widgets/text.rst b/docs/source/reference/lua-scripting/widgets/text.rst
index 2970724c74..b1e7d89e59 100644
--- a/docs/source/reference/lua-scripting/widgets/text.rst
+++ b/docs/source/reference/lua-scripting/widgets/text.rst
@@ -1,6 +1,8 @@
 Text Widget
 ===========
 
+Displays text.
+
 Properties
 ----------
 
diff --git a/docs/source/reference/lua-scripting/widgets/textedit.rst b/docs/source/reference/lua-scripting/widgets/textedit.rst
index 6cb18fc685..a06599ffd6 100644
--- a/docs/source/reference/lua-scripting/widgets/textedit.rst
+++ b/docs/source/reference/lua-scripting/widgets/textedit.rst
@@ -1,6 +1,8 @@
 TextEdit Widget
 ===============
 
+Accepts text input from the user.
+
 Properties
 ----------
 
diff --git a/docs/source/reference/lua-scripting/widgets/widget.rst b/docs/source/reference/lua-scripting/widgets/widget.rst
index 99596a6b9b..38470e766f 100644
--- a/docs/source/reference/lua-scripting/widgets/widget.rst
+++ b/docs/source/reference/lua-scripting/widgets/widget.rst
@@ -1,6 +1,8 @@
 Widget
 ======
 
+Base widget type, all the other widgets inherit its properties and events. 
+
 Properties
 ----------
 
diff --git a/docs/source/reference/modding/extended.rst b/docs/source/reference/modding/extended.rst
index 3243809949..001492f254 100644
--- a/docs/source/reference/modding/extended.rst
+++ b/docs/source/reference/modding/extended.rst
@@ -338,7 +338,7 @@ Also groundcover detection should be enabled via settings.cfg:
 Lua scripting
 -------------
 
-OpenMW supports Lua scripts. See :ref:`Lua scripting documentation <OpenMW Lua scripting>`.
+OpenMW supports Lua scripts. See :ref:`Lua scripting documentation <Lua scripting>`.
 It is not compatible with MWSE. A mod with Lua scripts will work only if it was developed specifically for OpenMW.
 
 Installation of a Lua mod is the same as of any other mod: add ``data=`` and ``content=`` entries to ``openmw.cfg``.
diff --git a/docs/source/reference/modding/index.rst b/docs/source/reference/modding/index.rst
index 4914a52be7..e2e9f84ac6 100644
--- a/docs/source/reference/modding/index.rst
+++ b/docs/source/reference/modding/index.rst
@@ -1,5 +1,5 @@
-OpenMW Modding Reference
-########################
+Modding Reference
+#################
 
 The following document is the complete reference guide to modifying, or
 modding, your OpenMW setup. It does not cover content creation itself,
diff --git a/docs/source/reference/modding/texture-modding/index.rst b/docs/source/reference/modding/texture-modding/index.rst
index aa2802af5d..a81f8ff7bd 100644
--- a/docs/source/reference/modding/texture-modding/index.rst
+++ b/docs/source/reference/modding/texture-modding/index.rst
@@ -1,6 +1,6 @@
-######################
-OpenMW Texture Modding
-######################
+###############
+Texture Modding
+###############
 
 Although texture modding requires external tools not supported by the OpenMW team,
 adding and modifying textures is an important part of content creation.
diff --git a/docs/source/reference/postprocessing/index.rst b/docs/source/reference/postprocessing/index.rst
index 061d76f37d..36fe871cff 100644
--- a/docs/source/reference/postprocessing/index.rst
+++ b/docs/source/reference/postprocessing/index.rst
@@ -1,6 +1,6 @@
-######################
-OpenMW Post Processing
-######################
+###############
+Post Processing
+###############
 
 .. toctree::
     :caption: Table of Contents
diff --git a/files/data/scripts/omw/ai.lua b/files/data/scripts/omw/ai.lua
index 16a420cca1..d2b248f761 100644
--- a/files/data/scripts/omw/ai.lua
+++ b/files/data/scripts/omw/ai.lua
@@ -87,7 +87,7 @@ return {
 
         --- Start new AI package.
         -- @function [parent=#AI] startPackage
-        -- @param #table options See the "Built-in AI packages" page.
+        -- @param #table options See the "AI packages" page.
         startPackage = startPackage,
 
         --- Iterate over all packages starting from the active one and remove those where `filterCallback` returns false.
diff --git a/files/data/scripts/omw/settings/player.lua b/files/data/scripts/omw/settings/player.lua
index 4ec61a73c7..0ae607df0b 100644
--- a/files/data/scripts/omw/settings/player.lua
+++ b/files/data/scripts/omw/settings/player.lua
@@ -33,7 +33,7 @@ end
 -- @field #string name A key from the localization context
 -- @field #string description A key from the localization context (optional, can be `nil`)
 -- @field default A default value
--- @field #string renderer A renderer key (see the "Built-in Setting Renderers" page)
+-- @field #string renderer A renderer key (see the "Setting Renderers" page)
 -- @field argument An argument for the renderer
 
 return {
diff --git a/files/lua_api/openmw/ambient.lua b/files/lua_api/openmw/ambient.lua
index 82d4dfdeee..436f10de1a 100644
--- a/files/lua_api/openmw/ambient.lua
+++ b/files/lua_api/openmw/ambient.lua
@@ -1,6 +1,6 @@
 ---
--- `openmw.ambient` controls background 2D sounds specific to a given player.
--- Can be used only by menu scripts and local scripts that are attached to a player.
+-- Controls background 2D sounds specific to a given player.
+-- @context menu|player
 -- @module ambient
 -- @usage local ambient = require('openmw.ambient')
 
diff --git a/files/lua_api/openmw/animation.lua b/files/lua_api/openmw/animation.lua
index cde046b443..847ba9bd78 100644
--- a/files/lua_api/openmw/animation.lua
+++ b/files/lua_api/openmw/animation.lua
@@ -1,7 +1,8 @@
 ---
--- `openmw.animation` defines functions that allow control of character animations.
+-- Defines functions that allow control of character animations.
 -- Note that for some methods, such as @{openmw.animation#playBlended} you should use the associated methods on the 
 -- [AnimationController](interface_animation.html) interface rather than invoking this API directly.
+-- @context local
 -- @module animation
 -- @usage local anim = require('openmw.animation')
 
diff --git a/files/lua_api/openmw/async.lua b/files/lua_api/openmw/async.lua
index 7a410336c0..c32c748f15 100644
--- a/files/lua_api/openmw/async.lua
+++ b/files/lua_api/openmw/async.lua
@@ -1,6 +1,7 @@
 ---
--- `openmw.async` contains timers and coroutine utilities. All functions require
+-- Contains timers and coroutine utilities. All functions require
 -- the package itself as a first argument.
+-- @context global|menu|local|player
 -- @module async
 -- @usage local async = require('openmw.async')
 
diff --git a/files/lua_api/openmw/camera.lua b/files/lua_api/openmw/camera.lua
index abe66e2d8c..b6b605fc10 100644
--- a/files/lua_api/openmw/camera.lua
+++ b/files/lua_api/openmw/camera.lua
@@ -1,6 +1,6 @@
 ---
--- `openmw.camera` controls camera.
--- Can be used only by player scripts.
+-- Controls camera.
+-- @context player
 -- @module camera
 -- @usage local camera = require('openmw.camera')
 
diff --git a/files/lua_api/openmw/core.lua b/files/lua_api/openmw/core.lua
index 8a78a52441..9c9d8dcd3a 100644
--- a/files/lua_api/openmw/core.lua
+++ b/files/lua_api/openmw/core.lua
@@ -1,6 +1,6 @@
 ---
--- `openmw.core` defines functions and types that are available in local,
--- global and menu scripts.
+-- Defines functions and types that are available in local, global and menu scripts.
+-- @context global|menu|local|player
 -- @module core
 -- @usage local core = require('openmw.core')
 
diff --git a/files/lua_api/openmw/debug.lua b/files/lua_api/openmw/debug.lua
index bde7071d1c..1919570a82 100644
--- a/files/lua_api/openmw/debug.lua
+++ b/files/lua_api/openmw/debug.lua
@@ -1,6 +1,6 @@
 ---
--- `openmw.debug` is an interface to the engine debug utils.
--- Can be used only by local scripts, that are attached to a player.
+-- Provides an interface to the engine debug utils.
+-- @context player
 -- @module Debug
 -- @usage local debug = require('openmw.debug')
 
diff --git a/files/lua_api/openmw/input.lua b/files/lua_api/openmw/input.lua
index b8e5e51261..0a8b04b9b2 100644
--- a/files/lua_api/openmw/input.lua
+++ b/files/lua_api/openmw/input.lua
@@ -1,9 +1,9 @@
 ---
--- `openmw.input` can be used only in menu scripts and scripts attached to a player.
 -- Most mods should prefer to use the actions/triggers API over the direct input device methods.
 -- Actions have one value on each frame (resolved just before the `onFrame` engine handler),
 --  while Triggers don't have a value, but can occur multiple times on each frame.
 -- Prefer to use built-in methods of binding actions, such as the [inputBinding setting renderer](setting_renderers.html#inputbinding)
+-- @context menu|player
 -- @module input
 -- @usage local input = require('openmw.input')
 -- -- Example of Action usage
diff --git a/files/lua_api/openmw/interfaces.lua b/files/lua_api/openmw/interfaces.lua
index 6f6e86be1e..82db412623 100644
--- a/files/lua_api/openmw/interfaces.lua
+++ b/files/lua_api/openmw/interfaces.lua
@@ -1,4 +1,5 @@
 ---
+-- @context global|menu|local|player
 -- @module interfaces
 -- @usage local I = require('openmw.interfaces')
 
diff --git a/files/lua_api/openmw/markup.lua b/files/lua_api/openmw/markup.lua
index c8776281d3..052e875caf 100644
--- a/files/lua_api/openmw/markup.lua
+++ b/files/lua_api/openmw/markup.lua
@@ -1,5 +1,6 @@
 ---
--- `openmw.markup` allows to work with markup languages.
+-- Allows to work with markup languages.
+-- @context global|menu|local|player
 -- @module markup
 -- @usage local markup = require('openmw.markup')
 
diff --git a/files/lua_api/openmw/menu.lua b/files/lua_api/openmw/menu.lua
index 85ca28bb32..9d7eb32205 100644
--- a/files/lua_api/openmw/menu.lua
+++ b/files/lua_api/openmw/menu.lua
@@ -1,5 +1,6 @@
 ---
--- `openmw.menu` can be used only in menu scripts.
+-- Provides interfaces to interact with menu elements.
+-- @context menu
 -- @module menu
 -- @usage local menu = require('openmw.menu')
 
diff --git a/files/lua_api/openmw/nearby.lua b/files/lua_api/openmw/nearby.lua
index f2a3dbbc37..29f1e79c24 100644
--- a/files/lua_api/openmw/nearby.lua
+++ b/files/lua_api/openmw/nearby.lua
@@ -1,6 +1,6 @@
 ---
--- `openmw.nearby` provides read-only access to the nearest area of the game world.
--- Can be used only from local scripts.
+-- Provides read-only access to the nearest area of the game world.
+-- @context local
 -- @module nearby
 -- @usage local nearby = require('openmw.nearby')
 
diff --git a/files/lua_api/openmw/postprocessing.lua b/files/lua_api/openmw/postprocessing.lua
index 18e2edd376..ca28975be5 100644
--- a/files/lua_api/openmw/postprocessing.lua
+++ b/files/lua_api/openmw/postprocessing.lua
@@ -1,6 +1,6 @@
 ---
--- `openmw.postprocessing` is an interface to postprocessing shaders.
--- Can be used only by local scripts, that are attached to a player.
+-- Provides an interface to postprocessing shaders.
+-- @context player
 -- @module postprocessing
 -- @usage local postprocessing = require('openmw.postprocessing')
 
diff --git a/files/lua_api/openmw/self.lua b/files/lua_api/openmw/self.lua
index 3a45bd68d8..c72f0cac5b 100644
--- a/files/lua_api/openmw/self.lua
+++ b/files/lua_api/openmw/self.lua
@@ -1,6 +1,7 @@
 ---
--- `openmw.self` provides full access to the object the script is attached to.
--- Can be used only from local scripts. All fields and function of `GameObject` are also available for `openmw.self`.
+-- Provides full access to the object the script is attached to.
+-- All fields and function of `GameObject` are also available for `openmw.self`.
+-- @context local
 -- @module Self
 -- @extends openmw.core#GameObject
 -- @usage local self = require('openmw.self')
diff --git a/files/lua_api/openmw/storage.lua b/files/lua_api/openmw/storage.lua
index 575b0f83d9..f80c55e6e3 100644
--- a/files/lua_api/openmw/storage.lua
+++ b/files/lua_api/openmw/storage.lua
@@ -1,5 +1,6 @@
 ---
--- `openmw.storage` contains functions to work with permanent Lua storage.
+-- Contains functions to work with permanent Lua storage.
+-- @context global|menu|local|player
 -- @module storage
 -- @usage
 -- local storage = require('openmw.storage')
diff --git a/files/lua_api/openmw/types.lua b/files/lua_api/openmw/types.lua
index 5aef5fac94..cab7c74c9e 100644
--- a/files/lua_api/openmw/types.lua
+++ b/files/lua_api/openmw/types.lua
@@ -1,5 +1,6 @@
 ---
--- `openmw.types` defines functions for specific types of game objects.
+-- Defines functions for specific types of game objects.
+-- @context global|menu|local|player
 -- @module types
 -- @usage local types = require('openmw.types')
 
diff --git a/files/lua_api/openmw/ui.lua b/files/lua_api/openmw/ui.lua
index c2587db821..598fbacca4 100644
--- a/files/lua_api/openmw/ui.lua
+++ b/files/lua_api/openmw/ui.lua
@@ -1,6 +1,6 @@
 ---
--- `openmw.ui` controls user interface.
--- Can be used only by menu scripts and local scripts, that are attached to a player.
+-- Controls user interface.
+-- @context menu|player
 -- @module ui
 -- @usage
 -- local ui = require('openmw.ui')
diff --git a/files/lua_api/openmw/util.lua b/files/lua_api/openmw/util.lua
index 9c6fd7985e..0ba1fe2a8e 100644
--- a/files/lua_api/openmw/util.lua
+++ b/files/lua_api/openmw/util.lua
@@ -1,5 +1,6 @@
 ---
--- `openmw.util` defines utility functions and classes like 3D vectors, that don't depend on the game world.
+-- Defines utility functions and classes like 3D vectors, that don't depend on the game world.
+-- @context global|menu|local|player
 -- @module util
 -- @usage local util = require('openmw.util')
 
diff --git a/files/lua_api/openmw/vfs.lua b/files/lua_api/openmw/vfs.lua
index ba381a1249..ca20eaa240 100644
--- a/files/lua_api/openmw/vfs.lua
+++ b/files/lua_api/openmw/vfs.lua
@@ -1,6 +1,7 @@
 ---
--- `openmw.vfs` provides read-only access to data directories via VFS.
+-- Provides read-only access to data directories via VFS.
 -- Interface is very similar to "io" library.
+-- @context global|menu|local|player
 -- @module vfs
 -- @usage local vfs = require('openmw.vfs')
 
diff --git a/files/lua_api/openmw/world.lua b/files/lua_api/openmw/world.lua
index b72120a8e5..c459fafca4 100644
--- a/files/lua_api/openmw/world.lua
+++ b/files/lua_api/openmw/world.lua
@@ -1,6 +1,6 @@
 ---
--- `openmw.world` is an interface to the game world for global scripts.
--- Can not be used from local scripts.
+-- Provides an interface to the game world for global scripts.
+-- @context global
 -- @module world
 -- @usage local world = require('openmw.world')
 

From 8d7bdc2e61344b2289d32627e97f65d70461fdc8 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Mon, 16 Jun 2025 15:39:49 -0700
Subject: [PATCH 02/44] docs - remove unused sphinx theme from requirements.txt

---
 docs/requirements.txt | 1 -
 1 file changed, 1 deletion(-)

diff --git a/docs/requirements.txt b/docs/requirements.txt
index 0e02883062..2b26b0866b 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -2,7 +2,6 @@ parse_cmake
 sphinx==7.1.2
 docutils==0.18.1
 jinja2==3.1.6
-sphinx_rtd_theme==3.0.1
 sphinx-design==0.6.1
 furo==2024.8.6
 sphinx-copybutton==0.5.2
\ No newline at end of file

From 49865b1aa1c30587a29b1d8e9ab389ad687d50aa Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Mon, 16 Jun 2025 15:55:59 -0700
Subject: [PATCH 03/44] docs - fix package version and logo

---
 docs/requirements.txt | 2 +-
 docs/source/conf.py   | 4 ++--
 2 files changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/requirements.txt b/docs/requirements.txt
index 2b26b0866b..d57ac5d781 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -2,6 +2,6 @@ parse_cmake
 sphinx==7.1.2
 docutils==0.18.1
 jinja2==3.1.6
-sphinx-design==0.6.1
+sphinx-design==0.5.0
 furo==2024.8.6
 sphinx-copybutton==0.5.2
\ No newline at end of file
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 38c1b01033..30816bb1dd 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -176,14 +176,14 @@ def setup(app):
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
-html_title = 'OpenMW'
+html_title = 'OpenMW Docs'
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
 # html_short_title = 'OpenMW Documentation'
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-html_logo = 'https://gitlab.com/OpenMW/openmw-docs/raw/master/docs/source/_static/images/openmw.png'
+# html_logo = 'https://gitlab.com/OpenMW/openmw-docs/raw/master/docs/source/_static/images/openmw.png'
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32

From 522a57203227822b797ad47dd77f47403df8947e Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Mon, 16 Jun 2025 16:05:43 -0700
Subject: [PATCH 04/44] docs - clean up styling for dark mode

---
 docs/source/_static/luadoc.css | 127 ++-------------------------------
 1 file changed, 5 insertions(+), 122 deletions(-)

diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index 8a2e01c082..6050fc8d4c 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -1,148 +1,31 @@
-#luadoc tt { font-family: monospace; }
-
-/* #luadoc p,
-#luadoc td,
-#luadoc th { font-size: .95em; line-height: 1.2em;}
-
-#luadoc ul
-{ margin: 10px 0 0 10px;}
-
-#luadoc strong { font-weight: bold;}
-
-#luadoc em { font-style: italic;}
-
-#luadoc h1 {
-    font-size: 1.5em;
-    margin: 25px 0 20px 0;
+#luadoc code, #luadoc tt {
+    font-family: monospace;
 }
-#luadoc h2,
-#luadoc h3,
-#luadoc h4 { margin: 15px 0 10px 0; }
-#luadoc h2 { font-size: 1.25em; }
-#luadoc h3 { font-size: 1.15em; }
-#luadoc h4 { font-size: 1.06em; }
-
-#luadoc hr {
-    color:#cccccc;
-    background: #00007f;
-    height: 1px;
-}
-
-#luadoc blockquote { margin-left: 3em; }
-
-#luadoc ul { list-style-type: disc; }
-
-#luadoc p.name {
-    font-family: "Andale Mono", monospace;
-    padding-top: 1em;
-}
-
-#luadoc p:first-child {
-    margin-top: 0px;
-}
-
-#luadoc table.function_list {
-    border-width: 1px;
-    border-style: solid;
-    border-color: #cccccc;
-    border-collapse: collapse;
-}
-#luadoc table.function_list td {
-    border-width: 1px;
-    padding: 3px;
-    border-style: solid;
-    border-color: #cccccc;
-}
-
-#luadoc table.function_list td.name { background-color: #f0f0f0; }
-#luadoc table.function_list td.summary { width: 100%; }
-
-#luadoc dl.table dt,
-#luadoc dl.function dt {border-top: 1px solid #ccc; padding-top: 1em;}
-#luadoc dl.table dd,
-#luadoc dl.function dd {padding-bottom: 1em; margin: 10px 0 0 20px;}
-#luadoc dl.table h3,
-#luadoc dl.function h3 {font-size: .95em;}
-
-
 
 #luadoc pre.example {
     background-color: #eeffcc;
-    border: 1px solid #e1e4e5;
     padding: 10px;
     margin: 10px 0 10px 0;
     overflow-x: auto;
 }
 
-#luadoc code {
-    background-color: inherit;
-    color: inherit;
-    border: none;
-    font-family: monospace;
-}
-
 #luadoc pre.example code {
-    color: #404040;
+    color: black;
     background-color: #eeffcc;
     border: none;
     white-space: pre;
     padding: 0px;
 }
 
-#luadoc dt {
-    background: inherit;
-    color: inherit;
-    width: 100%;
-    padding: 0px;
-}
-
-#luadoc a:not(:link) {
-    font-weight: bold;
-    color: #000;
-    text-decoration: none;
-    cursor: inherit;
-}
-#luadoc a:link { font-weight: bold; color: #004080; text-decoration: none; }
-#luadoc a:visited { font-weight: bold; color: #006699; text-decoration: none; }
-#luadoc a:link:hover { text-decoration: underline; }
-
-#luadoc dl,
-#luadoc dd {margin: 0px; line-height: 1.2em;}
-#luadoc li {list-style: bullet;} */
-
-#luadoc pre.example {
-    background-color: #eeffcc;
-    border: 1px solid #e1e4e5;
-    padding: 10px;
-    margin: 10px 0 10px 0;
-    overflow-x: auto;
-}
-
-
-#luadoc pre.example code {
-    color: var(--color-content-foreground);
-    background-color: #eeffcc;
-    border: none;
-    white-space: pre;
-    padding: 0px;
-}
-
-#luadoc code {
-    /* background-color: inherit;
-    color: inherit;
-    border: none; */
-    font-family: monospace;
-}
 
+/* EXAMPLE: this should serve as a template on how to conditonally apply styles for dark themes
 body[data-theme="dark"] #luadoc pre.example {
-    background-color: #eeffcc;
 }
 
 @media (prefers-color-scheme: dark) {
     body:not([data-theme="light"]) #luadoc pre.example {
-        background-color: #eeffcc;
     }
-}
+} */
 
 #luadoc a:not(:link) {
     font-weight: bold;

From 132ff5294ccb5429b330fa052b875b6d39917537 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Mon, 16 Jun 2025 16:19:20 -0700
Subject: [PATCH 05/44] docs - bump documentor commit

---
 docs/source/install_luadocumentor_in_docker.sh | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/source/install_luadocumentor_in_docker.sh b/docs/source/install_luadocumentor_in_docker.sh
index 5d37a37351..7eb22103db 100755
--- a/docs/source/install_luadocumentor_in_docker.sh
+++ b/docs/source/install_luadocumentor_in_docker.sh
@@ -33,7 +33,7 @@ PATH=$PATH:~/luarocks/bin
 echo "Install openmwluadocumentor"
 git clone https://gitlab.com/ptmikheev/openmw-luadocumentor.git
 cd openmw-luadocumentor
-git checkout 78577b255d19a1f4f4f539662e00357936b73c33
+git checkout c3252620eb5f6cd740dadfcb374a20b23b36f1fd
 luarocks make luarocks/openmwluadocumentor-0.2.0-1.rockspec
 cd ~
 rm -r openmw-luadocumentor

From 21cf7bb397c2d0f8a89894ea6045c66ecf78f8ca Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Mon, 16 Jun 2025 16:32:51 -0700
Subject: [PATCH 06/44] docs - add context tags to interfaces and aux packages

---
 files/data/openmw_aux/calendar.lua                       | 1 +
 files/data/openmw_aux/time.lua                           | 1 +
 files/data/openmw_aux/ui.lua                             | 1 +
 files/data/openmw_aux/util.lua                           | 1 +
 files/data/scripts/omw/activationhandlers.lua            | 1 +
 files/data/scripts/omw/ai.lua                            | 1 +
 files/data/scripts/omw/camera/camera.lua                 | 1 +
 files/data/scripts/omw/crimes.lua                        | 1 +
 files/data/scripts/omw/input/gamepadcontrols.lua         | 1 +
 files/data/scripts/omw/input/playercontrols.lua          | 1 +
 files/data/scripts/omw/mechanics/animationcontroller.lua | 1 +
 files/data/scripts/omw/mwui/init.lua                     | 1 +
 files/data/scripts/omw/settings/player.lua               | 1 +
 files/data/scripts/omw/skillhandlers.lua                 | 1 +
 files/data/scripts/omw/ui.lua                            | 1 +
 files/data/scripts/omw/usehandlers.lua                   | 1 +
 16 files changed, 16 insertions(+)

diff --git a/files/data/openmw_aux/calendar.lua b/files/data/openmw_aux/calendar.lua
index 7dba60dbeb..2ba7a47f27 100644
--- a/files/data/openmw_aux/calendar.lua
+++ b/files/data/openmw_aux/calendar.lua
@@ -2,6 +2,7 @@
 -- `openmw_aux.calendar` defines utility functions for formatting game time.
 -- Implementation can be found in `resources/vfs/openmw_aux/calendar.lua`.
 -- @module calendar
+-- @context global|menu|local
 -- @usage local calendar = require('openmw_aux.calendar')
 
 local core = require('openmw.core')
diff --git a/files/data/openmw_aux/time.lua b/files/data/openmw_aux/time.lua
index 1c543c53b8..d7f18b2795 100644
--- a/files/data/openmw_aux/time.lua
+++ b/files/data/openmw_aux/time.lua
@@ -2,6 +2,7 @@
 -- `openmw_aux.time` defines utility functions for timers.
 -- Implementation can be found in `resources/vfs/openmw_aux/time.lua`.
 -- @module time
+-- @context global|menu|local
 -- @usage local time = require('openmw_aux.time')
 
 local time = {
diff --git a/files/data/openmw_aux/ui.lua b/files/data/openmw_aux/ui.lua
index cadae2a033..2c1a138d11 100644
--- a/files/data/openmw_aux/ui.lua
+++ b/files/data/openmw_aux/ui.lua
@@ -4,6 +4,7 @@ local ui = require('openmw.ui')
 -- `openmw_aux.ui` defines utility functions for UI.
 -- Implementation can be found in `resources/vfs/openmw_aux/ui.lua`.
 -- @module ui
+-- @context menu|player
 -- @usage local auxUi = require('openmw_aux.ui')
 local aux_ui = {}
 
diff --git a/files/data/openmw_aux/util.lua b/files/data/openmw_aux/util.lua
index b360383066..ca4fe7ed31 100644
--- a/files/data/openmw_aux/util.lua
+++ b/files/data/openmw_aux/util.lua
@@ -2,6 +2,7 @@
 -- `openmw_aux.util` defines utility functions that are implemented in Lua rather than in C++.
 -- Implementation can be found in `resources/vfs/openmw_aux/util.lua`.
 -- @module util
+-- @context global|menu|local
 -- @usage local aux_util = require('openmw_aux.util')
 
 local aux_util = {}
diff --git a/files/data/scripts/omw/activationhandlers.lua b/files/data/scripts/omw/activationhandlers.lua
index a70696824f..419ffe6809 100644
--- a/files/data/scripts/omw/activationhandlers.lua
+++ b/files/data/scripts/omw/activationhandlers.lua
@@ -60,6 +60,7 @@ return {
     interfaceName = 'Activation',
     ---
     -- @module Activation
+    -- @context global
     -- @usage require('openmw.interfaces').Activation
     interface = {
         --- Interface version
diff --git a/files/data/scripts/omw/ai.lua b/files/data/scripts/omw/ai.lua
index d2b248f761..e44958c725 100644
--- a/files/data/scripts/omw/ai.lua
+++ b/files/data/scripts/omw/ai.lua
@@ -58,6 +58,7 @@ return {
     interfaceName = 'AI',
     --- Basic AI interface
     -- @module AI
+    -- @context local
     -- @usage require('openmw.interfaces').AI
     interface = {
         --- Interface version
diff --git a/files/data/scripts/omw/camera/camera.lua b/files/data/scripts/omw/camera/camera.lua
index 5cd04239f7..6730e0c069 100644
--- a/files/data/scripts/omw/camera/camera.lua
+++ b/files/data/scripts/omw/camera/camera.lua
@@ -239,6 +239,7 @@ return {
     interfaceName = 'Camera',
     ---
     -- @module Camera
+    -- @context player
     -- @usage require('openmw.interfaces').Camera
     interface = {
         --- Interface version is 1
diff --git a/files/data/scripts/omw/crimes.lua b/files/data/scripts/omw/crimes.lua
index 8539471973..ae6612b34f 100644
--- a/files/data/scripts/omw/crimes.lua
+++ b/files/data/scripts/omw/crimes.lua
@@ -20,6 +20,7 @@ return {
     ---
     -- Allows to utilize built-in crime mechanics.
     -- @module Crimes
+    -- @context global
     -- @usage require('openmw.interfaces').Crimes
     interface = {
         --- Interface version
diff --git a/files/data/scripts/omw/input/gamepadcontrols.lua b/files/data/scripts/omw/input/gamepadcontrols.lua
index 1f944fc708..9b89d505b5 100644
--- a/files/data/scripts/omw/input/gamepadcontrols.lua
+++ b/files/data/scripts/omw/input/gamepadcontrols.lua
@@ -6,6 +6,7 @@ return {
     ---
     -- Gamepad control interface
     -- @module GamepadControls
+    -- @context player
     -- @usage require('openmw.interfaces').GamepadControls
     interface = {
         --- Interface version
diff --git a/files/data/scripts/omw/input/playercontrols.lua b/files/data/scripts/omw/input/playercontrols.lua
index 244b952a1a..862fa33452 100644
--- a/files/data/scripts/omw/input/playercontrols.lua
+++ b/files/data/scripts/omw/input/playercontrols.lua
@@ -250,6 +250,7 @@ return {
     interfaceName = 'Controls',
     ---
     -- @module Controls
+    -- @context player
     -- @usage require('openmw.interfaces').Controls
     interface = {
         --- Interface version
diff --git a/files/data/scripts/omw/mechanics/animationcontroller.lua b/files/data/scripts/omw/mechanics/animationcontroller.lua
index c7a9182a8e..91cb60d177 100644
--- a/files/data/scripts/omw/mechanics/animationcontroller.lua
+++ b/files/data/scripts/omw/mechanics/animationcontroller.lua
@@ -60,6 +60,7 @@ return {
     --- 
     -- Animation controller interface
     -- @module AnimationController
+    -- @context local
     -- @usage local anim = require('openmw.animation')
     -- local I = require('openmw.interfaces')
     --
diff --git a/files/data/scripts/omw/mwui/init.lua b/files/data/scripts/omw/mwui/init.lua
index 5ab2d3cb23..253260d063 100644
--- a/files/data/scripts/omw/mwui/init.lua
+++ b/files/data/scripts/omw/mwui/init.lua
@@ -46,6 +46,7 @@ local templatesMeta = {
 
 ---
 -- @module MWUI
+-- @context menu|player
 -- @usage require('openmw.interfaces').MWUI
 local function TemplateOverrides(templates)
     return setmetatable({
diff --git a/files/data/scripts/omw/settings/player.lua b/files/data/scripts/omw/settings/player.lua
index 0ae607df0b..552a50043a 100644
--- a/files/data/scripts/omw/settings/player.lua
+++ b/files/data/scripts/omw/settings/player.lua
@@ -40,6 +40,7 @@ return {
     interfaceName = 'Settings',
     ---
     -- @module Settings
+    -- @context global|menu|player
     -- @usage
     -- -- In a player script
     -- local storage = require('openmw.storage')
diff --git a/files/data/scripts/omw/skillhandlers.lua b/files/data/scripts/omw/skillhandlers.lua
index 26fff6e799..d3a224dc46 100644
--- a/files/data/scripts/omw/skillhandlers.lua
+++ b/files/data/scripts/omw/skillhandlers.lua
@@ -153,6 +153,7 @@ return {
     ---
     -- Allows to extend or override built-in skill progression mechanics.
     -- @module SkillProgression
+    -- @context local
     -- @usage local I = require('openmw.interfaces')
     --
     -- -- Forbid increasing destruction skill past 50
diff --git a/files/data/scripts/omw/ui.lua b/files/data/scripts/omw/ui.lua
index 1e76b8e141..e29bbe254e 100644
--- a/files/data/scripts/omw/ui.lua
+++ b/files/data/scripts/omw/ui.lua
@@ -159,6 +159,7 @@ return {
     interfaceName = 'UI',
     ---
     -- @module UI
+    -- @context player
     -- @usage require('openmw.interfaces').UI
     interface = {
         --- Interface version
diff --git a/files/data/scripts/omw/usehandlers.lua b/files/data/scripts/omw/usehandlers.lua
index 563e31b3b7..cf976994be 100644
--- a/files/data/scripts/omw/usehandlers.lua
+++ b/files/data/scripts/omw/usehandlers.lua
@@ -36,6 +36,7 @@ return {
     -- * can't intercept actions performed by the AI (i.e. drinking a potion in combat);
     -- * can't intercept actions performed via quick keys menu.
     -- @module ItemUsage
+    -- @context global
     -- @usage local I = require('openmw.interfaces')
     --
     -- -- Override Use action (global script).

From f9af61f09643ef8cfc8348d44550feb631605b46 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Mon, 16 Jun 2025 16:35:24 -0700
Subject: [PATCH 07/44] docs - use shortened context for player

---
 docs/source/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index 30816bb1dd..5f5b772abe 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -98,7 +98,7 @@ rst_prolog = f"""
 .. |ppApiRevision| replace:: {ppApiRevision}
 .. |bdg-ctx-menu| replace:: :bdg-warning:`menu`
 .. |bdg-ctx-global| replace:: :bdg-danger:`global`
-.. |bdg-ctx-player| replace:: :bdg-secondary:`local:player`
+.. |bdg-ctx-player| replace:: :bdg-secondary:`player`
 .. |bdg-ctx-local| replace:: :bdg-info:`local`
 .. |bdg-ctx-all| replace:: :bdg-danger:`global` :bdg-warning:`menu` :bdg-info:`local`
 """

From 1de86f95ac928ba97b36b2f0e9c102bb45a4bbf8 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Mon, 16 Jun 2025 16:41:37 -0700
Subject: [PATCH 08/44] docs - slightly less ugly dark mode code blocks

---
 docs/source/_static/luadoc.css | 18 +++++++++++-------
 1 file changed, 11 insertions(+), 7 deletions(-)

diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index 6050fc8d4c..44e2557d7e 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -17,15 +17,19 @@
     padding: 0px;
 }
 
-
-/* EXAMPLE: this should serve as a template on how to conditonally apply styles for dark themes
-body[data-theme="dark"] #luadoc pre.example {
+@media (prefers-color-scheme: dark) {
+  body:not([data-theme="light"]) #luadoc pre.example,
+  body:not([data-theme="light"]) #luadoc pre.example code {
+    background-color: #2a3a49;
+    color: #ffffff;
+  }
 }
 
-@media (prefers-color-scheme: dark) {
-    body:not([data-theme="light"]) #luadoc pre.example {
-    }
-} */
+body[data-theme="dark"] #luadoc pre.example,
+body[data-theme="dark"] #luadoc pre.example code {
+  background-color: #2a3a49;
+  color: #ffffff;
+}
 
 #luadoc a:not(:link) {
     font-weight: bold;

From 30b27c966f369ceb8889476869b5e20641cc97a3 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 08:44:15 -0700
Subject: [PATCH 09/44] docs - switch to awesome sphinx theme

---
 docs/requirements.txt                  |  5 ++---
 docs/source/_static/theme-override.css | 17 ++++++++++++++++
 docs/source/_static/theme.css          | 11 ----------
 docs/source/conf.py                    | 28 ++++++++++++++++----------
 docs/source/index.rst                  |  2 +-
 5 files changed, 37 insertions(+), 26 deletions(-)
 create mode 100644 docs/source/_static/theme-override.css
 delete mode 100644 docs/source/_static/theme.css

diff --git a/docs/requirements.txt b/docs/requirements.txt
index d57ac5d781..7847723e88 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,7 +1,6 @@
 parse_cmake
-sphinx==7.1.2
+sphinx==8.2.3
 docutils==0.18.1
 jinja2==3.1.6
 sphinx-design==0.5.0
-furo==2024.8.6
-sphinx-copybutton==0.5.2
\ No newline at end of file
+sphinxawesome-theme==6.0.0b2
\ No newline at end of file
diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
new file mode 100644
index 0000000000..edd184c431
--- /dev/null
+++ b/docs/source/_static/theme-override.css
@@ -0,0 +1,17 @@
+#content a.sd-badge:not(.toc-backref)  {
+    text-decoration: none;
+}
+
+@media (prefers-color-scheme: dark) {
+    .dark\:invert {
+        --tw-invert: none;
+    }
+}
+
+.md-sidebar--primary {
+    width: 500px; /* default is 240px */
+}
+
+.md-content {
+    margin-left: 500px; /* match the new sidebar width */
+}
diff --git a/docs/source/_static/theme.css b/docs/source/_static/theme.css
deleted file mode 100644
index 2f0ef03b28..0000000000
--- a/docs/source/_static/theme.css
+++ /dev/null
@@ -1,11 +0,0 @@
-.content {
-    width: 60em;
-}
-
-a.next-page, a.prev-page {
-    color: var(--color-link);
-}
-
-a.next-page:hover, a.prev-page:hover {
-    text-decoration: underline;
-}
\ No newline at end of file
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 5f5b772abe..32c7548606 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -16,6 +16,10 @@ import os
 import sys
 import subprocess
 
+from dataclasses import asdict
+from sphinxawesome_theme import ThemeOptions
+from sphinxawesome_theme.postprocess import Icons
+
 # If extensions (or modules to document with autodoc) are in another directory,
 # add these directories to sys.path here. If the directory is relative to the
 # documentation root, use os.path.abspath to make it absolute, like shown here.
@@ -38,7 +42,6 @@ extensions = [
     'sphinx.ext.viewcode',
     'sphinx.ext.autosectionlabel',
     'sphinx_design',
-    'sphinx_copybutton',
 ]
 
 #autosectionlabel_prefix_document = True
@@ -147,20 +150,23 @@ primary_domain = 'c'
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'furo'
+html_theme = 'sphinxawesome_theme'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-html_theme_options = {
-    'navigation_with_keys': True,
-    'flyout_display': 'attached',
-    'sidebar_hide_name': False,
-    'top_of_page_buttons': [],
-}
+html_theme_options = asdict(ThemeOptions(
+   show_breadcrumbs=False,
+   main_nav_links= {
+        "Lua API": "reference/lua-scripting/index",
+        "Postprocessing": "reference/postprocessing/index",
+   }
+))
+
+html_permalinks_icon = Icons.permalinks_icon
 
 html_css_files = [
-    "theme.css",
+    "theme-override.css",
     "luadoc.css",
     "figures.css"
 ]
@@ -176,14 +182,14 @@ def setup(app):
 
 # The name for this set of Sphinx documents.  If None, it defaults to
 # "<project> v<release> documentation".
-html_title = 'OpenMW Docs'
+html_title = 'OpenMW'
 
 # A shorter title for the navigation bar.  Default is the same as html_title.
 # html_short_title = 'OpenMW Documentation'
 
 # The name of an image file (relative to this directory) to place at the top
 # of the sidebar.
-# html_logo = 'https://gitlab.com/OpenMW/openmw-docs/raw/master/docs/source/_static/images/openmw.png'
+html_logo = 'https://gitlab.com/OpenMW/openmw-docs/raw/master/docs/source/_static/images/openmw.png'
 
 # The name of an image file (within the static path) to use as favicon of the
 # docs.  This file should be a Windows icon file (.ico) being 16x16 or 32x32
diff --git a/docs/source/index.rst b/docs/source/index.rst
index de3773ddbd..532c041e82 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -3,7 +3,7 @@ Welcome to OpenMW's Documentation!
 
 .. toctree::
 	:caption: Table of Contents
-	:maxdepth: 3
+	:maxdepth: 8
 
 	manuals/index
 	reference/index

From 766b8f31459a93aa0b57331116f1e156887a2f97 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 11:03:55 -0700
Subject: [PATCH 10/44] docs - more restructuring

---
 docs/source/_static/luadoc.css                | 18 ++++---
 docs/source/_static/theme-override.css        |  4 ++
 docs/source/conf.py                           |  5 +-
 docs/source/index.rst                         | 28 ++++++++--
 .../documentationHowTo.rst                    |  6 +--
 docs/source/manuals/index.rst                 |  8 ---
 docs/source/manuals/installation/index.rst    |  1 +
 .../manuals/installation/install-openmw.rst   | 24 ++++-----
 docs/source/manuals/openmw-cs/index.rst       |  1 +
 docs/source/reference/index.rst               | 11 ----
 docs/source/reference/lua-scripting/api.rst   |  6 +--
 docs/source/reference/lua-scripting/index.rst | 18 -------
 .../lua-scripting/index_interfaces.rst        | 24 ++++-----
 .../reference/lua-scripting/overview.rst      |  6 +--
 docs/source/reference/modding/index.rst       |  6 +--
 .../reference/modding/settings/index.rst      |  1 +
 .../source/reference/postprocessing/index.rst | 49 ++++++++++++++++-
 docs/source/reference/postprocessing/lua.rst  |  6 +--
 .../source/reference/postprocessing/omwfx.rst |  6 +--
 .../reference/postprocessing/overview.rst     | 52 -------------------
 20 files changed, 135 insertions(+), 145 deletions(-)
 rename docs/source/{reference => manuals}/documentationHowTo.rst (99%)
 delete mode 100644 docs/source/manuals/index.rst
 delete mode 100644 docs/source/reference/index.rst
 delete mode 100644 docs/source/reference/lua-scripting/index.rst
 delete mode 100644 docs/source/reference/postprocessing/overview.rst

diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index 44e2557d7e..3ae140a4bb 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -18,17 +18,15 @@
 }
 
 @media (prefers-color-scheme: dark) {
-  body:not([data-theme="light"]) #luadoc pre.example,
-  body:not([data-theme="light"]) #luadoc pre.example code {
-    background-color: #2a3a49;
+  #luadoc pre.example,
+  #luadoc pre.example code {
+    background-color: hsl(var(--muted));
     color: #ffffff;
   }
 }
 
-body[data-theme="dark"] #luadoc pre.example,
-body[data-theme="dark"] #luadoc pre.example code {
-  background-color: #2a3a49;
-  color: #ffffff;
+#luadoc > p:nth-child(1) {
+  margin: 12px 0 12px 0;
 }
 
 #luadoc a:not(:link) {
@@ -46,9 +44,15 @@ body[data-theme="dark"] #luadoc pre.example code {
 
 .context-wrapper {
     display: flex;
+    margin-top: 14px;
     gap: 4px;
 }
 
+#luadoc ul { list-style-type: disc; }
+
+#luadoc ul { list-style-type: disc; }
+#luadoc li {list-style: bullet;}
+
 table.docutils {
     width: 100%;
 }
\ No newline at end of file
diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index edd184c431..71d572e890 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -8,6 +8,10 @@
     }
 }
 
+code {
+    white-space: normal;
+}
+
 .md-sidebar--primary {
     width: 500px; /* default is 240px */
 }
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 32c7548606..b8d73583bf 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -136,7 +136,7 @@ exclude_patterns = []
 #show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+pygments_style = 'github-dark'
 
 # A list of ignored prefixes for module index sorting.
 #modindex_common_prefix = []
@@ -158,7 +158,8 @@ html_theme = 'sphinxawesome_theme'
 html_theme_options = asdict(ThemeOptions(
    show_breadcrumbs=False,
    main_nav_links= {
-        "Lua API": "reference/lua-scripting/index",
+        "Modding": "reference/modding/index",
+        "Lua API": "reference/lua-scripting/overview",
         "Postprocessing": "reference/postprocessing/index",
    }
 ))
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 532c041e82..4a7ed95d02 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -2,8 +2,28 @@ Welcome to OpenMW's Documentation!
 ==================================
 
 .. toctree::
-	:caption: Table of Contents
-	:maxdepth: 8
+	:caption: Reference
+	:hidden:
+	:maxdepth: 4
 
-	manuals/index
-	reference/index
+	reference/modding/index
+	reference/postprocessing/index
+	reference/documentationHowTo
+
+.. toctree::
+	:caption: Lua
+	:hidden:
+	:maxdepth: 4
+
+	reference/lua-scripting/overview
+	reference/lua-scripting/api
+	reference/lua-scripting/teal
+
+.. toctree::
+	:caption: Help
+	:hidden:
+	:maxdepth: 4
+
+	manuals/installation/index
+	manuals/openmw-cs/index
+	manuals/documentationHowTo
diff --git a/docs/source/reference/documentationHowTo.rst b/docs/source/manuals/documentationHowTo.rst
similarity index 99%
rename from docs/source/reference/documentationHowTo.rst
rename to docs/source/manuals/documentationHowTo.rst
index d2b67d02ca..fb1062cd19 100644
--- a/docs/source/reference/documentationHowTo.rst
+++ b/docs/source/manuals/documentationHowTo.rst
@@ -1,6 +1,6 @@
-#######################################
-So you want to help with documentation?
-#######################################
+###############
+Help with docs?
+###############
 
 Or a beginner's guide to writing docs without having to deal with more techie stuff than you have to.
 #####################################################################################################
diff --git a/docs/source/manuals/index.rst b/docs/source/manuals/index.rst
deleted file mode 100644
index e6f0cbef2e..0000000000
--- a/docs/source/manuals/index.rst
+++ /dev/null
@@ -1,8 +0,0 @@
-User Manuals
-============
-
-.. toctree::
-    :maxdepth: 2
-
-    openmw-cs/index
-    installation/index
diff --git a/docs/source/manuals/installation/index.rst b/docs/source/manuals/installation/index.rst
index 6e6f5034ef..4cdc3968e1 100644
--- a/docs/source/manuals/installation/index.rst
+++ b/docs/source/manuals/installation/index.rst
@@ -6,6 +6,7 @@ In order to use OpenMW, you must install both the engine and the game files for
 
 .. toctree::
 	:maxdepth: 2
+	:hidden:
 
 	install-openmw
 	install-game-files
diff --git a/docs/source/manuals/installation/install-openmw.rst b/docs/source/manuals/installation/install-openmw.rst
index 2ef72abfd5..c4cb834632 100644
--- a/docs/source/manuals/installation/install-openmw.rst
+++ b/docs/source/manuals/installation/install-openmw.rst
@@ -2,8 +2,8 @@
 Install OpenMW
 ==============
 
-The (easier) Binary Way
-=======================
+Direct Download
+===============
 
 If you're not sure what any of the different methods mean, you should probably stick to this one.
 Simply download the latest version for your operating system from
@@ -15,14 +15,14 @@ and run the install package once downloaded. It's now installed!
 		as OpenMW automatically installs into a separate directory for each new version.
 		Your saves and configuration are compatible and accessible between versions.
 
-The (bleeding edge) Source Way
-==============================
+From Source
+===========
 
 Visit the `Development Environment Setup <https://wiki.openmw.org/index.php?title=Development_Environment_Setup>`_
 section of the Wiki for detailed instructions on how to build the engine.
 
-The Ubuntu Way
-==============
+Ubuntu
+======
 
 A `Launchpad PPA <https://launchpad.net/~openmw/+archive/openmw>`_ is available.
 Add it and install OpenMW::
@@ -39,16 +39,16 @@ To install, simply run the following as root (or in sudo)::
 
 	# pacman -S openmw
 
-The Void Linux Way
-==================
+Void Linux
+==========
 
 The binary package is available in the official Repository
 To install simply run the following as root (or in sudo)::
 
 	# xbps-install openmw
 
-The Debian Way
-==============
+Debian
+======
 
 OpenMW is available from the unstable (sid) repository of Debian contrib
 and can be easily installed if you are using testing or unstable.
@@ -56,8 +56,8 @@ However, it depends on several packages which are not in stable,
 so it is not possible to install OpenMW in Wheezy without creating a FrankenDebian.
 This is not recommended or supported.
 
-The Flatpak Way
-===============
+Flatpak
+=======
 
 OpenMW is available as a flatpak. With flatpak installed, run the command below. It should show up on your desktop.
 ::
diff --git a/docs/source/manuals/openmw-cs/index.rst b/docs/source/manuals/openmw-cs/index.rst
index f1f51409d4..f65d0a4ae9 100644
--- a/docs/source/manuals/openmw-cs/index.rst
+++ b/docs/source/manuals/openmw-cs/index.rst
@@ -15,6 +15,7 @@ few chapters to familiarise yourself with the new interface.
 
 .. toctree::
     :caption: Table of Contents
+    :hidden:
     :maxdepth: 2
 
     foreword
diff --git a/docs/source/reference/index.rst b/docs/source/reference/index.rst
deleted file mode 100644
index 9aa409f784..0000000000
--- a/docs/source/reference/index.rst
+++ /dev/null
@@ -1,11 +0,0 @@
-##################
-Reference Material
-##################
-
-.. toctree::
-	:maxdepth: 2
-
-	modding/index
-	lua-scripting/index
-	postprocessing/index
-	documentationHowTo
diff --git a/docs/source/reference/lua-scripting/api.rst b/docs/source/reference/lua-scripting/api.rst
index adede0b0d6..b8920b7ff1 100644
--- a/docs/source/reference/lua-scripting/api.rst
+++ b/docs/source/reference/lua-scripting/api.rst
@@ -1,6 +1,6 @@
-#################
-Lua API reference
-#################
+#############
+API Reference
+#############
 
 .. include:: version.rst
 
diff --git a/docs/source/reference/lua-scripting/index.rst b/docs/source/reference/lua-scripting/index.rst
deleted file mode 100644
index 8db10bdae1..0000000000
--- a/docs/source/reference/lua-scripting/index.rst
+++ /dev/null
@@ -1,18 +0,0 @@
-#############
-Lua scripting
-#############
-
-.. note::
-    OpenMW Lua is not compatible with MWSE.
-
-.. include:: version.rst
-
-.. toctree::
-    :caption: Table of Contents
-    :includehidden:
-    :maxdepth: 2
-
-    overview
-    api
-    teal
-
diff --git a/docs/source/reference/lua-scripting/index_interfaces.rst b/docs/source/reference/lua-scripting/index_interfaces.rst
index 06f21ee7d5..0e89cb09f7 100644
--- a/docs/source/reference/lua-scripting/index_interfaces.rst
+++ b/docs/source/reference/lua-scripting/index_interfaces.rst
@@ -7,18 +7,18 @@ Interfaces
 .. toctree::
     :hidden:
 
-    activation <interface_activation>
-    ai <interface_ai>
-    animation <interface_animation>
-    camera <interface_camera>
-    controls <interface_controls>
-    gamepadcontrols <interface_gamepadcontrols>
-    item_usage <interface_item_usage>
-    mwui <interface_mwui>
-    settings <interface_settings>
-    skill_progression <interface_skill_progression>
-    ui <interface_ui>
-    crimes <interface_crimes>
+    Activation <interface_activation>
+    AI <interface_ai>
+    Animation <interface_animation>
+    Camera <interface_camera>
+    Controls <interface_controls>
+    GamepadControls <interface_gamepadcontrols>
+    ItemUsage <interface_item_usage>
+    MWUI <interface_mwui>
+    Settings <interface_settings>
+    Skill_progression <interface_skill_progression>
+    UI <interface_ui>
+    Crimes <interface_crimes>
 
 **Interfaces of built-in scripts**
 
diff --git a/docs/source/reference/lua-scripting/overview.rst b/docs/source/reference/lua-scripting/overview.rst
index 2061e4efe9..852d63ca0a 100644
--- a/docs/source/reference/lua-scripting/overview.rst
+++ b/docs/source/reference/lua-scripting/overview.rst
@@ -1,5 +1,5 @@
-Overview of Lua scripting
-#########################
+Overview
+########
 
 .. include:: version.rst
 
@@ -641,7 +641,7 @@ Using IDE for Lua scripting
 Find the directory ``resources/lua_api`` in your installation of OpenMW.
 It describes OpenMW LuaAPI in
 `LDT Documentation Language <https://wiki.eclipse.org/LDT/User_Area/Documentation_Language>`__.
-It is the source from which the :ref:`API reference <Lua API reference>` is generated.
+It is the source from which the :ref:`API reference <API Reference>` is generated.
 
 If you write scripts using `Lua Development Tools <https://www.eclipse.org/ldt/>`__ (eclipse-based IDE),
 you can import these files to get code autocompletion and integrated OpenMW API reference. Here are the steps:
diff --git a/docs/source/reference/modding/index.rst b/docs/source/reference/modding/index.rst
index e2e9f84ac6..d9616f6483 100644
--- a/docs/source/reference/modding/index.rst
+++ b/docs/source/reference/modding/index.rst
@@ -1,5 +1,5 @@
-Modding Reference
-#################
+Modding
+#######
 
 The following document is the complete reference guide to modifying, or
 modding, your OpenMW setup. It does not cover content creation itself,
@@ -14,7 +14,7 @@ about creating new content for OpenMW, please refer to
 	not errors in the manual.
 
 .. toctree::
-	:caption: Table of Contents
+	:hidden:
 	:maxdepth: 2
 
 	foreword
diff --git a/docs/source/reference/modding/settings/index.rst b/docs/source/reference/modding/settings/index.rst
index 31ef4a3072..da367f4bee 100644
--- a/docs/source/reference/modding/settings/index.rst
+++ b/docs/source/reference/modding/settings/index.rst
@@ -47,6 +47,7 @@ The ranges included with each setting are the physically possible ranges, not re
 
 .. toctree::
 	:caption: Table of Contents
+	:hidden:
 	:maxdepth: 2
 
 	camera
diff --git a/docs/source/reference/postprocessing/index.rst b/docs/source/reference/postprocessing/index.rst
index 36fe871cff..7e0c88f654 100644
--- a/docs/source/reference/postprocessing/index.rst
+++ b/docs/source/reference/postprocessing/index.rst
@@ -2,11 +2,58 @@
 Post Processing
 ###############
 
+OpenMW supports a moddable post process framework for creating and
+controlling screenspace effects. This is integrated into OpenMW's Lua API, see
+`reference <../lua-scripting/openmw_postprocessing.html>`_ for details.
+
+Basic concepts
+==============
+
+Pass
+    Describes a single shader invocation pass. Currently only pixel (also known
+    as fragment) shaders are supported.
+
+Technique/Shader
+    An ordered list of passes, techniques will encompass a single effect like
+    bloom or SSAO. Technique is interchangeable with shader.
+
+Installing and Activating
+=========================
+
+Shaders are managed through the virtual file system, simply install the associated
+archive or folder as described in :ref:`mod-install<install>`. Shaders must be
+in the `Shaders` directory to be discoverable. A shader can be activated in one
+of two ways:
+
+1. Adding the shaders filename (without its extension) to the end of the
+   :ref:`chain` list in ``settings.cfg``.
+2. Using the in game post processor HUD, which can be activated with the ``F2``
+   key by default. This is the recommended method as manual editing can be error
+   prone.
+
+Localization
+============
+
+Output text (e.g. shader description) can use the ``#{ContextName:Key}`` tags.
+In this case OpenMW replaces it for value of ``Key`` key from the
+``Data Files\L10n\ContextName\used_language.yaml`` file.
+
+Hot Reloading
+=============
+
+It is possible to modify a shader without restarting OpenMW, hot reloading
+can be enabled by using the lua command `debug.setShaderHotReloadEnabled(true)`.
+Whenever a file is modified and saved, the shader will automatically reload in game.
+This allows shaders to be written in a text editor you are comfortable with. 
+The only restriction is that the VFS is not aware of new files or changes in non-shader files, 
+so new shaders and localization strings can not be used.
+
+
 .. toctree::
     :caption: Table of Contents
     :includehidden:
+    :hidden:
     :maxdepth: 2
 
-    overview
     omwfx
     lua
\ No newline at end of file
diff --git a/docs/source/reference/postprocessing/lua.rst b/docs/source/reference/postprocessing/lua.rst
index 45ccdd3631..28b99a5506 100644
--- a/docs/source/reference/postprocessing/lua.rst
+++ b/docs/source/reference/postprocessing/lua.rst
@@ -1,6 +1,6 @@
-####################
-Connecting With Lua
-####################
+###############
+Lua Integration
+###############
 
 Overview
 ########
diff --git a/docs/source/reference/postprocessing/omwfx.rst b/docs/source/reference/postprocessing/omwfx.rst
index 1eed8ad405..0efb8f408c 100644
--- a/docs/source/reference/postprocessing/omwfx.rst
+++ b/docs/source/reference/postprocessing/omwfx.rst
@@ -1,6 +1,6 @@
-#########################
-OMWFX Language Reference
-#########################
+##############
+OMWFX Language
+##############
 
 Overview
 ########
diff --git a/docs/source/reference/postprocessing/overview.rst b/docs/source/reference/postprocessing/overview.rst
deleted file mode 100644
index c9426e0cb4..0000000000
--- a/docs/source/reference/postprocessing/overview.rst
+++ /dev/null
@@ -1,52 +0,0 @@
-#####################################
-Overview of Post Processing Framework
-#####################################
-
-Overview
-========
-
-OpenMW supports a moddable post process framework for creating and
-controlling screenspace effects. This is integrated into OpenMW's Lua API, see
-`reference <../lua-scripting/openmw_postprocessing.html>`_ for details.
-
-Basic concepts
-==============
-
-Pass
-    Describes a single shader invocation pass. Currently only pixel (also known
-    as fragment) shaders are supported.
-
-Technique/Shader
-    An ordered list of passes, techniques will encompass a single effect like
-    bloom or SSAO. Technique is interchangeable with shader.
-
-Installing and Activating
-=========================
-
-Shaders are managed through the virtual file system, simply install the associated
-archive or folder as described in :ref:`mod-install<install>`. Shaders must be
-in the `Shaders` directory to be discoverable. A shader can be activated in one
-of two ways:
-
-1. Adding the shaders filename (without its extension) to the end of the
-   :ref:`chain` list in ``settings.cfg``.
-2. Using the in game post processor HUD, which can be activated with the ``F2``
-   key by default. This is the recommended method as manual editing can be error
-   prone.
-
-Localization
-============
-
-Output text (e.g. shader description) can use the ``#{ContextName:Key}`` tags.
-In this case OpenMW replaces it for value of ``Key`` key from the
-``Data Files\L10n\ContextName\used_language.yaml`` file.
-
-Hot Reloading
-=============
-
-It is possible to modify a shader without restarting OpenMW, hot reloading
-can be enabled by using the lua command `debug.setShaderHotReloadEnabled(true)`.
-Whenever a file is modified and saved, the shader will automatically reload in game.
-This allows shaders to be written in a text editor you are comfortable with. 
-The only restriction is that the VFS is not aware of new files or changes in non-shader files, 
-so new shaders and localization strings can not be used.

From 8439ac1b4e58d315262ceab92bcd1dd73533a345 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 11:05:08 -0700
Subject: [PATCH 11/44] docs - revert bump in sphinx version

---
 docs/requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/requirements.txt b/docs/requirements.txt
index 7847723e88..26bc5f6af8 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,5 +1,5 @@
 parse_cmake
-sphinx==8.2.3
+sphinx==7.1.2
 docutils==0.18.1
 jinja2==3.1.6
 sphinx-design==0.5.0

From 4032f4e06c3e2f7d4fc2f92891a2a5519e753131 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 11:42:13 -0700
Subject: [PATCH 12/44] docs - more restructuring

---
 docs/requirements.txt                         |  2 +-
 docs/source/_static/luadoc.css                | 11 ++--
 docs/source/_static/theme-override.css        | 12 +++--
 docs/source/conf.py                           |  3 +-
 docs/source/index.rst                         | 10 ++--
 .../lua-scripting/index_auxpackages.rst       |  8 +--
 .../lua-scripting/index_interfaces.rst        |  2 +-
 .../reference/modding/custom-models/index.rst |  1 +
 .../reference/modding/settings/index.rst      | 50 +++++++++----------
 .../texture-modding/texture-basics.rst        |  2 -
 10 files changed, 51 insertions(+), 50 deletions(-)

diff --git a/docs/requirements.txt b/docs/requirements.txt
index 26bc5f6af8..a193a5f96c 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -3,4 +3,4 @@ sphinx==7.1.2
 docutils==0.18.1
 jinja2==3.1.6
 sphinx-design==0.5.0
-sphinxawesome-theme==6.0.0b2
\ No newline at end of file
+sphinxawesome-theme==5.3.2
\ No newline at end of file
diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index 3ae140a4bb..238cdbee45 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -17,14 +17,11 @@
     padding: 0px;
 }
 
-@media (prefers-color-scheme: dark) {
-  #luadoc pre.example,
-  #luadoc pre.example code {
-    background-color: hsl(var(--muted));
-    color: #ffffff;
-  }
+html.dark #luadoc pre.example,
+html.dark #luadoc pre.example code {
+  background-color: hsl(var(--muted));
+  color: #ffffff;
 }
-
 #luadoc > p:nth-child(1) {
   margin: 12px 0 12px 0;
 }
diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 71d572e890..62eb60c943 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -1,11 +1,9 @@
-#content a.sd-badge:not(.toc-backref)  {
+#content a.sd-badge:not(.toc-backref), #content table a:not(.toc-backref)  {
     text-decoration: none;
 }
 
-@media (prefers-color-scheme: dark) {
-    .dark\:invert {
-        --tw-invert: none;
-    }
+.dark\:invert {
+    --tw-invert: none !important;
 }
 
 code {
@@ -19,3 +17,7 @@ code {
 .md-content {
     margin-left: 500px; /* match the new sidebar width */
 }
+
+#searchbox kbd {
+    display: none !important;
+}
\ No newline at end of file
diff --git a/docs/source/conf.py b/docs/source/conf.py
index b8d73583bf..85a3906e17 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -136,7 +136,8 @@ exclude_patterns = []
 #show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'github-dark'
+pygments_style = 'sphinx'
+pygments_style_dark = 'github-dark'
 
 # A list of ignored prefixes for module index sorting.
 #modindex_common_prefix = []
diff --git a/docs/source/index.rst b/docs/source/index.rst
index 4a7ed95d02..521a91cb5d 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -1,18 +1,20 @@
 Welcome to OpenMW's Documentation!
 ==================================
 
+This documentation covers all aspects of OpenMW development, scripting, and content creation.
+Use the categorized sections below to quickly access technical references, modding tools, and installation guides.
+
 .. toctree::
 	:caption: Reference
-	:hidden:
+   	:titlesonly:
 	:maxdepth: 4
 
 	reference/modding/index
 	reference/postprocessing/index
-	reference/documentationHowTo
 
 .. toctree::
 	:caption: Lua
-	:hidden:
+	:titlesonly:
 	:maxdepth: 4
 
 	reference/lua-scripting/overview
@@ -21,7 +23,7 @@ Welcome to OpenMW's Documentation!
 
 .. toctree::
 	:caption: Help
-	:hidden:
+	:titlesonly:
 	:maxdepth: 4
 
 	manuals/installation/index
diff --git a/docs/source/reference/lua-scripting/index_auxpackages.rst b/docs/source/reference/lua-scripting/index_auxpackages.rst
index e50fe45026..ea17a3ddbb 100644
--- a/docs/source/reference/lua-scripting/index_auxpackages.rst
+++ b/docs/source/reference/lua-scripting/index_auxpackages.rst
@@ -7,10 +7,10 @@ Auxiliary Packages
 .. toctree::
     :hidden:
 
-    aux_calendar <openmw_aux_calendar>
-    aux_time <openmw_aux_time>
-    aux_ui <openmw_aux_ui>
-    aux_util <openmw_aux_util>
+    calendar <openmw_aux_calendar>
+    time <openmw_aux_time>
+    ui <openmw_aux_ui>
+    util <openmw_aux_util>
 
 
 **Auxiliary packages**
diff --git a/docs/source/reference/lua-scripting/index_interfaces.rst b/docs/source/reference/lua-scripting/index_interfaces.rst
index 0e89cb09f7..4d9f6e9cff 100644
--- a/docs/source/reference/lua-scripting/index_interfaces.rst
+++ b/docs/source/reference/lua-scripting/index_interfaces.rst
@@ -16,7 +16,7 @@ Interfaces
     ItemUsage <interface_item_usage>
     MWUI <interface_mwui>
     Settings <interface_settings>
-    Skill_progression <interface_skill_progression>
+    SkillProgression <interface_skill_progression>
     UI <interface_ui>
     Crimes <interface_crimes>
 
diff --git a/docs/source/reference/modding/custom-models/index.rst b/docs/source/reference/modding/custom-models/index.rst
index b2d92032c5..fb317068c4 100644
--- a/docs/source/reference/modding/custom-models/index.rst
+++ b/docs/source/reference/modding/custom-models/index.rst
@@ -16,6 +16,7 @@ Below is a quick overview of supported formats, followed by separate articles wi
 
 .. toctree::
 	:caption: Table of Contents
+	:hidden:
 	:maxdepth: 1
 
 	pipeline-blender-collada-static-models
diff --git a/docs/source/reference/modding/settings/index.rst b/docs/source/reference/modding/settings/index.rst
index da367f4bee..940e207e0f 100644
--- a/docs/source/reference/modding/settings/index.rst
+++ b/docs/source/reference/modding/settings/index.rst
@@ -50,28 +50,28 @@ The ranges included with each setting are the physically possible ranges, not re
 	:hidden:
 	:maxdepth: 2
 
-	camera
-	cells
-	fog
-	groundcover
-	map
-	GUI
-	HUD
-	game
-	general
-	lua
-	shaders
-	shadows
-	input
-	saves
-	sound
-	terrain
-	video
-	water
-	windows
-	navigator
-	physics
-	models
-	postprocessing
-	stereo
-	stereoview
+	Camera <camera>
+	Cells <cells>
+	Fog <fog>
+	Groundcover <groundcover>
+	Map <map>
+	GUI <GUI>
+	HUD <HUD>
+	Game <game>
+	General <general>
+	Lua <lua>
+	Shaders <shaders>
+	Shadows <shadows>
+	Input <input>
+	Saves <saves>
+	Sound <sound>
+	Terrain <terrain>
+	Video <video>
+	Water <water>
+	Windows <windows>
+	Navigator <navigator>
+	Physics <physics>
+	Models <models>
+	Postprocessing <postprocessing>
+	Stereo <stereo>
+	Stereoview <stereoview>
diff --git a/docs/source/reference/modding/texture-modding/texture-basics.rst b/docs/source/reference/modding/texture-modding/texture-basics.rst
index 8bbf018fba..96ec48508b 100644
--- a/docs/source/reference/modding/texture-modding/texture-basics.rst
+++ b/docs/source/reference/modding/texture-modding/texture-basics.rst
@@ -1,5 +1,3 @@
-autosectionlabel_prefix_document = True
-
 ######################
 Texture Modding Basics
 ######################

From e649498f060213fb0c4edb3f5e91004c12b6e8c6 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 15:54:04 -0700
Subject: [PATCH 13/44] docs - adjust styling for em

---
 docs/source/_static/luadoc.css | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index 238cdbee45..b20f076204 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -33,6 +33,11 @@ html.dark #luadoc pre.example code {
     cursor: inherit;
 }
 
+#luadoc em {
+  font-size: 13px;
+  font-style: normal;
+}
+
 #luadoc p em { font-family: 'monospace';}
 
 #luadoc a:link { font-weight: bold; color: var(--color-link);; text-decoration: none; }

From 49a651761f137047a48d3ce93f13a3da942157b8 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 16:14:19 -0700
Subject: [PATCH 14/44] docs - clean up styles and add comments for each
 override

---
 docs/source/_static/theme-override.css | 17 +++++++++--------
 1 file changed, 9 insertions(+), 8 deletions(-)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 62eb60c943..e3d52e8007 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -1,23 +1,24 @@
+/* Hide text underline in tables since the underlines clash with table lines */
 #content a.sd-badge:not(.toc-backref), #content table a:not(.toc-backref)  {
     text-decoration: none;
 }
 
+/* Disables the saturation filter on project icon in dark mode */
 .dark\:invert {
     --tw-invert: none !important;
 }
 
+/* Disable no-wrap set on some code blocks, causing x-overflow issues in right bar */
 code {
     white-space: normal;
 }
 
-.md-sidebar--primary {
-    width: 500px; /* default is 240px */
-}
-
-.md-content {
-    margin-left: 500px; /* match the new sidebar width */
-}
-
+/* Hide the keybind shortcut for search, we haven't linked this to sphinx search addon yet */
 #searchbox kbd {
     display: none !important;
+}
+
+/* Table headers are bolded in dark mode, do it in light mode too */
+table th {
+    font-weight: 600 !important;
 }
\ No newline at end of file

From 36941bf4e939a073445c699adea412f1ca604dfb Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 16:31:18 -0700
Subject: [PATCH 15/44] docs - add table hover highlight and increase max width

---
 docs/source/_static/theme-override.css | 14 +++++++++++++-
 1 file changed, 13 insertions(+), 1 deletion(-)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index e3d52e8007..f0a8a13302 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -21,4 +21,16 @@ code {
 /* Table headers are bolded in dark mode, do it in light mode too */
 table th {
     font-weight: 600 !important;
-}
\ No newline at end of file
+}
+
+/* Highlight non-header rows on hover */
+tbody tr:hover {
+    background-color: hsl(var(--muted));
+}
+
+/* Increase maximum width for docs, default is quite narrow at 1400px max */
+@media (min-width: 1400px) {
+    .container {
+        max-width: 2000px !important;
+    }
+}

From 733631a77188d3a21ebbc55a45007f9952810c03 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 17:39:10 -0700
Subject: [PATCH 16/44] docs - more styling

---
 docs/source/_static/luadoc.css                | 36 ++++++++++++-------
 docs/source/_static/theme-override.css        | 24 +++++++++++++
 .../installation/install-game-files.rst       |  5 ++-
 .../manuals/installation/install-openmw.rst   |  4 +--
 4 files changed, 53 insertions(+), 16 deletions(-)

diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index b20f076204..f7fc66a550 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -1,9 +1,9 @@
-#luadoc code, #luadoc tt {
+#luadoc code, #luadoc tt, #luadoc p em {
     font-family: monospace;
 }
 
 #luadoc pre.example {
-    background-color: #eeffcc;
+    background-color: hsl(var(--accent)) !important;
     padding: 10px;
     margin: 10px 0 10px 0;
     overflow-x: auto;
@@ -11,7 +11,7 @@
 
 #luadoc pre.example code {
     color: black;
-    background-color: #eeffcc;
+    background-color: hsl(var(--accent)) !important;
     border: none;
     white-space: pre;
     padding: 0px;
@@ -22,15 +22,33 @@ html.dark #luadoc pre.example code {
   background-color: hsl(var(--muted));
   color: #ffffff;
 }
+
+#luadoc code {
+  background-color: unset;
+}
+
+#content #luadoc code a:not(.toc-backref) {
+  font-weight: 600;
+}
+
 #luadoc > p:nth-child(1) {
   margin: 12px 0 12px 0;
 }
 
-#luadoc a:not(:link) {
+#luadoc a:not([href]) {
     font-weight: bold;
-    color: var(--color-content-foreground);
     text-decoration: none;
     cursor: inherit;
+    color: inherit;
+}
+
+#luadoc a:not([href]):hover {
+    color: inherit;
+}
+
+#luadoc code a em {
+  color: inherit;
+  font-weight: inherit;
 }
 
 #luadoc em {
@@ -38,20 +56,12 @@ html.dark #luadoc pre.example code {
   font-style: normal;
 }
 
-#luadoc p em { font-family: 'monospace';}
-
-#luadoc a:link { font-weight: bold; color: var(--color-link);; text-decoration: none; }
-#luadoc a:visited { font-weight: bold; color: var(--color-link--hover); text-decoration: none; }
-#luadoc a:link:hover { text-decoration: underline; }
-
 .context-wrapper {
     display: flex;
     margin-top: 14px;
     gap: 4px;
 }
 
-#luadoc ul { list-style-type: disc; }
-
 #luadoc ul { list-style-type: disc; }
 #luadoc li {list-style: bullet;}
 
diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index f0a8a13302..6124a64e53 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -1,8 +1,32 @@
+:root {
+    --link: #4a90e2;
+    --link-hover: #1c6cd9;
+}
+
+/* Less aggressive dark background */
+.dark {
+    --background: 220 20% 7% !important;
+}
+
 /* Hide text underline in tables since the underlines clash with table lines */
 #content a.sd-badge:not(.toc-backref), #content table a:not(.toc-backref)  {
     text-decoration: none;
 }
 
+/* Override link colors, default is foreground */
+#content a:not(.toc-backref) {
+    color: var(--link);
+}
+
+#content a:not(.toc-backref):hover, #content a:not(.toc-backref):focus {
+    color: var(--link-hover);
+}
+
+#content .highlight {
+    background-color: hsl(var(--accent)) !important;
+    border-radius: 0.25rem;
+}
+
 /* Disables the saturation filter on project icon in dark mode */
 .dark\:invert {
     --tw-invert: none !important;
diff --git a/docs/source/manuals/installation/install-game-files.rst b/docs/source/manuals/installation/install-game-files.rst
index 42d4eb8d78..cb44f7d1de 100644
--- a/docs/source/manuals/installation/install-game-files.rst
+++ b/docs/source/manuals/installation/install-game-files.rst
@@ -163,7 +163,10 @@ Debian/Ubuntu - using "Steam Proton" & "OpenMW launcher".
 #. Launch "OpenMW launcher" and follow the setup wizard, when asked, point it at the location you installed Morrowind to, we will be looking for the directory that contains the Morrowing.esm file, for example '/steam library/steamapps/common/Morrowind/Data Files/'.
 #. Everything should now be in place, click that big "PLAY" button and fire up OpenMW.
 
-Note, Bloodmoon.esm needs to be below Tribunal.esm in your datafiles list, if you don't have the right order a red "!" will apear next to the filename in the datafiles section of the OpenMW launcher, just drag bloodmoon below tribunal to fix it.
+.. note::
+	`Bloodmoon.esm` needs to be below `Tribunal.esm` in your data files list.
+	If you don't have the right order a red `!` will apear next to the filename in the data files section of the OpenMW launcher.
+	To fix, drag `Bloodmoon.esm` below `Tribunal.esm`.
 
 Wine
 ~~~~
diff --git a/docs/source/manuals/installation/install-openmw.rst b/docs/source/manuals/installation/install-openmw.rst
index c4cb834632..5db6964072 100644
--- a/docs/source/manuals/installation/install-openmw.rst
+++ b/docs/source/manuals/installation/install-openmw.rst
@@ -31,8 +31,8 @@ Add it and install OpenMW::
 	$ sudo apt update
 	$ sudo apt install openmw
 
-The Arch Linux Way
-==================
+Arch Linux
+==========
 
 The binary package is available in the official [community] Repositories.
 To install, simply run the following as root (or in sudo)::

From 45d73957c173ab2710a6ff024b367c2a2a97f488 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 17:55:52 -0700
Subject: [PATCH 17/44] docs - style left TOC scroll

---
 docs/source/_static/theme-override.css | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 6124a64e53..deb8d3d0a8 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -58,3 +58,18 @@ tbody tr:hover {
         max-width: 2000px !important;
     }
 }
+
+/* Less intrusive scrollbar in left section TOC */
+#left-sidebar::-webkit-scrollbar {
+    width: 6px;
+    border-radius: 0;
+}
+
+#left-sidebar::-webkit-scrollbar-thumb {
+    background-color: hsl(var(--border));;
+    border-radius: 0;
+}
+
+#left-sidebar::-webkit-scrollbar-thumb:hover {
+    background-color: hsl(var(--muted));;
+}

From d81c666a2cd653517a93bffca362b2ee32feda9b Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 17:59:30 -0700
Subject: [PATCH 18/44] docs - increase width of left TOC on large screens

---
 docs/source/_static/theme-override.css | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index deb8d3d0a8..460812aca4 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -73,3 +73,9 @@ tbody tr:hover {
 #left-sidebar::-webkit-scrollbar-thumb:hover {
     background-color: hsl(var(--muted));;
 }
+
+@media (min-width: 1024px) {
+    .container:has(#left-sidebar) {
+        grid-template-columns: 310px minmax(0, 1fr);
+    }
+}
\ No newline at end of file

From cd1bd0eeafaa5f746903218b3188b943a034d9a9 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 18:01:49 -0700
Subject: [PATCH 19/44] docs - enable scroll to top widget

---
 docs/source/conf.py | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index 85a3906e17..722d46835b 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -162,7 +162,8 @@ html_theme_options = asdict(ThemeOptions(
         "Modding": "reference/modding/index",
         "Lua API": "reference/lua-scripting/overview",
         "Postprocessing": "reference/postprocessing/index",
-   }
+   },
+   show_scrolltop=True,
 ))
 
 html_permalinks_icon = Icons.permalinks_icon

From b7a1f76f4db7777d5559fdc5a5314394b59f2912 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 18:22:26 -0700
Subject: [PATCH 20/44] docs - make table headers real headers

---
 docs/source/reference/modding/custom-shader-effects.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/docs/source/reference/modding/custom-shader-effects.rst b/docs/source/reference/modding/custom-shader-effects.rst
index 5953af5238..0e7776c7ae 100644
--- a/docs/source/reference/modding/custom-shader-effects.rst
+++ b/docs/source/reference/modding/custom-shader-effects.rst
@@ -32,7 +32,7 @@ Variables.
 
 +--------------+--------------------------------------------------------------------------------------------------------+---------+---------+
 | Name         | Description                                                                                            | Type    | Default |
-+--------------+--------------------------------------------------------------------------------------------------------+---------+---------+
++==============+========================================================================================================+=========+=========+
 | size         | Scaling ratio. Larger values will make a softer fade effect. Larger geometry requires higher values.   | integer | 45      |
 +--------------+--------------------------------------------------------------------------------------------------------+---------+---------+
 | falloff      | Fades away geometry as camera gets closer. Geometry full fades when parallel to camera.                | boolean | false   |
@@ -73,7 +73,7 @@ Variables.
 
 +---------+--------------------------------------------------------------------------------------------------------+---------+---------+
 | Name    | Description                                                                                            | Type    | Default |
-+---------+--------------------------------------------------------------------------------------------------------+---------+---------+
++=========+========================================================================================================+=========+=========+
 | strength| The strength of the distortion effect. Scales linearly.                                                | float   | 0.1     |
 +---------+--------------------------------------------------------------------------------------------------------+---------+---------+
 

From 4e32e9f127256093b57ae5ff4cd9747ee88cd89c Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 21:01:03 -0700
Subject: [PATCH 21/44] docs - chevron 7 locked

---
 docs/source/_static/theme-override.css | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 460812aca4..6bcb93349c 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -78,4 +78,16 @@ tbody tr:hover {
     .container:has(#left-sidebar) {
         grid-template-columns: 310px minmax(0, 1fr);
     }
+}
+
+#left-sidebar a.expandable {
+    padding: 0 0 0 12px;
+}
+
+#left-sidebar a>button {
+    width: 30px;
+    height: 30px;
+    display: flex;
+    align-items: center;
+    justify-content: center;
 }
\ No newline at end of file

From 23a62085371dc988d4e2e402adb657a5483987e4 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Tue, 17 Jun 2025 21:05:41 -0700
Subject: [PATCH 22/44] Revert "docs - chevron 7 locked"

This reverts commit 4e32e9f127256093b57ae5ff4cd9747ee88cd89c.
---
 docs/source/_static/theme-override.css | 12 ------------
 1 file changed, 12 deletions(-)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 6bcb93349c..460812aca4 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -78,16 +78,4 @@ tbody tr:hover {
     .container:has(#left-sidebar) {
         grid-template-columns: 310px minmax(0, 1fr);
     }
-}
-
-#left-sidebar a.expandable {
-    padding: 0 0 0 12px;
-}
-
-#left-sidebar a>button {
-    width: 30px;
-    height: 30px;
-    display: flex;
-    align-items: center;
-    justify-content: center;
 }
\ No newline at end of file

From 638ceb73b7ec3980435daf70da5022e5d3c0d975 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Wed, 18 Jun 2025 06:16:09 -0700
Subject: [PATCH 23/44] docs - fix layout shift when expanding TOC

---
 docs/source/_static/theme-override.css | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 460812aca4..24b5c0273a 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -78,4 +78,9 @@ tbody tr:hover {
     .container:has(#left-sidebar) {
         grid-template-columns: 310px minmax(0, 1fr);
     }
-}
\ No newline at end of file
+}
+
+/* Always enable scrollbar in left TOC to prevent layout shifts when expanding */
+#left-sidebar {
+    overflow-y: scroll;
+}

From dab2538e0c3929716ddc485c39d0571a10f6f537 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Wed, 18 Jun 2025 06:33:14 -0700
Subject: [PATCH 24/44] docs - unify usage of code blocks in install openmw

---
 .../manuals/installation/install-openmw.rst   | 29 ++++++++++++-------
 1 file changed, 18 insertions(+), 11 deletions(-)

diff --git a/docs/source/manuals/installation/install-openmw.rst b/docs/source/manuals/installation/install-openmw.rst
index 5db6964072..c99b04da91 100644
--- a/docs/source/manuals/installation/install-openmw.rst
+++ b/docs/source/manuals/installation/install-openmw.rst
@@ -10,10 +10,10 @@ Simply download the latest version for your operating system from
 `github.com/OpenMW/openmw/releases <https://github.com/OpenMW/openmw/releases>`_
 and run the install package once downloaded. It's now installed!
 
-	.. note::
-		There is no need to uninstall previous versions
-		as OpenMW automatically installs into a separate directory for each new version.
-		Your saves and configuration are compatible and accessible between versions.
+.. note::
+	There is no need to uninstall previous versions
+	as OpenMW automatically installs into a separate directory for each new version.
+	Your saves and configuration are compatible and accessible between versions.
 
 From Source
 ===========
@@ -25,7 +25,9 @@ Ubuntu
 ======
 
 A `Launchpad PPA <https://launchpad.net/~openmw/+archive/openmw>`_ is available.
-Add it and install OpenMW::
+Add it and install OpenMW.
+
+.. code-block:: console
 
 	$ sudo add-apt-repository ppa:openmw/openmw
 	$ sudo apt update
@@ -35,17 +37,21 @@ Arch Linux
 ==========
 
 The binary package is available in the official [community] Repositories.
-To install, simply run the following as root (or in sudo)::
+To install, simply run the following as root (or in sudo).
 
-	# pacman -S openmw
+.. code-block:: console
+
+	$ pacman -S openmw
 
 Void Linux
 ==========
 
 The binary package is available in the official Repository
-To install simply run the following as root (or in sudo)::
+To install simply run the following as root (or in sudo).
 
-	# xbps-install openmw
+.. code-block:: console
+
+	$ xbps-install openmw
 
 Debian
 ======
@@ -60,6 +66,7 @@ Flatpak
 =======
 
 OpenMW is available as a flatpak. With flatpak installed, run the command below. It should show up on your desktop.
-::
 
-	# flatpak install openmw
+.. code-block:: console
+
+	$ flatpak install openmw

From fa0b3a04df8d75ae8ef7c26ad5a746b0acbbe885 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Wed, 18 Jun 2025 10:29:05 -0700
Subject: [PATCH 25/44] docs - change theme for luadoc monospace to match theme

---
 docs/source/_static/luadoc.css | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index f7fc66a550..92fb924dfa 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -1,5 +1,5 @@
 #luadoc code, #luadoc tt, #luadoc p em {
-    font-family: monospace;
+    font-family: 'JetBrains Mono', monospace;
 }
 
 #luadoc pre.example {

From 37e0566745aaae63b538200ee5e5e0e1a5d8faac Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Wed, 18 Jun 2025 17:43:31 -0700
Subject: [PATCH 26/44] docs - upgrade theme

---
 .readthedocs.yaml                      |  2 +-
 docs/requirements.txt                  |  2 +-
 docs/source/_static/luadoc.css         | 20 ++++++++++++++++----
 docs/source/_static/theme-override.css |  6 ++++--
 4 files changed, 22 insertions(+), 8 deletions(-)

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
index 962b34f516..926dd3dbf6 100644
--- a/.readthedocs.yaml
+++ b/.readthedocs.yaml
@@ -10,4 +10,4 @@ python:
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.8"
+    python: "3.9"
diff --git a/docs/requirements.txt b/docs/requirements.txt
index a193a5f96c..c044a3a21d 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -3,4 +3,4 @@ sphinx==7.1.2
 docutils==0.18.1
 jinja2==3.1.6
 sphinx-design==0.5.0
-sphinxawesome-theme==5.3.2
\ No newline at end of file
+git+https://github.com/glassmancody/sphinxawesome-theme.git@fix_dark_theme_pygment_and_flash
\ No newline at end of file
diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index 92fb924dfa..027aeefca1 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -17,16 +17,28 @@
     padding: 0px;
 }
 
-html.dark #luadoc pre.example,
-html.dark #luadoc pre.example code {
-  background-color: hsl(var(--muted));
-  color: #ffffff;
+@media (prefers-color-scheme: dark) {
+  #luadoc pre.example,
+  #luadoc pre.example code {
+    background-color: hsl(var(--muted));
+    color: #ffffff;
+  }
 }
 
 #luadoc code {
   background-color: unset;
 }
 
+#luadoc pre {
+    background-color: inherit;
+    color: inherit;
+    border: none;
+}
+
+#luadoc pre code {
+    white-space: normal;
+}
+
 #content #luadoc code a:not(.toc-backref) {
   font-weight: 600;
 }
diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 24b5c0273a..6d61867015 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -4,8 +4,10 @@
 }
 
 /* Less aggressive dark background */
-.dark {
-    --background: 220 20% 7% !important;
+@media (prefers-color-scheme: dark) {
+    :root {
+        --background: 220 20% 7% !important;
+    }
 }
 
 /* Hide text underline in tables since the underlines clash with table lines */

From b0fb0024bca8353a88af10576ed672bb8d6882fb Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Wed, 18 Jun 2025 17:58:38 -0700
Subject: [PATCH 27/44] docs - fix padding to accomodate hidden element

---
 docs/source/_static/theme-override.css | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 6d61867015..eccbfa10eb 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -44,6 +44,10 @@ code {
     display: none !important;
 }
 
+#search-input {
+    padding-right: 12px !important;
+}
+
 /* Table headers are bolded in dark mode, do it in light mode too */
 table th {
     font-weight: 600 !important;

From d500f801cce17ed284e57c0c7b999771ea0481f7 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Thu, 19 Jun 2025 10:06:42 -0700
Subject: [PATCH 28/44] docs - support flyout selector addon

---
 docs/source/_static/theme-override.css | 23 +++++++++++++++++++++++
 docs/source/conf.py                    |  2 +-
 2 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index eccbfa10eb..a49cb4414c 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -1,6 +1,29 @@
 :root {
     --link: #4a90e2;
     --link-hover: #1c6cd9;
+
+    --readthedocs-search-color: hsl(var(--foreground));
+    --readthedocs-search-link-color: var(--link);
+    --readthedocs-search-content-background-color: hsl(var(--background));
+    --readthedocs-search-content-border-color: hsl(var(--border));
+    --readthedocs-search-footer-background-color: hsl(var(--background));
+    --readthedocs-search-footer-color: hsl(var(--foreground));
+    --readthedocs-search-footer-code-background-color: hsl(var(--background));
+    --readthedocs-search-footer-code-border-color: hsl(var(--background));
+    --readthedocs-search-input-background-color: hsl(var(--accent));
+    --readthedocs-search-result-color: hsl(var(--foreground));
+    --readthedocs-search-result-icon-color: hsl(var(--foreground));
+    --readthedocs-search-result-heading-color: hsl(var(--foreground));
+    --readthedocs-search-result-subheading-color: hsl(var(--foreground));
+    --readthedocs-search-result-active-background-color: hsl(var(--accent));
+    --readthedocs-search-result-border-color: hsl(var(--border));
+
+    --readthedocs-flyout-background-color: hsl(var(--background));
+    --readthedocs-flyout-color: hsl(var(--foreground));
+    --readthedocs-flyout-current-version-color: hsl(var(--foreground));
+    --readthedocs-flyout-item-link-color: var(--link);
+    --readthedocs-flyout-link-color: var(--link);
+    --readthedocs-flyout-section-heading-color: hsl(var(--foreground));
 }
 
 /* Less aggressive dark background */
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 722d46835b..b55d53705c 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -163,7 +163,7 @@ html_theme_options = asdict(ThemeOptions(
         "Lua API": "reference/lua-scripting/overview",
         "Postprocessing": "reference/postprocessing/index",
    },
-   show_scrolltop=True,
+   show_scrolltop=False, # Useful, but hard to position with the Flyout addon since the best place for that is bottom right
 ))
 
 html_permalinks_icon = Icons.permalinks_icon

From cc5540039e55b0b007798d7b98afbc875e5a4317 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Thu, 19 Jun 2025 19:32:57 -0700
Subject: [PATCH 29/44] docs - better contrast for luadoc

---
 docs/source/_static/luadoc.css | 22 +++++++++++++++++++++-
 1 file changed, 21 insertions(+), 1 deletion(-)

diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index 027aeefca1..1a65a46944 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -48,7 +48,6 @@
 }
 
 #luadoc a:not([href]) {
-    font-weight: bold;
     text-decoration: none;
     cursor: inherit;
     color: inherit;
@@ -77,6 +76,27 @@
 #luadoc ul { list-style-type: disc; }
 #luadoc li {list-style: bullet;}
 
+#content #luadoc dl.function dt:not(.sig):first-child {
+  border-bottom: 2px solid hsl(163.24deg 81.3% 74.1% / 30%);
+  background-color: hsl(155.69deg 27.84% 54.99% / 12%);
+  padding: 6px;
+}
+
+#content #luadoc dl.function dt:not(.sig):first-child a {
+  text-decoration: none;
+}
+
+@media (prefers-color-scheme: dark) {
+  #content #luadoc dl.function dt:not(.sig):first-child {
+      border-bottom: 2px solid hsl(163.24deg 81.3% 74.1% / 20%);
+      background-color: hsl(155.69deg 27.84% 54.99% / 8%);
+  }
+}
+
+#luadoc .table-wrapper.container {
+  padding: 0;
+}
+
 table.docutils {
     width: 100%;
 }
\ No newline at end of file

From 8b56415597be2b86ac1d6913fe720dda1fd55c7e Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Thu, 19 Jun 2025 20:32:15 -0700
Subject: [PATCH 30/44] docs - remove ligature usage in code blocks

---
 docs/source/_static/theme-override.css | 1 +
 1 file changed, 1 insertion(+)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index a49cb4414c..35b41327d2 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -50,6 +50,7 @@
 #content .highlight {
     background-color: hsl(var(--accent)) !important;
     border-radius: 0.25rem;
+    font-variant-ligatures: none;
 }
 
 /* Disables the saturation filter on project icon in dark mode */

From 39917f1ebeeba3d4bda6d1a215d6c133e153a266 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Fri, 20 Jun 2025 06:12:55 -0700
Subject: [PATCH 31/44] docs - address more naming consistency with hyphens

---
 docs/source/conf.py                                       | 2 +-
 docs/source/manuals/openmw-cs/index.rst                   | 7 +++----
 docs/source/reference/modding/custom-models/index.rst     | 1 -
 docs/source/reference/modding/settings/index.rst          | 5 ++---
 docs/source/reference/modding/settings/postprocessing.rst | 2 +-
 docs/source/reference/postprocessing/index.rst            | 2 +-
 6 files changed, 8 insertions(+), 11 deletions(-)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index b55d53705c..555ea49dfe 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -161,7 +161,7 @@ html_theme_options = asdict(ThemeOptions(
    main_nav_links= {
         "Modding": "reference/modding/index",
         "Lua API": "reference/lua-scripting/overview",
-        "Postprocessing": "reference/postprocessing/index",
+        "Post-Processing": "reference/postprocessing/index",
    },
    show_scrolltop=False, # Useful, but hard to position with the Flyout addon since the best place for that is bottom right
 ))
diff --git a/docs/source/manuals/openmw-cs/index.rst b/docs/source/manuals/openmw-cs/index.rst
index f65d0a4ae9..223b4ab028 100644
--- a/docs/source/manuals/openmw-cs/index.rst
+++ b/docs/source/manuals/openmw-cs/index.rst
@@ -1,20 +1,19 @@
-OpenMW CS User Manual
+OpenMW-CS User Manual
 #####################
 
-The following document is the complete user manual for *OpenMW CS*, the
+The following document is the complete user manual for *OpenMW-CS*, the
 construction set for the OpenMW game engine. It is intended to serve both as an
 introduction and a reference for the application. Even if you are familiar with
 modding *The Elder Scrolls III: Morrowind* you should at least read the first
 few chapters to familiarise yourself with the new interface.
 
 .. warning::
-    OpenMW CS is still software in development. The manual does not cover any of
+    OpenMW-CS is still software in development. The manual does not cover any of
     its shortcomings, it is written as if everything was working as intended.
     Please report any software problems as bugs in the software, not errors in
     the manual.
 
 .. toctree::
-    :caption: Table of Contents
     :hidden:
     :maxdepth: 2
 
diff --git a/docs/source/reference/modding/custom-models/index.rst b/docs/source/reference/modding/custom-models/index.rst
index fb317068c4..40416f504c 100644
--- a/docs/source/reference/modding/custom-models/index.rst
+++ b/docs/source/reference/modding/custom-models/index.rst
@@ -15,7 +15,6 @@ Below is a quick overview of supported formats, followed by separate articles wi
 * **NIF** is the proprietary format used in the original Morrowind game. It supports static and animated models and everything else the format included in the original game.
 
 .. toctree::
-	:caption: Table of Contents
 	:hidden:
 	:maxdepth: 1
 
diff --git a/docs/source/reference/modding/settings/index.rst b/docs/source/reference/modding/settings/index.rst
index 940e207e0f..37ea947368 100644
--- a/docs/source/reference/modding/settings/index.rst
+++ b/docs/source/reference/modding/settings/index.rst
@@ -46,7 +46,6 @@ The ranges included with each setting are the physically possible ranges, not re
 	this guide should be plenty clear enough that you can find the setting you want to change and safely edit it.
 
 .. toctree::
-	:caption: Table of Contents
 	:hidden:
 	:maxdepth: 2
 
@@ -72,6 +71,6 @@ The ranges included with each setting are the physically possible ranges, not re
 	Navigator <navigator>
 	Physics <physics>
 	Models <models>
-	Postprocessing <postprocessing>
+	Post-Processing <postprocessing>
 	Stereo <stereo>
-	Stereoview <stereoview>
+	Stereo View <stereoview>
diff --git a/docs/source/reference/modding/settings/postprocessing.rst b/docs/source/reference/modding/settings/postprocessing.rst
index ed876c88d6..7015c46c7b 100644
--- a/docs/source/reference/modding/settings/postprocessing.rst
+++ b/docs/source/reference/modding/settings/postprocessing.rst
@@ -1,4 +1,4 @@
-Post Processing Settings
+Post-Processing Settings
 ########################
 
 .. _Post Processing:
diff --git a/docs/source/reference/postprocessing/index.rst b/docs/source/reference/postprocessing/index.rst
index 7e0c88f654..6d1f79c5b8 100644
--- a/docs/source/reference/postprocessing/index.rst
+++ b/docs/source/reference/postprocessing/index.rst
@@ -1,5 +1,5 @@
 ###############
-Post Processing
+Post-Processing
 ###############
 
 OpenMW supports a moddable post process framework for creating and

From 79f18effdd73b0997960526f328cefcdc9e5a3ad Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Fri, 20 Jun 2025 06:23:54 -0700
Subject: [PATCH 32/44] docs - unhide a TOC

---
 docs/source/_static/theme-override.css     | 5 +++++
 docs/source/manuals/installation/index.rst | 1 -
 2 files changed, 5 insertions(+), 1 deletion(-)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 35b41327d2..5155f0f519 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -33,6 +33,11 @@
     }
 }
 
+/* Enable hover-to-highlight in TOC */
+.contents ul li a.reference:hover, .toctree-wrapper ul li a.reference:hover {
+    color: hsl(var(--foreground)) !important;
+}
+
 /* Hide text underline in tables since the underlines clash with table lines */
 #content a.sd-badge:not(.toc-backref), #content table a:not(.toc-backref)  {
     text-decoration: none;
diff --git a/docs/source/manuals/installation/index.rst b/docs/source/manuals/installation/index.rst
index 4cdc3968e1..6e6f5034ef 100644
--- a/docs/source/manuals/installation/index.rst
+++ b/docs/source/manuals/installation/index.rst
@@ -6,7 +6,6 @@ In order to use OpenMW, you must install both the engine and the game files for
 
 .. toctree::
 	:maxdepth: 2
-	:hidden:
 
 	install-openmw
 	install-game-files

From 3bdf57f7c198d0ac7a32c26fcdb148880db1fe28 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Fri, 20 Jun 2025 10:42:35 -0700
Subject: [PATCH 33/44] docs - support prism and reorder some TOC

---
 docs/source/_static/luadoc.css                |  23 +--
 docs/source/_static/prism-dark.css            | 156 ++++++++++++++++++
 docs/source/_static/prism.css                 | 152 +++++++++++++++++
 docs/source/_static/prism.js                  |   7 +
 docs/source/_static/theme-override.css        |   8 +-
 docs/source/conf.py                           |   8 +-
 .../source/install_luadocumentor_in_docker.sh |   2 +-
 .../lua-scripting/index_interfaces.rst        |   2 +-
 .../lua-scripting/tables/aux_packages.rst     |   6 +-
 .../lua-scripting/tables/interfaces.rst       |  30 ++--
 .../lua-scripting/tables/packages.rst         |  70 ++++----
 11 files changed, 386 insertions(+), 78 deletions(-)
 create mode 100644 docs/source/_static/prism-dark.css
 create mode 100644 docs/source/_static/prism.css
 create mode 100644 docs/source/_static/prism.js

diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index 1a65a46944..83bfdf78b7 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -2,34 +2,15 @@
     font-family: 'JetBrains Mono', monospace;
 }
 
-#luadoc pre.example {
-    background-color: hsl(var(--accent)) !important;
-    padding: 10px;
-    margin: 10px 0 10px 0;
-    overflow-x: auto;
-}
-
 #luadoc pre.example code {
-    color: black;
-    background-color: hsl(var(--accent)) !important;
-    border: none;
     white-space: pre;
-    padding: 0px;
 }
 
-@media (prefers-color-scheme: dark) {
-  #luadoc pre.example,
-  #luadoc pre.example code {
-    background-color: hsl(var(--muted));
-    color: #ffffff;
-  }
-}
-
-#luadoc code {
+#luadoc code:not([class*="language-"]) {
   background-color: unset;
 }
 
-#luadoc pre {
+#luadoc pre:not([class*="language-"]) {
     background-color: inherit;
     color: inherit;
     border: none;
diff --git a/docs/source/_static/prism-dark.css b/docs/source/_static/prism-dark.css
new file mode 100644
index 0000000000..293a0d1267
--- /dev/null
+++ b/docs/source/_static/prism-dark.css
@@ -0,0 +1,156 @@
+@media (prefers-color-scheme: dark) {
+
+    /**
+ * Github Dark theme for Prism.js
+ * Based on Github: https://github.com
+ * @author Katorly
+ */
+    /* General */
+    pre[class*="language-"],
+    code[class*="language-"] {
+        color: #c9d1d9;
+        font-size: 13px;
+        text-shadow: none;
+        font-family: Consolas, Monaco, 'Andale Mono', 'Ubuntu Mono', monospace;
+        direction: ltr;
+        text-align: left;
+        white-space: pre;
+        word-spacing: normal;
+        word-break: normal;
+        line-height: 1.5;
+        -moz-tab-size: 4;
+        -o-tab-size: 4;
+        tab-size: 4;
+        -webkit-hyphens: none;
+        -moz-hyphens: none;
+        -ms-hyphens: none;
+        hyphens: none;
+    }
+
+    pre[class*="language-"]::selection,
+    code[class*="language-"]::selection,
+    pre[class*="language-"]::mozselection,
+    code[class*="language-"]::mozselection {
+        text-shadow: none;
+        background: #234879;
+    }
+
+    @media print {
+
+        pre[class*="language-"],
+        code[class*="language-"] {
+            text-shadow: none;
+        }
+    }
+
+    pre[class*="language-"] {
+        padding: 1em;
+        margin: .5em 0;
+        overflow: auto;
+        background: #161b22;
+    }
+
+    :not(pre)>code[class*="language-"] {
+        padding: .1em .3em;
+        border-radius: .3em;
+        color: #c9d1d9;
+        background: #343942;
+    }
+
+    /* Line highlighting */
+    pre[data-line] {
+        position: relative;
+    }
+
+    pre[class*="language-"]>code[class*="language-"] {
+        position: relative;
+        z-index: 1;
+    }
+
+    .line-highlight {
+        position: absolute;
+        left: 0;
+        right: 0;
+        padding: inherit 0;
+        margin-top: 1em;
+        background: #2f2a1e;
+        box-shadow: inset 5px 0 0 #674c16;
+        z-index: 0;
+        pointer-events: none;
+        line-height: inherit;
+        white-space: pre;
+    }
+
+    /* Tokens */
+    .namespace {
+        opacity: .7;
+    }
+
+    .token.comment,
+    .token.prolog,
+    .token.doctype,
+    .token.cdata {
+        color: #8b949e;
+    }
+
+    .token.punctuation {
+        color: #c9d1d9;
+    }
+
+    .token.property,
+    .token.tag,
+    .token.boolean,
+    .token.number,
+    .token.constant,
+    .token.symbol,
+    .token.deleted {
+        color: #79c0ff;
+    }
+
+    .token.selector,
+    .token.attr-name,
+    .token.string,
+    .token.char,
+    .token.builtin,
+    .token.inserted {
+        color: #a5d6ff;
+    }
+
+    .token.operator,
+    .token.entity,
+    .token.url,
+    .language-css .token.string,
+    .style .token.string {
+        color: #a5d6ff;
+        background: #161b22;
+    }
+
+    .token.atrule,
+    .token.attr-value,
+    .token.keyword {
+        color: #a5d6ff;
+    }
+
+    .token.function {
+        color: #d2a8ff;
+    }
+
+    .token.regex,
+    .token.important,
+    .token.variable {
+        color: #a8daff;
+    }
+
+    .token.important,
+    .token.bold {
+        font-weight: bold;
+    }
+
+    .token.italic {
+        font-style: italic;
+    }
+
+    .token.entity {
+        cursor: help;
+    }
+}
\ No newline at end of file
diff --git a/docs/source/_static/prism.css b/docs/source/_static/prism.css
new file mode 100644
index 0000000000..088a96cb6c
--- /dev/null
+++ b/docs/source/_static/prism.css
@@ -0,0 +1,152 @@
+/**
+ * Github Light theme for Prism.js
+ * Based on Github: https://github.com
+ * @author Katorly
+ */
+/* General */
+pre[class*="language-"],
+code[class*="language-"] {
+    color: #24292f;
+    font-size: 13px;
+    text-shadow: none;
+    font-family: Consolas, Monaco, 'Andale Mono', 'Ubuntu Mono', monospace;
+    direction: ltr;
+    text-align: left;
+    white-space: pre;
+    word-spacing: normal;
+    word-break: normal;
+    line-height: 1.5;
+    -moz-tab-size: 4;
+    -o-tab-size: 4;
+    tab-size: 4;
+    -webkit-hyphens: none;
+    -moz-hyphens: none;
+    -ms-hyphens: none;
+    hyphens: none;
+}
+
+pre[class*="language-"]::selection,
+code[class*="language-"]::selection,
+pre[class*="language-"]::mozselection,
+code[class*="language-"]::mozselection {
+    text-shadow: none;
+    background: #9fc6e9;
+}
+
+@media print {
+
+    pre[class*="language-"],
+    code[class*="language-"] {
+        text-shadow: none;
+    }
+}
+
+pre[class*="language-"] {
+    padding: 1em;
+    margin: .5em 0;
+    overflow: auto;
+    background: #f6f8fa;
+}
+
+:not(pre)>code[class*="language-"] {
+    padding: .1em .3em;
+    border-radius: .3em;
+    color: #24292f;
+    background: #eff1f3;
+}
+
+/* Line highlighting */
+pre[data-line] {
+    position: relative;
+}
+
+pre[class*="language-"]>code[class*="language-"] {
+    position: relative;
+    z-index: 1;
+}
+
+.line-highlight {
+    position: absolute;
+    left: 0;
+    right: 0;
+    padding: inherit 0;
+    margin-top: 1em;
+    background: #fff8c5;
+    box-shadow: inset 5px 0 0 #eed888;
+    z-index: 0;
+    pointer-events: none;
+    line-height: inherit;
+    white-space: pre;
+}
+
+/* Tokens */
+.namespace {
+    opacity: .7;
+}
+
+.token.comment,
+.token.prolog,
+.token.doctype,
+.token.cdata {
+    color: #6e7781;
+}
+
+.token.punctuation {
+    color: #24292f;
+}
+
+.token.property,
+.token.tag,
+.token.boolean,
+.token.number,
+.token.constant,
+.token.symbol,
+.token.deleted {
+    color: #0550ae;
+}
+
+.token.selector,
+.token.attr-name,
+.token.string,
+.token.char,
+.token.builtin,
+.token.inserted {
+    color: #0a3069;
+}
+
+.token.operator,
+.token.entity,
+.token.url,
+.language-css .token.string,
+.style .token.string {
+    color: #0550ae;
+}
+
+.token.atrule,
+.token.attr-value,
+.token.keyword {
+    color: #cf222e;
+}
+
+.token.function {
+    color: #8250df;
+}
+
+.token.regex,
+.token.important,
+.token.variable {
+    color: #0a3069;
+}
+
+.token.important,
+.token.bold {
+    font-weight: bold;
+}
+
+.token.italic {
+    font-style: italic;
+}
+
+.token.entity {
+    cursor: help;
+}
\ No newline at end of file
diff --git a/docs/source/_static/prism.js b/docs/source/_static/prism.js
new file mode 100644
index 0000000000..fa92d07899
--- /dev/null
+++ b/docs/source/_static/prism.js
@@ -0,0 +1,7 @@
+/* PrismJS 1.30.0
+https://prismjs.com/download#themes=prism&languages=json+lua+yaml&plugins=toolbar */
+var _self="undefined"!=typeof window?window:"undefined"!=typeof WorkerGlobalScope&&self instanceof WorkerGlobalScope?self:{},Prism=function(e){var n=/(?:^|\s)lang(?:uage)?-([\w-]+)(?=\s|$)/i,t=0,r={},a={manual:e.Prism&&e.Prism.manual,disableWorkerMessageHandler:e.Prism&&e.Prism.disableWorkerMessageHandler,util:{encode:function e(n){return n instanceof i?new i(n.type,e(n.content),n.alias):Array.isArray(n)?n.map(e):n.replace(/&/g,"&amp;").replace(/</g,"&lt;").replace(/\u00a0/g," ")},type:function(e){return Object.prototype.toString.call(e).slice(8,-1)},objId:function(e){return e.__id||Object.defineProperty(e,"__id",{value:++t}),e.__id},clone:function e(n,t){var r,i;switch(t=t||{},a.util.type(n)){case"Object":if(i=a.util.objId(n),t[i])return t[i];for(var l in r={},t[i]=r,n)n.hasOwnProperty(l)&&(r[l]=e(n[l],t));return r;case"Array":return i=a.util.objId(n),t[i]?t[i]:(r=[],t[i]=r,n.forEach((function(n,a){r[a]=e(n,t)})),r);default:return n}},getLanguage:function(e){for(;e;){var t=n.exec(e.className);if(t)return t[1].toLowerCase();e=e.parentElement}return"none"},setLanguage:function(e,t){e.className=e.className.replace(RegExp(n,"gi"),""),e.classList.add("language-"+t)},currentScript:function(){if("undefined"==typeof document)return null;if(document.currentScript&&"SCRIPT"===document.currentScript.tagName)return document.currentScript;try{throw new Error}catch(r){var e=(/at [^(\r\n]*\((.*):[^:]+:[^:]+\)$/i.exec(r.stack)||[])[1];if(e){var n=document.getElementsByTagName("script");for(var t in n)if(n[t].src==e)return n[t]}return null}},isActive:function(e,n,t){for(var r="no-"+n;e;){var a=e.classList;if(a.contains(n))return!0;if(a.contains(r))return!1;e=e.parentElement}return!!t}},languages:{plain:r,plaintext:r,text:r,txt:r,extend:function(e,n){var t=a.util.clone(a.languages[e]);for(var r in n)t[r]=n[r];return t},insertBefore:function(e,n,t,r){var i=(r=r||a.languages)[e],l={};for(var o in i)if(i.hasOwnProperty(o)){if(o==n)for(var s in t)t.hasOwnProperty(s)&&(l[s]=t[s]);t.hasOwnProperty(o)||(l[o]=i[o])}var u=r[e];return r[e]=l,a.languages.DFS(a.languages,(function(n,t){t===u&&n!=e&&(this[n]=l)})),l},DFS:function e(n,t,r,i){i=i||{};var l=a.util.objId;for(var o in n)if(n.hasOwnProperty(o)){t.call(n,o,n[o],r||o);var s=n[o],u=a.util.type(s);"Object"!==u||i[l(s)]?"Array"!==u||i[l(s)]||(i[l(s)]=!0,e(s,t,o,i)):(i[l(s)]=!0,e(s,t,null,i))}}},plugins:{},highlightAll:function(e,n){a.highlightAllUnder(document,e,n)},highlightAllUnder:function(e,n,t){var r={callback:t,container:e,selector:'code[class*="language-"], [class*="language-"] code, code[class*="lang-"], [class*="lang-"] code'};a.hooks.run("before-highlightall",r),r.elements=Array.prototype.slice.apply(r.container.querySelectorAll(r.selector)),a.hooks.run("before-all-elements-highlight",r);for(var i,l=0;i=r.elements[l++];)a.highlightElement(i,!0===n,r.callback)},highlightElement:function(n,t,r){var i=a.util.getLanguage(n),l=a.languages[i];a.util.setLanguage(n,i);var o=n.parentElement;o&&"pre"===o.nodeName.toLowerCase()&&a.util.setLanguage(o,i);var s={element:n,language:i,grammar:l,code:n.textContent};function u(e){s.highlightedCode=e,a.hooks.run("before-insert",s),s.element.innerHTML=s.highlightedCode,a.hooks.run("after-highlight",s),a.hooks.run("complete",s),r&&r.call(s.element)}if(a.hooks.run("before-sanity-check",s),(o=s.element.parentElement)&&"pre"===o.nodeName.toLowerCase()&&!o.hasAttribute("tabindex")&&o.setAttribute("tabindex","0"),!s.code)return a.hooks.run("complete",s),void(r&&r.call(s.element));if(a.hooks.run("before-highlight",s),s.grammar)if(t&&e.Worker){var c=new Worker(a.filename);c.onmessage=function(e){u(e.data)},c.postMessage(JSON.stringify({language:s.language,code:s.code,immediateClose:!0}))}else u(a.highlight(s.code,s.grammar,s.language));else u(a.util.encode(s.code))},highlight:function(e,n,t){var r={code:e,grammar:n,language:t};if(a.hooks.run("before-tokenize",r),!r.grammar)throw new Error('The language "'+r.language+'" has no grammar.');return r.tokens=a.tokenize(r.code,r.grammar),a.hooks.run("after-tokenize",r),i.stringify(a.util.encode(r.tokens),r.language)},tokenize:function(e,n){var t=n.rest;if(t){for(var r in t)n[r]=t[r];delete n.rest}var a=new s;return u(a,a.head,e),o(e,a,n,a.head,0),function(e){for(var n=[],t=e.head.next;t!==e.tail;)n.push(t.value),t=t.next;return n}(a)},hooks:{all:{},add:function(e,n){var t=a.hooks.all;t[e]=t[e]||[],t[e].push(n)},run:function(e,n){var t=a.hooks.all[e];if(t&&t.length)for(var r,i=0;r=t[i++];)r(n)}},Token:i};function i(e,n,t,r){this.type=e,this.content=n,this.alias=t,this.length=0|(r||"").length}function l(e,n,t,r){e.lastIndex=n;var a=e.exec(t);if(a&&r&&a[1]){var i=a[1].length;a.index+=i,a[0]=a[0].slice(i)}return a}function o(e,n,t,r,s,g){for(var f in t)if(t.hasOwnProperty(f)&&t[f]){var h=t[f];h=Array.isArray(h)?h:[h];for(var d=0;d<h.length;++d){if(g&&g.cause==f+","+d)return;var v=h[d],p=v.inside,m=!!v.lookbehind,y=!!v.greedy,k=v.alias;if(y&&!v.pattern.global){var x=v.pattern.toString().match(/[imsuy]*$/)[0];v.pattern=RegExp(v.pattern.source,x+"g")}for(var b=v.pattern||v,w=r.next,A=s;w!==n.tail&&!(g&&A>=g.reach);A+=w.value.length,w=w.next){var P=w.value;if(n.length>e.length)return;if(!(P instanceof i)){var E,S=1;if(y){if(!(E=l(b,A,e,m))||E.index>=e.length)break;var L=E.index,O=E.index+E[0].length,C=A;for(C+=w.value.length;L>=C;)C+=(w=w.next).value.length;if(A=C-=w.value.length,w.value instanceof i)continue;for(var j=w;j!==n.tail&&(C<O||"string"==typeof j.value);j=j.next)S++,C+=j.value.length;S--,P=e.slice(A,C),E.index-=A}else if(!(E=l(b,0,P,m)))continue;L=E.index;var N=E[0],_=P.slice(0,L),M=P.slice(L+N.length),W=A+P.length;g&&W>g.reach&&(g.reach=W);var I=w.prev;if(_&&(I=u(n,I,_),A+=_.length),c(n,I,S),w=u(n,I,new i(f,p?a.tokenize(N,p):N,k,N)),M&&u(n,w,M),S>1){var T={cause:f+","+d,reach:W};o(e,n,t,w.prev,A,T),g&&T.reach>g.reach&&(g.reach=T.reach)}}}}}}function s(){var e={value:null,prev:null,next:null},n={value:null,prev:e,next:null};e.next=n,this.head=e,this.tail=n,this.length=0}function u(e,n,t){var r=n.next,a={value:t,prev:n,next:r};return n.next=a,r.prev=a,e.length++,a}function c(e,n,t){for(var r=n.next,a=0;a<t&&r!==e.tail;a++)r=r.next;n.next=r,r.prev=n,e.length-=a}if(e.Prism=a,i.stringify=function e(n,t){if("string"==typeof n)return n;if(Array.isArray(n)){var r="";return n.forEach((function(n){r+=e(n,t)})),r}var i={type:n.type,content:e(n.content,t),tag:"span",classes:["token",n.type],attributes:{},language:t},l=n.alias;l&&(Array.isArray(l)?Array.prototype.push.apply(i.classes,l):i.classes.push(l)),a.hooks.run("wrap",i);var o="";for(var s in i.attributes)o+=" "+s+'="'+(i.attributes[s]||"").replace(/"/g,"&quot;")+'"';return"<"+i.tag+' class="'+i.classes.join(" ")+'"'+o+">"+i.content+"</"+i.tag+">"},!e.document)return e.addEventListener?(a.disableWorkerMessageHandler||e.addEventListener("message",(function(n){var t=JSON.parse(n.data),r=t.language,i=t.code,l=t.immediateClose;e.postMessage(a.highlight(i,a.languages[r],r)),l&&e.close()}),!1),a):a;var g=a.util.currentScript();function f(){a.manual||a.highlightAll()}if(g&&(a.filename=g.src,g.hasAttribute("data-manual")&&(a.manual=!0)),!a.manual){var h=document.readyState;"loading"===h||"interactive"===h&&g&&g.defer?document.addEventListener("DOMContentLoaded",f):window.requestAnimationFrame?window.requestAnimationFrame(f):window.setTimeout(f,16)}return a}(_self);"undefined"!=typeof module&&module.exports&&(module.exports=Prism),"undefined"!=typeof global&&(global.Prism=Prism);
+Prism.languages.json={property:{pattern:/(^|[^\\])"(?:\\.|[^\\"\r\n])*"(?=\s*:)/,lookbehind:!0,greedy:!0},string:{pattern:/(^|[^\\])"(?:\\.|[^\\"\r\n])*"(?!\s*:)/,lookbehind:!0,greedy:!0},comment:{pattern:/\/\/.*|\/\*[\s\S]*?(?:\*\/|$)/,greedy:!0},number:/-?\b\d+(?:\.\d+)?(?:e[+-]?\d+)?\b/i,punctuation:/[{}[\],]/,operator:/:/,boolean:/\b(?:false|true)\b/,null:{pattern:/\bnull\b/,alias:"keyword"}},Prism.languages.webmanifest=Prism.languages.json;
+Prism.languages.lua={comment:/^#!.+|--(?:\[(=*)\[[\s\S]*?\]\1\]|.*)/m,string:{pattern:/(["'])(?:(?!\1)[^\\\r\n]|\\z(?:\r\n|\s)|\\(?:\r\n|[^z]))*\1|\[(=*)\[[\s\S]*?\]\2\]/,greedy:!0},number:/\b0x[a-f\d]+(?:\.[a-f\d]*)?(?:p[+-]?\d+)?\b|\b\d+(?:\.\B|(?:\.\d*)?(?:e[+-]?\d+)?\b)|\B\.\d+(?:e[+-]?\d+)?\b/i,keyword:/\b(?:and|break|do|else|elseif|end|false|for|function|goto|if|in|local|nil|not|or|repeat|return|then|true|until|while)\b/,function:/(?!\d)\w+(?=\s*(?:[({]))/,operator:[/[-+*%^&|#]|\/\/?|<[<=]?|>[>=]?|[=~]=?/,{pattern:/(^|[^.])\.\.(?!\.)/,lookbehind:!0}],punctuation:/[\[\](){},;]|\.+|:+/};
+!function(e){var n=/[*&][^\s[\]{},]+/,r=/!(?:<[\w\-%#;/?:@&=+$,.!~*'()[\]]+>|(?:[a-zA-Z\d-]*!)?[\w\-%#;/?:@&=+$.~*'()]+)?/,t="(?:"+r.source+"(?:[ \t]+"+n.source+")?|"+n.source+"(?:[ \t]+"+r.source+")?)",a="(?:[^\\s\\x00-\\x08\\x0e-\\x1f!\"#%&'*,\\-:>?@[\\]`{|}\\x7f-\\x84\\x86-\\x9f\\ud800-\\udfff\\ufffe\\uffff]|[?:-]<PLAIN>)(?:[ \t]*(?:(?![#:])<PLAIN>|:<PLAIN>))*".replace(/<PLAIN>/g,(function(){return"[^\\s\\x00-\\x08\\x0e-\\x1f,[\\]{}\\x7f-\\x84\\x86-\\x9f\\ud800-\\udfff\\ufffe\\uffff]"})),d="\"(?:[^\"\\\\\r\n]|\\\\.)*\"|'(?:[^'\\\\\r\n]|\\\\.)*'";function o(e,n){n=(n||"").replace(/m/g,"")+"m";var r="([:\\-,[{]\\s*(?:\\s<<prop>>[ \t]+)?)(?:<<value>>)(?=[ \t]*(?:$|,|\\]|\\}|(?:[\r\n]\\s*)?#))".replace(/<<prop>>/g,(function(){return t})).replace(/<<value>>/g,(function(){return e}));return RegExp(r,n)}e.languages.yaml={scalar:{pattern:RegExp("([\\-:]\\s*(?:\\s<<prop>>[ \t]+)?[|>])[ \t]*(?:((?:\r?\n|\r)[ \t]+)\\S[^\r\n]*(?:\\2[^\r\n]+)*)".replace(/<<prop>>/g,(function(){return t}))),lookbehind:!0,alias:"string"},comment:/#.*/,key:{pattern:RegExp("((?:^|[:\\-,[{\r\n?])[ \t]*(?:<<prop>>[ \t]+)?)<<key>>(?=\\s*:\\s)".replace(/<<prop>>/g,(function(){return t})).replace(/<<key>>/g,(function(){return"(?:"+a+"|"+d+")"}))),lookbehind:!0,greedy:!0,alias:"atrule"},directive:{pattern:/(^[ \t]*)%.+/m,lookbehind:!0,alias:"important"},datetime:{pattern:o("\\d{4}-\\d\\d?-\\d\\d?(?:[tT]|[ \t]+)\\d\\d?:\\d{2}:\\d{2}(?:\\.\\d*)?(?:[ \t]*(?:Z|[-+]\\d\\d?(?::\\d{2})?))?|\\d{4}-\\d{2}-\\d{2}|\\d\\d?:\\d{2}(?::\\d{2}(?:\\.\\d*)?)?"),lookbehind:!0,alias:"number"},boolean:{pattern:o("false|true","i"),lookbehind:!0,alias:"important"},null:{pattern:o("null|~","i"),lookbehind:!0,alias:"important"},string:{pattern:o(d),lookbehind:!0,greedy:!0},number:{pattern:o("[+-]?(?:0x[\\da-f]+|0o[0-7]+|(?:\\d+(?:\\.\\d*)?|\\.\\d+)(?:e[+-]?\\d+)?|\\.inf|\\.nan)","i"),lookbehind:!0},tag:r,important:n,punctuation:/---|[:[\]{}\-,|>?]|\.\.\./},e.languages.yml=e.languages.yaml}(Prism);
+!function(){if("undefined"!=typeof Prism&&"undefined"!=typeof document){var e=[],t={},n=function(){};Prism.plugins.toolbar={};var a=Prism.plugins.toolbar.registerButton=function(n,a){var r;r="function"==typeof a?a:function(e){var t;return"function"==typeof a.onClick?((t=document.createElement("button")).type="button",t.addEventListener("click",(function(){a.onClick.call(this,e)}))):"string"==typeof a.url?(t=document.createElement("a")).href=a.url:t=document.createElement("span"),a.className&&t.classList.add(a.className),t.textContent=a.text,t},n in t?console.warn('There is a button with the key "'+n+'" registered already.'):e.push(t[n]=r)},r=Prism.plugins.toolbar.hook=function(a){var r=a.element.parentNode;if(r&&/pre/i.test(r.nodeName)&&!r.parentNode.classList.contains("code-toolbar")){var o=document.createElement("div");o.classList.add("code-toolbar"),r.parentNode.insertBefore(o,r),o.appendChild(r);var i=document.createElement("div");i.classList.add("toolbar");var l=e,d=function(e){for(;e;){var t=e.getAttribute("data-toolbar-order");if(null!=t)return(t=t.trim()).length?t.split(/\s*,\s*/g):[];e=e.parentElement}}(a.element);d&&(l=d.map((function(e){return t[e]||n}))),l.forEach((function(e){var t=e(a);if(t){var n=document.createElement("div");n.classList.add("toolbar-item"),n.appendChild(t),i.appendChild(n)}})),o.appendChild(i)}};a("label",(function(e){var t=e.element.parentNode;if(t&&/pre/i.test(t.nodeName)&&t.hasAttribute("data-label")){var n,a,r=t.getAttribute("data-label");try{a=document.querySelector("template#"+r)}catch(e){}return a?n=a.content:(t.hasAttribute("data-url")?(n=document.createElement("a")).href=t.getAttribute("data-url"):n=document.createElement("span"),n.textContent=r),n}})),Prism.hooks.add("complete",r)}}();
diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 5155f0f519..3d1a9280da 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -53,11 +53,17 @@
 }
 
 #content .highlight {
-    background-color: hsl(var(--accent)) !important;
+    background-color: #f6f8fa !important;
     border-radius: 0.25rem;
     font-variant-ligatures: none;
 }
 
+@media (prefers-color-scheme: dark) {
+    #content .highlight {
+        background-color: #161b22 !important;
+    }
+}
+
 /* Disables the saturation filter on project icon in dark mode */
 .dark\:invert {
     --tw-invert: none !important;
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 555ea49dfe..73d195ae1b 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -168,10 +168,16 @@ html_theme_options = asdict(ThemeOptions(
 
 html_permalinks_icon = Icons.permalinks_icon
 
+html_js_files = [
+    'prism.js'
+]
+
 html_css_files = [
     "theme-override.css",
     "luadoc.css",
-    "figures.css"
+    "figures.css",
+    "prism.css",
+    "prism-dark.css",
 ]
 
 # Add any paths that contain custom themes here, relative to this directory.
diff --git a/docs/source/install_luadocumentor_in_docker.sh b/docs/source/install_luadocumentor_in_docker.sh
index 7eb22103db..388ba8b739 100755
--- a/docs/source/install_luadocumentor_in_docker.sh
+++ b/docs/source/install_luadocumentor_in_docker.sh
@@ -33,7 +33,7 @@ PATH=$PATH:~/luarocks/bin
 echo "Install openmwluadocumentor"
 git clone https://gitlab.com/ptmikheev/openmw-luadocumentor.git
 cd openmw-luadocumentor
-git checkout c3252620eb5f6cd740dadfcb374a20b23b36f1fd
+git checkout 122e4f55c5f2dd62076135211e03edfb8dec3a55
 luarocks make luarocks/openmwluadocumentor-0.2.0-1.rockspec
 cd ~
 rm -r openmw-luadocumentor
diff --git a/docs/source/reference/lua-scripting/index_interfaces.rst b/docs/source/reference/lua-scripting/index_interfaces.rst
index 4d9f6e9cff..02a202ed20 100644
--- a/docs/source/reference/lua-scripting/index_interfaces.rst
+++ b/docs/source/reference/lua-scripting/index_interfaces.rst
@@ -12,13 +12,13 @@ Interfaces
     Animation <interface_animation>
     Camera <interface_camera>
     Controls <interface_controls>
+    Crimes <interface_crimes>
     GamepadControls <interface_gamepadcontrols>
     ItemUsage <interface_item_usage>
     MWUI <interface_mwui>
     Settings <interface_settings>
     SkillProgression <interface_skill_progression>
     UI <interface_ui>
-    Crimes <interface_crimes>
 
 **Interfaces of built-in scripts**
 
diff --git a/docs/source/reference/lua-scripting/tables/aux_packages.rst b/docs/source/reference/lua-scripting/tables/aux_packages.rst
index d51949e1b2..202f5219c2 100644
--- a/docs/source/reference/lua-scripting/tables/aux_packages.rst
+++ b/docs/source/reference/lua-scripting/tables/aux_packages.rst
@@ -8,12 +8,12 @@
    * - :doc:`calendar </reference/lua-scripting/openmw_aux_calendar>`
      - |bdg-ctx-all|
      - Game time calendar
-   * - :doc:`util </reference/lua-scripting/openmw_aux_util>`
-     - |bdg-ctx-all|
-     - Miscellaneous utils
    * - :doc:`time </reference/lua-scripting/openmw_aux_time>`
      - |bdg-ctx-all|
      - Timers and game time utils
    * - :doc:`ui </reference/lua-scripting/openmw_aux_ui>`
      - |bdg-ctx-menu| |bdg-ctx-player|
      - User interface utils
+   * - :doc:`util </reference/lua-scripting/openmw_aux_util>`
+     - |bdg-ctx-all|
+     - Miscellaneous utils
diff --git a/docs/source/reference/lua-scripting/tables/interfaces.rst b/docs/source/reference/lua-scripting/tables/interfaces.rst
index bdf8104678..8496d01029 100644
--- a/docs/source/reference/lua-scripting/tables/interfaces.rst
+++ b/docs/source/reference/lua-scripting/tables/interfaces.rst
@@ -8,36 +8,36 @@
   * - :doc:`Activation </reference/lua-scripting/interface_activation>`
     - |bdg-ctx-global|
     - Allows to extend or override built-in activation mechanics.
-  * - :doc:`ItemUsage </reference/lua-scripting/interface_item_usage>`
-    - |bdg-ctx-global|
-    - Allows to extend or override built-in item usage mechanics.
-  * - :doc:`Crimes </reference/lua-scripting/interface_crimes>`
-    - |bdg-ctx-global|
-    - Commit crimes.
   * - :doc:`AI </reference/lua-scripting/interface_ai>`
     - |bdg-ctx-local|
     - Control basic AI of NPCs and creatures.
   * - :doc:`AnimationController </reference/lua-scripting/interface_animation>`
     - |bdg-ctx-local|
     - Control animations of NPCs and creatures.
-  * - :doc:`SkillProgression </reference/lua-scripting/interface_skill_progression>`
-    - |bdg-ctx-local|
-    - Control, extend, and override skill progression of the player.
   * - :doc:`Camera </reference/lua-scripting/interface_camera>`
     - |bdg-ctx-player|
     - Allows to alter behavior of the built-in camera script without overriding the script completely.
   * - :doc:`Controls </reference/lua-scripting/interface_controls>`
     - |bdg-ctx-player|
     - Allows to alter behavior of the built-in script that handles player controls.
+  * - :doc:`Crimes </reference/lua-scripting/interface_crimes>`
+    - |bdg-ctx-global|
+    - Commit crimes.
   * - :doc:`GamepadControls </reference/lua-scripting/interface_gamepadcontrols>`
     - |bdg-ctx-player|
     - Allows to alter behavior of the built-in script that handles player gamepad controls.
-  * - :doc:`UI </reference/lua-scripting/interface_ui>`
-    - |bdg-ctx-player|
-    - High-level UI modes interface. Allows to override parts of the interface.
-  * - :doc:`Settings </reference/lua-scripting/interface_settings>`
-    - |bdg-ctx-global| |bdg-ctx-menu| |bdg-ctx-player| 
-    - Save, display and track changes of setting values.
+  * - :doc:`ItemUsage </reference/lua-scripting/interface_item_usage>`
+    - |bdg-ctx-global|
+    - Allows to extend or override built-in item usage mechanics.
   * - :doc:`MWUI </reference/lua-scripting/interface_mwui>`
     - |bdg-ctx-menu| |bdg-ctx-player|
     - Morrowind-style UI templates.
+  * - :doc:`Settings </reference/lua-scripting/interface_settings>`
+    - |bdg-ctx-global| |bdg-ctx-menu| |bdg-ctx-player| 
+    - Save, display and track changes of setting values.
+  * - :doc:`SkillProgression </reference/lua-scripting/interface_skill_progression>`
+    - |bdg-ctx-local|
+    - Control, extend, and override skill progression of the player.
+  * - :doc:`UI </reference/lua-scripting/interface_ui>`
+    - |bdg-ctx-player|
+    - High-level UI modes interface. Allows to override parts of the interface.
diff --git a/docs/source/reference/lua-scripting/tables/packages.rst b/docs/source/reference/lua-scripting/tables/packages.rst
index 290b7d3507..b39336b3ac 100644
--- a/docs/source/reference/lua-scripting/tables/packages.rst
+++ b/docs/source/reference/lua-scripting/tables/packages.rst
@@ -5,24 +5,51 @@
    * - Package
      - Context
      - Description
-   * - :doc:`core </reference/lua-scripting/openmw_core>`
-     - |bdg-ctx-all|
-     - Functions that are common for both global and local scripts
+   * - :doc:`ambient </reference/lua-scripting/openmw_ambient>`
+     - |bdg-ctx-menu| |bdg-ctx-player|
+     - Controls background sounds for given player.
+   * - :doc:`animation </reference/lua-scripting/openmw_animation>`
+     - |bdg-ctx-local|
+     - Animation controls
    * - :doc:`async </reference/lua-scripting/openmw_async>`
      - |bdg-ctx-all|
      - Timers and callbacks.
-   * - :ref:`interfaces <Script interfaces>`
+   * - :doc:`camera </reference/lua-scripting/openmw_camera>`
+     - |bdg-ctx-player|
+     - Controls camera.
+   * - :doc:`core </reference/lua-scripting/openmw_core>`
      - |bdg-ctx-all|
-     - Public interfaces of other scripts.
+     - Functions that are common for both global and local scripts
+   * - :doc:`debug </reference/lua-scripting/openmw_debug>`
+     - |bdg-ctx-player|
+     - Collection of debug utils.
+   * - :doc:`input </reference/lua-scripting/openmw_input>`
+     - |bdg-ctx-menu| |bdg-ctx-player|
+     - User input.
    * - :doc:`markup </reference/lua-scripting/openmw_markup>`
      - |bdg-ctx-all|
      - API to work with markup languages.
+   * - :doc:`menu </reference/lua-scripting/openmw_menu>`
+     - |bdg-ctx-menu|
+     - Main menu functionality, such as managing game saves
+   * - :doc:`nearby </reference/lua-scripting/openmw_nearby>`
+     - |bdg-ctx-local|
+     - Read-only access to the nearest area of the game world.
+   * - :doc:`postprocessing </reference/lua-scripting/openmw_postprocessing>`
+     - |bdg-ctx-player|
+     - Controls post-process shaders.
+   * - :doc:`self </reference/lua-scripting/openmw_self>`
+     - |bdg-ctx-local|
+     - Full access to the object the script is attached to.
    * - :doc:`storage </reference/lua-scripting/openmw_storage>`
      - |bdg-ctx-all|
      - Storage API. In particular can be used to store data between game sessions.
    * - :doc:`types </reference/lua-scripting/openmw_types>`
      - |bdg-ctx-all|
      - Functions for specific types of game objects.
+   * - :doc:`ui </reference/lua-scripting/openmw_ui>`
+     - |bdg-ctx-menu| |bdg-ctx-player|
+     - Controls :ref:`user interface <UI reference>`.
    * - :doc:`util </reference/lua-scripting/openmw_util>`
      - |bdg-ctx-all|
      - Defines utility functions and classes like 3D vectors, that don't depend on the game world.
@@ -32,33 +59,6 @@
    * - :doc:`world </reference/lua-scripting/openmw_world>`
      - |bdg-ctx-global|
      - Read-write access to the game world.
-   * - :doc:`menu </reference/lua-scripting/openmw_menu>`
-     - |bdg-ctx-menu|
-     - Main menu functionality, such as managing game saves
-   * - :doc:`animation </reference/lua-scripting/openmw_animation>`
-     - |bdg-ctx-local|
-     - Animation controls
-   * - :doc:`nearby </reference/lua-scripting/openmw_nearby>`
-     - |bdg-ctx-local|
-     - Read-only access to the nearest area of the game world.
-   * - :doc:`self </reference/lua-scripting/openmw_self>`
-     - |bdg-ctx-local|
-     - Full access to the object the script is attached to.
-   * - :doc:`camera </reference/lua-scripting/openmw_camera>`
-     - |bdg-ctx-player|
-     - Controls camera.
-   * - :doc:`debug </reference/lua-scripting/openmw_debug>`
-     - |bdg-ctx-player|
-     - Collection of debug utils.
-   * - :doc:`postprocessing </reference/lua-scripting/openmw_postprocessing>`
-     - |bdg-ctx-player|
-     - Controls post-process shaders.
-   * - :doc:`ambient </reference/lua-scripting/openmw_ambient>`
-     - |bdg-ctx-menu| |bdg-ctx-player|
-     - Controls background sounds for given player.
-   * - :doc:`input </reference/lua-scripting/openmw_input>`
-     - |bdg-ctx-menu| |bdg-ctx-player|
-     - User input.
-   * - :doc:`ui </reference/lua-scripting/openmw_ui>`
-     - |bdg-ctx-menu| |bdg-ctx-player|
-     - Controls :ref:`user interface <UI reference>`.
+   * - :ref:`interfaces <Script interfaces>`
+     - |bdg-ctx-all|
+     - Public interfaces of other scripts.

From 320b2cf55e53745e964d4cce3b6cae0305418038 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Fri, 20 Jun 2025 13:00:30 -0700
Subject: [PATCH 34/44] docs - adjust more ordering and add interfaces to
 package table

---
 docs/source/reference/lua-scripting/index_interfaces.rst | 2 +-
 docs/source/reference/lua-scripting/index_packages.rst   | 1 +
 docs/source/reference/lua-scripting/user_interface.rst   | 6 +++---
 3 files changed, 5 insertions(+), 4 deletions(-)

diff --git a/docs/source/reference/lua-scripting/index_interfaces.rst b/docs/source/reference/lua-scripting/index_interfaces.rst
index 02a202ed20..37a2df63c4 100644
--- a/docs/source/reference/lua-scripting/index_interfaces.rst
+++ b/docs/source/reference/lua-scripting/index_interfaces.rst
@@ -9,7 +9,7 @@ Interfaces
 
     Activation <interface_activation>
     AI <interface_ai>
-    Animation <interface_animation>
+    AnimationController <interface_animation>
     Camera <interface_camera>
     Controls <interface_controls>
     Crimes <interface_crimes>
diff --git a/docs/source/reference/lua-scripting/index_packages.rst b/docs/source/reference/lua-scripting/index_packages.rst
index 53a836519f..951b9c1007 100644
--- a/docs/source/reference/lua-scripting/index_packages.rst
+++ b/docs/source/reference/lua-scripting/index_packages.rst
@@ -14,6 +14,7 @@ Packages
     core <openmw_core>
     debug <openmw_debug>
     input <openmw_input>
+    interfaces <openmw_interfaces>
     markup <openmw_markup>
     menu <openmw_menu>
     nearby <openmw_nearby>
diff --git a/docs/source/reference/lua-scripting/user_interface.rst b/docs/source/reference/lua-scripting/user_interface.rst
index 480aa82a93..5be573ee24 100644
--- a/docs/source/reference/lua-scripting/user_interface.rst
+++ b/docs/source/reference/lua-scripting/user_interface.rst
@@ -78,11 +78,11 @@ Events
    :hidden:
 
    Widget <widgets/widget>
+   Container <widgets/container>
+   Flex <widgets/flex>
+   Image <widgets/image>
    Text <widgets/text>
    TextEdit <widgets/textedit>
-   Image <widgets/image>
-   Flex <widgets/flex>
-   Container <widgets/container>
 
 Example
 -------

From 3abc86be736dc8e2e5ad9b0ee073a9e37f18253e Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Fri, 20 Jun 2025 13:05:15 -0700
Subject: [PATCH 35/44] docs - fix interfaces

---
 docs/source/reference/lua-scripting/index_packages.rst  | 1 -
 docs/source/reference/lua-scripting/tables/packages.rst | 6 +++---
 2 files changed, 3 insertions(+), 4 deletions(-)

diff --git a/docs/source/reference/lua-scripting/index_packages.rst b/docs/source/reference/lua-scripting/index_packages.rst
index 951b9c1007..53a836519f 100644
--- a/docs/source/reference/lua-scripting/index_packages.rst
+++ b/docs/source/reference/lua-scripting/index_packages.rst
@@ -14,7 +14,6 @@ Packages
     core <openmw_core>
     debug <openmw_debug>
     input <openmw_input>
-    interfaces <openmw_interfaces>
     markup <openmw_markup>
     menu <openmw_menu>
     nearby <openmw_nearby>
diff --git a/docs/source/reference/lua-scripting/tables/packages.rst b/docs/source/reference/lua-scripting/tables/packages.rst
index b39336b3ac..2485f2c0cd 100644
--- a/docs/source/reference/lua-scripting/tables/packages.rst
+++ b/docs/source/reference/lua-scripting/tables/packages.rst
@@ -26,6 +26,9 @@
    * - :doc:`input </reference/lua-scripting/openmw_input>`
      - |bdg-ctx-menu| |bdg-ctx-player|
      - User input.
+   * - :ref:`interfaces <Script interfaces>`
+     - |bdg-ctx-all|
+     - Public interfaces of other scripts.
    * - :doc:`markup </reference/lua-scripting/openmw_markup>`
      - |bdg-ctx-all|
      - API to work with markup languages.
@@ -59,6 +62,3 @@
    * - :doc:`world </reference/lua-scripting/openmw_world>`
      - |bdg-ctx-global|
      - Read-write access to the game world.
-   * - :ref:`interfaces <Script interfaces>`
-     - |bdg-ctx-all|
-     - Public interfaces of other scripts.

From ac400f0ebc6fb3a0f8948128296fce59774a7391 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Fri, 20 Jun 2025 17:17:13 -0700
Subject: [PATCH 36/44] docs - dropdown toc

---
 docs/source/index.rst                         | 43 +++++++-------
 docs/source/manuals/installation/index.rst    | 13 +++--
 docs/source/manuals/openmw-cs/index.rst       | 36 ++++++------
 docs/source/reference/modding/index.rst       | 42 +++++++-------
 .../reference/modding/settings/index.rst      | 58 ++++++++++---------
 5 files changed, 102 insertions(+), 90 deletions(-)

diff --git a/docs/source/index.rst b/docs/source/index.rst
index 521a91cb5d..6906403e9d 100644
--- a/docs/source/index.rst
+++ b/docs/source/index.rst
@@ -4,28 +4,31 @@ Welcome to OpenMW's Documentation!
 This documentation covers all aspects of OpenMW development, scripting, and content creation.
 Use the categorized sections below to quickly access technical references, modding tools, and installation guides.
 
-.. toctree::
-	:caption: Reference
-   	:titlesonly:
-	:maxdepth: 4
+.. dropdown:: Table of Contents
+    :icon: book
 
-	reference/modding/index
-	reference/postprocessing/index
+    .. toctree::
+        :caption: Reference
+        :titlesonly:
+        :maxdepth: 4
 
-.. toctree::
-	:caption: Lua
-	:titlesonly:
-	:maxdepth: 4
+        reference/modding/index
+        reference/postprocessing/index
 
-	reference/lua-scripting/overview
-	reference/lua-scripting/api
-	reference/lua-scripting/teal
+    .. toctree::
+        :caption: Lua
+        :titlesonly:
+        :maxdepth: 4
 
-.. toctree::
-	:caption: Help
-	:titlesonly:
-	:maxdepth: 4
+        reference/lua-scripting/overview
+        reference/lua-scripting/api
+        reference/lua-scripting/teal
 
-	manuals/installation/index
-	manuals/openmw-cs/index
-	manuals/documentationHowTo
+    .. toctree::
+        :caption: Help
+        :titlesonly:
+        :maxdepth: 4
+
+        manuals/installation/index
+        manuals/openmw-cs/index
+        manuals/documentationHowTo
diff --git a/docs/source/manuals/installation/index.rst b/docs/source/manuals/installation/index.rst
index 6e6f5034ef..c1113603dc 100644
--- a/docs/source/manuals/installation/index.rst
+++ b/docs/source/manuals/installation/index.rst
@@ -4,9 +4,12 @@ Installation Guide
 
 In order to use OpenMW, you must install both the engine and the game files for a compatible game.
 
-.. toctree::
-	:maxdepth: 2
+.. dropdown:: Table of Contents
+    :icon: book
 
-	install-openmw
-	install-game-files
-	common-problems
\ No newline at end of file
+    .. toctree::
+        :maxdepth: 2
+
+        install-openmw
+        install-game-files
+        common-problems
diff --git a/docs/source/manuals/openmw-cs/index.rst b/docs/source/manuals/openmw-cs/index.rst
index 223b4ab028..637f5858b2 100644
--- a/docs/source/manuals/openmw-cs/index.rst
+++ b/docs/source/manuals/openmw-cs/index.rst
@@ -13,21 +13,23 @@ few chapters to familiarise yourself with the new interface.
     Please report any software problems as bugs in the software, not errors in
     the manual.
 
-.. toctree::
-    :hidden:
-    :maxdepth: 2
+.. dropdown:: Table of Contents
+   :icon: book
 
-    foreword
-    tour
-    files-and-directories
-    starting-dialog
-    tables
-    tables-file
-    tables-world
-    tables-mechanics
-    tables-characters
-    tables-assets
-    record-types
-    record-filters
-    cell-view
-    records-drag-and-drop
+   .. toctree::
+       :maxdepth: 2
+
+       foreword
+       tour
+       files-and-directories
+       starting-dialog
+       tables
+       tables-file
+       tables-world
+       tables-mechanics
+       tables-characters
+       tables-assets
+       record-types
+       record-filters
+       cell-view
+       records-drag-and-drop
diff --git a/docs/source/reference/modding/index.rst b/docs/source/reference/modding/index.rst
index d9616f6483..965acd9667 100644
--- a/docs/source/reference/modding/index.rst
+++ b/docs/source/reference/modding/index.rst
@@ -13,24 +13,26 @@ about creating new content for OpenMW, please refer to
 	intended. Please report any software problems as bugs in the software,
 	not errors in the manual.
 
-.. toctree::
-	:hidden:
-	:maxdepth: 2
+.. dropdown:: Table of Contents
+    :icon: book
 
-	foreword
-	differences
-	mod-install
-	openmw-game-template
-	settings/index
-	texture-modding/index
-	custom-models/index
-	font
-	sound-effects
-	music
-	sky-system
-	doors-and-teleports
-	custom-shader-effects
-	extended
-	animation-blending
-	paths
-	localisation
+    .. toctree::
+        :maxdepth: 2
+
+        foreword
+        differences
+        mod-install
+        openmw-game-template
+        settings/index
+        texture-modding/index
+        custom-models/index
+        font
+        sound-effects
+        music
+        sky-system
+        doors-and-teleports
+        custom-shader-effects
+        extended
+        animation-blending
+        paths
+        localisation
diff --git a/docs/source/reference/modding/settings/index.rst b/docs/source/reference/modding/settings/index.rst
index 37ea947368..c1d7b631ee 100644
--- a/docs/source/reference/modding/settings/index.rst
+++ b/docs/source/reference/modding/settings/index.rst
@@ -45,32 +45,34 @@ The ranges included with each setting are the physically possible ranges, not re
 	you may want to steer clear of altering these files. That being said,
 	this guide should be plenty clear enough that you can find the setting you want to change and safely edit it.
 
-.. toctree::
-	:hidden:
-	:maxdepth: 2
+.. dropdown:: Table of Contents
+    :icon: book
 
-	Camera <camera>
-	Cells <cells>
-	Fog <fog>
-	Groundcover <groundcover>
-	Map <map>
-	GUI <GUI>
-	HUD <HUD>
-	Game <game>
-	General <general>
-	Lua <lua>
-	Shaders <shaders>
-	Shadows <shadows>
-	Input <input>
-	Saves <saves>
-	Sound <sound>
-	Terrain <terrain>
-	Video <video>
-	Water <water>
-	Windows <windows>
-	Navigator <navigator>
-	Physics <physics>
-	Models <models>
-	Post-Processing <postprocessing>
-	Stereo <stereo>
-	Stereo View <stereoview>
+    .. toctree::
+        :maxdepth: 2
+
+        Camera <camera>
+        Cells <cells>
+        Fog <fog>
+        Groundcover <groundcover>
+        Map <map>
+        GUI <GUI>
+        HUD <HUD>
+        Game <game>
+        General <general>
+        Lua <lua>
+        Shaders <shaders>
+        Shadows <shadows>
+        Input <input>
+        Saves <saves>
+        Sound <sound>
+        Terrain <terrain>
+        Video <video>
+        Water <water>
+        Windows <windows>
+        Navigator <navigator>
+        Physics <physics>
+        Models <models>
+        Post-Processing <postprocessing>
+        Stereo <stereo>
+        Stereo View <stereoview>

From 74c9da78d3122158e0dc08593b4997a0bf79c743 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Fri, 20 Jun 2025 17:23:03 -0700
Subject: [PATCH 37/44] docs - dropdown toc

---
 .../reference/modding/texture-modding/index.rst     | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)

diff --git a/docs/source/reference/modding/texture-modding/index.rst b/docs/source/reference/modding/texture-modding/index.rst
index a81f8ff7bd..626bfef829 100644
--- a/docs/source/reference/modding/texture-modding/index.rst
+++ b/docs/source/reference/modding/texture-modding/index.rst
@@ -7,9 +7,12 @@ adding and modifying textures is an important part of content creation.
 Therefore, we've included the following in hopes of helping modders transition
 to texture modding in OpenMW.
 
-.. toctree::
-	:caption: Table of Contents
-	:maxdepth: 2
+.. dropdown:: Table of Contents
+	:icon: book
 
-	texture-basics
-	convert-bump-mapped-mods
+	.. toctree::
+		:caption: Table of Contents
+		:maxdepth: 2
+
+		texture-basics
+		convert-bump-mapped-mods

From 8301dafad19d2edbb9f60b06dd2afb9f1291e897 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Sun, 22 Jun 2025 09:31:55 -0700
Subject: [PATCH 38/44] docs - remove ugly blue in dark mode links

---
 docs/source/_static/luadoc.css         | 4 ++++
 docs/source/_static/theme-override.css | 3 +++
 2 files changed, 7 insertions(+)

diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index 83bfdf78b7..a8e1dffc75 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -57,6 +57,10 @@
 #luadoc ul { list-style-type: disc; }
 #luadoc li {list-style: bullet;}
 
+#luadoc .function a:not(.toc-backref) {
+  font-weight: 500;
+}
+
 #content #luadoc dl.function dt:not(.sig):first-child {
   border-bottom: 2px solid hsl(163.24deg 81.3% 74.1% / 30%);
   background-color: hsl(155.69deg 27.84% 54.99% / 12%);
diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 3d1a9280da..6cfa96c0d0 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -30,6 +30,8 @@
 @media (prefers-color-scheme: dark) {
     :root {
         --background: 220 20% 7% !important;
+        --link: #ffffff;
+        --link-hover: #ffffff;
     }
 }
 
@@ -46,6 +48,7 @@
 /* Override link colors, default is foreground */
 #content a:not(.toc-backref) {
     color: var(--link);
+    font-weight: 600;
 }
 
 #content a:not(.toc-backref):hover, #content a:not(.toc-backref):focus {

From ce8f81a6a7f916178f38640afc977090a7490866 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Sun, 22 Jun 2025 09:54:11 -0700
Subject: [PATCH 39/44] docs - less blue dark

---
 docs/source/_static/luadoc.css         | 8 ++++----
 docs/source/_static/theme-override.css | 8 +++++++-
 2 files changed, 11 insertions(+), 5 deletions(-)

diff --git a/docs/source/_static/luadoc.css b/docs/source/_static/luadoc.css
index a8e1dffc75..b2efec85b4 100644
--- a/docs/source/_static/luadoc.css
+++ b/docs/source/_static/luadoc.css
@@ -62,8 +62,8 @@
 }
 
 #content #luadoc dl.function dt:not(.sig):first-child {
-  border-bottom: 2px solid hsl(163.24deg 81.3% 74.1% / 30%);
-  background-color: hsl(155.69deg 27.84% 54.99% / 12%);
+  border-bottom: 2px solid hsl(var(--muted)  / 50%);
+  background-color: hsl(var(--muted));
   padding: 6px;
 }
 
@@ -73,8 +73,8 @@
 
 @media (prefers-color-scheme: dark) {
   #content #luadoc dl.function dt:not(.sig):first-child {
-      border-bottom: 2px solid hsl(163.24deg 81.3% 74.1% / 20%);
-      background-color: hsl(155.69deg 27.84% 54.99% / 8%);
+      border-bottom: 2px solid hsl(var(--accent)  / 50%);
+      background-color: hsl(var(--accent));
   }
 }
 
diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 6cfa96c0d0..9a1f103240 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -29,7 +29,13 @@
 /* Less aggressive dark background */
 @media (prefers-color-scheme: dark) {
     :root {
-        --background: 220 20% 7% !important;
+        /* These were not overriding without important when deploying to RTD */
+        --background: 220 14% 9% !important;
+        --border: 216 14% 17% !important;
+        --accent: 216 14% 17% !important;
+        --input: 216 14% 17% !important;
+        --muted: 223 27% 14% !important;
+
         --link: #ffffff;
         --link-hover: #ffffff;
     }

From 937f2bd4418e497bb4a30e7f30475b0ea2e08c93 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Sun, 22 Jun 2025 15:56:16 -0700
Subject: [PATCH 40/44] docs - sphinx card colors

---
 docs/source/_static/theme-override.css | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index 9a1f103240..fa1e8ddb79 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -29,21 +29,25 @@
 /* Less aggressive dark background */
 @media (prefers-color-scheme: dark) {
     :root {
-        /* These were not overriding without important when deploying to RTD */
         --background: 220 14% 9% !important;
-        --border: 216 14% 17% !important;
-        --accent: 216 14% 17% !important;
-        --input: 216 14% 17% !important;
-        --muted: 223 27% 14% !important;
+        --border: 216 14% 17%;
+        --accent: 216 14% 17%;
+        --input: 216 14% 17%;
+        --muted: 223 27% 14%;
+        --card: 220 14% 9%;
 
         --link: #ffffff;
         --link-hover: #ffffff;
     }
+
+    .contents ul li a.reference:hover, .sd-dropdown .toctree-wrapper ul li a.reference, details.sd-dropdown .sd-summary-title {
+        --muted-foreground: 215.4 16.3% 86.9%;
+    }
 }
 
 /* Enable hover-to-highlight in TOC */
 .contents ul li a.reference:hover, .toctree-wrapper ul li a.reference:hover {
-    color: hsl(var(--foreground)) !important;
+    text-decoration: underline !important;
 }
 
 /* Hide text underline in tables since the underlines clash with table lines */

From 759cea3051ae934d8a151e24455644f0d636499c Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Mon, 23 Jun 2025 17:39:01 -0700
Subject: [PATCH 41/44] docs - advanced settings

---
 docs/source/_ext/omw-directives.py            |   76 ++
 docs/source/_static/omw-directives.css        |   21 +
 docs/source/_static/theme-override.css        |    8 +-
 docs/source/conf.py                           |    2 +
 .../source/reference/modding/settings/GUI.rst |  410 +++----
 .../source/reference/modding/settings/HUD.rst |   23 +-
 .../reference/modding/settings/camera.rst     |  194 ++-
 .../reference/modding/settings/cells.rst      |  286 ++---
 .../source/reference/modding/settings/fog.rst |  264 ++--
 .../reference/modding/settings/game.rst       | 1059 ++++++++---------
 .../reference/modding/settings/general.rst    |  192 ++-
 .../modding/settings/groundcover.rst          |  153 ++-
 .../reference/modding/settings/index.rst      |   22 +-
 .../reference/modding/settings/input.rst      |  388 +++---
 .../source/reference/modding/settings/lua.rst |  138 +--
 .../source/reference/modding/settings/map.rst |  148 +--
 .../reference/modding/settings/models.rst     |  336 ++----
 .../reference/modding/settings/navigator.rst  |  639 ++++------
 .../reference/modding/settings/physics.rst    |   43 +-
 .../modding/settings/postprocessing.rst       |   82 +-
 .../reference/modding/settings/saves.rst      |   49 +-
 .../reference/modding/settings/shaders.rst    |  560 ++++-----
 .../reference/modding/settings/shadows.rst    |  436 +++----
 .../reference/modding/settings/sound.rst      |  205 ++--
 .../reference/modding/settings/stereo.rst     |   90 +-
 .../reference/modding/settings/stereoview.rst |  334 +++---
 .../reference/modding/settings/terrain.rst    |  333 +++---
 .../reference/modding/settings/video.rst      |  312 +++--
 .../reference/modding/settings/water.rst      |  252 ++--
 .../reference/modding/settings/windows.rst    |  823 +++++++++----
 30 files changed, 3753 insertions(+), 4125 deletions(-)
 create mode 100644 docs/source/_ext/omw-directives.py
 create mode 100644 docs/source/_static/omw-directives.css

diff --git a/docs/source/_ext/omw-directives.py b/docs/source/_ext/omw-directives.py
new file mode 100644
index 0000000000..245c84ad7a
--- /dev/null
+++ b/docs/source/_ext/omw-directives.py
@@ -0,0 +1,76 @@
+from docutils import nodes
+from docutils.parsers.rst import Directive, directives
+
+class OMWSettingDirective(Directive):
+    has_content = True
+    option_spec = {
+        'title': directives.unchanged_required,
+        'type': directives.unchanged_required,
+        'range': directives.unchanged,
+        'default': directives.unchanged,
+        'location': directives.unchanged,
+    }
+
+    badge_map = {
+        'float32': 'bdg-secondary', 'float64': 'bdg-muted',
+        'int': 'bdg-primary', 'uint': 'bdg-light',
+        'string': 'bdg-success', 'boolean': 'bdg-warning',
+        'color': 'bdg-info',
+    }
+
+    def run(self):
+        opts = self.options
+        title = opts['title']
+        type_tags = opts['type'].split('|')
+        badges = ' '.join(f':{self.badge_map.get(t)}:`{t}`' for t in type_tags)
+
+        values = [
+            badges,
+            opts.get('range', ''),
+            opts.get('default', ''),
+            opts.get('location', ':bdg-danger:`user settings.cfg`')
+        ]
+
+        table = nodes.table(classes=['omw-setting'])
+        tgroup = nodes.tgroup(cols=4)
+        table += tgroup
+        for _ in range(4):
+            tgroup += nodes.colspec(colwidth=20)
+
+        thead = nodes.thead()
+        tgroup += thead
+        thead += nodes.row('', *[
+            nodes.entry('', nodes.paragraph(text=label))
+            for label in ['Type', 'Range', 'Default', 'Location']
+        ])
+
+        tbody = nodes.tbody()
+        tgroup += tbody
+        row = nodes.row()
+
+        for i, val in enumerate(values):
+            entry = nodes.entry()
+            inline, _ = self.state.inline_text(val, self.lineno)
+            if i == 2 and 'color' in type_tags:
+                rgba = [float(c) for c in opts['default'].split()]
+                style = f'background-color:rgba({rgba[0]*255}, {rgba[1]*255}, {rgba[2]*255}, {rgba[3]})'
+                chip = nodes.raw('', f'<span class="color-chip" style="{style}"></span>', format='html')
+                wrapper = nodes.container(classes=['type-color-wrapper'], children=[chip] + inline)
+                entry += wrapper
+            else:
+                entry += inline
+            row += entry
+        tbody += row
+
+        desc = nodes.paragraph()
+        self.state.nested_parse(self.content, self.content_offset, desc)
+
+        section = nodes.section(ids=[nodes.make_id(title)])
+        section += nodes.title(text=title)
+        section += table
+        section += desc
+        return [section]
+
+def setup(app):
+    app.add_css_file("omw-directives.css")
+    app.add_directive("omw-setting", OMWSettingDirective)
diff --git a/docs/source/_static/omw-directives.css b/docs/source/_static/omw-directives.css
new file mode 100644
index 0000000000..38f6218025
--- /dev/null
+++ b/docs/source/_static/omw-directives.css
@@ -0,0 +1,21 @@
+.omw-setting td:nth-child(1) { width: 20%; }
+.omw-setting td:nth-child(2) { width: 20%; }
+.omw-setting td:nth-child(3) { width: 20%; }
+.omw-setting td:nth-child(4) { width: 20%; }
+
+.omw-setting .type-color-wrapper {
+    display: flex;
+    flex-direction: row;
+    align-items: center;
+    justify-content: left;
+    padding: 0;
+    gap: 12px;
+}
+
+.color-chip {
+    display: inline-block;
+    width: 1.5em;
+    height: 1.5em;
+    border-radius: 0.2em;
+    border: 1px solid #333;
+}
diff --git a/docs/source/_static/theme-override.css b/docs/source/_static/theme-override.css
index fa1e8ddb79..e41ab2c2d6 100644
--- a/docs/source/_static/theme-override.css
+++ b/docs/source/_static/theme-override.css
@@ -113,18 +113,18 @@ tbody tr:hover {
     }
 }
 
-/* Less intrusive scrollbar in left section TOC */
-#left-sidebar::-webkit-scrollbar {
+/* Less intrusive scrollbar in the TOC */
+#left-sidebar::-webkit-scrollbar, #right-sidebar .sticky::-webkit-scrollbar {
     width: 6px;
     border-radius: 0;
 }
 
-#left-sidebar::-webkit-scrollbar-thumb {
+#left-sidebar::-webkit-scrollbar-thumb, #right-sidebar .sticky::-webkit-scrollbar-thumb {
     background-color: hsl(var(--border));;
     border-radius: 0;
 }
 
-#left-sidebar::-webkit-scrollbar-thumb:hover {
+#left-sidebar::-webkit-scrollbar-thumb:hover, #right-sidebar .sticky::-webkit-scrollbar-thumb:hover {
     background-color: hsl(var(--muted));;
 }
 
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 73d195ae1b..aaa42e3678 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -25,6 +25,7 @@ from sphinxawesome_theme.postprocess import Icons
 # documentation root, use os.path.abspath to make it absolute, like shown here.
 project_root = os.path.abspath('../../')
 sys.path.insert(0, project_root)
+sys.path.append(os.path.abspath("_ext"))
 
 # -- General configuration ------------------------------------------------
 
@@ -42,6 +43,7 @@ extensions = [
     'sphinx.ext.viewcode',
     'sphinx.ext.autosectionlabel',
     'sphinx_design',
+    'omw-directives'
 ]
 
 #autosectionlabel_prefix_document = True
diff --git a/docs/source/reference/modding/settings/GUI.rst b/docs/source/reference/modding/settings/GUI.rst
index 8a27ed2c01..b9065c8daf 100644
--- a/docs/source/reference/modding/settings/GUI.rst
+++ b/docs/source/reference/modding/settings/GUI.rst
@@ -1,232 +1,184 @@
 GUI Settings
 ############
 
-scaling factor
---------------
-
-:Type:		floating point
-:Range:		0.5 to 8.0
-:Default:	1.0
-
-This setting scales GUI windows.
-A value of 1.0 results in the normal scale. Larger values are useful to increase the scale of the GUI for high resolution displays.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-font size
----------
-
-:Type:		integer
-:Range:		12 to 18
-:Default:	16
-
-Allows to specify glyph size for in-game fonts.
-Note: default bitmap fonts are supposed to work with 16px size, otherwise glyphs will be blurry.
-TrueType fonts do not have this issue.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-menu transparency
------------------
-
-:Type:		floating point
-:Range:		0.0 (transparent) to 1.0 (opaque)
-:Default:	0.84
-
-This setting controls the transparency of the GUI windows.
-This setting can be adjusted in game with the Menu Transparency slider in the Prefs panel of the Options menu.
-
-tooltip delay
--------------
-
-:Type:		floating point
-:Range:		>= 0.0
-:Default:	0.0
-
-This value determines the number of seconds between when you begin hovering over an item and when its tooltip appears.
-This setting only affects the tooltip delay for objects under the crosshair in GUI mode windows.
-
-The tooltip displays context sensitive information on the selected GUI element,
-such as weight, value, damage, armor rating, magical effects, and detailed description.
-
-This setting can be adjusted between 0.0 and 1.0 in game
-with the Menu Help Delay slider in the Prefs panel of the Options menu.
-
-keyboard navigation
--------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-Enable or disable keyboard navigation, such as arrow keys and tab moving UI focus, spacebar and Use keys pressing buttons.
-
-stretch menu background
------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Stretch or shrink the main menu screen, loading splash screens, introductory movie,
-and cut scenes to fill the specified video resolution, distorting their aspect ratio.
-The Bethesda provided assets have a 4:3 aspect ratio, but other assets are permitted to have other aspect ratios.
-If this setting is false, the assets will be centered in the mentioned 4:3 aspect ratio,
-with black bars filling the remainder of the screen.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-subtitles
----------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Enable or disable subtitles for NPC spoken dialog (and some sound effects).
-Subtitles will appear in a tool tip box in the lower center of the screen.
-
-This setting can be toggled in game with the Subtitles button in the Prefs panel of Options menu.
-
-hit fader
----------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-This setting enables or disables the "red flash" overlay that provides a visual clue when the character has taken damage.
-
-If this setting is disabled, the player will "bleed" like NPCs do.
-
-This setting can only be configured by editing the settings configuration file.
-
-werewolf overlay
-----------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-Enable or disable the werewolf visual effect in first-person mode.
-
-This setting can only be configured by editing the settings configuration file.
-
-color background owned
-----------------------
-
-:Type:		RGBA floating point
-:Range:		0.0 to 1.0
-:Default:	0.15 0.0 0.0 1.0 (dark red)
-
-The following two settings determine the background color of the tool tip and the crosshair
-when hovering over an item owned by an NPC.
-The color definitions are composed of four floating point values between 0.0 and 1.0 inclusive,
-representing the red, green, blue and alpha channels. The alpha value is currently ignored.
-The crosshair color will have no effect if the crosshair setting in the HUD section is disabled.
-
-This setting can only be configured by editing the settings configuration file.
-This setting has no effect if the show owned setting in the Game Settings Section is false.
-
-color crosshair owned
----------------------
-
-:Type:		RGBA floating point
-:Range:		0.0 to 1.0
-:Default:	1.0 0.15 0.15 1.0 (bright red)
-
-This setting sets the color of the crosshair when hovering over an item owned by an NPC.
-The value is composed of four floating point values representing the red, green, blue and alpha channels.
-The alpha value is currently ignored.
-
-This setting can only be configured by editing the settings configuration file.
-This setting has no effect if the crosshair setting in the HUD Settings Section is false.
-This setting has no effect if the show owned setting in the Game Settings Section is false.
-
-color topic enable
-------------------
-
-:Type:      boolean
-:Range:		True/False
-:Default:	False
-
-This setting controls whether the topics available in the dialogue topic list are coloured according to their state.
-See 'color topic specific' and 'color topic exhausted' for details.
-
-color topic specific
---------------------
-
-:Type:		RGBA floating point
-:Range:		0.0 to 1.0 for each channel
-:Default:	0.45 0.5 0.8 1 (blue)
-
-This setting overrides the colour of dialogue topics that have a response unique to the actors speaking.
-The value is composed of four floating point values representing the red, green, blue and alpha channels.
-The alpha value is currently ignored.
-
-A topic response is considered unique if its Actor filter field contains the speaking actor's object ID and hasn't yet been read.
-
-color topic specific over
--------------------------
-
-:Type:		RGBA floating point
-:Range:		0.0 to 1.0 for each channel
-:Default:	0.6 0.6 0.85 1 (blue)
-
-This setting provides an "over" colour to dialogue topics that meet the color topic specific criteria.
-The value is composed of four floating point values representing the red, green, blue and alpha channels.
-The alpha value is currently ignored.
-
-A dialogue topic is considered "over" if it is the active GUI element through keyboard or mouse events.
-
-color topic specific pressed
-----------------------------
-
-:Type:		RGBA floating point
-:Range:		0.0 to 1.0 for each channel
-:Default:	0.3 0.35 0.75 1 (blue)
-
-This setting provides an "pressed" colour to dialogue topics that meet the color topic specific criteria.
-The value is composed of four floating point values representing the red, green, blue and alpha channels.
-The alpha value is currently ignored.
-
-A dialogue topic is considered "pressed" if it is the active GUI element and it receives a sustained keyboard or mouse event.
-
-color topic exhausted
----------------------
-
-:Type:		RGBA floating point
-:Range:		0.0 to 1.0 for each channel
-:Default:	0.3 0.3 0.3 1 (grey)
-
-This setting overrides the colour of dialogue topics which have been "exhausted" by the player.
-The value is composed of four floating point values representing the red, green, blue and alpha channels.
-The alpha value is currently ignored.
-
-A topic is considered "exhausted" if the response the player is about to see has already been seen.
-
-color topic exhausted over
---------------------------
-
-:Type:		RGBA floating point
-:Range:		0.0 to 1.0 for each channel
-:Default:	0.55 0.55 0.55 1 (grey)
-
-This setting provides an "over" colour to dialogue topics that meet the color topic exhausted criteria.
-The value is composed of four floating point values representing the red, green, blue and alpha channels.
-The alpha value is currently ignored.
-
-A dialogue topic is considered "over" if it is the active GUI element through keyboard or mouse events.
-
-color topic exhausted pressed
------------------------------
-
-:Type:		RGBA floating point
-:Range:		0.0 to 1.0 for each channel
-:Default:	0.45 0.45 0.45 1 (grey)
-
-This setting provides a "pressed" colour to dialogue topics that meet the color topic exhausted criteria.
-The value is composed of four floating point values representing the red, green, blue and alpha channels.
-The alpha value is currently ignored.
-
-A dialogue topic is considered "pressed" if it is the active GUI element and it receives a sustained keyboard or mouse event.
+.. omw-setting::
+   :title: scaling factor
+   :type: float32
+   :range: 0.5 to 8.0
+   :default: 1.0
+   :location: :bdg-success:`Launcher > Settings > Interface`
+
+   This setting scales GUI windows.
+   A value of 1.0 results in normal scale.
+   Larger values increase GUI scale for high resolution displays.
+
+.. omw-setting::
+   :title: font size
+   :type: int
+   :range: 12 to 18
+   :default: 16
+   :location: :bdg-success:`Launcher > Settings > Interface`
+
+   Specifies glyph size for in-game fonts.
+   Default bitmap fonts work best at 16px; others may be blurry.
+   trueType fonts do not have this issue.
+
+.. omw-setting::
+   :title: menu transparency
+   :type: float32
+   :range: 0.0 (transparent) to 1.0 (opaque)
+   :default: 0.84
+
+   Controls transparency of GUI windows.
+   Adjustable in game via Menu Transparency slider in the Prefs panel of Options.
+
+.. omw-setting::
+   :title: tooltip delay
+   :type: float32
+   :range: ≥ 0.0
+   :default: 0.0
+
+   Seconds delay before tooltip appears when hovering over an item in GUI mode.
+   Tooltips show context-sensitive info (weight, value, damage, etc.).
+   Adjustable in game with Menu Help Delay slider in Prefs panel.
+
+.. omw-setting::
+   :title: keyboard navigation
+   :type: boolean
+   :range: true, false
+   :default: true
+
+   Enable or disable keyboard navigation (arrow keys, tab focus, spacebar, Use key).
+
+.. omw-setting::
+   :title: stretch menu background
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Interface`
+
+   Stretch or shrink main menu, splash screens, intro movies, and cut scenes
+   to fill the video resolution, possibly distorting aspect ratio.
+   Bethesda assets are 4:3 ratio; others may differ.
+   If false, assets are centered with black bars filling remainder.
+
+.. omw-setting::
+   :title: subtitles
+   :type: boolean
+   :range: true, false
+   :default: false
+
+   Enable or disable subtitles for NPC dialog and some sound effects.
+   Subtitles appear in a tooltip box at screen lower center.
+   Toggleable in game with Subtitles button in Prefs panel.
+
+.. omw-setting::
+   :title: hit fader
+   :type: boolean
+   :range: true, false
+   :default: true
+   
+
+   Enables or disables the red flash overlay when the character takes damage.
+   Disabling causes the player to "bleed" like NPCs.
+
+.. omw-setting::
+   :title: werewolf overlay
+   :type: boolean
+   :range: true, false
+   :default: true
+   
+
+   Enable or disable the werewolf visual effect in first-person mode.
+
+.. omw-setting::
+   :title: color background owned
+   :type: color
+   :range: [0, 1]
+   :default: 0.15 0.0 0.0 1.0
+   
+
+   Background color of tooltip and crosshair when hovering over an NPC-owned item.
+   Four floating point values: red, green, blue, alpha (alpha ignored).
+   No effect if "show owned" in Game Settings is false.
+
+.. omw-setting::
+   :title: color crosshair owned
+   :type: color
+   :range: [0, 1]
+   :default: 1.0 0.15 0.15 1.0
+   
+
+   Crosshair color when hovering over an NPC-owned item.
+   Four floating point values: red, green, blue, alpha (alpha ignored).
+   No effect if crosshair setting in HUD is false or "show owned" in Game Settings is false.
+
+.. omw-setting::
+   :title: color topic enable
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Interface`
+
+   Controls whether dialogue topics in the list are colored by their state.
+   See related "color topic specific" and "color topic exhausted".
+
+.. omw-setting::
+   :title: color topic specific
+   :type: color
+   :range: [0, 1]
+   :default: 0.45 0.5 0.8 1
+
+   Overrides color of dialogue topics with unique actor responses.
+   Four floating point values: red, green, blue, alpha (alpha ignored).
+   Unique if Actor filter matches speaking actor and not read yet.
+
+.. omw-setting::
+   :title: color topic specific over
+   :type: color
+   :range: [0, 1]
+   :default: 0.6 0.6 0.85 1
+
+   "Over" color for dialogue topics meeting "color topic specific" criteria.
+   Four floating point values; alpha ignored.
+   Active GUI element via keyboard or mouse events.
+
+.. omw-setting::
+   :title: color topic specific pressed
+   :type: color
+   :range: [0, 1]
+   :default: 0.3 0.35 0.75 1
+
+   "Pressed" color for dialogue topics meeting "color topic specific".
+   Four floating point values; alpha ignored.
+   Active GUI element receiving sustained input.
+
+.. omw-setting::
+   :title: color topic exhausted
+   :type: color
+   :range: [0, 1]
+   :default: 0.3 0.3 0.3 1
+
+   Overrides color of dialogue topics exhausted by the player.
+   Four floating point values; alpha ignored.
+   Exhausted if response has been seen.
+
+.. omw-setting::
+   :title: color topic exhausted over
+   :type: color
+   :range: [0, 1]
+   :default: 0.55 0.55 0.55 1
+
+   "Over" color for dialogue topics meeting "color topic exhausted".
+   Four floating point values; alpha ignored.
+   Active GUI element via keyboard or mouse.
+
+.. omw-setting::
+   :title: color topic exhausted pressed
+   :type: color
+   :range: [0, 1]
+   :default: 0.45 0.45 0.45 1
+
+   "Pressed" color for dialogue topics meeting "color topic exhausted".
+   Four floating point values; alpha ignored.
+   Active GUI element receiving sustained input.
diff --git a/docs/source/reference/modding/settings/HUD.rst b/docs/source/reference/modding/settings/HUD.rst
index 07a3135c8d..55fcc62e28 100644
--- a/docs/source/reference/modding/settings/HUD.rst
+++ b/docs/source/reference/modding/settings/HUD.rst
@@ -1,18 +1,15 @@
 HUD Settings
 ############
 
-crosshair
----------
+.. omw-setting::
+   :title: crosshair
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-info:`In Game > Options > Video`
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   Determines whether the crosshair or reticle is displayed.
+   Enabling provides immediate feedback about the focused object.
+   Disabling may improve immersion or be preferred for screenshots.
 
-This setting determines whether the crosshair or reticle is displayed. 
-Enabling the crosshair provides more immediate feedback about which object is currently the focus of actions.
-Some players perceive that disabling the crosshair provides a more immersive experience.
-Another common use is to disable the crosshair for screen shots.
-
-As an alternative to this setting, the complete GUI, including the crosshair, may be toggled at runtime with the F11 key.
-
-This setting can be toggled with the Crosshair button in the Prefs panel of the Options menu.
+   The complete GUI, including crosshair, can be toggled at runtime with F11.
diff --git a/docs/source/reference/modding/settings/camera.rst b/docs/source/reference/modding/settings/camera.rst
index 5011885919..c0d26a0dfb 100644
--- a/docs/source/reference/modding/settings/camera.rst
+++ b/docs/source/reference/modding/settings/camera.rst
@@ -4,125 +4,115 @@ Camera Settings
 .. note::
     Some camera settings are available only in the in-game settings menu. See the tab "Scripts/OpenMW Camera".
 
-near clip
----------
+.. omw-setting::
+   :title: near clip
+   :type: float32
+   :range: ≥ 0.005
+   :default: 1
+   
 
-:Type:		floating point
-:Range:		>= 0.005
-:Default:	1.0
+   This setting controls the distance to the near clipping plane. The value must be greater than zero.
+   Values greater than approximately 18.0 will occasionally clip objects in the world in front of the character.
+   Values greater than approximately 8.0 will clip the character's hands in first person view
+   and/or the back of their head in third person view.
 
-This setting controls the distance to the near clipping plane. The value must be greater than zero.
-Values greater than approximately 18.0 will occasionally clip objects in the world in front of the character.
-Values greater than approximately 8.0 will clip the character's hands in first person view
-and/or the back of their head in third person view.
+.. omw-setting::
+   :title: small feature culling
+   :type: boolean
+   :range: true, false
+   :default: true
+   
 
-This setting can only be configured by editing the settings configuration file.
+   This setting determines whether objects that render to a few pixels or smaller will be culled (not drawn).
+   It generally improves performance to enable this feature,
+   and by definition the culled objects will be very small on screen.
+   The size in pixels for an object to be considered 'small' is controlled by a separate setting.
 
-small feature culling
----------------------
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+.. omw-setting::
+   :title: small feature culling pixel size
+   :type: float32
+   :range: > 0
+   :default: 2
+   
 
-This setting determines whether objects that render to a few pixels or smaller will be culled (not drawn).
-It generally improves performance to enable this feature,
-and by definition the culled objects will be very small on screen.
-The size in pixels for an object to be considered 'small' is controlled by a separate setting.
+   Controls the cutoff in pixels for the 'small feature culling' setting,
+   which will have no effect if 'small feature culling' is disabled.
 
-This setting can only be configured by editing the settings configuration file.
+.. omw-setting::
+   :title: viewing distance
+   :type: float32
+   :range: ≥ 0
+   :default: 7168
+   :location: :bdg-success:`Launcher > Settings > Visuals > Terrain` :bdg-info:`In Game > Options > Detail`
 
-small feature culling pixel size
---------------------------------
+   This value controls the maximum visible distance (also called the far clipping plane).
+   Larger values significantly improve rendering in exterior spaces,
+   but also increase the amount of rendered geometry and significantly reduce the frame rate.
+   Note that when cells are visible before loading, the geometry will "pop-in" suddenly,
+   creating a jarring visual effect. To prevent this effect, this value should not be greater than:
 
-:Type:		floating point
-:Range:		> 0
-:Default:	2.0
+   .. math::
 
-Controls the cutoff in pixels for the 'small feature culling' setting,
-which will have no effect if 'small feature culling' is disabled.
+   	\text{CellSizeInUnits} \times \text{CellGridRadius} - 1024
 
-This setting can only be configured by editing the settings configuration file.
+   The CellSizeInUnits is the size of a game cell in units (8192 by default), CellGridRadius determines how many
+   neighboring cells to current one to load (1 by default - 3x3 grid), and 1024 is the threshold distance for loading a new cell.
+   The field of view setting also interacts with this setting because the view frustum end is a plane,
+   so you can see further at the edges of the screen than you should be able to.
+   This can be observed in game by looking at distant objects
+   and rotating the camera so the objects are near the edge of the screen.
+   As a result, this distance is recommended to further be reduced to avoid pop-in for wide fields of view
+   and long viewing distances near the edges of the screen if distant terrain and object paging are not used.
 
-viewing distance
-----------------
+   Reductions of up to 25% or more can be required to completely eliminate this pop-in.
+   Such situations are unusual and probably not worth the performance penalty introduced
+   by loading geometry obscured by fog in the center of the screen.
+   See RenderingManager::configureFog for the relevant source code.
 
-:Type:		floating point
-:Range:		> 0
-:Default:	7168.0
+   This setting can be adjusted in game from the ridiculously low value of 2500 units to a maximum of 7168 units
+   using the View Distance slider in the Detail tab of the Video panel of the Options menu, unless distant terrain is enabled,
+   in which case the maximum is increased to 81920 units.
 
-This value controls the maximum visible distance (also called the far clipping plane).
-Larger values significantly improve rendering in exterior spaces,
-but also increase the amount of rendered geometry and significantly reduce the frame rate.
-Note that when cells are visible before loading, the geometry will "pop-in" suddenly,
-creating a jarring visual effect. To prevent this effect, this value should not be greater than:
+.. omw-setting::
+   :title: field of view
+   :type: float32
+   :range: [1,179]
+   :default: 60
+   :location: :bdg-info:`In Game > Options > Video`
 
-	CellSizeInUnits * CellGridRadius - 1024
+   Sets the camera field of view in degrees. Recommended values range from 30 degrees to 110 degrees.
+   Small values provide a very narrow field of view that creates a "zoomed in" effect,
+   while large values cause distortion at the edges of the screen.
+   The "field of view" setting interacts with aspect ratio of your video resolution in that more square aspect ratios
+   (e.g. 4:3) need a wider field of view to more resemble the same field of view on a widescreen (e.g. 16:9) monitor.
 
-The CellSizeInUnits is the size of a game cell in units (8192 by default), CellGridRadius determines how many
-neighboring cells to current one to load (1 by default - 3x3 grid), and 1024 is the threshold distance for loading a new cell.
-The field of view setting also interacts with this setting because the view frustum end is a plane,
-so you can see further at the edges of the screen than you should be able to.
-This can be observed in game by looking at distant objects
-and rotating the camera so the objects are near the edge of the screen.
-As a result, this distance is recommended to further be reduced to avoid pop-in for wide fields of view
-and long viewing distances near the edges of the screen if distant terrain and object paging are not used.
+.. omw-setting::
+   :title: first person field of view
+   :type: float32
+   :range: [1,179]
+   :default: 60
+   
 
-Reductions of up to 25% or more can be required to completely eliminate this pop-in.
-Such situations are unusual and probably not worth the performance penalty introduced
-by loading geometry obscured by fog in the center of the screen.
-See RenderingManager::configureFog for the relevant source code.
+   This setting controls the field of view for first person meshes such as the player's hands and held objects.
+   It is not recommended to change this value from its default value
+   because the Bethesda provided Morrowind assets do not adapt well to large values,
+   while small values can result in the hands not being visible.
 
-This setting can be adjusted in game from the ridiculously low value of 2500 units to a maximum of 7168 units
-using the View Distance slider in the Detail tab of the Video panel of the Options menu, unless distant terrain is enabled,
-in which case the maximum is increased to 81920 units.
+.. omw-setting::
+   :title: reverse z
+   :type: boolean
+   :range: true, false
+   :default: true
+   
 
-field of view
--------------
-
-:Type:		floating point
-:Range:		1-179
-:Default:	55.0
-
-Sets the camera field of view in degrees. Recommended values range from 30 degrees to 110 degrees.
-Small values provide a very narrow field of view that creates a "zoomed in" effect,
-while large values cause distortion at the edges of the screen.
-The "field of view" setting interacts with aspect ratio of your video resolution in that more square aspect ratios
-(e.g. 4:3) need a wider field of view to more resemble the same field of view on a widescreen (e.g. 16:9) monitor.
-
-This setting can be changed in game using the Field of View slider from the Video tab of the Video panel of the Options menu.
-
-first person field of view
---------------------------
-
-:Type:		floating point
-:Range:		1-179
-:Default:	55.0
-
-This setting controls the field of view for first person meshes such as the player's hands and held objects.
-It is not recommended to change this value from its default value
-because the Bethesda provided Morrowind assets do not adapt well to large values,
-while small values can result in the hands not being visible.
-
-This setting can only be configured by editing the settings configuration file.
-
-reverse z
----------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-Enables a reverse-z depth buffer in which the depth range is reversed. This
-allows for small :ref:`near clip` values and removes almost all z-fighting with
-terrain and even tightly coupled meshes at extreme view distances. For this to
-be useful, a floating point depth buffer is required. These features require
-driver and hardware support, but should work on any semi-modern desktop hardware
-through OpenGL extensions. The exception is macOS, which has since dropped
-development of OpenGL drivers. If unsupported, this setting has no effect.
-
-Note, this will force OpenMW to use shaders as if :ref:`force shaders` was enabled.
-The performance impact of this feature should be negligible.
-
-This setting can only be configured by editing the settings configuration file.
+   Enables a reverse-z depth buffer in which the depth range is reversed. This
+   allows for small :ref:`near clip` values and removes almost all z-fighting with
+   terrain and even tightly coupled meshes at extreme view distances. For this to
+   be useful, a floating point depth buffer is required. These features require
+   driver and hardware support, but should work on any semi-modern desktop hardware
+   through OpenGL extensions. The exception is macOS, which has since dropped
+   development of OpenGL drivers. If unsupported, this setting has no effect.
 
+   Note, this will force OpenMW to use shaders as if :ref:`force shaders` was enabled.
+   The performance impact of this feature should be negligible.
diff --git a/docs/source/reference/modding/settings/cells.rst b/docs/source/reference/modding/settings/cells.rst
index 7bdf40681c..4581918fd6 100644
--- a/docs/source/reference/modding/settings/cells.rst
+++ b/docs/source/reference/modding/settings/cells.rst
@@ -1,180 +1,180 @@
 Cells Settings
 ##############
 
-preload enabled
----------------
+.. omw-setting::
+   :title: preload enabled
+   :type: boolean
+   :range: true, false
+   :default: true
+   
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   Controls whether textures and objects will be pre-loaded in background threads.
+   This setting being enabled should result in a reduced amount of loading screens, no impact on frame rate,
+   and a varying amount of additional RAM usage, depending on how the preloader was configured (see the below settings).
+   The default preloading settings with vanilla game files should only use negligible amounts of RAM, however,
+   when using high-res texture and model replacers
+   it may be necessary to tweak these settings to prevent the game from running out of memory.
 
-Controls whether textures and objects will be pre-loaded in background threads.
-This setting being enabled should result in a reduced amount of loading screens, no impact on frame rate,
-and a varying amount of additional RAM usage, depending on how the preloader was configured (see the below settings).
-The default preloading settings with vanilla game files should only use negligible amounts of RAM, however,
-when using high-res texture and model replacers
-it may be necessary to tweak these settings to prevent the game from running out of memory.
+   The effects of (pre-)loading can be observed on the in-game statistics panel brought up with the 'F4' key.
 
-The effects of (pre-)loading can be observed on the in-game statistics panel brought up with the 'F4' key.
+   All settings starting with 'preload' in this section will have no effect if preloading is disabled,
+   and can only be configured by editing the settings configuration file.
 
-All settings starting with 'preload' in this section will have no effect if preloading is disabled,
-and can only be configured by editing the settings configuration file.
+.. omw-setting::
+   :title: preload num threads
+   :type: int
+   :range: ≥ 1
+   :default: 1
+   
 
+   Controls the number of worker threads used for preloading operations.
+   If you have additional CPU cores to spare, consider increasing the number of preloading threads to 2 or 3 for a boost in preloading performance.
+   Faster preloading will reduce the chance that a cell could not be completely loaded before the player moves into it,
+   and hence reduce the chance of seeing loading screens or frame drops.
+   This may be especially relevant when the player moves at high speed
+   and/or a large number of objects are preloaded due to large viewing distance.
 
-preload num threads
--------------------
+   A value of 4 or higher is not recommended.
+   With 4 or more threads, improvements will start to diminish due to file reading and synchronization bottlenecks.
 
-:Type:		integer
-:Range:		>=1
-:Default:	1
+.. omw-setting::
+   :title: preload exterior grid
+   :type: boolean
+   :range: true, false
+   :default: true
+   
 
-Controls the number of worker threads used for preloading operations.
-If you have additional CPU cores to spare, consider increasing the number of preloading threads to 2 or 3 for a boost in preloading performance.
-Faster preloading will reduce the chance that a cell could not be completely loaded before the player moves into it,
-and hence reduce the chance of seeing loading screens or frame drops.
-This may be especially relevant when the player moves at high speed
-and/or a large number of objects are preloaded due to large viewing distance.
+   Controls whether adjacent cells are preloaded when the player moves close to an exterior cell border.
 
-A value of 4 or higher is not recommended.
-With 4 or more threads, improvements will start to diminish due to file reading and synchronization bottlenecks.
+.. omw-setting::
+   :title: preload fast travel
+   :type: boolean
+   :range: true, false
+   :default: false
+   
 
-preload exterior grid
----------------------
+   Controls whether fast travel destinations are preloaded when the player moves close to a travel service.
+   Because the game can not predict the destination that the player will choose,
+   all possible destinations will be preloaded. This setting is disabled by default
+   due to the adverse effect on memory usage caused by the preloading of all possible destinations.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+.. omw-setting::
+   :title: preload doors
+   :type: boolean
+   :range: true, false
+   :default: true
+   
 
-Controls whether adjacent cells are preloaded when the player moves close to an exterior cell border.
+   Controls whether locations behind a door are preloaded when the player moves close to the door.
 
-preload fast travel
--------------------
+.. omw-setting::
+   :title: preload distance
+   :type: float32
+   :range: > 0
+   :default: 1000
+   
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   Controls the distance in in-game units that is considered the player being 'close' to a preloading trigger.
+   Used by all the preloading mechanisms i.e. 'preload exterior grid', 'preload fast travel' and 'preload doors'.
 
-Controls whether fast travel destinations are preloaded when the player moves close to a travel service.
-Because the game can not predict the destination that the player will choose,
-all possible destinations will be preloaded. This setting is disabled by default
-due to the adverse effect on memory usage caused by the preloading of all possible destinations.
+   For measurement purposes, the distance to an object in-game can be observed by opening the console,
+   clicking on the object and typing 'getdistance player'.
 
-preload doors
--------------
+.. omw-setting::
+   :title: preload instances
+   :type: boolean
+   :range: true, false
+   :default: true
+   
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   Controls whether or not objects are also pre-instanced on top of being pre-loaded.
+   Instancing happens when the same object is placed more than once in the cell,
+   and to be sure that any modifications to one instance do not affect the other,
+   the game will create independent copies (instances) of the object.
+   If this setting is enabled, the creation of instances will be done in the preloading thread;
+   otherwise, instancing will only happen in the main thread once the cell is actually loaded.
 
-Controls whether locations behind a door are preloaded when the player moves close to the door.
+   Enabling this setting should reduce the chance of frame drops when transitioning into a preloaded cell,
+   but will also result in some additional memory usage.
 
-preload distance
-----------------
+.. omw-setting::
+   :title: preload cell cache min
+   :type: int
+   :range: > 0
+   :default: 12
+   
 
-:Type:		floating point
-:Range:		>0
-:Default:	1000
+   The minimum number of preloaded cells that will be kept in the cache.
+   Once the number of preloaded cells in the cache exceeds this setting,
+   the game may start to expire preloaded cells based on the 'preload cell expiry delay' setting,
+   starting with the oldest cell.
+   When a preloaded cell expires, all the assets that were loaded for it will also expire
+   and will have to be loaded again the next time the cell is requested for preloading.
 
-Controls the distance in in-game units that is considered the player being 'close' to a preloading trigger.
-Used by all the preloading mechanisms i.e. 'preload exterior grid', 'preload fast travel' and 'preload doors'.
+.. omw-setting::
+   :title: preload cell cache max
+   :type: int
+   :range: > 0
+   :default: 20
+   
 
-For measurement purposes, the distance to an object in-game can be observed by opening the console,
-clicking on the object and typing 'getdistance player'.
+   The maximum number of cells that will ever be in pre-loaded state simultaneously.
+   This setting is intended to put a cap on the amount of memory that could potentially be used by preload state.
 
-preload instances
------------------
+.. omw-setting::
+   :title: preload cell expiry delay
+   :type: float32
+   :range: ≥ 0
+   :default: 5
+   
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   The amount of time (in seconds) that a preloaded cell will stay in cache after it is no longer referenced or required,
+   for example, after the player has moved away from a door without entering it.
 
-Controls whether or not objects are also pre-instanced on top of being pre-loaded.
-Instancing happens when the same object is placed more than once in the cell,
-and to be sure that any modifications to one instance do not affect the other,
-the game will create independent copies (instances) of the object.
-If this setting is enabled, the creation of instances will be done in the preloading thread;
-otherwise, instancing will only happen in the main thread once the cell is actually loaded.
+.. omw-setting::
+   :title: prediction time
+   :type: float32
+   :range: ≥ 0
+   :default: 1
+   
 
-Enabling this setting should reduce the chance of frame drops when transitioning into a preloaded cell,
-but will also result in some additional memory usage.
+   The amount of time (in seconds) in the future to predict the player position for. 
+   This predicted position is used to preload any cells and/or distant terrain required at that position.
 
-preload cell cache min
-----------------------
+   This setting will only have an effect if 'preload enabled' is set or the 'distant terrain' in the Terrain section is set.
 
-:Type:		integer
-:Range:		>0
-:Default:	12
+   Increasing this setting from its default may help if your computer/hard disk is too slow to preload in time and you see
+   loading screens and/or lag spikes.
 
-The minimum number of preloaded cells that will be kept in the cache.
-Once the number of preloaded cells in the cache exceeds this setting,
-the game may start to expire preloaded cells based on the 'preload cell expiry delay' setting,
-starting with the oldest cell.
-When a preloaded cell expires, all the assets that were loaded for it will also expire
-and will have to be loaded again the next time the cell is requested for preloading.
+.. omw-setting::
+   :title: cache expiry delay
+   :type: float32
+   :range: ≥ 0
+   :default: 5
+   
 
-preload cell cache max
-----------------------
+   The amount of time (in seconds) that a preloaded texture or object will stay in cache
+   after it is no longer referenced or required, for example, when all cells containing this texture have been unloaded.
 
-:Type:		integer
-:Range:		>0
-:Default:	20
+.. omw-setting::
+   :title: target framerate
+   :type: float32
+   :range: > 0
+   :default: 60
+   
 
-The maximum number of cells that will ever be in pre-loaded state simultaneously.
-This setting is intended to put a cap on the amount of memory that could potentially be used by preload state.
+   Affects the time to be set aside each frame for graphics preloading operations.
+   The game will distribute the preloading over several frames so as to not go under the specified framerate. 
+   For best results, set this value to the monitor's refresh rate. If you still experience stutters on turning around, 
+   you can try a lower value, although the framerate during loading will suffer a bit in that case.
 
-preload cell expiry delay
--------------------------
+.. omw-setting::
+   :title: pointers cache size
+   :type: int
+   :range: [40, 1000]
+   :default: 40
+   
 
-:Type:		floating point
-:Range:		>=0
-:Default:	5
-
-The amount of time (in seconds) that a preloaded cell will stay in cache after it is no longer referenced or required,
-for example, after the player has moved away from a door without entering it.
-
-prediction time
----------------
-
-:Type:		floating point
-:Range:		>=0
-:Default:	1
-
-The amount of time (in seconds) in the future to predict the player position for. 
-This predicted position is used to preload any cells and/or distant terrain required at that position.
-
-This setting will only have an effect if 'preload enabled' is set or the 'distant terrain' in the Terrain section is set.
-
-Increasing this setting from its default may help if your computer/hard disk is too slow to preload in time and you see
-loading screens and/or lag spikes.
-
-cache expiry delay
-------------------
-
-:Type:		floating point
-:Range:		>=0
-:Default:	5
-
-The amount of time (in seconds) that a preloaded texture or object will stay in cache
-after it is no longer referenced or required, for example, when all cells containing this texture have been unloaded.
-
-target framerate
-----------------
-:Type:          floating point
-:Range:         >0
-:Default:       60
-
-Affects the time to be set aside each frame for graphics preloading operations.
-The game will distribute the preloading over several frames so as to not go under the specified framerate. 
-For best results, set this value to the monitor's refresh rate. If you still experience stutters on turning around, 
-you can try a lower value, although the framerate during loading will suffer a bit in that case.
-
-pointers cache size
--------------------
-
-:Type:		integer
-:Range:		40 to 1000
-:Default:	40
-
-The count of object pointers that will be saved for a faster search by object ID.
-This is a temporary setting that can be used to mitigate scripting performance issues with certain game files. 
-If your profiler (press F3 twice) displays a large overhead for the Scripting section, try increasing this setting. 
+   The count of object pointers that will be saved for a faster search by object ID.
+   This is a temporary setting that can be used to mitigate scripting performance issues with certain game files. 
+   If your profiler (press F3 twice) displays a large overhead for the Scripting section, try increasing this setting.
diff --git a/docs/source/reference/modding/settings/fog.rst b/docs/source/reference/modding/settings/fog.rst
index 20bfdaf14d..9e1ac7678a 100644
--- a/docs/source/reference/modding/settings/fog.rst
+++ b/docs/source/reference/modding/settings/fog.rst
@@ -1,173 +1,163 @@
 Fog Settings
 ############
 
-use distant fog
----------------
+.. omw-setting::
+   :title: use distant fog
+   :type: boolean
+   :range: true, false
+   :default: false
+   
+   This setting overhauls the behavior of fog calculations.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   Normally the fog start and end distance are proportional to the viewing distance
+   and use the fog depth set in the fallback settings.
 
-This setting overhauls the behavior of fog calculations.
+   Enabling this setting separates the fog distance from the viewing distance and fallback settings and makes fog distance
+   and apparent density dependent on the weather and the current location according to the settings below.
 
-Normally the fog start and end distance are proportional to the viewing distance
-and use the fog depth set in the fallback settings.
+   Unfortunately specific weather-dependent fog factor and offset parameters are currently hard-coded.
+   They are based off the default settings of MGE XE.
 
-Enabling this setting separates the fog distance from the viewing distance and fallback settings and makes fog distance
-and apparent density dependent on the weather and the current location according to the settings below.
+   +--------------+------------+--------+
+   | Weather Type | Fog Factor | Offset |
+   +==============+============+========+
+   | Clear        | 1.0        | 0.0    |
+   +--------------+------------+--------+
+   | Cloudy       | 0.9        | 0.0    |
+   +--------------+------------+--------+
+   | Foggy        | 0.2        | 0.3    |
+   +--------------+------------+--------+
+   | Overcast     | 0.7        | 0.0    |
+   +--------------+------------+--------+
+   | Rain         | 0.5        | 0.1    |
+   +--------------+------------+--------+
+   | Thunderstorm | 0.5        | 0.2    |
+   +--------------+------------+--------+
+   | Ashstorm     | 0.2        | 0.5    |
+   +--------------+------------+--------+
+   | Blight       | 0.2        | 0.6    |
+   +--------------+------------+--------+
+   | Snow         | 0.5        | 0.4    |
+   +--------------+------------+--------+
+   | Blizzard     | 0.16       | 0.7    |
+   +--------------+------------+--------+
 
-Unfortunately specific weather-dependent fog factor and offset parameters are currently hard-coded.
-They are based off the default settings of MGE XE.
+   Non-underwater fog start and end distance are calculated like this according to these parameters::
 
-+--------------+------------+--------+
-| Weather Type | Fog Factor | Offset |
-+==============+============+========+
-| Clear        | 1.0        | 0.0    |
-+--------------+------------+--------+
-| Cloudy       | 0.9        | 0.0    |
-+--------------+------------+--------+
-| Foggy        | 0.2        | 0.3    |
-+--------------+------------+--------+
-| Overcast     | 0.7        | 0.0    |
-+--------------+------------+--------+
-| Rain         | 0.5        | 0.1    |
-+--------------+------------+--------+
-| Thunderstorm | 0.5        | 0.2    |
-+--------------+------------+--------+
-| Ashstorm     | 0.2        | 0.5    |
-+--------------+------------+--------+
-| Blight       | 0.2        | 0.6    |
-+--------------+------------+--------+
-| Snow         | 0.5        | 0.4    |
-+--------------+------------+--------+
-| Blizzard     | 0.16       | 0.7    |
-+--------------+------------+--------+
+      fog start distance = fog factor * (base fog start distance - fog offset * base fog end distance)
+      fog end distance = fog factor * (1.0 - fog offset) * base fog end distance
 
-Non-underwater fog start and end distance are calculated like this according to these parameters::
+   Underwater fog distance is used as-is.
 
-	fog start distance = fog factor * (base fog start distance - fog offset * base fog end distance)
-	fog end distance = fog factor * (1.0 - fog offset) * base fog end distance
+   A negative fog start distance means that the fog starts behind the camera
+   so the entirety of the scene will be at least partially fogged.
 
-Underwater fog distance is used as-is.
+   A negative fog end distance means that the fog ends behind the camera
+   so the entirety of the scene will be completely submerged in the fog.
 
-A negative fog start distance means that the fog starts behind the camera
-so the entirety of the scene will be at least partially fogged.
+   Fog end distance should be larger than the fog start distance.
 
-A negative fog end distance means that the fog ends behind the camera
-so the entirety of the scene will be completely submerged in the fog.
+   This setting and all further settings can only be configured by editing the settings configuration file.
 
-Fog end distance should be larger than the fog start distance.
+.. omw-setting::
+   :title: distant land fog start
+   :type: float32
+   :range: full float32 range
+   :default: 16384 (2 cells)
+   
 
-This setting and all further settings can only be configured by editing the settings configuration file.
+   This is the base fog start distance used for distant fog calculations in exterior locations.
 
-distant land fog start
-----------------------
+.. omw-setting::
+   :title: distant land fog end
+   :type: float32
+   :range: full float32 range
+   :default: 40960 (5 cells)
+   
 
-:Type:		floating point
-:Range:		The whole range of 32-bit floating point
-:Default:	16384 (2 cells)
+   This is the base fog end distance used for distant fog calculations in exterior locations.
 
-This is the base fog start distance used for distant fog calculations in exterior locations.
+.. omw-setting::
+   :title: distant underwater fog start
+   :type: float32
+   :range: full float32 range
+   :default: -4096
+   
 
-distant land fog end
---------------------
+   This is the base fog start distance used for distant fog calculations in underwater locations.
 
-:Type:		floating point
-:Range:		The whole range of 32-bit floating point
-:Default:	40960 (5 cells)
+.. omw-setting::
+   :title: distant underwater fog end
+   :type: float32
+   :range: full float32 range
+   :default: 2457.6
+   
 
-This is the base fog end distance used for distant fog calculations in exterior locations.
+   This is the base fog end distance used for distant fog calculations in underwater locations.
 
-distant underwater fog start
-----------------------------
+.. omw-setting::
+   :title: distant interior fog start
+   :type: float32
+   :range: full float32 range
+   :default: 0
+   
 
-:Type:		floating point
-:Range:		The whole range of 32-bit floating point
-:Default:	-4096
+   This is the base fog start distance used for distant fog calculations in interior locations.
 
-This is the base fog start distance used for distant fog calculations in underwater locations.
+.. omw-setting::
+   :title: distant interior fog end
+   :type: float32
+   :range: full float32 range
+   :default: 16384 (2 cells)
+   
 
-distant underwater fog end
---------------------------
+   This is the base fog end distance used for distant fog calculations in interior locations.
 
-:Type:		floating point
-:Range:		The whole range of 32-bit floating point
-:Default:	2457.6
+.. omw-setting::
+   :title: radial fog
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Fog`
 
-This is the base fog end distance used for distant fog calculations in underwater locations.
+   By default, the fog becomes thicker proportionally to your distance from the clipping plane set at the clipping distance, which causes distortion at the edges of the screen.
+   This setting makes the fog use the actual eye point distance (or so called Euclidean distance) to calculate the fog, which makes the fog look less artificial, especially if you have a wide FOV.
+   Note that the rendering will act as if you have 'force shaders' option enabled with this on, which means that shaders will be used to render all objects and the terrain.
 
-distant interior fog start
---------------------------
+.. omw-setting::
+   :title: exponential fog
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Fog`
 
-:Type:		floating point
-:Range:		The whole range of 32-bit floating point
-:Default:	0
+   Similar to "radial fog" but uses an exponential formula for the fog.
+   Note that the rendering will act as if you have 'force shaders' option enabled with this on, which means that shaders will be used to render all objects and the terrain.
 
-This is the base fog start distance used for distant fog calculations in interior locations.
+.. omw-setting::
+   :title: sky blending
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Fog`
 
-distant interior fog end
-------------------------
+   Whether to use blending with the sky for everything that is close to the clipping plane.
+   If enabled the clipping plane becomes invisible.
+   Note that the rendering will act as if you have 'force shaders' option enabled with this on, which means that shaders will be used to render all objects and the terrain.
 
-:Type:		floating point
-:Range:		The whole range of 32-bit floating point
-:Default:	16384 (2 cells)
+.. omw-setting::
+   :title: sky blending start
+   :type: float32
+   :range: [0.0, 1.0)
+   :default: 0.8
+   :location: :bdg-success:`Launcher > Settings > Visuals > Fog`
 
-This is the base fog end distance used for distant fog calculations in interior locations.
+   The fraction of the maximum distance at which blending with the sky starts.
 
-radial fog
-----------
+.. omw-setting::
+   :title: sky rtt resolution
+   :type: float32|float32
+   :default: 512 256
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-By default, the fog becomes thicker proportionally to your distance from the clipping plane set at the clipping distance, which causes distortion at the edges of the screen.
-This setting makes the fog use the actual eye point distance (or so called Euclidean distance) to calculate the fog, which makes the fog look less artificial, especially if you have a wide FOV.
-Note that the rendering will act as if you have 'force shaders' option enabled with this on, which means that shaders will be used to render all objects and the terrain.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-exponential fog
----------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Similar to "radial fog" but uses an exponential formula for the fog.
-Note that the rendering will act as if you have 'force shaders' option enabled with this on, which means that shaders will be used to render all objects and the terrain.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-sky blending
-------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Whether to use blending with the sky for everything that is close to the clipping plane.
-If enabled the clipping plane becomes invisible.
-Note that the rendering will act as if you have 'force shaders' option enabled with this on, which means that shaders will be used to render all objects and the terrain.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-sky blending start
-------------------
-
-:Type:		floating point
-:Range:		from 0.0 (including) to 1.0 (excluding)
-:Default:	0.8
-
-The fraction of the maximum distance at which blending with the sky starts.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-sky rtt resolution
-------------------
-
-:Type:		two positive integers
-:Default:	512 256
-
-The sky RTT texture size, used only for sky blending. Smaller values
-reduce quality of the sky blending, but can have slightly better performance.
+   The sky RTT texture size, used only for sky blending. Smaller values
+   reduce quality of the sky blending, but can have slightly better performance.
diff --git a/docs/source/reference/modding/settings/game.rst b/docs/source/reference/modding/settings/game.rst
index 3994fd5077..19d31279c6 100644
--- a/docs/source/reference/modding/settings/game.rst
+++ b/docs/source/reference/modding/settings/game.rst
@@ -1,571 +1,514 @@
 Game Settings
 #############
 
-show owned
-----------
+.. omw-setting::
+   :title: show owned
+   :type: int
+   :range: 0, 1, 2, 3
+   :default: 0
+   :location: :bdg-success:`Launcher > Settings > Interface`
+
+   .. list-table::
+      :header-rows: 1
+
+      * - Mode
+        - Meaning
+      * - 0
+        - No clues are provided which is the default Morrowind behaviour.
+      * - 1
+        - The background of the tool tip for the object is highlighted in the colour specified by the colour background owned setting in the GUI Settings Section.
+          The crosshair is not visible if crosshair is false.
+      * - 2
+        - The crosshair is the colour of the colour crosshair owned setting in the GUI Settings section.
+      * - 3
+        - Both the tool tip background and the crosshair are coloured.
+
+   Enable visual clues for items owned by NPCs when the crosshair is on the object.
+
+.. omw-setting::
+   :title: show projectile damage
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Interface`
+
+   If this setting is true, the damage bonus of arrows and bolts will show on their tooltip.
+
+.. omw-setting::
+   :title: show melee info
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Interface`
+
+   If this setting is true, the reach and speed of weapons will show on their tooltip.
+
+.. omw-setting::
+   :title: show enchant chance
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Interface`
+
+   Whether or not the chance of success will be displayed in the enchanting menu.
+
+.. omw-setting::
+   :title: best attack
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-info:`In Game > Options > Prefs`
+
+   If this setting is true, the player character will always use the most powerful attack when striking with a weapon
+   (chop, slash or thrust). If this setting is false,
+   the type of attack is determined by the direction that the character is moving at the time the attack begins.
+
+.. omw-setting::
+   :title: can loot during death animation
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   If this setting is true, the player is allowed to loot actors (e.g. summoned creatures) during death animation, 
+   if they are not in combat. In this case we have to increment death counter and run disposed actor's script instantly.
+
+   If this setting is false, player has to wait until end of death animation in all cases.
+   Makes using of summoned creatures exploit (looting summoned Dremoras and Golden Saints for expensive weapons) a lot harder.
+   Conflicts with mannequin mods, which use SkipAnim to prevent end of death animation.
+
+.. omw-setting::
+   :title: difficulty
+   :type: int
+   :range: -500 to 500
+   :default: 0
+   :location: :bdg-info:`In Game > Options > Prefs`
+
+   This setting adjusts the difficulty of the game and is intended to be in the range -100 to 100 inclusive.
+   Given the default game setting for fDifficultyMult of 5.0,
+   a value of -100 results in the player taking 80% of the usual damage, doing 6 times the normal damage.
+   A value of 100 results in the player taking 6 times as much damage, while inflicting only 80% of the usual damage.
+   Values below -500 will result in the player receiving no damage,
+   and values above 500 will result in the player inflicting no damage.
+
+.. omw-setting::
+   :title: actors processing range
+   :type: int
+   :range: 3584 to 7168
+   :default: 7168
+   :location: :bdg-info:`In Game > Options > Prefs`
+
+   This setting specifies the actor state update distance from the player in game units.
+   Actor state update includes AI, animations, and physics processing.
+   Actors close to this distance softly fade in and out instead of appearing or disappearing abruptly.
+   Keep in mind that actors running Travel AI packages are always active to avoid
+   issues in mods with long-range AiTravel packages (for example, patrols, caravans and travellers).
+
+.. omw-setting::
+   :title: classic reflected absorb spells behavior
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   If this setting is true, effects of Absorb spells which were reflected by the target are not mirrored,
+   and the caster will absorb their own stat resulting in no effect on either the caster and the target.
+   This makes the gameplay as a mage easier, but these spells become imbalanced.
+   This is how Morrowind behaves.
+
+.. omw-setting::
+   :title: classic calm spells behavior
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   If this setting is true, Calm spells will take their target out of combat every frame.
+   This means that a Calm spell of any magnitude will always take actors out of combat for the entirety of its duration.
+   This is how Morrowind behaves without the Morrowind Code Patch. If this setting is off,
+   Calm spells will only take their target out of combat once. Allowing them to re-engage if the spell was not sufficiently strong.
+
+.. omw-setting::
+   :title: use magic item animations
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Animations`
+
+   If this setting is true, the engine will use casting animations for magic items, including scrolls.
+   Otherwise, there will be no casting animations, just as in original engine
+
+.. omw-setting::
+   :title: show effect duration
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Interface`
+
+   Show the remaining duration of magic effects and lights if this setting is true.
+   The remaining duration is displayed in the tooltip by hovering over the magical effect.
+
+.. omw-setting::
+   :title: enchanted weapons are magical
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   Make enchanted weapons without Magical flag bypass normal weapons resistance (and weakness) certain creatures have.
+   This is how Morrowind behaves.
+
+.. omw-setting::
+   :title: prevent merchant equipping
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   Prevent merchants from equipping items that are sold to them.
+
+.. omw-setting::
+   :title: followers attack on sight
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   Make player followers and escorters start combat with enemies who have started combat with them or the player.
+   Otherwise they wait for the enemies or the player to do an attack first.
+   Please note this setting has not been extensively tested and could have side effects with certain quests.
+
+.. omw-setting::
+   :title: shield sheathing
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Animations`
+
+   If this setting is true, OpenMW will utilize shield sheathing-compatible assets to display holstered shields.
+
+   To make use of this, you need to have an xbase_anim_sh.nif file with weapon bones that will be injected into the skeleton.
+   Also you can use additional _sh meshes for more precise shield placement.
+   Warning: this feature may conflict with mods that use pseudo-shields to emulate item in actor's hand (e.g. books, baskets, pick axes).
+   To avoid conflicts, you can use _sh mesh without "Bip01 Sheath" node for such "shields" meshes, or declare its bodypart as Clothing type, not as Armor.
+   Also you can use an _sh node with empty "Bip01 Sheath" node.
+   In this case the engine will use basic shield model, but will use transformations from the "Bip01 Sheath" node.
+
+.. omw-setting::
+   :title: weapon sheathing
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Animations`
+
+   If this setting is true, OpenMW will utilize weapon sheathing-compatible assets to display holstered weapons.
+
+   To make use of this, you need to have an xbase_anim_sh.nif file with weapon bones that will be injected into the skeleton.
+   Additional _sh suffix models are not essential for weapon sheathing to work but will act as quivers or scabbards for the weapons they correspond to.
+
+.. omw-setting::
+   :title: use additional anim sources
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Animations`
+
+   Allow the engine to load additional animation sources when enabled.
+   For example, if the main animation mesh has name Meshes/x.nif, 
+   the engine will load all KF-files from Animations/x folder and its child folders.
+   This can be useful if you want to use several animation replacers without merging them.
+   Attention: animations from AnimKit have their own format and are not supposed to be directly loaded in-game!
+
+.. omw-setting::
+   :title: barter disposition change is permanent
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   If this setting is true, 
+   disposition change of merchants caused by trading will be permanent and won't be discarded upon exiting dialogue with them.
+   This imitates the option that Morrowind Code Patch offers.
+
+.. omw-setting::
+   :title: only appropriate ammunition bypasses resistance
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   If this setting is true, you will have to use the appropriate ammunition to bypass normal weapon resistance (or weakness).
+   An enchanted bow with chitin arrows will no longer be enough for the purpose, while a steel longbow with glass arrows will still work.
+   This was previously the default engine behavior that diverged from Morrowind design.
+
+.. omw-setting::
+   :title: strength influences hand to hand
+   :type: int
+   :range: 0, 1, 2
+   :default: 0
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   This setting controls the behavior of factoring of Strength attribute into hand-to-hand damage, which is using the formula
+   Morrowind Code Patch uses for its equivalent feature: damage is multiplied by its value divided by 40.
+
+   .. list-table:: 
+      :header-rows: 1
+
+      * - Mode
+        - Meaning
+      * - 0
+        - Strength attribute is ignored
+      * - 1
+        - Strength attribute is factored in damage from any actor
+      * - 2
+        - Strength attribute is factored in damage from any actor except werewolves
+
+.. omw-setting::
+   :title: normalise race speed
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   By default race weight is factored into horizontal movement and magic projectile speed like in Morrowind.
+   For example, an NPC which has 1.2 race weight is faster than an NPC with the exact same stats and weight 1.0 by a factor of 120%.
+   If this setting is true, race weight is ignored in the calculations which allows for a movement behavior
+   equivalent to the one introduced by the equivalent Morrowind Code Patch feature.
+   This makes the movement speed behavior more fair between different races.
+
+.. omw-setting::
+   :title: projectiles enchant multiplier
+   :type: float32
+   :range: [0, 1]
+   :default: 0.0
+   
+
+   The value of this setting determines how many projectiles (thrown weapons, arrows and bolts) you can enchant at once according to the following formula:
+
+   .. math::
+
+      \text{count} = \frac{\text{soul gem charge} \cdot \text{projectiles enchant multiplier}}{\text{enchantment strength}}
+
+   A value of 0 means that you can only enchant one projectile.
+   If you want to have Morrowind Code Patch-like count of projectiles being enchanted at once, set this value to 0.25 (i.e. 25% of the charge).
+
+.. omw-setting::
+   :title: uncapped damage fatigue
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   There are four ways to decrease an actor's Fatigue stat in Morrowind gameplay mechanics:
+   Drain, Absorb, Damage Fatigue magic effects and hand-to-hand combat.
+   However, in Morrowind you can't knock down an actor with a Damage Fatigue spell or an Absorb Fatigue spell.
+   Morrowind Code Patch adds an option to make it possible for Damage Fatigue spells. This is the equivalent of that option.
+
+   Setting the value of this setting to true will remove the 0 lower cap from the value,
+   allowing Damage Fatigue to reduce Fatigue to a value below zero.
+
+.. omw-setting::
+   :title: turn to movement direction
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Animations`
+
+   Affects side and diagonal movement. Enabling this setting makes movement more realistic.
+
+   If disabled then the whole character's body is pointed to the direction of view. Diagonal movement has no special animation and causes sliding.
+
+   If enabled then the character turns lower body to the direction of movement. Upper body is turned partially. Head is always pointed to the direction of view. In combat mode it works only for diagonal movement. In non-combat mode it changes straight right and straight left movement as well. Also turns the whole body up or down when swimming according to the movement direction.
+
+.. omw-setting::
+   :title: smooth movement
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Animations`
+
+   Makes NPCs and player movement more smooth.
+
+   Recommended to use with "turn to movement direction" enabled.
+
+.. omw-setting::
+   :title: smooth movement player turning delay
+   :type: float32
+   :range: ≥ 0.01
+   :default: 0.333
+
+   Max delay of turning (in seconds) if player drastically changes direction on the run. Makes sense only if "smooth movement" is enabled.
+
+.. omw-setting::
+   :title: NPCs avoid collisions
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   If enabled NPCs apply evasion maneuver to avoid collisions with others.
+
+.. omw-setting::
+   :title: NPCs give way
+   :type: boolean
+   :range: true, false
+   :default: true
 
-:Type:		integer
-:Range:		0, 1, 2, 3
-:Default:	0
+   Standing NPCs give way to moving ones. Works only if 'NPCs avoid collisions' is enabled.
+
+.. omw-setting::
+   :title: swim upward correction
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
 
-Enable visual clues for items owned by NPCs when the crosshair is on the object.
-If the setting is 0, no clues are provided which is the default Morrowind behaviour.
-If the setting is 1, the background of the tool tip for the object is highlighted
-in the colour specified by the colour background owned setting in the GUI Settings Section.
-If the setting is 2, the crosshair is the colour of the colour crosshair owned setting in the GUI Settings section.
-If the setting is 3, both the tool tip background and the crosshair are coloured.
-The crosshair is not visible if crosshair is false.
+   Makes player swim a bit upward from the line of sight. Applies only in third person mode. Intended to make simpler swimming without diving.
 
-This setting can be controlled in the Settings tab of the launcher.
+.. omw-setting::
+   :title: swim upward coef
+   :type: float32
+   :range: -1.0 to 1.0
+   :default: 0.2
 
-show projectile damage
-----------------------
+   Regulates strength of the "swim upward correction" effect (if enabled).
+   Makes player swim a bit upward (or downward in case of negative value) from the line of sight. Recommended range of values is from 0.0 to 0.25.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+.. omw-setting::
+   :title: trainers training skills based on base skill
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
 
-If this setting is true, the damage bonus of arrows and bolts will show on their tooltip.
+   The trainers in Morrowind choose their proposed training skills based on their 3 best attributes.
 
-This setting can be controlled in the Settings tab of the launcher.
+   If disabled then the 3 best skills of trainers and the training limits take into account fortified/drained trainer skill.
 
-show melee info
----------------
+   If enabled then the 3 best skills of trainers and the training limits are based on the trainer base skills.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+.. omw-setting::
+   :title: always allow stealing from knocked out actors
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   By Bethesda's design, in the latest released version of Morrowind pickpocketing is impossible during combat,
+   even if the fighting NPC is knocked out.
+
+   This setting allows the player to steal items from fighting NPCs that were knocked out if enabled.
+
+.. omw-setting::
+   :title: graphic herbalism
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   Some mods add harvestable container models. When this setting is enabled, activating a container using a harvestable model will visually harvest from it instead of opening the menu.
+
+   When this setting is turned off or when activating a regular container, the menu will open as usual.
+
+.. omw-setting::
+   :title: allow actors to follow over water surface
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   If enabled actors will always find path over the water surface when following other actors. This makes OpenMW behaviour closer to the vanilla engine.
+
+   If disabled actors without the ability to swim will not follow other actors to the water.
+
+   .. note::
+       Has effect only when Navigator is enabled.
+
+.. omw-setting::
+   :title: default actor pathfind half extents
+   :type: float32|float32|float32
+   :range: > 0
+   :default: 29.27999496459961 28.479997634887695 66.5
+
+   Actor half extents used for exterior cells to generate navmesh.
+   Changing the value will invalidate navmesh disk cache.
+
+.. omw-setting::
+   :title: day night switches
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   Some mods add models which change visuals based on time of day. When this setting is enabled, supporting models will automatically make use of Day/night state.
+
+.. omw-setting::
+   :title: unarmed creature attacks damage armor
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   If disabled unarmed creature attacks do not reduce armor condition, just as with vanilla engine.
+
+   If enabled unarmed creature attacks reduce armor condition, the same as attacks from NPCs and armed creatures.
+
+.. omw-setting::
+   :title: actor collision shape type
+   :type: int
+   :range: 0, 1, 2
+   :default: 0 (Axis-aligned bounding box)
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   Collision is used for both physics simulation and navigation mesh generation for pathfinding.
+   Cylinder gives the best consistency bewtween available navigation paths and ability to move by them.
+   Changing this value affects navigation mesh generation therefore navigation mesh disk cache generated for one value
+   will not be useful with another.
+
+   .. list-table::
+      :header-rows: 1
+
+      * - Mode
+        - Meaning
+      * - 0
+        - Axis-aligned bounding box
+      * - 1
+        - Rotating box
+      * - 2
+        - Cylinder
+
+.. omw-setting::
+   :title: player movement ignores animation
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Animations`
+
+   In third person, the camera will sway along with the movement animations of the player. 
+   Enabling this option disables this swaying by having the player character move independently of its animation.
+
+.. omw-setting::
+   :title: smooth animation transitions
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Animations`
 
-If this setting is true, the reach and speed of weapons will show on their tooltip.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-show enchant chance
--------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Whether or not the chance of success will be displayed in the enchanting menu.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-best attack
------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If this setting is true, the player character will always use the most powerful attack when striking with a weapon
-(chop, slash or thrust). If this setting is false,
-the type of attack is determined by the direction that the character is moving at the time the attack begins.
-
-This setting can be toggled with the Always Use Best Attack button in the Prefs panel of the Options menu.
-
-can loot during death animation
--------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-If this setting is true, the player is allowed to loot actors (e.g. summoned creatures) during death animation, 
-if they are not in combat. In this case we have to increment death counter and run disposed actor's script instantly.
-
-If this setting is false, player has to wait until end of death animation in all cases.
-Makes using of summoned creatures exploit (looting summoned Dremoras and Golden Saints for expensive weapons) a lot harder.
-Conflicts with mannequin mods, which use SkipAnim to prevent end of death animation.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-difficulty
-----------
-
-:Type:		integer
-:Range:		-500 to 500
-:Default:	0
-
-This setting adjusts the difficulty of the game and is intended to be in the range -100 to 100 inclusive.
-Given the default game setting for fDifficultyMult of 5.0,
-a value of -100 results in the player taking 80% of the usual damage, doing 6 times the normal damage.
-A value of 100 results in the player taking 6 times as much damage, while inflicting only 80% of the usual damage.
-Values below -500 will result in the player receiving no damage,
-and values above 500 will result in the player inflicting no damage.
-
-This setting can be controlled in game with the Difficulty slider in the Prefs panel of the Options menu.
-
-actors processing range
------------------------
-
-:Type:		integer
-:Range:		3584 to 7168
-:Default:	7168
-
-This setting specifies the actor state update distance from the player in game units.
-Actor state update includes AI, animations, and physics processing.
-Actors close to this distance softly fade in and out instead of appearing or disappearing abruptly.
-Keep in mind that actors running Travel AI packages are always active to avoid
-issues in mods with long-range AiTravel packages (for example, patrols, caravans and travellers).
-
-This setting can be controlled in game with the "Actors Processing Range" slider in the Prefs panel of the Options menu.
-
-classic reflected absorb spells behavior
-----------------------------------------
-
-:Type:		boolean
-:Range: 	True/False
-:Default:	True
-
-If this setting is true, effects of Absorb spells which were reflected by the target are not mirrored,
-and the caster will absorb their own stat resulting in no effect on either the caster and the target.
-This makes the gameplay as a mage easier, but these spells become imbalanced.
-This is how Morrowind behaves.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-classic calm spells behavior
-----------------------------------------
-
-:Type:		boolean
-:Range: 	True/False
-:Default:	True
-
-If this setting is true, Calm spells will take their target out of combat every frame.
-This means that a Calm spell of any magnitude will always take actors out of combat for the entirety of its duration.
-This is how Morrowind behaves without the Morrowind Code Patch. If this setting is off,
-Calm spells will only take their target out of combat once. Allowing them to re-engage if the spell was not sufficiently strong.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-use magic item animations
--------------------------
-
-:Type:		boolean
-:Range: 	True/False
-:Default:	False
-
-If this setting is true, the engine will use casting animations for magic items, including scrolls.
-Otherwise, there will be no casting animations, just as in original engine
-
-This setting can only be configured by editing the settings configuration file.
-
-show effect duration
---------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Show the remaining duration of magic effects and lights if this setting is true.
-The remaining duration is displayed in the tooltip by hovering over the magical effect.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-enchanted weapons are magical
------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-Make enchanted weapons without Magical flag bypass normal weapons resistance (and weakness) certain creatures have.
-This is how Morrowind behaves.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-prevent merchant equipping
---------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Prevent merchants from equipping items that are sold to them.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-followers attack on sight
--------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Make player followers and escorters start combat with enemies who have started combat with them or the player.
-Otherwise they wait for the enemies or the player to do an attack first.
-Please note this setting has not been extensively tested and could have side effects with certain quests.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-shield sheathing
-----------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If this setting is true, OpenMW will utilize shield sheathing-compatible assets to display holstered shields.
-
-To make use of this, you need to have an xbase_anim_sh.nif file with weapon bones that will be injected into the skeleton.
-Also you can use additional _sh meshes for more precise shield placement.
-Warning: this feature may conflict with mods that use pseudo-shields to emulate item in actor's hand (e.g. books, baskets, pick axes).
-To avoid conflicts, you can use _sh mesh without "Bip01 Sheath" node for such "shields" meshes, or declare its bodypart as Clothing type, not as Armor.
-Also you can use an _sh node with empty "Bip01 Sheath" node.
-In this case the engine will use basic shield model, but will use transformations from the "Bip01 Sheath" node.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-weapon sheathing
-----------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If this setting is true, OpenMW will utilize weapon sheathing-compatible assets to display holstered weapons.
-
-To make use of this, you need to have an xbase_anim_sh.nif file with weapon bones that will be injected into the skeleton.
-Additional _sh suffix models are not essential for weapon sheathing to work but will act as quivers or scabbards for the weapons they correspond to.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-use additional anim sources
----------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Allow the engine to load additional animation sources when enabled.
-For example, if the main animation mesh has name Meshes/x.nif, 
-the engine will load all KF-files from Animations/x folder and its child folders.
-This can be useful if you want to use several animation replacers without merging them.
-Attention: animations from AnimKit have their own format and are not supposed to be directly loaded in-game!
-
-This setting can be controlled in the Settings tab of the launcher.
-
-barter disposition change is permanent
---------------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If this setting is true, 
-disposition change of merchants caused by trading will be permanent and won't be discarded upon exiting dialogue with them.
-This imitates the option that Morrowind Code Patch offers.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-only appropriate ammunition bypasses resistance
------------------------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If this setting is true, you will have to use the appropriate ammunition to bypass normal weapon resistance (or weakness).
-An enchanted bow with chitin arrows will no longer be enough for the purpose, while a steel longbow with glass arrows will still work.
-This was previously the default engine behavior that diverged from Morrowind design.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-strength influences hand to hand
---------------------------------
-
-:Type:		integer
-:Range:		0, 1, 2
-:Default:	0
-
-This setting controls the behavior of factoring of Strength attribute into hand-to-hand damage, which is using the formula
-Morrowind Code Patch uses for its equivalent feature: damage is multiplied by its value divided by 40.
-
-0: Strength attribute is ignored
-1: Strength attribute is factored in damage from any actor
-2: Strength attribute is factored in damage from any actor except werewolves
-
-This setting can be controlled in the Settings tab of the launcher.
-
-normalise race speed
---------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-By default race weight is factored into horizontal movement and magic projectile speed like in Morrowind.
-For example, an NPC which has 1.2 race weight is faster than an NPC with the exact same stats and weight 1.0 by a factor of 120%.
-If this setting is true, race weight is ignored in the calculations which allows for a movement behavior
-equivalent to the one introduced by the equivalent Morrowind Code Patch feature.
-This makes the movement speed behavior more fair between different races.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-projectiles enchant multiplier
-------------------------------
-
-:Type:		floating point
-:Range:		0.0 to 1.0
-:Default:	0.0
-
-The value of this setting determines how many projectiles (thrown weapons, arrows and bolts) you can enchant at once according to the following formula:
-
-count = (soul gem charge * projectiles enchant multiplier) / enchantment strength
-
-A value of 0 means that you can only enchant one projectile.
-If you want to have Morrowind Code Patch-like count of projectiles being enchanted at once, set this value to 0.25 (i.e. 25% of the charge).
-
-This setting can only be configured by editing the settings configuration file.
-
-uncapped damage fatigue
------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-There are four ways to decrease an actor's Fatigue stat in Morrowind gameplay mechanics:
-Drain, Absorb, Damage Fatigue magic effects and hand-to-hand combat.
-However, in Morrowind you can't knock down an actor with a Damage Fatigue spell or an Absorb Fatigue spell.
-Morrowind Code Patch adds an option to make it possible for Damage Fatigue spells. This is the equivalent of that option.
-
-Setting the value of this setting to true will remove the 0 lower cap from the value,
-allowing Damage Fatigue to reduce Fatigue to a value below zero.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-turn to movement direction
---------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Affects side and diagonal movement. Enabling this setting makes movement more realistic.
-
-If disabled then the whole character's body is pointed to the direction of view. Diagonal movement has no special animation and causes sliding.
-
-If enabled then the character turns lower body to the direction of movement. Upper body is turned partially. Head is always pointed to the direction of view. In combat mode it works only for diagonal movement. In non-combat mode it changes straight right and straight left movement as well. Also turns the whole body up or down when swimming according to the movement direction.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-smooth movement
----------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Makes NPCs and player movement more smooth.
-
-Recommended to use with "turn to movement direction" enabled.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-smooth movement player turning delay
-------------------------------------
-
-:Type:		floating point
-:Range:		>= 0.01
-:Default:	0.333
-
-Max delay of turning (in seconds) if player drastically changes direction on the run. Makes sense only if "smooth movement" is enabled.
-
-This setting can only be configured by editing the settings configuration file.
-
-NPCs avoid collisions
----------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If enabled NPCs apply evasion maneuver to avoid collisions with others.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-NPCs give way
--------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-Standing NPCs give way to moving ones. Works only if 'NPCs avoid collisions' is enabled.
-
-This setting can only be configured by editing the settings configuration file.
-
-swim upward correction
-----------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Makes player swim a bit upward from the line of sight. Applies only in third person mode. Intended to make simpler swimming without diving.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-swim upward coef
-----------------
-
-:Type:		floating point
-:Range:		-1.0 to 1.0
-:Default:	0.2
-
-Regulates strength of the "swim upward correction" effect (if enabled).
-Makes player swim a bit upward (or downward in case of negative value) from the line of sight. Recommended range of values is from 0.0 to 0.25.
-
-This setting can only be configured by editing the settings configuration file.
-
-trainers training skills based on base skill
---------------------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-The trainers in Morrowind choose their proposed training skills based on their 3 best attributes.
-
-If disabled then the 3 best skills of trainers and the training limits take into account fortified/drained trainer skill.
-
-If enabled then the 3 best skills of trainers and the training limits are based on the trainer base skills.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-always allow stealing from knocked out actors
----------------------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-By Bethesda's design, in the latest released version of Morrowind pickpocketing is impossible during combat,
-even if the fighting NPC is knocked out.
-
-This setting allows the player to steal items from fighting NPCs that were knocked out if enabled.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-graphic herbalism
------------------
-
-:Type:      boolean
-:Range:		True/False
-:Default:	True
-
-Some mods add harvestable container models. When this setting is enabled, activating a container using a harvestable model will visually harvest from it instead of opening the menu.
-
-When this setting is turned off or when activating a regular container, the menu will open as usual.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-allow actors to follow over water surface
------------------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-If enabled actors will always find path over the water surface when following other actors. This makes OpenMW behaviour closer to the vanilla engine.
-
-If disabled actors without the ability to swim will not follow other actors to the water.
-
-.. note::
-    Has effect only when Navigator is enabled.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-default actor pathfind half extents
------------------------------------
-
-:Type:		3D vector floating point
-:Range:		All components > 0
-:Default:	29.27999496459961 28.479997634887695 66.5
-
-Actor half extents used for exterior cells to generate navmesh.
-Changing the value will invalidate navmesh disk cache.
-
-day night switches
-------------------
-
-:Type:      boolean
-:Range:		True/False
-:Default:	True
-
-Some mods add models which change visuals based on time of day. When this setting is enabled, supporting models will automatically make use of Day/night state.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-unarmed creature attacks damage armor
--------------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If disabled unarmed creature attacks do not reduce armor condition, just as with vanilla engine.
-
-If enabled unarmed creature attacks reduce armor condition, the same as attacks from NPCs and armed creatures.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-actor collision shape type
---------------------------
-
-:Type:		integer
-:Range:		0, 1, 2
-:Default:	0 (Axis-aligned bounding box)
-
-Collision is used for both physics simulation and navigation mesh generation for pathfinding.
-Cylinder gives the best consistency bewtween available navigation paths and ability to move by them.
-Changing this value affects navigation mesh generation therefore navigation mesh disk cache generated for one value
-will not be useful with another.
-
-* 0: Axis-aligned bounding box
-* 1: Rotating box
-* 2: Cylinder
-
-This setting can be controlled in the Settings tab of the launcher.
-
-player movement ignores animation
----------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-In third person, the camera will sway along with the movement animations of the player. 
-Enabling this option disables this swaying by having the player character move independently of its animation.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-smooth animation transitions
-----------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Enabling this option uses smooth transitions between animations making them a lot less jarring. Also allows to load modded animation blending.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-rebalance soul gem values
--------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Enabling this option drastically reduces the value of filled soul gems.
-The value will depend on soul magnitude but not the size of the used
-soul gem.
-
-The new value formula is based on the Morrowind Code Patch project::
-
-	new value = 0.0001 * (soul magnitude)³ + 2 * (soul magnitude)
-
-This setting can be controlled in the Settings tab of the launcher.
+   Enabling this option uses smooth transitions between animations making them a lot less jarring. Also allows to load modded animation blending.
+
+.. omw-setting::
+   :title: rebalance soul gem values
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
+
+   Enabling this option drastically reduces the value of filled soul gems.
+   The value will depend on soul magnitude but not the size of the used
+   soul gem.
+
+   The new value formula is based on the Morrowind Code Patch project:
+
+   .. math::
+
+   	\text{new value} = 0.0001 \cdot (\text{soul magnitude})^3 + 2 \cdot (\text{soul magnitude})
diff --git a/docs/source/reference/modding/settings/general.rst b/docs/source/reference/modding/settings/general.rst
index d7afc04349..19628a56c3 100644
--- a/docs/source/reference/modding/settings/general.rst
+++ b/docs/source/reference/modding/settings/general.rst
@@ -1,130 +1,104 @@
-General Settings
-################
+General
+#######
 
-anisotropy
-----------
+.. omw-setting::
+   :title: anisotropy
+   :type: int
+   :range: 0 to 16
+   :default: 4
+   :location: :bdg-info:`In Game > Options > Video > Detail Level`
 
-:Type:		integer
-:Range:		0 to 16
-:Default:	4
+   Set the maximum anisotropic filtering on textures.
+   Anisotropic filtering enhances the image quality of textures on surfaces at oblique viewing angles.
+   Valid values range from 0 to 16.
+   Modern video cards can often perform 8 or 16 anisotropic filtering with minimal performance impact.
 
-Set the maximum anisotropic filtering on textures.
-Anisotropic filtering is a method of enhancing the image quality of textures
-on surfaces that are at oblique viewing angles with respect to the camera. Valid values range from 0 to 16.
-Modern video cards can often perform 8 or 16 anisotropic filtering with a minimal performance impact.
-This effect of this setting can be seen in the Video panel of the Options menu by finding a location with straight lines
-(striped rugs and Balmora cobblestones work well) radiating into the distance, and adjusting the anisotropy slider.
+   This setting's effect can be seen by finding locations with straight lines
+   (striped rugs or Balmora cobblestones) radiating into the distance,
+   and adjusting the anisotropy slider.
 
-This setting can be changed in game
-using the Anisotropy slider in the Detail tab of the Video panel of the Options menu.
+.. omw-setting::
+   :title: screenshot format
+   :type: string
+   :range: jpg, png, tga
+   :default: png
+   :location: :bdg-success:`Launcher > Settings > Miscellaneous`
 
-screenshot format
------------------
+   Specify the format for screenshots taken using the screenshot key (F12 by default).
+   This should be the file extension commonly associated with the format.
+   Supported formats depend on compilation, but typically include "jpg", "png", and "tga".
 
-:Type:		string
-:Range:		jpg, png, tga
-:Default:	png
+.. omw-setting::
+   :title: texture mag filter
+   :type: string
+   :range: nearest, linear
+   :default: linear
 
-Specify the format for screen shots taken by pressing the screen shot key (bound to F12 by default).
-This setting should be the file extension commonly associated with the desired format.
-The formats supported will be determined at compilation, but "jpg", "png", and "tga" should be allowed.
+   Set the texture magnification filter type.
 
-This setting can be controlled in the Settings tab of the launcher.
+.. omw-setting::
+   :title: texture min filter
+   :type: string
+   :range: nearest, linear
+   :default: linear
 
-texture mag filter
-------------------
+   Set the texture minification filter type.
 
-:Type:		string
-:Range:		nearest, linear
-:Default:	linear
+.. omw-setting::
+   :title: texture mipmap
+   :type: string
+   :range: none, nearest, linear
+   :default: nearest
 
-Set the texture magnification filter type.
+   Set the texture mipmap type to control the method mipmaps are created.
+   Mipmapping reduces processing power needed during minification by pre-generating a series of smaller textures.
 
-texture min filter
-------------------
+.. omw-setting::
+   :title: notify on saved screenshot
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Miscellaneous`
 
-:Type:		string
-:Range:		nearest, linear
-:Default:	linear
+   Show a message box when a screenshot is saved to a file.
 
-Set the texture minification filter type.
+.. omw-setting::
+   :title: preferred locales
+   :type: string
+   :default: en
+   :location: :bdg-info:`In Game > Options > Language`
 
-texture mipmap
---------------
+   Comma-separated list of preferred locales (e.g. "de,en").
+   Each locale must consist of a two-letter language code and can optionally include a two-letter country code (e.g. "en_US").
+   Country codes improve accuracy, but partial matches are allowed.
 
-:Type:		string
-:Range:		none, nearest, linear
-:Default:	nearest
+.. omw-setting::
+   :title: gmst overrides l10n
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-info:`In Game > Options > Language`
 
-Set the texture mipmap type to control the method mipmaps are created.
-Mipmapping is a way of reducing the processing power needed during minification
-by pregenerating a series of smaller textures.
+   If true, localization GMSTs in content take priority over l10n files.
+   Set to false if your preferred locale does not match the content language.
 
-notify on saved screenshot
---------------------------
+.. omw-setting::
+   :title: log buffer size
+   :type: int
+   :range: ≥ 0
+   :default: 65536
+   
+   Buffer size for the in-game log viewer (F10).
+   If the log exceeds the buffer size, only the end will be visible.
+   Setting this to zero disables the log viewer.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+.. omw-setting::
+   :title: console history buffer size
+   :type: int
+   :range: ≥ 0
+   :default: 4096
 
-Show message box when screenshot is saved to a file.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-preferred locales
------------------
-
-:Type:		string
-:Default:	en
-
-List of the preferred locales separated by comma.
-For example "de,en" means German as the first priority and English as a fallback.
-
-Each locale must consist of a two-letter language code (e.g. "de" or "en") and
-can also optionally include a two-letter country code (e.g. "en_US", "fr_CA").
-Locales with country codes can match locales without one (e.g. specifying "en_US"
-will match "en"), so is recommended that you include the country codes where possible,
-since if the country code isn't specified the generic language-code only locale might
-refer to any of the country-specific variants.
-
-Two highest priority locales may be assigned via the Localization tab of the in-game options.
-
-gmst overrides l10n
--------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-If true, localization GMSTs in content have priority over l10n files.
-Setting to false can be useful if selected preferred locale doesn't
-match the language of content files.
-
-Can be changed via the Localization tab of the in-game options.
-
-log buffer size
----------------
-
-:Type:		platform dependant unsigned integer
-:Range:		>= 0
-:Default:	65536
-
-Buffer size for the in-game log viewer (press F10 to toggle the log viewer).
-When the log doesn't fit into the buffer, only the end of the log is visible in the log viewer.
-Zero disables the log viewer.
-
-This setting can only be configured by editing the settings configuration file.
-
-console history buffer size 
----------------------------
-
-:Type:		platform dependant unsigned integer
-:Range:		>= 0
-:Default:	4096
-
-Number of console history objects to retrieve from previous session. If the number of history 
-objects in the file exceeds this value, history objects will be erased starting from the oldest. 
-This operation runs on every new session. See :doc:`../paths` for location of the history file.
-
-This setting can only be configured by editing the settings configuration file.
 
+   Number of console history entries retrieved from the previous session.
+   Older entries are discarded when the file exceeds this value.
+   See :doc:`../paths` for the location of the history file.
diff --git a/docs/source/reference/modding/settings/groundcover.rst b/docs/source/reference/modding/settings/groundcover.rst
index 7b060f58ad..320ed30986 100644
--- a/docs/source/reference/modding/settings/groundcover.rst
+++ b/docs/source/reference/modding/settings/groundcover.rst
@@ -1,97 +1,92 @@
 Groundcover Settings
 ####################
 
-enabled
--------
+.. omw-setting::
+   :title: enabled
+   :type: boolean
+   :range: true, false
+   :default: false
+   
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   Allows the engine to use groundcover.
+   Groundcover objects are static and come from ESP files registered via "groundcover" entries in `openmw.cfg`,
+   not via "content". These objects are assumed to have no collision and cannot be interacted with,
+   allowing them to be merged and animated efficiently regardless of player distance.
 
-Allows the engine to use groundcover.
-Groundcover objects are static objects which come from ESP files, registered via
-"groundcover" entries from openmw.cfg rather than "content" ones.
-We assume that groundcover objects have no collisions, can not be moved or interacted with,
-so we can merge them to pages and animate them indifferently from distance from player.
+.. omw-setting::
+   :title: density
+   :type: float32
+   :range: 0.0 (0%) to 1.0 (100%)
+   :default: 1.0
+   
 
-This setting can only be configured by editing the settings configuration file.
+   Determines how many groundcover instances from content files are used in the game.
+   Higher values increase density but may impact performance.
 
-density
--------
+.. omw-setting::
+   :title: rendering distance
+   :type: float32
+   :range: ≥ 0.0
+   :default: 6144.0
+   
 
-:Type:		floating point
-:Range:		0.0 (0%) to 1.0 (100%)
-:Default:	1.0
+   Sets the distance (in game units) at which grass pages are rendered.
+   Larger values may reduce performance.
 
-Determines how many groundcover instances from content files
-are used in the game. Can affect performance a lot.
+.. omw-setting::
+   :title: stomp mode
+   :type: int
+   :range: 0, 1, 2
+   :default: 2
+   
 
-This setting can only be configured by editing the settings configuration file.
+   Determines how grass responds to player movement.
 
-rendering distance
-------------------
+   .. list-table::
+      :header-rows: 1
 
-:Type:		floating point
-:Range:		>= 0.0
-:Default:	6144.0
+      * - Mode
+        - Meaning
+      * - 0
+        - Grass cannot be trampled.
+      * - 1
+        - Only the player's XY position is taken into account.
+      * - 2
+        - Player's height above the ground is also considered.
 
-Determines on which distance in game units grass pages are rendered.
-May affect performance a lot.
+   In MGE XE, grass responds to player jumping due to changes in XY position,
+   even when levitating. OpenMW’s height-aware system avoids false triggers,
+   but grass may snap back when the player exits it quickly.
 
-This setting can only be configured by editing the settings configuration file.
+   Avoid using MGE XE's intensity constants when this is set to 2;
+   set :ref:`stomp intensity` to 0 or 1 in that case.
 
-stomp mode
-----------
+.. omw-setting::
+   :title: stomp intensity
+   :type: int
+   :range: 0, 1, 2
+   :default: 1
+   
 
-:Type:		integer
-:Range:		0, 1, 2
-:Default:	2
+   Determines the distance from the player at which grass reacts to footsteps,
+   and how far it moves in response.
 
-Determines whether grass should respond to the player treading on it.
+   .. list-table::
+      :header-rows: 1
 
-.. list-table:: Modes
-	:header-rows: 1
-
-	* - Mode number
-	  - Meaning
-	* - 0
-	  - Grass cannot be trampled.
-	* - 1
-	  - The player's XY position is taken into account.
-	* - 2
-	  - The player's height above the ground is taken into account, too.
-
-In MGE XE, which existing grass mods were made for, only the player's XY position was taken into account.
-However, presumably due to a bug, jumping straight up would change the XY position, so grass *does* respond to the player jumping.
-Levitating above grass in MGE XE still considers it stood-on, which can look bad.
-OpenMW's height-aware system ensures grass does not act as if it's being stood on when the player levitates above it, but that means grass rapidly snaps back to its original position when the player jumps out of it.
-Therefore, it is not recommended to use MGE XE's intensity constants if this setting is set to 2, i.e. :ref:`stomp intensity` should be 0 or 1 when :ref:`stomp mode` is 2.
-
-stomp intensity
----------------
-
-:Type:		integer
-:Range:		0, 1, 2
-:Default:	1
-
-How far away from the player grass can be before it's unaffected by being trod on, and how far it moves when it is.
-
-.. list-table:: Presets
-	:header-rows: 1
-
-	* - Preset number
-	  - Range (Units)
-	  - Distance (Units)
-	  - Description
-	* - 2
-	  - 150
-	  - 60
-	  - MGE XE levels. Generally excessive/comical, but what existing mods were made with in mind.
-	* - 1
-	  - 80
-	  - 40
-	  - Reduced levels. Usually looks better.
-	* - 0
-	  - 50
-	  - 20
-	  - Gentle levels.
+      * - Preset
+        - Range (Units)
+        - Distance (Units)
+        - Description
+      * - 2
+        - 150
+        - 60
+        - MGE XE levels — excessive/comical, matches legacy mods.
+      * - 1
+        - 80
+        - 40
+        - Reduced levels — visually balanced.
+      * - 0
+        - 50
+        - 20
+        - Gentle levels — subtle and restrained.
diff --git a/docs/source/reference/modding/settings/index.rst b/docs/source/reference/modding/settings/index.rst
index c1d7b631ee..d551d69ec0 100644
--- a/docs/source/reference/modding/settings/index.rst
+++ b/docs/source/reference/modding/settings/index.rst
@@ -54,25 +54,25 @@ The ranges included with each setting are the physically possible ranges, not re
         Camera <camera>
         Cells <cells>
         Fog <fog>
-        Groundcover <groundcover>
-        Map <map>
-        GUI <GUI>
-        HUD <HUD>
         Game <game>
         General <general>
+        Groundcover <groundcover>
+        GUI <GUI>
+        HUD <HUD>
+        Input <input>
         Lua <lua>
+        Map <map>
+        Models <models>
+        Navigator <navigator>
+        Physics <physics>
+        Post-Processing <postprocessing>
         Shaders <shaders>
         Shadows <shadows>
-        Input <input>
         Saves <saves>
         Sound <sound>
+        Stereo <stereo>
+        Stereo View <stereoview>
         Terrain <terrain>
         Video <video>
         Water <water>
         Windows <windows>
-        Navigator <navigator>
-        Physics <physics>
-        Models <models>
-        Post-Processing <postprocessing>
-        Stereo <stereo>
-        Stereo View <stereoview>
diff --git a/docs/source/reference/modding/settings/input.rst b/docs/source/reference/modding/settings/input.rst
index df9a6e7f48..bc6a494511 100644
--- a/docs/source/reference/modding/settings/input.rst
+++ b/docs/source/reference/modding/settings/input.rst
@@ -1,238 +1,156 @@
 Input Settings
 ##############
 
-grab cursor
------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-OpenMW will capture control of the cursor if this setting is true.
-
-In "look mode", OpenMW will center the cursor regardless of the value of this setting
-(since the cursor/crosshair is always centered in the OpenMW window).
-However, in GUI mode, this setting determines the behavior when the cursor is moved outside the OpenMW window.
-If true, the cursor movement stops at the edge of the window preventing access to other applications.
-If false, the cursor is allowed to move freely on the desktop.
-
-This setting does not apply to the screen where escape has been pressed, where the cursor is never captured.
-Regardless of this setting "Alt-Tab" or some other operating system dependent key sequence can be used
-to allow the operating system to regain control of the mouse cursor.
-This setting interacts with the minimize on focus loss setting by affecting what counts as a focus loss.
-Specifically on a two-screen configuration it may be more convenient to access the second screen with setting disabled.
-
-Note for developers: it's desirable to have this setting disabled when running the game in a debugger,
-to prevent the mouse cursor from becoming unusable when the game pauses on a breakpoint.
-
-This setting can only be configured by editing the settings configuration file.
-
-toggle sneak
-------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-This setting causes the behavior of the sneak key (bound to Ctrl by default)
-to toggle sneaking on and off rather than requiring the key to be held down while sneaking.
-Players that spend significant time sneaking may find the character easier to control with this option enabled.
-
-**This setting is removed from settings.cfg.**
-
-Can be configured in game in the settings menu.
-
-always run
-----------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If this setting is true, the character is running by default, otherwise the character is walking by default.
-The shift key will temporarily invert this setting, and the caps lock key will invert this setting while it's "locked".
-This setting is updated every time you exit the game,
-based on whether the caps lock key was on or off at the time you exited.
-
-**This setting is removed from settings.cfg.**
-
-This setting can be toggled in game by pressing the CapsLock key or in the settings menu.
-
-camera sensitivity
-------------------
-
-:Type:		floating point
-:Range:		> 0
-:Default:	1.0
-
-This setting controls the overall camera/mouse sensitivity when not in GUI mode.
-The default sensitivity is 1.0, with smaller values requiring more mouse movement,
-and larger values requiring less.
-This setting does not affect mouse speed in GUI mode,
-which is instead controlled by your operating system mouse speed setting.
-
-This setting can be changed with the Camera Sensitivity slider in the Controls panel of the Options menu.
-
-camera y multiplier
--------------------
-
-:Type:		floating point
-:Range:		> 0
-:Default:	1.0
-
-This setting controls the vertical camera/mouse sensitivity relative to the horizontal sensitivity
-(see camera sensitivity above). It is multiplicative with the previous setting,
-meaning that it should remain set at 1.0 unless the player desires to have different sensitivities in the two axes.
-
-This setting can only be configured by editing the settings configuration file.
-
-invert x axis
--------------
-
-:Type:      boolean
-:Range:     True/False
-:Default:   False
-
-
-Invert the horizontal axis while not in GUI mode.
-If this setting is true, moving the mouse to the left will cause the view to rotate counter-clockwise,
-while moving it to the right will cause the view to rotate clockwise. This setting does not affect cursor movement in GUI mode.
-
-This setting can be toggled in game with the Invert X Axis button in the Controls panel of the Options menu.
-
-invert y axis
--------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Invert the vertical axis while not in GUI mode.
-If this setting is true, moving the mouse away from the player will look down,
-while moving it towards the player will look up. This setting does not affect cursor movement in GUI mode.
-
-This setting can be toggled in game with the Invert Y Axis button in the Controls panel of the Options menu.
-
-enable controller
------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-Enable support of controller input — or rather not ignore controller events,
-which are always sent if a controller is present and detected.
-Disabling this setting can be useful for working around controller-related issues or for setting up split-screen gameplay configurations.
-
-This setting can be toggled in game with the Enable Joystick button in the Controls panel of the Options menu.
-
-gamepad cursor speed
---------------------
-
-:Type: float
-:Range: >0
-:Default: 1.0
-
-This setting controls the speed of the cursor within GUI mode when using the joystick.
-This setting has no effect on the camera rotation speed, which is controlled by the
-camera sensitivity setting.
-
-This setting can only be configured by editing the settings configuration file.
-
-joystick dead zone
-------------------
-
-:Type:		floating point
-:Range:		0.0 to 0.5
-:Default:	0.1
-
-This setting controls the radius of dead zone (where an input is discarded) for joystick axes.
-Note that third-party software can provide its own dead zones. In this case OpenmW-specific setting dead zone can be disabled (0.0).
-
-This setting can only be configured by editing the settings configuration file.
-
-enable gyroscope
-----------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Enable the support of camera rotation based on the information supplied from the gyroscope through SDL.
-
-This setting can only be configured by editing the settings configuration file.
-
-Built-in (e. g. in a phone or tablet) and controller gyroscopes are supported. If both are present, controller gyroscope takes priority.
-
-Note: controller gyroscopes are only supported when OpenMW is built with SDL 2.0.14 or higher,
-and were tested only on Windows.
-
-gyro horizontal axis
---------------------
-
-:Type:      string
-:Range:     x, y, z, -x, -y, -z
-:Default:   -x
-
-This setting sets up an axis of the gyroscope as the horizontal camera axis.
-Minus sign swaps the positive and negative direction of the axis.
-Keep in mind that while this setting corresponds to the landscape mode of the display,
-the portrait mode or any other mode will have this axis corrected automatically.
-
-This setting can only be configured by editing the settings configuration file.
-
-gyro vertical axis
-------------------
-
-:Type:      string
-:Range:     x, y, z, -x, -y, -z
-:Default:   y
-
-This setting sets up an axis of the gyroscope as the vertical camera axis.
-Minus sign swaps the positive and negative direction of the axis.
-Keep in mind that while this setting corresponds to the landscape mode of the display,
-the portrait mode or any other mode will have this axis corrected automatically.
-
-This setting can only be configured by editing the settings configuration file.
-
-gyro input threshold
---------------------
-
-:Type:		floating point
-:Range:		>=0
-:Default:	0.0
-
-This setting determines the minimum value of the rotation that will be accepted.
-It allows to avoid crosshair oscillation due to gyroscope "noise".
-
-This setting can only be configured by editing the settings configuration file.
-
-gyro horizontal sensitivity
----------------------------
-
-:Type: float
-:Range: >0
-:Default: 1.0
-
-This setting controls the overall gyroscope horizontal sensitivity.
-The smaller this sensitivity is, the less visible effect the device rotation
-will have on the horizontal camera rotation, and vice versa.
-
-Value of X means that rotating the device by 1 degree will cause the player to rotate by X degrees.
-
-This setting can only be configured by editing the settings configuration file.
-
-gyro vertical sensitivity
--------------------------
-
-:Type: float
-:Range: >0
-:Default: 1.0
-
-This setting controls the overall gyroscope vertical sensitivity.
-The smaller this sensitivity is, the less visible effect the device
-rotation will have on the vertical camera rotation, and vice versa.
-
-Value of X means that rotating the device by 1 degree will cause the player to rotate by X degrees.
-
-This setting can only be configured by editing the settings configuration file.
+.. omw-setting::
+   :title: grab cursor
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Settings > Testing`
+
+   If true, OpenMW captures the mouse cursor.
+   In GUI mode, prevents cursor from leaving the window.
+   In look mode, cursor is always centered.
+   Useful to disable when debugging or using multi-monitor setups.
+
+.. omw-setting::
+   :title: toggle sneak
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-info:`Lua` :bdg-info:`In Game > Options > Scripts > OpenMW Camera`
+
+   Sneak key toggles sneaking on/off instead of needing to be held.
+   Useful for extended sneaking sessions.
+
+.. omw-setting::
+   :title: always run
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-info:`Lua` :bdg-info:`In Game > Options > Scripts > OpenMW Controls`
+
+   If true, character runs by default.
+   Shift inverts behavior temporarily; CapsLock toggles it persistently.
+
+.. omw-setting::
+   :title: camera sensitivity
+   :type: float32
+   :range: > 0
+   :default: 1.0
+   :location: :bdg-info:`In Game > Options > Controls > Mouse/Keyboard`
+
+   Controls mouse sensitivity outside of GUI mode.
+   Does not affect GUI cursor speed.
+
+.. omw-setting::
+   :title: camera y multiplier
+   :type: float32
+   :range: > 0
+   :default: 1.0
+
+
+   Adjusts vertical camera sensitivity relative to horizontal.
+   Multiplied with the camera sensitivity value.
+
+.. omw-setting::
+   :title: invert x axis
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-info:`In Game > Options > Controls`
+
+   Inverts horizontal camera movement outside of GUI mode.
+
+.. omw-setting::
+   :title: invert y axis
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-info:`In Game > Options > Controls`
+
+   Inverts vertical camera movement outside of GUI mode.
+
+.. omw-setting::
+   :title: enable controller
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-info:`In Game > Options > Controls`
+
+   Enables controller input (if present).
+   Disable to avoid controller interference or for split-screen setups.
+
+.. omw-setting::
+   :title: gamepad cursor speed
+   :type: float32
+   :range: >0
+   :default: 1.0
+
+   Controls joystick-based cursor speed in GUI mode.
+   Does not affect camera movement.
+
+.. omw-setting::
+   :title: joystick dead zone
+   :type: float32
+   :range: 0.0 to 0.5
+   :default: 0.1
+
+   Sets radius for joystick dead zones.
+   Values inside the zone are ignored.
+   Can be set to 0.0 when using third-party dead zone tools.
+
+.. omw-setting::
+   :title: enable gyroscope
+   :type: boolean
+   :range: true, false
+   :default: false
+
+   Enables camera control via gyroscope (built-in or controller-based).
+   Controller gyroscopes require SDL 2.0.14+ (tested on Windows).
+
+.. omw-setting::
+   :title: gyro horizontal axis
+   :type: string
+   :range: x, y, z, -x, -y, -z
+   :default: -x
+
+   Sets gyroscope axis used for horizontal camera movement.
+   Minus sign reverses direction.
+   Axis is landscape-aligned and auto-corrects for portrait.
+
+.. omw-setting::
+   :title: gyro vertical axis
+   :type: string
+   :range: x, y, z, -x, -y, -z
+   :default: y
+
+   Sets gyroscope axis used for vertical camera movement.
+   Minus sign reverses direction.
+   Axis is landscape-aligned and auto-corrects for portrait.
+
+.. omw-setting::
+   :title: gyro input threshold
+   :type: float32
+   :range: ≥0
+   :default: 0.0
+
+   Sets minimum gyroscope movement value to avoid noise-based crosshair jitter.
+
+.. omw-setting::
+   :title: gyro horizontal sensitivity
+   :type: float32
+   :range: >0
+   :default: 1.0
+
+   Controls horizontal sensitivity for gyroscope input.
+   A value of X means 1° of real-world rotation causes X° of in-game rotation.
+
+.. omw-setting::
+   :title: gyro vertical sensitivity
+   :type: float32
+   :range: >0
+   :default: 1.0
+
+   Controls vertical sensitivity for gyroscope input.
+   A value of X means 1° of real-world rotation causes X° of in-game rotation.
diff --git a/docs/source/reference/modding/settings/lua.rst b/docs/source/reference/modding/settings/lua.rst
index 1369e4edf0..77848e23c7 100644
--- a/docs/source/reference/modding/settings/lua.rst
+++ b/docs/source/reference/modding/settings/lua.rst
@@ -1,100 +1,74 @@
 Lua Settings
 ############
 
-lua debug
----------
+.. omw-setting::
+   :title: lua debug
+   :type: boolean
+   :range: true, false
+   :default: false
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   Enables debug tracebacks for Lua actions.
+   Causes significant performance overhead.
 
-Enables debug tracebacks for Lua actions.
-It adds significant performance overhead, don't enable if you don't need it.
+.. omw-setting::
+   :title: lua num threads
+   :type: int
+   :range: 0, 1
+   :default: 1
 
-This setting can only be configured by editing the settings configuration file.
+   Maximum number of threads used for Lua scripts.
+   0 = main thread only, 1 = separate thread.
+   Values >1 not supported.
 
-lua num threads
----------------
+.. omw-setting::
+   :title: lua profiler
+   :type: boolean
+   :range: true, false
+   :default: true
 
-:Type:		integer
-:Range:		0, 1
-:Default:	1
+   Enables Lua profiler.
 
-The maximum number of threads used for Lua scripts.
-If zero, Lua scripts are processed in the main thread.
-If one, a separate thread is used.
-Values >1 are not yet supported.
+.. omw-setting::
+   :title: small alloc max size
+   :type: int
+   :range: ≥ 0
+   :default: 1024
 
-This setting can only be configured by editing the settings configuration file.
+   Max size in bytes for allocations without ownership tracking.
+   Used only if lua profiler is true.
+   Lower values increase memory tracking detail at cost of overhead.
 
-lua profiler
-------------
+.. omw-setting::
+   :title: memory limit
+   :type: int
+   :range: > 0
+   :default: 2147483648
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   Memory limit for Lua runtime (if lua profiler is true).
+   If exceeded, only small allocations are allowed.
 
-Enables Lua profiler.
+.. omw-setting::
+   :title: log memory usage
+   :type: boolean
+   :range: true, false
+   :default: false
 
-This setting can only be configured by editing the settings configuration file.
+   Prints debug info about memory usage (if lua profiler is true).
 
-small alloc max size
---------------------
+.. omw-setting::
+   :title: instruction limit per call
+   :type: int
+   :range: > 1000
+   :default: 100000000
 
-:Type:		unsigned 64-bit integer
-:Range:		>= 0
-:Default:	1024
+   Max number of Lua instructions per function call (if lua profiler is true).
+   Functions exceeding this limit will be terminated.
 
-No ownership tracking for memory allocations below or equal this size (in bytes).
-This setting is used only if ``lua profiler = true``.
-With the default value (1024) the lua profiler will show almost no memory usage because allocation more than 1KB are rare.
-Decrease the value of this setting (e.g. set it to 64) to have better memory tracking by the cost of higher overhead.
-
-This setting can only be configured by editing the settings configuration file.
-
-memory limit
-------------
-
-:Type:		unsigned 64-bit integer
-:Range:		> 0
-:Default:	2147483648 (2GB)
-
-Memory limit for Lua runtime (only if ``lua profiler = true``). If exceeded then only small allocations are allowed.
-Small allocations are always allowed, so e.g. Lua console can function.
-
-This setting can only be configured by editing the settings configuration file.
-
-log memory usage
-----------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Print debug info about memory usage (only if ``lua profiler = true``).
-
-This setting can only be configured by editing the settings configuration file.
-
-instruction limit per call
---------------------------
-
-:Type:		unsigned 64-bit integer
-:Range:		> 1000
-:Default:	100000000
-
-The maximal number of Lua instructions per function call (only if ``lua profiler = true``).
-If exceeded (e.g. because of an infinite loop) the function will be terminated.
-
-This setting can only be configured by editing the settings configuration file.
-
-gc steps per frame
-------------------
-
-:Type:		integer
-:Range:		>= 0
-:Default:	100
-
-Lua garbage collector steps per frame. The higher the value the more time Lua runtime can spend on freeing unused memory.
-
-This setting can only be configured by editing the settings configuration file.
+.. omw-setting::
+   :title: gc steps per frame
+   :type: int
+   :range: ≥ 0
+   :default: 100
 
+   Lua garbage collector steps per frame.
+   Higher values allow more memory to be freed per frame.
diff --git a/docs/source/reference/modding/settings/map.rst b/docs/source/reference/modding/settings/map.rst
index 7468b2b836..b6d8bddfaa 100644
--- a/docs/source/reference/modding/settings/map.rst
+++ b/docs/source/reference/modding/settings/map.rst
@@ -1,113 +1,67 @@
 Map Settings
 ############
 
-global
-------
+.. omw-setting::
+   :title: global
+   :type: boolean
+   :range: true, false
+   :default: false
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   If true, the map window displays the world map; otherwise, it displays the local map.
+   Updates automatically when switching map views in-game.
 
-If this value is true, the map window will display the world map, otherwise the local map. 
-The setting updates automatically when pressing the local/world map switch button on the map window.
+.. omw-setting::
+   :title: global map cell size
+   :type: int
+   :range: 1 to 50
+   :default: 18
 
-global map cell size
---------------------
+   Sets the width in pixels of each cell on the world map.
+   Larger values show more detail, smaller values less.
+   Recommended values: 12 to 36.
+   Changing this affects saved games due to scaling of explored area overlays.
 
-:Type:		integer
-:Range:		1 to 50
-:Default:	18
+.. omw-setting::
+   :title: local map hud fog of war
+   :type: boolean
+   :range: true, false
+   :default: false
 
-This setting adjusts the scale of the world map in the GUI mode map window.
-The value is the width in pixels of each cell in the map, so larger values result in larger more detailed world maps,
-while smaller values result in smaller less detailed world maps.
-However, the native resolution of the map source material appears to be 9 pixels per unexplored cell
-and approximately 18 pixels per explored cell, so values larger than 36 don't produce much additional detail.
-Similarly, the size of place markers is currently fixed at 12 pixels,
-so values smaller than this result in overlapping place markers.
-Values from 12 to 36 are recommended. For reference, Vvardenfell is approximately 41x36 cells.
+   Enables fog of war rendering on the HUD map.
+   Default off since map size limits fog impact.
 
-.. Warning::
-	Changing this setting affects saved games. The currently explored area is stored as an image
-	in the save file that's overlaid on the default world map in game.
-	When you increase the resolution of the map, the overlay of earlier saved games will be scaled up on load,
-	and appear blurry. When you visit the cell again, the overlay for that cell is regenerated at the new resolution,
-	so the blurry areas can be corrected by revisiting all the cells you've already visited.
+.. omw-setting::
+   :title: local map resolution
+   :type: int
+   :range: ≥ 1
+   :default: 256
 
-This setting can not be configured except by editing the settings configuration file.
+   Controls resolution of the GUI local map window.
+   Larger values increase detail but may cause load time and VRAM issues.
 
-local map hud fog of war
-------------------------
+.. omw-setting::
+   :title: local map widget size
+   :type: int
+   :range: ≥ 1
+   :default: 512
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   Sets the canvas size of the GUI local map window.
+   Larger sizes increase on-screen map size and panning.
 
-This setting enables fog of war rendering on the HUD map.
-Default is Off since with default settings the map is so small that the fog would not obscure anything,
-just darken the edges slightly.
+.. omw-setting::
+   :title: allow zooming
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Interface`
 
-local map resolution
---------------------
+   Enables zooming on local and global maps via mouse wheel.
 
-:Type:		integer
-:Range:		>= 1
-:Default:	256
+.. omw-setting::
+   :title: max local viewing distance
+   :type: int
+   :range: > 0
+   :default: 10
 
-This setting controls the resolution of the GUI mode local map window.
-Larger values generally increase the visible detail in map.
-If this setting is half the local map widget size or smaller, the map will generally be be fairly blurry.
-Setting both options to the same value results in a map with good detail.
-Values that exceed the local map widget size setting by more than a factor of two
-are unlikely to provide much of an improvement in detail since they're subsequently scaled back
-to the approximately the map widget size before display.
-The video resolution settings interacts with this setting in that regard.
-
-.. warning::
-	Increasing this setting can increase cell load times,
-	because the map is rendered on demand each time you enter a new cell.
-	Large values may exceed video card limits or exhaust VRAM.
-
-This setting can not be configured except by editing the settings configuration file.
-
-local map widget size
----------------------
-
-:Type:		integer
-:Range:		>= 1
-:Default:	512
-
-This setting controls the canvas size of the GUI mode local map window.
-Larger values result in a larger physical map size on screen,
-and typically require more panning to see all available portions of the map.
-This larger size also enables an overall greater level of detail if the local map resolution setting is also increased.
-
-This setting can not be configured except by editing the settings configuration file.
-
-allow zooming
--------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If this setting is true the user can zoom in/out on local and global map with the mouse wheel.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-max local viewing distance
----------------------------
-
-:Type:		integer
-:Range:		> 0
-:Default:	10
-
-This setting controls the viewing distance on local map when 'distant terrain' is enabled.
-If this setting is greater than the viewing distance then only up to the viewing distance is used for local map, otherwise the viewing distance is used.
-If view distance is changed in settings menu during the game, then viewable distance on the local map is not updated.
-
-.. warning::
-	Increasing this setting can increase cell load times,
-	because the localmap take a snapshot of each cell contained in a square of 2 x (max local viewing distance) + 1 square.
-
-This setting can not be configured except by editing the settings configuration file.
+   Controls viewing distance on the local map when 'distant terrain' is enabled.
+   Increasing this may increase cell load times.
diff --git a/docs/source/reference/modding/settings/models.rst b/docs/source/reference/modding/settings/models.rst
index f39faca7cf..3cde29f685 100644
--- a/docs/source/reference/modding/settings/models.rst
+++ b/docs/source/reference/modding/settings/models.rst
@@ -1,262 +1,174 @@
 Models Settings
 ###############
 
-load unsupported nif files
---------------------------
+.. omw-setting::
+   :title: load unsupported nif files
+   :type: boolean
+   :range: true, false
+   :default: false
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   Allows the engine to load arbitrary NIF files that appear valid.
+   Support is limited and experimental; enabling may cause crashes or memory issues.
+   Do not enable unless you understand the risks.
 
-Allow the engine to load arbitrary NIF files as long as they appear to be valid.
+.. omw-setting::
+   :title: xbaseanim
+   :type: string
+   :default: meshes/xbase_anim.nif
 
-OpenMW has limited and **experimental** support for NIF files
-that Morrowind itself cannot load, which normally goes unused.
+   Path to the 3rd person base animation model file; expects a matching KF file.
+   For COLLADA, use the same file for all animation entries with corresponding textkeys.
 
-If enabled, this setting allows the NIF loader to make use of that functionality.
+.. omw-setting::
+   :title: baseanim
+   :type: string
+   :default: meshes/base_anim.nif
 
-.. warning::
-	You must keep in mind that since the mentioned support is experimental,
-	loading unsupported NIF files may fail, and the degree of this failure may vary.
-	
-	In milder cases, OpenMW will reject the file anyway because
-	it lacks a definition for a certain record type that the file may use.
-	
-	In more severe cases OpenMW's incomplete understanding of a record type
-	can lead to memory corruption, freezes or even crashes.
-	
-	**Do not enable** this if you're not so sure that you know what you're doing.
+   Path to the 3rd person base model file with textkeys data.
 
-xbaseanim
----------
+.. omw-setting::
+   :title: xbaseanim1st
+   :type: string
+   :default: meshes/xbase_anim.1st.nif
 
-:Type:		string
-:Range:		
-:Default:	meshes/xbase_anim.nif
+   Path to the 1st person base animation model file; expects a matching KF file.
 
-Path to the file used for 3rd person base animation model that looks also for 
-the corresponding kf-file.
+.. omw-setting::
+   :title: baseanimkna
+   :type: string
+   :default: meshes/base_animkna.nif
 
-.. note::
-	If you are using the COLLADA format, you don't need to separate the files as 
-	they are separated between .nif and .kf files. It works if you plug the same 
-	COLLADA file into all animation-related entries, just make sure there is a 
-	corresponding textkeys file. You can read more about the textkeys in 
-	:doc:`../../modding/custom-models/pipeline-blender-collada-animated-creature`.
+   Path to the 3rd person beast race base model with textkeys data.
 
-baseanim
---------
+.. omw-setting::
+   :title: baseanimkna1st
+   :type: string
+   :default: meshes/base_animkna.1st.nif
 
-:Type:		string
-:Range:		
-:Default:	meshes/base_anim.nif
+   Path to the 1st person beast race base animation model.
 
-Path to the file used for 3rd person base model with textkeys-data.
+.. omw-setting::
+   :title: xbaseanimfemale
+   :type: string
+   :default: meshes/xbase_anim_female.nif
 
-xbaseanim1st
-------------
+   Path to the 3rd person female base animation model.
 
-:Type:		string
-:Range:		
-:Default:	meshes/xbase_anim.1st.nif
+.. omw-setting::
+   :title: baseanimfemale
+   :type: string
+   :default: meshes/base_anim_female.nif
 
-Path to the file used for 1st person base animation model that looks also for 
-corresponding kf-file.
+   Path to the 3rd person female base model with textkeys data.
 
-baseanimkna
------------
+.. omw-setting::
+   :title: baseanimfemale1st
+   :type: string
+   :default: meshes/base_anim_female.1st.nif
 
-:Type:		string
-:Range:		
-:Default:	meshes/base_animkna.nif
+   Path to the 1st person female base model with textkeys data.
 
-Path to the file used for 3rd person beast race base model with textkeys-data.
+.. omw-setting::
+   :title: wolfskin
+   :type: string
+   :default: meshes/wolf/skin.nif
 
-baseanimkna1st
---------------
+   Path to the 3rd person werewolf skin model.
 
-:Type:		string
-:Range:		
-:Default:	meshes/base_animkna.1st.nif
+.. omw-setting::
+   :title: wolfskin1st
+   :type: string
+   :default: meshes/wolf/skin.1st.nif
 
-Path to the file used for 1st person beast race base animation model.
+   Path to the 1st person werewolf skin model.
 
-xbaseanimfemale
----------------
+.. omw-setting::
+   :title: xargonianswimkna
+   :type: string
+   :default: meshes/xargonian_swimkna.nif
 
-:Type:		string
-:Range:		
-:Default:	meshes/xbase_anim_female.nif
+   Path to the Argonian swimkna model.
 
-Path to the file used for 3rd person female base animation model.
+.. omw-setting::
+   :title: xbaseanimkf
+   :type: string
+   :default: meshes/xbase_anim.kf
 
-baseanimfemale
---------------
+   Animation file for xbaseanim 3rd person animations.
 
-:Type:		string
-:Range:		
-:Default:	meshes/base_anim_female.nif
+.. omw-setting::
+   :title: xbaseanim1stkf
+   :type: string
+   :default: meshes/xbase_anim.1st.kf
 
-Path to the file used for 3rd person female base model with textkeys-data.
+   Animation file for xbaseanim 1st person animations.
 
-baseanimfemale1st
------------------
+.. omw-setting::
+   :title: xbaseanimfemalekf
+   :type: string
+   :default: meshes/xbase_anim_female.kf
 
-:Type:		string
-:Range:		
-:Default:	meshes/base_anim_female.1st.nif
+   Animation file for xbaseanim female animations.
 
-Path to the file used for 1st person female base model with textkeys-data.
+.. omw-setting::
+   :title: xargonianswimknakf
+   :type: string
+   :default: meshes/xargonian_swimkna.kf
 
-wolfskin
---------
+   Animation file for xargonianswimkna animations.
 
-:Type:		string
-:Range:		
-:Default:	meshes/wolf/skin.nif
+.. omw-setting::
+   :title: skyatmosphere
+   :type: string
+   :default: meshes/sky_atmosphere.nif
 
-Path to the file used for 3rd person werewolf skin.
+   Sky atmosphere mesh for the top half of the sky.
 
-wolfskin1st
------------
+.. omw-setting::
+   :title: skyclouds
+   :type: string
+   :default: meshes/sky_clouds_01.nif
 
-:Type:		string
-:Range:		
-:Default:	meshes/wolf/skin.1st.nif
+   Sky clouds mesh displaying scrolling cloud textures.
 
-Path to the file used for 1st person werewolf skin.
+.. omw-setting::
+   :title: skynight01
+   :type: string
+   :default: meshes/sky_night_01.nif
 
-xargonianswimkna
-----------------
+   Sky stars mesh used during night if skynight02 is not present.
 
-:Type:		string
-:Range:		
-:Default:	meshes/xargonian_swimkna.nif
+.. omw-setting::
+   :title: skynight02
+   :type: string
+   :default: meshes/sky_night_02.nif
 
-Path to the file used for Argonian swimkna.
+   Sky stars mesh used during night, takes priority over skynight01.
 
-xbaseanimkf
------------
+.. omw-setting::
+   :title: weatherashcloud
+   :type: string
+   :default: meshes/ashcloud.nif
 
-:Type:		string
-:Range:		
-:Default:	meshes/xbase_anim.kf
+   Ash clouds weather effect file from Morrowind (not used by OpenMW).
 
-File to load xbaseanim 3rd person animations.
+.. omw-setting::
+   :title: weatherblightcloud
+   :type: string
+   :default: meshes/blightcloud.nif
 
-xbaseanim1stkf
---------------
+   Blight clouds weather effect file from Morrowind (not used by OpenMW).
 
-:Type:		string
-:Range:		
-:Default:	meshes/xbase_anim.1st.kf
+.. omw-setting::
+   :title: weathersnow
+   :type: string
+   :default: meshes/snow.nif
 
-File to load xbaseanim 3rd person animations.
+   Snow falling weather effect file from Morrowind (not used by OpenMW).
 
-xbaseanimfemalekf
------------------
+.. omw-setting::
+   :title: weatherblizzard
+   :type: string
+   :default: meshes/blizzard.nif
 
-:Type:		string
-:Range:		
-:Default:	meshes/xbase_anim_female.kf
-
-File to load xbaseanim animations from.
-
-xargonianswimknakf
-------------------
-
-:Type:		string
-:Range:		
-:Default:	meshes/xargonian_swimkna.kf
-
-File to load xargonianswimkna animations from.
-
-skyatmosphere
--------------
-
-:Type:		string
-:Range:		
-:Default:	meshes/sky_atmosphere.nif
-
-Path to the file used for the sky atmosphere mesh, which is one of the three 
-meshes needed to render the sky. It's used to make the top half of the sky blue 
-and renders in front of the background color.
-
-skyclouds
----------
-
-:Type:		string
-:Range:		
-:Default:	meshes/sky_clouds_01.nif.
-
-Path to the file used for the sky clouds mesh, which is one of the three meshes 
-needed to render the sky. It displays a scrolling texture of clouds in front of 
-the atmosphere mesh and background color
-
-skynight01
-----------
-
-:Type:		string
-:Range:		
-:Default:	meshes/sky_night_01.nif
-
-Path to the file used for the sky stars mesh, which is one of the three meshes 
-needed to render the sky. During night, it displays a texture with stars in 
-front of the atmosphere and behind the clouds. If skynight02 is present, 
-skynight01 will not be used.
-
-skynight02
-----------
-
-:Type:		string
-:Range:		
-:Default:	meshes/sky_night_02.nif
-
-Path to the file used for the sky stars mesh, which is one of the three meshes 
-needed to render the sky. During night, it displays a texture with stars in 
-front of the atmosphere and behind the clouds. If it's present it will be used 
-instead of skynight01.
-
-weatherashcloud
----------------
-
-:Type:		string
-:Range:		
-:Default:	meshes/ashcloud.nif
-
-Path to the file used for the ash clouds weather effect in Morrowind. OpenMW 
-doesn't use this file, instead it renders a similar looking particle effect. 
-Changing this won't have any effect.
-
-weatherblightcloud
-------------------
-
-:Type:		string
-:Range:		
-:Default:	meshes/blightcloud.nif
-
-Path to the file used for the blight clouds weather effect in Morrowind. OpenMW 
-doesn't use this file, instead it renders a similar looking particle effect. 
-Changing this won't have any effect.
-
-weathersnow
------------
-
-:Type:		string
-:Range:		
-:Default:	meshes/snow.nif
-
-Path to the file used for the snow falling weather effect in Morrowind. OpenMW 
-doesn't use this file, instead it renders a similar looking particle effect. 
-Changing this won't have any effect.
-
-weatherblizzard
----------------
-
-:Type:		string
-:Range:		
-:Default:	meshes/blizzard.nif
-
-Path to the file used for the blizzard clouds weather effect in Morrowind. 
-OpenMW doesn't use this file, instead it renders a similar looking particle 
-effect. Changing this won't have any effect.
+   Blizzard weather effect file from Morrowind (not used by OpenMW).
diff --git a/docs/source/reference/modding/settings/navigator.rst b/docs/source/reference/modding/settings/navigator.rst
index 6fafdcdfd2..a163d1ce52 100644
--- a/docs/source/reference/modding/settings/navigator.rst
+++ b/docs/source/reference/modding/settings/navigator.rst
@@ -1,433 +1,298 @@
 Navigator Settings
 ##################
 
-Main settings
-*************
+.. omw-setting::
+   :title: enable
+   :type: boolean
+   :range: true, false
+   :default: true
+
+   Enables the navigator system, building a navmesh for pathfinding.
+   Disabling uses only path grid, which affects NPC AI and pathfinding.
+   May impact performance, especially on single-core CPUs.
+
+.. omw-setting::
+   :title: max tiles number
+   :type: int
+   :range: ≥ 0
+   :default: 512
+
+   Sets the number of tiles in the navmesh area around the player.
+   Increasing can decrease performance.
+   Must satisfy: max tiles number * max polygons per tile ≤ 4194304.
+
+.. omw-setting::
+   :title: wait until min distance to player
+   :type: int
+   :range: ≥ 0
+   :default: 5
+
+   Distance in tiles around player to delay loading screen until navmesh is generated.
+   Zero disables waiting.
+
+.. omw-setting::
+   :title: enable nav mesh disk cache
+   :type: boolean
+   :range: true, false
+   :default: true
+
+   Enables using disk cache for navmesh tiles in addition to memory cache.
+
+.. omw-setting::
+   :title: write to navmeshdb
+   :type: boolean
+   :range: true, false
+   :default: true
+
+   Enables writing generated navmesh tiles to disk cache during runtime.
+
+.. omw-setting::
+   :title: max navmeshdb file size
+   :type: uint
+   :range: > 0
+   :default: 2147483648
+
+   Maximum size in bytes of navmesh disk cache file.
+
+.. omw-setting::
+   :title: async nav mesh updater threads
+   :type: uint
+   :range: ≥ 1
+   :default: 1
+
+   Number of background threads updating navmesh.
+   Increasing threads may affect latency and performance.
+
+.. omw-setting::
+   :title: max nav mesh tiles cache size
+   :type: uint
+   :range: ≥ 0
+   :default: 268435456
+
+   Maximum memory size for cached navmesh tiles.
+   Larger cache reduces update latency but uses more memory.
+
+.. omw-setting::
+   :title: min update interval ms
+   :type: int
+   :range: ≥ 0
+   :default: 250
+
+   Minimum milliseconds between navmesh updates per tile when objects move.
+   Smaller values increase CPU usage.
+
+.. omw-setting::
+   :title: enable write recast mesh to file
+   :type: boolean
+   :range: true, false
+   :default: false
+
+   Write recast mesh to .obj file on each update for debugging.
+
+.. omw-setting::
+   :title: enable write nav mesh to file
+   :type: boolean
+   :range: true, false
+   :default: false
+
+   Write navmesh to file readable by RecastDemo app.
+
+.. omw-setting::
+   :title: enable recast mesh file name revision
+   :type: boolean
+   :range: true, false
+   :default: false
+
+   Append revision number to recast mesh file names to keep history.
+
+.. omw-setting::
+   :title: enable nav mesh file name revision
+   :type: boolean
+   :range: true, false
+   :default: false
+
+   Append revision number to navmesh file names to keep history.
+
+.. omw-setting::
+   :title: recast mesh path prefix
+   :type: string
+   :default: ""
+
+   File path prefix for recast mesh files.
+
+.. omw-setting::
+   :title: nav mesh path prefix
+   :type: string
+   :default: ""
 
-This section is for players.
+   File path prefix for navmesh files.
 
-enable
-------
+.. omw-setting::
+   :title: enable nav mesh render
+   :type: boolean
+   :range: true, false
+   :default: false
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   Render the navmesh in-game for debugging.
 
-Enable navigator to make all settings in this category take effect.
-When enabled, a navigation mesh (navmesh) is built in the background for world geometry to be used for pathfinding.
-When disabled only the path grid is used to build paths.
-Single-core CPU systems may have a big performance impact on existing interior location and moving across the exterior world.
-May slightly affect performance on multi-core CPU systems.
-Multi-core CPU systems may have different latency for navigation mesh update depending on other settings and system performance.
-Moving across external world, entering/exiting location produce navigation mesh update.
-NPC and creatures may not be able to find path before navigation mesh is built around them.
-Try to disable this if you want to have old fashioned AI which doesn't know where to go when you stand behind that stone and cast a firebolt.
+.. omw-setting::
+   :title: nav mesh render mode
+   :type: string
+   :range: "area type", "update frequency"
+   :default: "area type"
 
-max tiles number
-----------------
+   Mode to render navmesh: color by area type or show update frequency heatmap.
 
-:Type:		integer
-:Range:		>= 0
-:Default:	512
+.. omw-setting::
+   :title: enable agents paths render
+   :type: boolean
+   :range: true, false
+   :default: false
 
-Number of tiles at navigation mesh.
-Nav mesh covers circle area around player.
-This option allows to set an explicit limit for navigation mesh size, how many tiles should fit into circle.
-If actor is inside this area it able to find path over navigation mesh.
-Increasing this value may decrease performance.
+   Render NPC/creature planned paths, even if navigator disabled.
 
-.. note::
-    Don't expect infinite navigation mesh size increasing.
-    This condition is always true: ``max tiles number * max polygons per tile <= 4194304``.
-    It's a limitation of `Recastnavigation <https://github.com/recastnavigation/recastnavigation>`_ library.
+.. omw-setting::
+   :title: enable recast mesh render
+   :type: boolean
+   :range: true, false
+   :default: false
 
-wait until min distance to player
----------------------------------
+   Render recast mesh (culled tiles from physical mesh) for debugging.
 
-:Type:		integer
-:Range:		>= 0
-:Default:	5
+.. omw-setting::
+   :title: wait for all jobs on exit
+   :type: boolean
+   :range: true, false
+   :default: false
 
-Distance in navigation mesh tiles around the player to keep loading screen until navigation mesh is generated.
-Allows to complete cell loading only when minimal navigation mesh area is generated to correctly find path for actors
-nearby the player. Increasing this value will keep loading screen longer but will slightly increase navigation mesh generation
-speed on systems bound by CPU. Zero means no waiting.
+   Wait for all async navmesh jobs to complete before engine exit.
 
-enable nav mesh disk cache
---------------------------
+.. omw-setting::
+   :title: recast scale factor
+   :type: float32
+   :range: > 0.0
+   :default: 0.029411764705882353
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   Scale factor between navigation mesh voxels and world units.
+   Changing affects mesh generation and navigation accuracy.
 
-If true navigation mesh cache stored on disk will be used in addition to memory cache.
-If navigation mesh tile is not present in memory cache, it will be looked up in the disk cache.
-If it's not found there it will be generated.
+.. omw-setting::
+   :title: max polygon path size
+   :type: uint
+   :range: > 0
+   :default: 1024
 
-write to navmeshdb
-------------------
+   Maximum path length over polygons.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+.. omw-setting::
+   :title: max smooth path size
+   :type: uint
+   :range: > 0
+   :default: 1024
 
-If true generated navigation mesh tiles will be stored into disk cache while game is running.
+   Maximum length of smoothed path.
 
-max navmeshdb file size
------------------------
+.. omw-setting::
+   :title: cell height
+   :type: float32
+   :range: > 0.0
+   :default: 0.2
 
-:Type:		unsigned 64-bit integer
-:Range:		> 0
-:Default:	2147483648
+   Height (Z axis) size of each voxel cell in navigation mesh.
 
-Approximate maximum file size of navigation mesh cache stored on disk in bytes (value > 0).
+.. omw-setting::
+   :title: cell size
+   :type: float32
+   :range: > 0.0
+   :default: 0.2
 
-Advanced settings
-*****************
+   XY plane size of each voxel cell in navigation mesh.
 
-This section is for advanced PC uses who understands concepts of OS thread and memory.
+.. omw-setting::
+   :title: detail sample dist
+   :type: float32
+   :range: 0.0 or ≥ 0.9
+   :default: 6.0
 
-async nav mesh updater threads
-------------------------------
+   Sampling distance when generating detail mesh.
 
-:Type:		platform dependant unsigned integer
-:Range:		>= 1
-:Default:	1
+.. omw-setting::
+   :title: detail sample max error
+   :type: float32
+   :range: ≥ 0.0
+   :default: 1.0
 
-Number of background threads to update navigation mesh.
-Increasing this value may decrease performance, but also may decrease or increase navigation mesh update latency depending on number of CPU cores.
-On systems with not less than 4 CPU cores latency dependens approximately like 1/log(n) from number of threads.
-Don't expect twice better latency by doubling this value.
+   Maximum deviation distance of detail mesh surface from heightfield.
 
-max nav mesh tiles cache size
------------------------------
+.. omw-setting::
+   :title: max simplification error
+   :type: float32
+   :range: ≥ 0.0
+   :default: 1.3
 
-:Type:		platform dependant unsigned integer
-:Range:		>= 0
-:Default:	268435456
+   Max deviation for simplified contours from raw contour.
 
-Maximum total cached size of all navigation mesh tiles in bytes.
-Setting greater than zero value will reduce navigation mesh update latency for previously visited locations.
-Increasing this value may increase total memory consumption, but potentially will reduce latency for recently visited locations.
-Limit this value by total available physical memory minus base game memory consumption and other applications.
-Game will not eat all memory at once.
-Memory will be consumed in approximately linear dependency from number of navigation mesh updates.
-But only for new locations or already dropped from cache.
+.. omw-setting::
+   :title: tile size
+   :type: int
+   :range: > 0
+   :default: 128
 
-min update interval ms
-----------------------
+   Width and height of each navmesh tile in voxels.
 
-:Type:		integer
-:Range:		>= 0
-:Default:	250
+.. omw-setting::
+   :title: border size
+   :type: int
+   :range: ≥ 0
+   :default: 16
 
-Minimum time duration required to pass before next navigation mesh update for the same tile in milliseconds.
-Only tiles affected where objects are transformed.
-Next update for tile with added or removed object will not be delayed.
-Visible ingame effect is navigation mesh update around opening or closing door.
-Primary usage is for rotating signs like in Seyda Neen at Arrille's Tradehouse entrance.
-Decreasing this value may increase CPU usage by background threads.
+   Size of non-navigable border around heightfield.
 
-Developer's settings
-********************
+.. omw-setting::
+   :title: max edge len
+   :type: int
+   :range: ≥ 0
+   :default: 12
 
-This section is for developers or anyone who wants to learn how navigation mesh system works in OpenMW.
+   Max length for contour edges on mesh border.
 
-enable write recast mesh to file
---------------------------------
+.. omw-setting::
+   :title: max nav mesh query nodes
+   :type: int
+   :range: [1, 65535]
+   :default: 2048
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   Maximum number of search nodes for pathfinding queries.
 
-Write recast mesh to file in .obj format for each use to update navigation mesh.
-Option is used to find out what world geometry is used to build navigation mesh.
-Potentially decreases performance.
+.. omw-setting::
+   :title: max polygons per tile
+   :type: int
+   :range: powers of two [0, 22]
+   :default: 4096
 
-enable write nav mesh to file
------------------------------
+   Max polygons per navmesh tile.
+   Must satisfy: max tiles number * max polygons per tile ≤ 4194304.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+.. omw-setting::
+   :title: max verts per poly
+   :type: int
+   :range: ≥ 3
+   :default: 6
 
-Write navigation mesh to file to be able to open by RecastDemo application.
-Usually it is more useful to have both enable write recast mesh to file and this options enabled.
-RecastDemo supports .obj files.
-Potentially decreases performance.
+   Max vertices per polygon in mesh.
 
-enable recast mesh file name revision
--------------------------------------
+.. omw-setting::
+   :title: region merge area
+   :type: int
+   :range: ≥ 0
+   :default: 400
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   Regions smaller than this may be merged with larger ones.
 
-Write each recast mesh file with revision in name.
-Otherwise will rewrite same file.
-If it is unclear when geometry is changed use this option to dump multiple files for each state.
+.. omw-setting::
+   :title: region min area
+   :type: int
+   :range: ≥ 0
+   :default: 64
 
-enable nav mesh file name revision
-----------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Write each navigation mesh file with revision in name.
-Otherwise will rewrite same file.
-If it is unclear when navigation mesh is changed use this option to dump multiple files for each state.
-
-recast mesh path prefix
------------------------
-
-:Type:		string
-:Range:		file system path
-:Default:	""
-
-Write recast mesh file at path with this prefix.
-
-nav mesh path prefix
---------------------
-
-:Type:		string
-:Range:		file system path
-:Default:	""
-
-Write navigation mesh file at path with this prefix.
-
-enable nav mesh render
-----------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Render navigation mesh.
-Allows to do in-game debug.
-Every navigation mesh is visible and every update is noticeable.
-Potentially decreases performance.
-
-nav mesh render mode
---------------------
-
-:Type:		string
-:Range:		"area type", "update frequency"
-:Default:	"area type"
-
-Render navigation mesh in specific mode.
-"area type" - show area types using different colours.
-"update frequency" - show tiles update frequency as a heatmap.
-
-enable agents paths render
---------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Render agents paths.
-Make visible all NPC's and creaure's plans where they are going.
-Works even if Navigator is disabled.
-Potentially decreases performance.
-
-enable recast mesh render
--------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Render recast mesh that is built as set of culled tiles from physical mesh.
-Should show similar mesh to physical one.
-Little difference can be a result of floating point error.
-Absent pieces usually mean a bug in recast mesh tiles building.
-Allows to do in-game debug.
-Potentially decreases performance.
-
-wait for all jobs on exit
--------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Wait until all queued async navmesh jobs are processed before exiting the engine.
-Useful when a benchmark generates jobs to write into navmeshdb faster than they are processed.
-
-Expert settings
-***************
-
-This section is for developers who wants to go deeper into Detournavigator component logic.
-
-recast scale factor
--------------------
-
-:Type:		floating point
-:Range:		> 0.0
-:Default:	0.029411764705882353
-
-Scale of navigation mesh coordinates to world coordinates. Recastnavigation builds voxels for world geometry.
-Basically voxel size is 1 / "cell size". To reduce amount of voxels we apply scale factor, to make voxel size
-"recast scale factor" / "cell size". Default value calculates by this equation:
-sStepSizeUp * "recast scale factor" / "cell size" = 5 (max climb height should be equal to 4 voxels).
-Changing this value will change generated navigation mesh. Some locations may become unavailable for NPC and creatures.
-Pay attention to slopes and roofs when change it. Increasing this value will reduce navigation mesh update latency.
-
-max polygon path size
----------------------
-
-:Type:		platform dependant unsigned integer
-:Range:		> 0
-:Default:	1024
-
-Maximum size of path over polygons.
-
-max smooth path size
---------------------
-
-:Type:		platform dependant unsigned integer
-:Range:		> 0
-:Default:	1024
-
-Maximum size of smoothed path.
-
-Expert Recastnavigation related settings
-****************************************
-
-This section is for OpenMW developers who knows about `Recastnavigation <https://github.com/recastnavigation/recastnavigation>`_ library and understands how it works.
-
-cell height
------------
-
-:Type:		floating point
-:Range:		> 0.0
-:Default:	0.2
-
-The z-axis cell size to use for fields.
-Defines voxel/grid/cell size. So their values have significant
-side effects on all parameters defined in voxel units.
-The minimum value for this parameter depends on the platform's floating point
-accuracy, with the practical minimum usually around 0.05.
-Same default value is used in RecastDemo.
-
-cell size
----------
-
-:Type:		floating point
-:Range:		> 0.0
-:Default:	0.2
-
-The xy-plane cell size to use for fields.
-Defines voxel/grid/cell size. So their values have significant
-side effects on all parameters defined in voxel units.
-The minimum value for this parameter depends on the platform's floating point
-accuracy, with the practical minimum usually around 0.05.
-Same default value is used in RecastDemo.
-
-detail sample dist
-------------------
-
-:Type:		floating point
-:Range:		= 0.0 or >= 0.9
-:Default:	6.0
-
-Sets the sampling distance to use when generating the detail mesh.
-
-detail sample max error
------------------------
-
-:Type:		floating point
-:Range:		>= 0.0
-:Default:	1.0
-
-The maximum distance the detail mesh surface should deviate from heightfield data.
-
-max simplification error
-------------------------
-
-:Type:		floating point
-:Range:		>= 0.0
-:Default:	1.3
-
-The maximum distance a simplfied contour's border edges should deviate the original raw contour.
-
-tile size
----------
-
-:Type:		integer
-:Range:		> 0
-:Default:	128
-
-The width and height of each tile.
-
-border size
------------
-
-:Type:		integer
-:Range:		>= 0
-:Default:	16
-
-The size of the non-navigable border around the heightfield.
-
-max edge len
-------------
-
-:Type:		integer
-:Range:		>= 0
-:Default:	12
-
-The maximum allowed length for contour edges along the border of the mesh.
-
-max nav mesh query nodes
-------------------------
-
-:Type:		integer
-:Range:		0 < value <= 65535
-:Default:	2048
-
-Maximum number of search nodes.
-
-max polygons per tile
----------------------
-
-:Type:		integer
-:Range:		2^n, 0 < n < 22
-:Default:	4096
-
-Maximum number of polygons per navigation mesh tile. Maximum number of navigation mesh tiles depends on
-this value. 22 bits is a limit to store both tile identifier and polygon identifier (tiles = 2^(22 - log2(polygons))).
-See `recastnavigation <https://github.com/recastnavigation/recastnavigation>`_ for more details.
-
-.. Warning::
-    Lower value may lead to ignored world geometry on navigation mesh.
-    Greater value will reduce number of navigation mesh tiles.
-    This condition is always true: ``max tiles number * max polygons per tile <= 4194304``.
-    It's a limitation of `Recastnavigation <https://github.com/recastnavigation/recastnavigation>`_ library.
-
-max verts per poly
-------------------
-
-:Type:		integer
-:Range:		>= 3
-:Default:	6
-
-The maximum number of vertices allowed for polygons generated during the contour to polygon conversion process.
-
-region merge area
------------------
-
-:Type:		integer
-:Range:		>= 0
-:Default:	400
-
-Any regions with a span count smaller than this value will, if possible, be merged with larger regions.
-
-region min area
----------------
-
-:Type:		integer
-:Range:		>= 0
-:Default:	64
-
-The minimum number of cells allowed to form isolated island areas.
+   Minimum cell count to form isolated regions.
diff --git a/docs/source/reference/modding/settings/physics.rst b/docs/source/reference/modding/settings/physics.rst
index e20d18049e..dfd7d4fac8 100644
--- a/docs/source/reference/modding/settings/physics.rst
+++ b/docs/source/reference/modding/settings/physics.rst
@@ -1,27 +1,28 @@
 Physics Settings
 ################
 
-async num threads
------------------
+.. omw-setting::
+   :title: async num threads
+   :type: int
+   :range: ≥ 0
+   :default: 1
+   :location: :bdg-success:`Launcher > Settings > Gameplay`
 
-:Type:		integer
-:Range:		>= 0
-:Default:	1
+   Number of threads spawned for physics updates (processing actor movement) in the background.
+   A value of 0 means physics update runs in the main thread.
+   Values > 1 require Bullet physics library compiled with multithreading support.
+   If multithreading is unsupported, a warning is logged and value 1 is used instead.
 
-Determines how many threads will be spawned to compute physics update in the background (that is, process actors movement). A value of 0 means that the update will be performed in the main thread.
-A value greater than 1 requires the Bullet library be compiled with multithreading support. If that's not the case, a warning will be written in ``openmw.log`` and a value of 1 will be used.
+.. omw-setting::
+   :title: lineofsight keep inactive cache
+   :type: int
+   :range: ≥ -1
+   :default: 0
 
-lineofsight keep inactive cache
--------------------------------
-
-:Type:		integer
-:Range:		>= -1
-:Default:	0
-
-The line of sight determines if 2 actors can see each other (without taking into account game mechanics such as invisibility or sneaking). It is used by some scripts (the getLOS function), by the AI (to determine if an actor should start combat or chase an opponent) and for functionalities such as greetings or turning NPC head toward an object.
-This parameters determine for how long a cache of request should be kept warm.
-A value of 0 means that the cache is kept only for the current frame, that is if a request is done 2 times in the same frame, the second request will be in cache.
-Any value > 0 is the number of frames for which the values are kept in cache even if the results was not requested again.
-If :ref:`async num threads` is 0, a value of 0 will be used.
-If a request is not found in the cache, it is always fulfilled immediately. In case Bullet is compiled without multithreading support, non-cached requests involve blocking the async thread, which might hurt performance.
-If Bullet is compiled with multithreading support, requests are non blocking, it is better to set this parameter to 0.
+   Duration (in frames) to keep line-of-sight request results cached.
+   Line of sight determines if two actors can see each other, used by AI and scripts.
+   0 means cache only for current frame (multiple requests in same frame hit cache).
+   Values > 0 keep cache warm for given frame count even without repeated requests.
+   If async num threads is 0, this setting is forced to 0.
+   If Bullet is compiled without multithreading support, uncached requests block async thread, hurting performance.
+   If Bullet has multithreading, requests are non-blocking, so setting this to 0 is preferable.
diff --git a/docs/source/reference/modding/settings/postprocessing.rst b/docs/source/reference/modding/settings/postprocessing.rst
index 7015c46c7b..4688e225bc 100644
--- a/docs/source/reference/modding/settings/postprocessing.rst
+++ b/docs/source/reference/modding/settings/postprocessing.rst
@@ -1,55 +1,49 @@
 Post-Processing Settings
 ########################
 
-.. _Post Processing:
+.. omw-setting::
+   :title: enabled
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings> Visuals > Post Processing` :bdg-info:`In Game > Options > Video`
 
-enabled
--------
+   Enable or disable post-processing effects.
+   Requires post-processing shaders to be installed.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+.. omw-setting::
+   :title: chain
+   :type: string
+   :location: :bdg-info:`In Game > F2 Menu`
 
-Enable or disable post processing.
-This enables use of post processing shaders, which must be installed.
+   List of active post-processing effects and their order.
+   Recommended to configure via in-game HUD (default key: F2).
+   Note: an empty chain does not disable post-processing.
+   Has no effect if :ref:`enabled` is false.
 
-chain
------
+.. omw-setting::
+   :title: auto exposure speed
+   :type: float32
+   :range: > 0.0001
+   :default: 0.9
+   :location: :bdg-success:`Launcher > Settings> Visuals > Post Processing`
 
-:Type:		string list
+   Controls speed of eye adaptation (scene luminance changes between frames).
+   Smaller values cause slower adaptation.
+   Most noticeable when moving between drastically different lighting (e.g., dark cave to bright sun).
+   Has no effect if HDR or :ref:`enabled` is false.
 
-Controls which post process effects are active and their order.
-It is recommended to configure the settings and order of shaders through the in game HUD. By default this is available with the F2 key.
-Note, an empty chain will not disable post processing.
+.. omw-setting::
+   :title: transparent postpass
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Settings> Visuals > Post Processing`
 
-This setting has no effect if :ref:`enabled` is set to false.
+   Re-renders transparent objects with alpha-clipping using a fixed threshold.
+   Important for vanilla content where blended objects disable depth writes and have large alpha margins.
 
-auto exposure speed
--------------------
-
-:Type:      float
-:Range:     Any number > 0.0001
-:Default:   0.9
-
-Use for eye adaptation to control speed at which average scene luminance can change from one frame to the next.
-Average scene luminance is used in some shader effects for features such as dynamic eye adaptation.
-Smaller values will cause slower changes in scene luminance. This is most impactful when the brightness
-drastically changes quickly, like when entering a dark cave or exiting an interior and looking into a bright sun.
-
-This settings has no effect when HDR is disabled or :ref:`enabled` is set to false.
-
-transparent postpass
---------------------
-
-:Type:      boolean
-:Range:     True/False
-:Default:   True
-
-Re-renders transparent objects with alpha-clipping forced with a fixed threshold. This is particularly important with vanilla content, where blended
-objects usually have depth writes disabled and massive margins between the geometry and texture alpha.
-
-
-.. warning::
-    This can be quite costly with vanilla assets. For best performance it is recommended to use a mod replacer which
-    uses alpha tested foliage and disable this setting. Morrowind Optimization Patch is a great option. 
-    If you are not using any shaders which utilize the depth buffer this setting should be disabled.
+   .. warning::
+      Can be performance heavy with vanilla assets.
+      For better performance, use alpha-tested foliage mods (e.g., Morrowind Optimization Patch) and disable this setting.
+      Disable if no shaders use the depth buffer.
diff --git a/docs/source/reference/modding/settings/saves.rst b/docs/source/reference/modding/settings/saves.rst
index 88aa48fc56..f51596f168 100644
--- a/docs/source/reference/modding/settings/saves.rst
+++ b/docs/source/reference/modding/settings/saves.rst
@@ -1,35 +1,30 @@
 Saves Settings
 ##############
 
-character
----------
+.. omw-setting::
+   :title: character
+   :type: string
+   :default: ""
 
-:Type:		string
-:Range:
-:Default:	""
+   The default character shown in the Load Game menu.
+   Automatically updated when a different character is selected.
 
-This contains the default character for the Load Game menu and is automatically updated when a different character is selected.
+.. omw-setting::
+   :title: autosave
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-info:`In Game > Options > Prefs`
 
-autosave
---------
+   Determines whether the game auto-saves when the character rests.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+.. omw-setting::
+   :title: max quicksaves
+   :type: int
+   :range: >0
+   :default: 1
+   :location: :bdg-success:`Launcher > Settings > Miscellaneous`
 
-This setting determines whether the game will be automatically saved when the character rests.
-
-This setting can be toggled in game with the Auto-Save when Rest button in the Prefs panel of the Options menu.
-
-max quicksaves
---------------
-
-:Type:		integer
-:Range:		>0
-:Default:	1
-
-This setting determines how many quicksave and autosave slots you can have at a time.  If greater than 1, 
-quicksaves will be sequentially created each time you quicksave.  Once the maximum number of quicksaves has been reached, 
-the oldest quicksave will be recycled the next time you perform a quicksave.
-
-This setting can only be configured by editing the settings configuration file.
+   Number of quicksave and autosave slots available.
+   If greater than 1, quicksaves are created sequentially.
+   When the max is reached, the oldest quicksave is overwritten on the next quicksave.
\ No newline at end of file
diff --git a/docs/source/reference/modding/settings/shaders.rst b/docs/source/reference/modding/settings/shaders.rst
index cdf6571808..22f3ed6c07 100644
--- a/docs/source/reference/modding/settings/shaders.rst
+++ b/docs/source/reference/modding/settings/shaders.rst
@@ -1,338 +1,228 @@
 Shaders Settings
 ################
 
-force shaders
--------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Force rendering with shaders, even for objects that don't strictly need them.
-By default, only objects with certain effects, such as bump or normal maps will use shaders.
-With enhancements enabled, such as :ref:`enable shadows` and :ref:`reverse z`, shaders must be used for all objects, as if this setting is true.
-Typically, one or more of these enhancements will be enabled, and shaders will be needed for everything anyway, meaning toggling this setting will have no effect.
-
-Some settings, such as :ref:`clamp lighting` only apply to objects using shaders, so enabling this option may cause slightly different visuals when used at the same time.
-Otherwise, there should not be a visual difference.
-
-Please note enabling shaders may have a significant performance impact on some systems, and a mild impact on many others.
-
-force per pixel lighting
-------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Force the use of per pixel lighting. By default, only bump and normal mapped objects use per-pixel lighting.
-Only affects objects drawn with shaders (see :ref:`force shaders` option).
-Enabling per-pixel lighting results in visual differences to the original MW engine as certain lights in Morrowind rely on vertex lighting to look as intended.
-Note that groundcover shaders and particle effects ignore this setting.
-
-clamp lighting
---------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-Restrict the amount of lighting that an object can receive to a maximum of (1,1,1).
-Only affects objects drawn with shaders (see :ref:`force shaders` option) as objects drawn without shaders always have clamped lighting.
-When disabled, terrain is always drawn with shaders to prevent seams between tiles that are and that aren't.
-
-Leaving this option at its default makes the lighting compatible with Morrowind's fixed-function method,
-but the lighting may appear dull and there might be colour shifts.
-Setting this option to 'false' results in more dynamic lighting.
-
-auto use object normal maps
----------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If this option is enabled, normal maps are automatically recognized and used if they are named appropriately
-(see :ref:`normal map pattern`, e.g. for a base texture ``foo.dds``, the normal map texture would have to be named ``foo_n.dds``).
-If this option is disabled,
-normal maps are only used if they are explicitly listed within the mesh file (``.nif`` or ``.osg`` file). Affects objects.
-
-auto use object specular maps
------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If this option is enabled, specular maps are automatically recognized and used if they are named appropriately
-(see :ref:`specular map pattern`, e.g. for a base texture ``foo.dds``,
-the specular map texture would have to be named ``foo_spec.dds``).
-If this option is disabled, normal maps are only used if they are explicitly listed within the mesh file
-(``.osg`` file, not supported in ``.nif`` files). Affects objects.
-
-auto use terrain normal maps
-----------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-See :ref:`auto use object normal maps`. Affects terrain.
-
-auto use terrain specular maps
-------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If a file with pattern :ref:`terrain specular map pattern` exists, use that file as a 'diffuse specular' map.
-The texture must contain the layer colour in the RGB channel (as usual), and a specular multiplier in the alpha channel.
-
-normal map pattern
-------------------
-
-:Type:		string
-:Range:
-:Default:	_n
-
-The filename pattern to probe for when detecting normal maps
-(see :ref:`auto use object normal maps`, :ref:`auto use terrain normal maps`)
-
-normal height map pattern
--------------------------
-
-:Type:		string
-:Range:
-:Default:	_nh
-
-Alternative filename pattern to probe for when detecting normal maps.
-Files with this pattern are expected to include 'height' in the alpha channel.
-This height is used for parallax effects. Works for both terrain and objects.
-
-specular map pattern
---------------------
-
-:Type:		string
-:Range:
-:Default:	_spec
-
-The filename pattern to probe for when detecting object specular maps (see :ref:`auto use object specular maps`)
-
-terrain specular map pattern
-----------------------------
-
-:Type:		string
-:Range:
-:Default:	_diffusespec
-
-The filename pattern to probe for when detecting terrain specular maps (see :ref:`auto use terrain specular maps`)
-
-apply lighting to environment maps
-----------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Normally environment map reflections aren't affected by lighting, which makes environment-mapped (and thus bump-mapped objects) glow in the dark.
-Morrowind Code Patch includes an option to remedy that by doing environment-mapping before applying lighting, this is the equivalent of that option.
-Affected objects will use shaders.
-
-lighting method
----------------
-
-:Type:		string
-:Range:		legacy|shaders compatibility|shaders
-:Default:	default
-
-Sets the internal handling of light sources.
-
-'legacy' is restricted to 8 lights per object and it is the method closest to
-fixed function pipeline lighting.
-
-'shaders compatibility' removes the light limit controllable through :ref:`max
-lights` and follows a modified attenuation formula which can drastically reduce
-light popping and seams. This mode also enables lighting on groundcover.
-It is recommended to use this with older hardware and a
-light limit closer to 8. Because of its wide range of compatibility it is set as
-the default.
-
-'shaders' carries all of the benefits that 'shaders compatibility' does, but
-uses a modern approach that allows for a higher :ref:`max lights` count with
-little to no performance penalties on modern hardware. It is recommended to use
-this mode when supported and where the GPU is not a bottleneck. On some weaker
-devices, using this mode along with :ref:`force per pixel lighting` can carry
-performance penalties.
-
-When enabled, groundcover lighting is forced to be vertex lighting, unless
-normal maps are provided. This is due to some groundcover mods using the Z-Up
-normals technique to avoid some common issues with shading. As a consequence,
-per pixel lighting would give undesirable results.
-
-Note that the rendering will act as if you have :ref:`force shaders` option enabled
-when not set to 'legacy'. This means that shaders will be used to render all objects and
-the terrain.
-
-light bounds multiplier
------------------------
-
-:Type:		float
-:Range:		0.0-5.0
-:Default:	1.65
-
-Controls the bounding sphere radius of point lights, which is used to determine
-if an object should receive lighting from a particular light source. Note, this
-has no direct effect on the overall illumination of lights. Larger multipliers
-will allow for smoother transitions of light sources, but may require an
-increase in :ref:`max lights` and thus carries a performance penalty. This
-especially helps with abrupt light popping with handheld light sources such as
-torches and lanterns.
-
-In Morrowind, this multiplier is non-existent, i.e. it is always 1.0.
-
-classic falloff
----------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Use the traditional point light attenuation formula which lacks an early fade out.
-
-A flaw of the traditional formula is that light influence never quite reaches zero.
-This is physically accurate, but because lights don't have infinite radius (see :ref:`light bounds multiplier`),
-this can cause lighting seams between objects that got the relevant point light assigned and objects that didn't.
-Early fade out helps diminish these seams at the cost of darkening the scene.
-
-Morrowind uses the traditional formula, so you may want to enable this if you dislike the brightness differences.
-Alternatively, refer to :ref:`minimum interior brightness`.
-
-'legacy' :ref:`lighting method` behaves as if this setting were enabled.
-
-match sunlight to sun
----------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-In Morrowind, the apparent sun position does not match its light direction due to mysterious reasons.
-We preserve this unrealistic behavior for compatibility.
-
-This option makes the sun light source's position match the sun's position.
-
-maximum light distance
-----------------------
-
-:Type:		float
-:Range:		The whole range of 32-bit floating point
-:Default:	8192
-
-The maximum distance from the camera that lights will be illuminated, applies to
-both interiors and exteriors. A lower distance will improve performance. Set
-this to a non-positive value to disable fading.
-
-In Morrowind, there is no distance-based light fading.
-
-light fade start
-----------------
-
-:Type:		float
-:Range:		0.0-1.0
-:Default:	0.85
-
-The fraction of the maximum distance at which lights will begin to fade away.
-Tweaking it will make the transition proportionally more or less smooth.
-
-This setting has no effect if the :ref:`maximum light distance` is non-positive.
-
-max lights
-----------
-
-:Type:		integer
-:Range:		2-64
-:Default:	8
-
-Sets the maximum number of lights that each object can receive lighting from.
-Increasing this too much can cause significant performance loss, especially if
-:ref:`lighting method` is not set to 'shaders' or :ref:`force per pixel
-lighting` is on.
-
-This setting has no effect if :ref:`lighting method` is 'legacy'.
-
-minimum interior brightness
----------------------------
-
-:Type:		float
-:Range:		0.0-1.0
-:Default:	0.08
-
-Sets the minimum interior ambient brightness for interior cells.
-
-A consequence of the new lighting system is that interiors will sometimes be darker
-since light sources now have sensible fall-offs.
-A couple solutions are to either add more lights or increase their
-radii to compensate, but these require content changes. For best results it is
-recommended to set this to 0.0 to retain the colors that level designers
-intended. If brighter interiors are wanted, however, this setting should be
-increased. Note, it is advised to keep this number small (< 0.1) to avoid the
-aforementioned changes in visuals.
-
-This setting has no effect if :ref:`lighting method` is 'legacy'
-or if :ref:`classic falloff` is enabled.
-
-antialias alpha test
---------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Convert the alpha test (cutout/punchthrough alpha) to alpha-to-coverage when :ref:`antialiasing` is on.
-This allows MSAA to work with alpha-tested meshes, producing better-looking edges without pixelation.
-When MSAA is off, this setting will have no visible effect, but might have a performance cost.
-
-
-adjust coverage for alpha test
-------------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-Attempt to simulate coverage-preserving mipmaps in textures created without them which are used for alpha testing anyway.
-This will somewhat mitigate these objects appearing to shrink as they get further from the camera, but isn't perfect.
-Better results can be achieved by generating more appropriate mipmaps in the first place, but if this workaround is used with such textures, affected objects will appear to grow as they get further from the camera.
-It is recommended that mod authors specify how this setting should be set, and mod users follow their advice.
-
-soft particles
---------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Enables soft particles for particle effects. This technique softens the
-intersection between individual particles and other opaque geometry by blending
-between them. Note, this relies on overriding specific properties of particle
-systems that potentially differ from the source content, this setting may change
-the look of some particle systems.
-
-Note that the rendering will act as if you have :ref:`force shaders` option enabled.
-This means that shaders will be used to render all objects and the terrain.
-
-weather particle occlusion
---------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Enables particle occlusion for rain and snow particle effects.
-When enabled, rain and snow will not clip through ceilings and overhangs.
-Currently this relies on an additional render pass, which may lead to a performance hit.
-
-.. warning::
-    This is an experimental feature that may cause visual oddities, especially when using default rain settings.
-    It is recommended to at least double the rain diameter through `openmw.cfg`.`
+.. omw-setting::
+   :title: force shaders
+   :type: boolean
+   :range: true, false
+   :default: false
+
+   Force rendering with shaders for all objects, even those that do not strictly need them.
+   Required if enhancements like shadows or reverse z are enabled.
+   May have a significant performance impact.
+
+.. omw-setting::
+   :title: force per pixel lighting
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-info:`In Game > Settings > Options > Video > Lights`
+
+   Force per-pixel lighting on all shader objects.
+   Changes lighting behavior from the original MW engine.
+   Groundcover shaders and particles ignore this setting.
+
+.. omw-setting::
+   :title: clamp lighting
+   :type: boolean
+   :range: true, false
+   :default: true
+
+   Restrict lighting to a maximum of (1,1,1) on shader objects.
+   Prevents overly bright or shifted colors but can dull lighting.
+   Terrain is always drawn with shaders to prevent seams.
+
+.. omw-setting::
+   :title: auto use object normal maps
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shaders`
+
+   Automatically detect and use object normal maps named with pattern defined by :ref:`normal map pattern`.
+   Otherwise normal maps must be explicitly listed in mesh files.
+
+.. omw-setting::
+   :title: auto use object specular maps
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shaders`
+
+   Automatically detect and use object specular maps named with pattern defined by :ref:`specular map pattern`.
+   Only supported in `.osg` files.
+
+.. omw-setting::
+   :title: auto use terrain normal maps
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shaders`
+
+   Same as :ref:`auto use object normal maps`, but applies to terrain.
+
+.. omw-setting::
+   :title: auto use terrain specular maps
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shaders`
+
+   Use terrain specular maps if matching :ref:`terrain specular map pattern` texture exists.
+   Texture RGB is layer color, alpha is specular multiplier.
+
+.. omw-setting::
+   :title: normal map pattern
+   :type: string
+   :default: _n
+
+   Filename pattern used to detect normal maps automatically.
+
+.. omw-setting::
+   :title: normal height map pattern
+   :type: string
+   :default: _nh
+
+   Alternative pattern for normal maps containing height in alpha channel for parallax effects.
+
+.. omw-setting::
+   :title: specular map pattern
+   :type: string
+   :default: _spec
+
+   Filename pattern to detect object specular maps.
+
+.. omw-setting::
+   :title: terrain specular map pattern
+   :type: string
+   :default: _diffusespec
+
+   Filename pattern to detect terrain specular maps.
+
+.. omw-setting::
+   :title: apply lighting to environment maps
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shaders`
+
+   Enable lighting effects on environment map reflections to prevent glowing in dark areas.
+
+.. omw-setting::
+   :title: lighting method
+   :type: string
+   :range: legacy | shaders compatibility | shaders
+   :default: shaders compatibility
+   :location: :bdg-info:`In Game > Settings > Options > Video > Lights` :bdg-success:`Launcher > Settings > Visuals > Lighting`
+
+   Controls internal light source handling:
+   - `legacy`: fixed-function pipeline, max 8 lights per object.
+   - `shaders compatibility`: removes light limit, better attenuation, recommended for older hardware.
+   - `shaders`: modern lighting approach, higher light counts, better for modern GPUs.
+
+.. omw-setting::
+   :title: light bounds multiplier
+   :type: float32
+   :range: 0.0-5.0
+   :default: 1.65
+   :location: :bdg-info:`In Game > Settings > Options > Video > Lights`
+
+   Multiplier for point light bounding sphere radius, affecting light transition smoothness and performance.
+
+.. omw-setting::
+   :title: classic falloff
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-info:`In Game > Settings > Options > Video > Lights`
+
+   Use traditional point light attenuation without early fade out.
+   Reduces lighting seams but may darken the scene.
+
+.. omw-setting::
+   :title: match sunlight to sun
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-info:`In Game > Settings > Options > Video > Lights`
+
+   Aligns the sun light source direction with the visible sun position for realism.
+
+.. omw-setting::
+   :title: maximum light distance
+   :type: float32
+   :range: full float range
+   :default: 8192
+   :location: :bdg-info:`In Game > Settings > Options > Video > Lights`
+
+   Maximum distance at which lights illuminate objects.
+   Set to ≤ 0 to disable fading for lights.
+
+.. omw-setting::
+   :title: light fade start
+   :type: float32
+   :range: 0.0-1.0
+   :default: 0.85
+   :location: :bdg-info:`In Game > Settings > Options > Video > Lights`
+
+   Fraction of max distance where light fading begins.
+
+.. omw-setting::
+   :title: max lights
+   :type: int
+   :range: 2-64
+   :default: 8
+   :location: :bdg-info:`In Game > Settings > Options > Video > Lights`
+
+   Maximum lights affecting each object.
+   Too high values may reduce performance unless using 'shaders' method.
+
+.. omw-setting::
+   :title: minimum interior brightness
+   :type: float32
+   :range: 0.0-1.0
+   :default: 0.08
+   :location: :bdg-info:`In Game > Settings > Options > Video > Lights`
+
+   Minimum ambient brightness inside interiors.
+   Should be small to avoid unwanted visual changes.
+
+.. omw-setting::
+   :title: antialias alpha test
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shaders`
+
+   Converts alpha testing to alpha-to-coverage for smoother edges with MSAA enabled.
+
+.. omw-setting::
+   :title: adjust coverage for alpha test
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shaders`
+
+   Mitigates shrinking artifacts on alpha-tested textures without coverage-preserving mipmaps.
+
+.. omw-setting::
+   :title: soft particles
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shaders`
+
+   Enables soft particles effect for smoother particle intersections.
+
+.. omw-setting::
+   :title: weather particle occlusion
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shaders`
+
+   Prevents rain and snow clipping through ceilings by using an extra render pass.
+   
+   .. warning::
+
+      Experimental and may cause visual oddities.
diff --git a/docs/source/reference/modding/settings/shadows.rst b/docs/source/reference/modding/settings/shadows.rst
index 061184bdb9..3c08e111a0 100644
--- a/docs/source/reference/modding/settings/shadows.rst
+++ b/docs/source/reference/modding/settings/shadows.rst
@@ -1,245 +1,197 @@
 Shadows Settings
 ################
 
-Main settings
-*************
-
-enable shadows
---------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Enable or disable the rendering of shadows.
-Unlike in the original Morrowind engine, 'Shadow Mapping' is used, which can have a performance impact, but has more realistic results.
-Bear in mind that this will force OpenMW to use shaders as if :ref:`force shaders` was enabled.
-A keen developer may be able to implement compatibility with fixed-function mode using the advice of `this post <https://github.com/OpenMW/openmw/pull/1547#issuecomment-369657381>`_, but it may be more difficult than it seems.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-number of shadow maps
----------------------
-
-:Type:		integer
-:Range:		1 to 8, but higher values may conflict with other texture effects
-:Default:	3
-
-Control how many shadow maps to use - more of these means each shadow map texel covers less area, producing better-looking shadows, but may decrease performance.
-Using too many shadow maps will lead to them overriding texture slots used for other effects, producing unpleasant artefacts.
-A value of three is recommended in most cases, but other values may produce better results or performance.
-
-maximum shadow map distance
----------------------------
-
-:Type:		float
-:Range:		The whole range of 32-bit floating point
-:Default:	8192
-
-The maximum distance from the camera shadows cover, limiting their overall area coverage
-and improving their quality and performance at the cost of removing shadows of distant objects or terrain.
-Set this to a non-positive value to remove the limit.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-shadow fade start
--------------------
-
-:Type:		float
-:Range:		0.0-1.0
-:Default:	0.9
-
-The fraction of the maximum shadow map distance at which the shadows will begin to fade away.
-Tweaking it will make the transition proportionally more or less smooth.
-This setting has no effect if the maximum shadow map distance is non-positive (infinite).
-
-This setting can be controlled in the Settings tab of the launcher.
-
-enable debug hud
-----------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Enable or disable the debug hud to see what the shadow map(s) contain.
-This setting is only recommended for developers, bug reporting and advanced users performing fine-tuning of shadow settings.
-
-enable debug overlay
---------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Enable or disable the debug overlay to see the area covered by each shadow map.
-This setting is only recommended for developers, bug reporting and advanced users performing fine-tuning of shadow settings.
-
-compute scene bounds
---------------------
-
-:Type:		string
-:Range:		primitives|bounds|none
-:Default:	bounding volumes
-
-Two different ways to make better use of shadow map(s) by making them cover a smaller area.
-While primitives give better shadows at expense of more CPU, bounds gives better performance overall but with lower quality shadows. There is also the ability to disable this computation with none.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-shadow map resolution
----------------------
-
-:Type:		integer
-:Range:		Dependent on GPU/driver combination
-:Default:	1024
-
-Control How large to make the shadow map(s).
-Higher values increase GPU load but can produce better-looking results.
-Power-of-two values may turn out to be faster than smaller values which are not powers of two on some GPU/driver combinations.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-actor shadows
--------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Allow actors to cast shadows.
-Potentially decreases performance.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-player shadows
---------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Allow the player to cast shadows.
-Potentially decreases performance.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-terrain shadows
----------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Allow terrain to cast shadows.
-Potentially decreases performance.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-object shadows
---------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Allow static objects to cast shadows.
-Potentially decreases performance.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-enable indoor shadows
----------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Allow shadows indoors.
-Due to limitations with Morrowind's data, only actors can cast shadows indoors without the ceiling casting a shadow everywhere.
-Some might feel this is distracting as shadows can be cast through other objects, so indoor shadows can be disabled completely.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-Expert settings
-***************
-
-These settings are probably too complicated for regular users to judge what might be good values to set them to.
-If you've got a good understanding of how shadow mapping works, or you've got enough time to try a large set of values, you may get better results tuning these yourself.
-Copying values from another user who's done careful tuning is the recommended way of arriving at an optimal value for these settings.
-
-Understanding what some of these do might be easier for people who've read `this paper on Parallel Split Shadow Maps <https://pdfs.semanticscholar.org/15a9/f2a7cf6b1494f45799617c017bd42659d753.pdf>`_ and understood how they interact with the transformation used with Light Space Perspective Shadow Maps.
-
-polygon offset factor
----------------------
-
-:Type:		float
-:Range:		Theoretically the whole range of 32-bit floating point, but values just above 1.0 are most sensible.
-:Default:	1.1
-
-Used as the factor parameter for the polygon offset used for shadow map rendering.
-Higher values reduce shadow flicker, but risk increasing Peter Panning.
-See `the OpenGL documentation for glPolygonOffset <https://www.khronos.org/registry/OpenGL-Refpages/gl4/html/glPolygonOffset.xhtml>`_ for details.
-
-polygon offset units
----------------------
-
-:Type:		float
-:Range:		Theoretically the whole range of 32-bit floating point, but values between 1 and 10 are most sensible.
-:Default:	4.0
-
-Used as the units parameter for the polygon offset used for shadow map rendering.
-Higher values reduce shadow flicker, but risk increasing Peter Panning.
-See `the OpenGL documentation for glPolygonOffset <https://www.khronos.org/registry/OpenGL-Refpages/gl4/html/glPolygonOffset.xhtml>`_ for details.
-
-normal offset distance
-----------------------
-
-:Type:		float
-:Range:		Theoretically the whole range of 32-bit floating point, but values between 0 and 2 are most sensible.
-:Default:	1.0
-
-How far along the surface normal to project shadow coordinates.
-Higher values significantly reduce shadow flicker, usually with a lower increase of Peter Panning than the Polygon Offset settings.
-This value is in in-game units, so 1.0 is roughly 1.4 cm.
-
-use front face culling
-----------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-Excludes theoretically unnecessary faces from shadow maps, slightly increasing performance.
-In practice, Peter Panning can be much less visible with these faces included, so if you have high polygon offset values, leaving this off may help minimise the side effects.
-
-split point uniform logarithmic ratio
--------------------------------------
-
-:Type:		float
-:Range:		0.0-1.0 for sensible results. Other values may 'work' but could behave bizarrely.
-:Default:	0.5
-
-Controls the ratio of :math:`C_i^{log}` versus :math:`C_i^{uniform}` used to form the Practical Split Scheme as described in the linked paper.
-When using a larger-than-default viewing distance and distant terrain, larger values will prevent nearby shadows losing quality.
-It is therefore recommended that this isn't left at the default when the viewing distance is changed.
-
-split point bias
-----------------
-
-:Type:		float
-:Range:		Any value supported by C++ floats on your platform, although undesirable behaviour is more likely to appear the further the value is from zero.
-:Default:	0.0
-
-The :math:`\delta_{bias}` parameter used to form the Practical Split Scheme as described in the linked paper.
-
-minimum lispsm near far ratio
------------------------------
-
-:Type:		float
-:Range:		Must be greater than zero.
-:Default:	0.25
-
-Controls the minimum near/far ratio for the Light Space Perspective Shadow Map transformation.
-Helps prevent too much detail being brought towards the camera at the expense of detail further from the camera.
-Increasing this pushes detail further away by moving the frustum apex further from the near plane.
+.. omw-setting::
+   :title: enable shadows
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shadows`
+
+   Enable or disable shadow rendering using shadow mapping.
+   More realistic but may reduce performance.
+   Forces shaders usage like :ref:`force shaders`.
+
+.. omw-setting::
+   :title: number of shadow maps
+   :type: int
+   :range: 1 to 8
+   :default: 3
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shadows`
+
+   Number of shadow maps used.
+   More maps improve shadow quality but may reduce performance or cause texture conflicts.
+
+.. omw-setting::
+   :title: maximum shadow map distance
+   :type: float32
+   :range: full 32-bit float range
+   :default: 8192
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shadows`
+
+   Maximum distance shadows cover from the camera.
+   Set ≤ 0 to disable distance limit.
+
+.. omw-setting::
+   :title: shadow fade start
+   :type: float32
+   :range: [0, 1]
+   :default: 0.9
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shadows`
+
+   Fraction of maximum shadow distance at which shadows start fading.
+   No effect if distance limit disabled.
+
+.. omw-setting::
+   :title: enable debug hud
+   :type: boolean
+   :range: true, false
+   :default: false
+
+   Show debug HUD visualizing shadow map contents.
+   Recommended for developers or advanced users.
+
+.. omw-setting::
+   :title: enable debug overlay
+   :type: boolean
+   :range: true, false
+   :default: false
+
+   Show debug overlay showing shadow map coverage areas.
+   Recommended for advanced debugging.
+
+.. omw-setting::
+   :title: compute scene bounds
+   :type: string
+   :range: primitives | bounds | none
+   :default: bounds
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shadows`
+
+   Method to compute shadow map coverage:
+   - `primitives`: better shadows, higher CPU cost
+   - `bounds`: better performance, lower quality
+   - `none`: disables computation
+
+.. omw-setting::
+   :title: shadow map resolution
+   :type: int
+   :range: dependent on GPU/driver
+   :default: 1024
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shadows`
+
+   Size of shadow maps.
+   Higher values improve quality but increase GPU load.
+   Powers of two may perform better on some hardware.
+
+.. omw-setting::
+   :title: actor shadows
+   :type: boolean
+   :range: true, false
+   :default: false
+
+   Enable shadows cast by NPCs and creatures.
+   May reduce performance.
+
+.. omw-setting::
+   :title: player shadows
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shadows`
+
+   Enable shadows cast by the player character.
+   May reduce performance.
+
+.. omw-setting::
+   :title: terrain shadows
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shadows`
+
+   Enable shadows cast by terrain.
+   May reduce performance.
+
+.. omw-setting::
+   :title: object shadows
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shadows`
+
+   Enable shadows cast by static objects.
+   May reduce performance.
+
+.. omw-setting::
+   :title: enable indoor shadows
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Shadows`
+
+   Enable shadows indoors.
+   Only actors cast shadows indoors without full ceiling shadows.
+   Can cause shadows appearing through objects.
+
+.. omw-setting::
+   :title: polygon offset factor
+   :type: float32
+   :range: full 32-bit float range, sensibly >1.0
+   :default: 1.1
+
+   Polygon offset factor for shadow map rendering.
+   Reduces shadow flicker but may increase Peter Panning.
+
+.. omw-setting::
+   :title: polygon offset units
+   :type: float32
+   :range: full 32-bit float range, sensibly 1 to 10
+   :default: 4.0
+
+   Polygon offset units for shadow map rendering.
+   Works with offset factor to reduce artifacts.
+
+.. omw-setting::
+   :title: normal offset distance
+   :type: float32
+   :range: full 32-bit float range, sensibly 0 to 2
+   :default: 1.0
+
+   Distance along surface normal to project shadow coordinates.
+   Reduces flicker with less Peter Panning than polygon offset.
+
+.. omw-setting::
+   :title: use front face culling
+   :type: boolean
+   :range: true, false
+   :default: false
+
+   Exclude front faces from shadow maps for performance.
+   May increase Peter Panning artifacts.
+
+.. omw-setting::
+   :title: split point uniform logarithmic ratio
+   :type: float32
+   :range: [0, 1]
+   :default: 0.5
+
+   Controls balance between logarithmic and uniform split points for shadow splits.
+   Adjust when using large view distances or distant terrain.
+
+.. omw-setting::
+   :title: split point bias
+   :type: float32
+   :range: full C++ float range
+   :default: 0.0
+
+   Bias parameter used in shadow split computation.
+   Non-zero values can cause unusual behavior.
+
+.. omw-setting::
+   :title: minimum lispsm near far ratio
+   :type: float32
+   :range: > 0
+   :default: 0.25
+
+   Minimum near/far ratio for Light Space Perspective Shadow Map.
+   Controls distribution of shadow detail near and far from the camera.
diff --git a/docs/source/reference/modding/settings/sound.rst b/docs/source/reference/modding/settings/sound.rst
index dbcad65d0d..e38cd9de78 100644
--- a/docs/source/reference/modding/settings/sound.rst
+++ b/docs/source/reference/modding/settings/sound.rst
@@ -1,142 +1,123 @@
 Sound Settings
 ##############
 
-device
-------
+.. omw-setting::
+   :title: device
+   :type: string
+   :range:
+   :default: ""
+   :location: :bdg-success:`Launcher > Settings > Audio`
 
-:Type:		string
-:Range:
-:Default:	""
+   This setting determines which audio device to use. A blank or missing setting means to use the default device,
+   which should usually be sufficient, but if you need to explicitly specify a device use this setting.
 
-This setting determines which audio device to use. A blank or missing setting means to use the default device,
-which should usually be sufficient, but if you need to explicitly specify a device use this setting.
+   The names of detected devices can be found in the openmw.log file in your configuration directory.
 
-The names of detected devices can be found in the openmw.log file in your configuration directory.
+.. omw-setting::
+   :title: master volume
+   :type: float32
+   :range: 0.0 (silent) to 1.0 (maximum volume)
+   :default: 1.0
+   :location: :bdg-info:`In Game > Options > Audio`
 
-This setting can be controlled in the Settings tab of the launcher.
+   This setting controls the overall volume.
+   The master volume is multiplied with specific volume settings to determine the final volume.
 
-master volume
--------------
+.. omw-setting::
+   :title: footsteps volume
+   :type: float32
+   :range: 0.0 (silent) to 1.0 (maximum volume)
+   :default: 0.2
+   :location: :bdg-info:`In Game > Options > Audio`
 
-:Type:		floating point
-:Range:		0.0 (silent) to 1.0 (maximum volume)
-:Default:	1.0
+   This setting controls the volume of footsteps from the character and other actors.
 
-This setting controls the overall volume.
-The master volume is multiplied with specific volume settings to determine the final volume.
+.. omw-setting::
+   :title: music volume
+   :type: float32
+   :range: 0.0 (silent) to 1.0 (maximum volume)
+   :default: 0.5
+   :location: :bdg-info:`In Game > Options > Audio`
 
-This setting can be changed in game using the Master slider from the Audio panel of the Options menu.
+   This setting controls the volume for music tracks.
 
-footsteps volume
-----------------
+.. omw-setting::
+   :title: sfx volume
+   :type: float32
+   :range: 0.0 (silent) to 1.0 (maximum volume)
+   :default: 1.0
+   :location: :bdg-info:`In Game > Options > Audio`
 
-:Type:		floating point
-:Range:		0.0 (silent) to 1.0 (maximum volume)
-:Default:	0.2
+   This setting controls the volume for special sound effects such as combat noises.
 
-This setting controls the volume of footsteps from the character and other actors.
+.. omw-setting::
+   :title: voice volume
+   :type: float32
+   :range: 0.0 (silent) to 1.0 (maximum volume)
+   :default: 0.8
+   :location: :bdg-info:`In Game > Options > Audio`
 
-This setting can be changed in game using the Footsteps slider from the Audio panel of the Options menu.
+   This setting controls the volume for spoken dialogue from NPCs.
 
-music volume
-------------
 
-:Type:		floating point
-:Range:		0.0 (silent) to 1.0 (maximum volume)
-:Default:	0.5
+.. omw-setting::
+   :title: buffer cache min
+   :type: int
+   :range: > 0
+   :default: 14
 
-This setting controls the volume for music tracks.
+   This setting determines the minimum size of the sound buffer cache in megabytes.
+   When the cache reaches the size specified by the buffer cache max setting,
+   old buffers will be unloaded until it's using no more memory than specified by this setting.
+   This setting must be less than or equal to the buffer cache max setting.
 
-This setting can be changed in game using the Music slider from the Audio panel of the Options menu.
 
-sfx volume
-----------
+.. omw-setting::
+   :title: buffer cache max
+   :type: int
+   :range: > 0
+   :default: 16
 
-:Type:		floating point
-:Range:		0.0 (silent) to 1.0 (maximum volume)
-:Default:	1.0
+   This setting determines the maximum size of the sound buffer cache in megabytes. When the cache reaches this size,
+   old buffers will be unloaded until it reaches the size specified by the buffer cache min setting.
+   This setting must be greater than or equal to the buffer cache min setting.
 
-This setting controls the volume for special sound effects such as combat noises.
 
-This setting can be changed in game using the Effects slider from the Audio panel of the Options menu.
+.. omw-setting::
+   :title: hrtf enable
+   :type: int
+   :range: -1, 0, 1
+   :default: -1
+   :location: :bdg-success:`Launcher > Settings > Audio`
 
-voice volume
-------------
+   This setting determines whether to enable head-related transfer function (HRTF) audio processing.
+   HRTF audio processing creates the perception of sounds occurring in a three dimensional space when wearing headphones.
+   Enabling HRTF may also require an OpenAL Soft version greater than 1.17.0,
+   and possibly some operating system configuration.
+   A value of 0 disables HRTF processing, while a value of 1 explicitly enables HRTF processing.
+   The default value is -1, which should enable the feature automatically for most users when possible.
 
-:Type:		floating point
-:Range:		0.0 (silent) to 1.0 (maximum volume)
-:Default:	0.8
 
-This setting controls the volume for spoken dialogue from NPCs.
+.. omw-setting::
+   :title: hrtf
+   :type: string
+   :range:
+   :default: ""
+   :location: :bdg-success:`Launcher > Settings > Audio`
 
-This setting can be changed in game using the Voice slider from the Audio panel of the Options menu.
+   This setting specifies which HRTF profile to use when HRTF is enabled. Blank means use the default.
+   This setting has no effect if HRTF is not enabled based on the hrtf enable setting.
+   Allowed values for this field are enumerated in openmw.log file is an HRTF enabled audio system is installed.
+   The default value is empty, which uses the default profile.
 
-buffer cache min
-----------------
 
-:Type:		integer
-:Range:		> 0
-:Default:	14
+.. omw-setting::
+   :title: camera listener
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Audio`
 
-This setting determines the minimum size of the sound buffer cache in megabytes.
-When the cache reaches the size specified by the buffer cache max setting,
-old buffers will be unloaded until it's using no more memory than specified by this setting.
-This setting must be less than or equal to the buffer cache max setting.
-
-This setting can only be configured by editing the settings configuration file.
-
-buffer cache max
-----------------
-
-:Type:		integer
-:Range:		> 0
-:Default:	16
-
-This setting determines the maximum size of the sound buffer cache in megabytes. When the cache reaches this size,
-old buffers will be unloaded until it reaches the size specified by the buffer cache min setting.
-This setting must be greater than or equal to the buffer cache min setting.
-
-This setting can only be configured by editing the settings configuration file.
-
-hrtf enable
------------
-
-:Type:		integer
-:Range:		-1, 0, 1
-:Default:	-1
-
-This setting determines whether to enable head-related transfer function (HRTF) audio processing.
-HRTF audio processing creates the perception of sounds occurring in a three dimensional space when wearing headphones.
-Enabling HRTF may also require an OpenAL Soft version greater than 1.17.0,
-and possibly some operating system configuration.
-A value of 0 disables HRTF processing, while a value of 1 explicitly enables HRTF processing.
-The default value is -1, which should enable the feature automatically for most users when possible.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-hrtf
-----
-
-:Type:		string
-:Range:
-:Default:	""
-
-This setting specifies which HRTF profile to use when HRTF is enabled. Blank means use the default.
-This setting has no effect if HRTF is not enabled based on the hrtf enable setting.
-Allowed values for this field are enumerated in openmw.log file is an HRTF enabled audio system is installed.
-The default value is empty, which uses the default profile.
-
-This setting can be controlled in the Settings tab of the launcher.
-
-camera listener
----------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-When true, uses the camera position and direction for audio instead of the player position.
-This makes audio in third person sound relative to camera instead of the player.
-False is vanilla Morrowind behaviour.
-
-This setting can be controlled in the Settings tab of the launcher.
\ No newline at end of file
+   When true, uses the camera position and direction for audio instead of the player position.
+   This makes audio in third person sound relative to camera instead of the player.
+   False is vanilla Morrowind behaviour.
diff --git a/docs/source/reference/modding/settings/stereo.rst b/docs/source/reference/modding/settings/stereo.rst
index b1267bd286..70733a089d 100644
--- a/docs/source/reference/modding/settings/stereo.rst
+++ b/docs/source/reference/modding/settings/stereo.rst
@@ -1,64 +1,58 @@
 Stereo Settings
 ###############
 
-stereo enabled
---------------
+.. omw-setting::
+   :title: stereo enabled
+   :type: boolean
+   :range: true, false
+   :default: false
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   Enable/disable stereo view. This setting is ignored in VR.
 
-Enable/disable stereo view. This setting is ignored in VR.
+.. omw-setting::
+   :title: multiview
+   :type: boolean
+   :range: true, false
+   :default: false
 
-multiview
----------
+   If enabled, OpenMW will use the :code:`GL_OVR_MultiView` and :code:`GL_OVR_MultiView2` extensions where possible.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+.. omw-setting::
+   :title: shared shadow maps
+   :type: boolean
+   :range: true, false
+   :default: true
 
-If enabled, OpenMW will use the :code:`GL_OVR_MultiView` and :code:`GL_OVR_MultiView2` extensions where possible.
+   Use one set of shadow maps for both eyes.
+   Will likely be significantly faster than the brute-force approach of rendering a separate copy for each eye with no or imperceptible quality loss.
 
-shared shadow maps
-------------------
+.. omw-setting::
+   :title: allow display lists for multiview
+   :type: boolean
+   :range: true, false
+   :default: true
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   If false, OpenMW-VR will disable display lists when using multiview. Necessary on some buggy drivers, but may incur a slight performance penalty.
 
-Use one set of shadow maps for both eyes.
-Will likely be significantly faster than the brute-force approach of rendering a separate copy for each eye with no or imperceptible quality loss.
+.. omw-setting::
+   :title: use custom view
+   :type: boolean
+   :range: true, false
+   :default: false
 
-allow display lists for multiview
----------------------------------
+   If false, the default OSG horizontal split will be used for stereo.
+   If true, the config defined in the :ref:`[Stereo View]<Stereo View Settings>` settings category will be used.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   .. note::
+      This option is ignored in VR, and exists primarily for debugging purposes
 
-If false, OpenMW-VR will disable display lists when using multiview. Necessary on some buggy drivers, but may incur a slight performance penalty.
+.. omw-setting::
+   :title: use custom eye resolution
+   :type: boolean
+   :range: true, false
+   :default: false
 
-use custom view
----------------
+   If true, overrides rendering resolution for each eye.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If false, the default OSG horizontal split will be used for stereo.
-If true, the config defined in the :ref:`[Stereo View]<Stereo View Settings>` settings category will be used.
-
-.. note::
-	This option is ignored in VR, and exists primarily for debugging purposes
-
-use custom eye resolution
--------------------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	False
-
-If true, overrides rendering resolution for each eye.
-
-.. note::
-	This option is ignored in VR, and exists primarily for debugging purposes
+   .. note::
+      This option is ignored in VR, and exists primarily for debugging purposes
diff --git a/docs/source/reference/modding/settings/stereoview.rst b/docs/source/reference/modding/settings/stereoview.rst
index 3e2e3e7231..bd8e4a2c13 100644
--- a/docs/source/reference/modding/settings/stereoview.rst
+++ b/docs/source/reference/modding/settings/stereoview.rst
@@ -1,218 +1,194 @@
 Stereo View Settings
 ####################
 
-eye resolution x
-----------------
+.. omw-setting::
+   :title: eye resolution x
+   :type: int
+   :range: > 0
+   :default: 3128
 
-:Type:		integer
-:Range:		> 0
-:Default:	3128
+   The default values are based on an HP Reverb G2 HMD.
+
+.. omw-setting::
+   :title: eye resolution y
+   :type: int
+   :range: > 0
+   :default: 3060
 
-The default values are based on an HP Reverb G2 HMD.
+   The default values are based on an HP Reverb G2 HMD.
+
+.. omw-setting::
+   :title: left eye offset x
+   :type: float64
+   :range: any
+   :default: -2.35
 
-eye resolution y
-----------------
+   Left eye offset from center, expressed in MW units (1 meter = ~70).
+
+.. omw-setting::
+   :title: left eye offset y
+   :type: float64
+   :range: any
+   :default: 0.0
 
-:Type:		integer
-:Range:		> 0
-:Default:	3060
+   Left eye offset from center, expressed in MW units (1 meter = ~70).
+
+.. omw-setting::
+   :title: left eye offset z
+   :type: float64
+   :range: any
+   :default: 0.0
 
-The default values are based on an HP Reverb G2 HMD.
+   Left eye offset from center, expressed in MW units (1 meter = ~70).
+
+.. omw-setting::
+   :title: left eye orientation x
+   :type: float64
+   :range: -1.0 to 1.0
+   :default: 0.0
 
-left eye offset x
------------------
+   Left eye orientation, expressed as a quaternion.
+
+.. omw-setting::
+   :title: left eye orientation y
+   :type: float64
+   :range: -1.0 to 1.0
+   :default: 0.0
 
-:Type:		double precision floating point
-:Range:		any
-:Default:	-2.35
+   Left eye orientation, expressed as a quaternion.
+
+.. omw-setting::
+   :title: left eye orientation z
+   :type: float64
+   :range: -1.0 to 1.0
+   :default: 0.0
 
-Left eye offset from center, expressed in MW units (1 meter = ~70).
+   Left eye orientation, expressed as a quaternion.
+
+.. omw-setting::
+   :title: left eye orientation w
+   :type: float64
+   :range: -1.0 to 1.0
+   :default: 1.0
 
-left eye offset y
------------------
+   Left eye orientation, expressed as a quaternion.
+
+.. omw-setting::
+   :title: left eye fov left
+   :type: float64
+   :range: -π to π
+   :default: -0.86
 
-:Type:		double precision floating point
-:Range:		any
-:Default:	0.0
+   Left eye field of view, expressed in radians.
+
+.. omw-setting::
+   :title: left eye fov right
+   :type: float64
+   :range: -π to π
+   :default: 0.78
 
-Left eye offset from center, expressed in MW units (1 meter = ~70).
+   Left eye field of view, expressed in radians.
+
+.. omw-setting::
+   :title: left eye fov up
+   :type: float64
+   :range: -π to π
+   :default: 0.8
 
-left eye offset z
------------------
+   Left eye field of view, expressed in radians.
 
-:Type:		double precision floating point
-:Range:		any
-:Default:	0.0
+.. omw-setting::
+   :title: left eye fov down
+   :type: float64
+   :range: -π to π
+   :default: -0.8
 
-Left eye offset from center, expressed in MW units (1 meter = ~70).
+   Left eye field of view, expressed in radians.
 
-left eye orientation x
-----------------------
+.. omw-setting::
+   :title: right eye offset x
+   :type: float64
+   :range: any
+   :default: 2.35
 
-:Type:		double precision floating point
-:Range:		-1.0 to 1.0
-:Default:	0.0
+   Left eye offset from center, expressed in MW units (1 meter = ~70).
 
-Left eye orientation, expressed as a quaternion.
+.. omw-setting::
+   :title: right eye offset y
+   :type: float64
+   :range: any
+   :default: 0.0
 
-left eye orientation y
-----------------------
+   Left eye offset from center, expressed in MW units (1 meter = ~70).
 
-:Type:		double precision floating point
-:Range:		-1.0 to 1.0
-:Default:	0.0
+.. omw-setting::
+   :title: right eye offset z
+   :type: float64
+   :range: any
+   :default: 0.0
 
-Left eye orientation, expressed as a quaternion.
+   Left eye offset from center, expressed in MW units (1 meter = ~70).
 
-left eye orientation z
-----------------------
+.. omw-setting::
+   :title: right eye orientation x
+   :type: float64
+   :range: -1.0 to 1.0
+   :default: 0.0
 
-:Type:		double precision floating point
-:Range:		-1.0 to 1.0
-:Default:	0.0
+   Left eye orientation, expressed as a quaternion.
 
-Left eye orientation, expressed as a quaternion.
+.. omw-setting::
+   :title: right eye orientation y
+   :type: float64
+   :range: -1.0 to 1.0
+   :default: 0.0
 
-left eye orientation w
-----------------------
+   Left eye orientation, expressed as a quaternion.
 
-:Type:		double precision floating point
-:Range:		-1.0 to 1.0
-:Default:	1.0
+.. omw-setting::
+   :title: right eye orientation z
+   :type: float64
+   :range: -1.0 to 1.0
+   :default: 0.0
 
-Left eye orientation, expressed as a quaternion.
+   Left eye orientation, expressed as a quaternion.
 
-left eye fov left
------------------
+.. omw-setting::
+   :title: right eye orientation w
+   :type: float64
+   :range: -1.0 to 1.0
+   :default: 1.0
 
-:Type:		double precision floating point
-:Range:		-π to π
-:Default:	-0.86
+   Left eye orientation, expressed as a quaternion.
 
-Left eye field of view, expressed in radians.
+.. omw-setting::
+   :title: right eye fov left
+   :type: float64
+   :range: -π to π
+   :default: -0.78
 
-left eye fov right
-------------------
+   Left eye field of view.
 
-:Type:		double precision floating point
-:Range:		-π to π
-:Default:	0.78
+.. omw-setting::
+   :title: right eye fov right
+   :type: float64
+   :range: -π to π
+   :default: 0.86
 
-Left eye field of view, expressed in radians.
+   Left eye field of view.
 
-left eye fov up
----------------
+.. omw-setting::
+   :title: right eye fov up
+   :type: float64
+   :range: -π to π
+   :default: 0.8
 
-:Type:		double precision floating point
-:Range:		-π to π
-:Default:	0.8
+   Left eye field of view.
 
-Left eye field of view, expressed in radians.
+.. omw-setting::
+   :title: right eye fov down
+   :type: float64
+   :range: -π to π
+   :default: -0.8
 
-left eye fov down
------------------
-
-:Type:		double precision floating point
-:Range:		-π to π
-:Default:	-0.8
-
-Left eye field of view, expressed in radians.
-
-right eye offset x
-------------------
-
-:Type:		double precision floating point
-:Range:		any
-:Default:	2.35
-
-Left eye offset from center, expressed in MW units (1 meter = ~70).
-
-right eye offset y
-------------------
-
-:Type:		double precision floating point
-:Range:		any
-:Default:	0.0
-
-Left eye offset from center, expressed in MW units (1 meter = ~70).
-
-right eye offset z
-------------------
-
-:Type:		double precision floating point
-:Range:		any
-:Default:	0.0
-
-Left eye offset from center, expressed in MW units (1 meter = ~70).
-
-right eye orientation x
------------------------
-
-:Type:		double precision floating point
-:Range:		-1.0 to 1.0
-:Default:	0.0
-
-Left eye orientation, expressed as a quaternion.
-
-right eye orientation y
------------------------
-
-:Type:		double precision floating point
-:Range:		-1.0 to 1.0
-:Default:	0.0
-
-Left eye orientation, expressed as a quaternion.
-
-right eye orientation z
------------------------
-
-:Type:		double precision floating point
-:Range:		-1.0 to 1.0
-:Default:	0.0
-
-Left eye orientation, expressed as a quaternion.
-
-right eye orientation w
------------------------
-
-:Type:		double precision floating point
-:Range:		-1.0 to 1.0
-:Default:	1.0
-
-Left eye orientation, expressed as a quaternion.
-
-right eye fov left
-------------------
-
-:Type:		double precision floating point
-:Range:		-π to π
-:Default:	-0.78
-
-Left eye field of view.
-
-right eye fov right
--------------------
-
-:Type:		double precision floating point
-:Range:		-π to π
-:Default:	0.86
-
-Left eye field of view.
-
-right eye fov up
-----------------
-
-:Type:		double precision floating point
-:Range:		-π to π
-:Default:	0.8
-
-Left eye field of view.
-
-right eye fov down
-------------------
-
-:Type:		double precision floating point
-:Range:		-π to π
-:Default:	-0.8
-
-Left eye field of view.
+   Left eye field of view.
diff --git a/docs/source/reference/modding/settings/terrain.rst b/docs/source/reference/modding/settings/terrain.rst
index 767f549fc7..fbf4837669 100644
--- a/docs/source/reference/modding/settings/terrain.rst
+++ b/docs/source/reference/modding/settings/terrain.rst
@@ -1,220 +1,215 @@
 Terrain Settings
 ################
 
-distant terrain
----------------
+.. omw-setting::
+   :title: distant terrain
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-success:`Launcher > Settings > Visuals > Terrain`
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   Controls whether the engine will use paging (chunking) and LOD algorithms to load the terrain of the entire world at all times.
+   Otherwise, only the terrain of the surrounding cells is loaded.
 
-Controls whether the engine will use paging (chunking) and LOD algorithms to load the terrain of the entire world at all times.
-Otherwise, only the terrain of the surrounding cells is loaded.
+   .. note::
+      When enabling distant terrain, make sure the 'viewing distance' in the camera section is set to a larger value so
+      that you can actually see the additional terrain and objects.
 
-.. note::
-	When enabling distant terrain, make sure the 'viewing distance' in the camera section is set to a larger value so
-	that you can actually see the additional terrain and objects.
+   To avoid frame drops as the player moves around, nearby terrain pages are always preloaded in the background,
+   regardless of the preloading settings in the 'Cells' section,
+   but the preloading of terrain behind a door or a travel destination, for example,
+   will still be controlled by cell preloading settings.
 
-To avoid frame drops as the player moves around, nearby terrain pages are always preloaded in the background,
-regardless of the preloading settings in the 'Cells' section,
-but the preloading of terrain behind a door or a travel destination, for example,
-will still be controlled by cell preloading settings.
+.. omw-setting::
+   :title: vertex lod mod
+   :type: int
+   :range: any
+   :default: 0
 
-The distant terrain engine is currently considered experimental and may receive updates in the future.
+   Controls only the Vertex LOD of the terrain. The amount of terrain chunks and the detail of composite maps is left unchanged.
 
-vertex lod mod
---------------
+   Must be changed in increments of 1. Each increment will double (for positive values) or halve (for negative values) the number of vertices rendered.
+   For example: -2 means 4x reduced detail, +3 means 8x increased detail.
 
-:Type:      integer
-:Range:     any
-:Default:   0
+   Note this setting will typically not affect near terrain. When set to increase detail, the detail of near terrain can not be increased
+   because the detail is simply not there in the data files, and when set to reduce detail,
+   the detail of near terrain will not be reduced because it was already less detailed than the far terrain (in view relative terms) to begin with.
 
-Controls only the Vertex LOD of the terrain. The amount of terrain chunks and the detail of composite maps is left unchanged.
+.. omw-setting::
+   :title: lod factor
+   :type: float32
+   :range: >0
+   :default: 1.0
 
-Must be changed in increments of 1. Each increment will double (for positive values) or halve (for negative values) the number of vertices rendered.
-For example: -2 means 4x reduced detail, +3 means 8x increased detail.
+   Controls the level of detail if distant terrain is enabled.
+   Higher values increase detail at the cost of performance, lower values reduce detail but increase performance.
 
-Note this setting will typically not affect near terrain. When set to increase detail, the detail of near terrain can not be increased
-because the detail is simply not there in the data files, and when set to reduce detail,
-the detail of near terrain will not be reduced because it was already less detailed than the far terrain (in view relative terms) to begin with.
+   Note: it also changes how the Quad Tree is split.
+   Increasing detail with this setting results in the visible terrain being divided into more chunks,
+   where as reducing detail with this setting would reduce the number of chunks.
 
-lod factor
-----------
+   Fewer terrain chunks is faster for rendering, but on the other hand a larger proportion of the entire terrain
+   must be rebuilt when LOD levels change as the camera moves.
+   This could result in frame drops if moving across the map at high speed.
 
-:Type:		float
-:Range:		>0
-:Default:	1.0
+   For this reason, it is not recommended to change this setting if you want to change the LOD.
+   If you want to do that, first try using the 'vertex lod mod' setting to configure the detail of the terrain outlines
+   to your liking and then use 'composite map resolution' to configure the texture detail to your liking.
+   But these settings can only be changed in multiples of two, so you may want to adjust 'lod factor' afterwards for even more fine-tuning.
 
-Controls the level of detail if distant terrain is enabled.
-Higher values increase detail at the cost of performance, lower values reduce detail but increase performance.
+.. omw-setting::
+   :title: composite map level
+   :type: int
+   :range: ≥ -3
+   :default: 0
 
-Note: it also changes how the Quad Tree is split.
-Increasing detail with this setting results in the visible terrain being divided into more chunks,
-where as reducing detail with this setting would reduce the number of chunks.
+   Controls at which minimum size (in 2^value cell units) terrain chunks will start to use a composite map instead of the high-detail textures.
+   With value -3 composite maps are used everywhere.
 
-Fewer terrain chunks is faster for rendering, but on the other hand a larger proportion of the entire terrain
-must be rebuilt when LOD levels change as the camera moves.
-This could result in frame drops if moving across the map at high speed.
+   A composite map is a pre-rendered texture that contains all the texture layers combined.
+   Note that resolution of composite maps is currently always fixed at 'composite map resolution',
+   regardless of the resolution of the underlying terrain textures.
+   If high resolution texture replacers are used, it is recommended to increase 'composite map resolution' setting value.
 
-For this reason, it is not recommended to change this setting if you want to change the LOD.
-If you want to do that, first try using the 'vertex lod mod' setting to configure the detail of the terrain outlines
-to your liking and then use 'composite map resolution' to configure the texture detail to your liking.
-But these settings can only be changed in multiples of two, so you may want to adjust 'lod factor' afterwards for even more fine-tuning.
+.. omw-setting::
+   :title: composite map resolution
+   :type: int
+   :range: >0
+   :default: 512
 
-composite map level
--------------------
+   Controls the resolution of composite maps. Larger values result in increased detail,
+   but may take longer to prepare and thus could result in longer loading times and an increased chance of frame drops during play.
+   As with most other texture resolution settings, it's most efficient to use values that are powers of two.
 
-:Type:		integer
-:Range:		>= -3
-:Default:	0
+   An easy way to observe changes to loading time is to load a save in an interior next to an exterior door
+   (so it will start preloding terrain) and watch how long it takes for the 'Composite' counter on the F4 panel to fall to zero.
 
-Controls at which minimum size (in 2^value cell units) terrain chunks will start to use a composite map instead of the high-detail textures.
-With value -3 composite maps are used everywhere.
+.. omw-setting::
+   :title: max composite geometry size
+   :type: float32
+   :range: ≥1.0
+   :default: 4.0
 
-A composite map is a pre-rendered texture that contains all the texture layers combined.
-Note that resolution of composite maps is currently always fixed at 'composite map resolution',
-regardless of the resolution of the underlying terrain textures.
-If high resolution texture replacers are used, it is recommended to increase 'composite map resolution' setting value.
+   Controls the maximum size of simple composite geometry chunk in cell units. With small values there will more draw calls and small textures,
+   but higher values create more overdraw (not every texture layer is used everywhere).
 
-composite map resolution
-------------------------
+.. omw-setting::
+   :title: debug chunks
+   :type: boolean
+   :range: true, false
+   :default: false
 
-:Type:		integer
-:Range:		>0
-:Default:	512
+   This debug setting allows you to see the borders of each chunks of the world by drawing lines around them (as with toggleborder). 
+   If object paging is set to true then this debug setting will allows you to see what objects have been merged in the scene
+   by making them colored randomly.
 
-Controls the resolution of composite maps. Larger values result in increased detail,
-but may take longer to prepare and thus could result in longer loading times and an increased chance of frame drops during play.
-As with most other texture resolution settings, it's most efficient to use values that are powers of two.
+.. omw-setting::
+   :title: object paging
+   :type: boolean
+   :range: true, false
+   :default: true
 
-An easy way to observe changes to loading time is to load a save in an interior next to an exterior door
-(so it will start preloding terrain) and watch how long it takes for the 'Composite' counter on the F4 panel to fall to zero.
+   Controls whether the engine will use paging (chunking) algorithms to load non-terrain objects
+   outside of the active cell grid.
 
-max composite geometry size
----------------------------
+   Depending on the settings below every object in the game world has a chance
+   to be batched and be visible in the game world, effectively allowing
+   the engine to render distant objects with a relatively low performance impact automatically.
 
-:Type:		float
-:Range:		>=1.0
-:Default:	4.0
+   In general, an object is more likely to be batched if the number of the object's vertices
+   and the corresponding memory cost of merging the object is low compared to
+   the expected number of the draw calls that are going to be optimized out.
+   This memory cost and the saved number of draw calls shall be called
+   the "merging cost" and the "merging benefit" in the following documentation.
 
-Controls the maximum size of simple composite geometry chunk in cell units. With small values there will more draw calls and small textures,
-but higher values create more overdraw (not every texture layer is used everywhere).
+   Objects that are scripted to disappear from the game world
+   will be handled properly as long as their scripts have a chance to actually disable them.
 
-debug chunks
-------------
+   This setting has no effect if distant terrain is disabled.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+.. omw-setting::
+   :title: object paging active grid
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Settings > Visuals > Terrain`
 
-This debug setting allows you to see the borders of each chunks of the world by drawing lines around them (as with toggleborder). 
-If object paging is set to true then this debug setting will allows you to see what objects have been merged in the scene
-by making them colored randomly.
+   Controls whether the objects in the active cells use the mentioned paging algorithms.
+   Active grid paging significantly improves the framerate when your setup is CPU-limited.
 
+   .. note::
+      There is a limit of light sources which may affect a rendering shape at the moment.
+      If this limit is too small, lighting issues arising due to merged objects
+      being considered a single object, and they may disrupt your gameplay experience.
+      Consider increasing the 'max lights' setting value in the 'Shaders' section to avoid this issue.
+      With the Legacy lighting mode this limit can not be increased (only 8 sources can be used).
 
-object paging
--------------
+.. omw-setting::
+   :title: object paging merge factor
+   :type: float32
+   :range: >0
+   :default: 250.0
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   Affects the likelihood of more complex objects to get paged.
+   Higher values improve visual fidelity at the cost of performance and RAM.
 
-Controls whether the engine will use paging (chunking) algorithms to load non-terrain objects
-outside of the active cell grid.
+   Technically this factor is a multiplier of merging benefit and affects the decision
+   whether displaying the object is cheap enough to justify the sacrifices.
 
-Depending on the settings below every object in the game world has a chance
-to be batched and be visible in the game world, effectively allowing
-the engine to render distant objects with a relatively low performance impact automatically.
+.. omw-setting::
+   :title: object paging min size
+   :type: float32
+   :range: >0
+   :default: 0.01
+   :location: :bdg-success:`Launcher > Settings > Visuals > Terrain`
 
-In general, an object is more likely to be batched if the number of the object's vertices
-and the corresponding memory cost of merging the object is low compared to
-the expected number of the draw calls that are going to be optimized out.
-This memory cost and the saved number of draw calls shall be called
-the "merging cost" and the "merging benefit" in the following documentation.
+   Controls how large an object must be to be visible in the scene.
+   The object's size is divided by its distance to the camera
+   and the result of the division is compared with this value.
+   The smaller this value is, the more objects you will see in the scene.
 
-Objects that are scripted to disappear from the game world
-will be handled properly as long as their scripts have a chance to actually disable them.
+.. omw-setting::
+   :title: object paging min size merge factor
+   :type: float32
+   :range: >0
+   :default: 0.3
 
-This setting has no effect if distant terrain is disabled.
+   This setting gives inexpensive objects a chance to be rendered from a greater distance
+   even if the engine would rather discard them according to the previous setting.
 
-object paging active grid
--------------------------
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   It controls the factor that the minimum size is multiplied by
+   roughly according to the following formula:
 
-Controls whether the objects in the active cells use the mentioned paging algorithms.
-Active grid paging significantly improves the framerate when your setup is CPU-limited.
+   .. math::
 
-.. note::
-	There is a limit of light sources which may affect a rendering shape at the moment.
-	If this limit is too small, lighting issues arising due to merged objects
-	being considered a single object, and they may disrupt your gameplay experience.
-	Consider increasing the 'max lights' setting value in the 'Shaders' section to avoid this issue.
-	With the Legacy lighting mode this limit can not be increased (only 8 sources can be used).
+      \begin{aligned}
+      \text{factor} &= \text{merge cost} \cdot \frac{\text{min size cost multiplier}}{\text{merge benefit}} \\
+      \text{factor} &= \text{factor} + (1 - \text{factor}) \cdot \text{min size merge factor}
+      \end{aligned}
 
-object paging merge factor
---------------------------
-:Type:		float
-:Range:		>0
-:Default:	250.0
+   Since the larger this factor is, the smaller chance a large object has to be rendered,
+   decreasing this value makes more objects visible in the scene
+   without impacting the performance as dramatically as the minimum size setting.
 
-Affects the likelihood of more complex objects to get paged.
-Higher values improve visual fidelity at the cost of performance and RAM.
+.. omw-setting::
+   :title: object paging min size cost multiplier
+   :type: float32
+   :range: >0
+   :default: 25.0
 
-Technically this factor is a multiplier of merging benefit and affects the decision
-whether displaying the object is cheap enough to justify the sacrifices.
+   This setting adjusts the calculated cost of merging an object used in the mentioned functionality.
+   The larger this value is, the less expensive objects can be before they are discarded.
+   See the formula above to figure out the math.
 
-object paging min size
-----------------------
-:Type:		float
-:Range:		>0
-:Default:	0.01
+.. omw-setting::
+   :title: water culling
+   :type: boolean
+   :range: true, false
+   :default: true
 
-Controls how large an object must be to be visible in the scene.
-The object's size is divided by its distance to the camera
-and the result of the division is compared with this value.
-The smaller this value is, the more objects you will see in the scene.
+   Controls whether water culling is used.
 
-object paging min size merge factor
------------------------------------
-:Type:		float
-:Range:		>0
-:Default:	0.3
+   Water culling is an optimisation that prevents the expensive rendering of water when it is
+   evaluated to be below any visible terrain chunk, potentially improving performance in many scenes.
 
-This setting gives inexpensive objects a chance to be rendered from a greater distance
-even if the engine would rather discard them according to the previous setting.
-
-It controls the factor that the minimum size is multiplied by
-roughly according to the following formula:
-
-	factor = merge cost * min size cost multiplier / merge benefit
-	
-	factor = factor + (1 - factor) * min size merge factor
-
-Since the larger this factor is, the smaller chance a large object has to be rendered,
-decreasing this value makes more objects visible in the scene
-without impacting the performance as dramatically as the minimum size setting.
-
-object paging min size cost multiplier
---------------------------------------
-:Type:		float
-:Range:		>0
-:Default:	25.0
-
-This setting adjusts the calculated cost of merging an object used in the mentioned functionality.
-The larger this value is, the less expensive objects can be before they are discarded.
-See the formula above to figure out the math.
-
-water culling
--------------
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-Controls whether water culling is used.
-
-Water culling is an optimisation that prevents the expensive rendering of water when it is
-evaluated to be below any visible terrain chunk, potentially improving performance in many scenes.
-
-You may want to opt out of it if it causes framerate instability or inappropriately invisible water on your setup.
+   You may want to opt out of it if it causes framerate instability or inappropriately invisible water on your setup.
diff --git a/docs/source/reference/modding/settings/video.rst b/docs/source/reference/modding/settings/video.rst
index 76b20bb1da..1180403d30 100644
--- a/docs/source/reference/modding/settings/video.rst
+++ b/docs/source/reference/modding/settings/video.rst
@@ -1,196 +1,174 @@
 Video Settings
 ##############
 
-resolution x
-------------
+.. omw-setting::
+   :title: resolution x
+   :type: int
+   :range: > 0
+   :default: 800
+   :location: :bdg-success:`Launcher > Display` :bdg-info:`In Game > Options > Video`
 
-:Type:		integer
-:Range:		> 0
-:Default:	800
+   This setting determines the horizontal resolution of the OpenMW game window.
+   Larger values produce more detailed images within the constraints of your graphics hardware,
+   but may reduce the frame rate.
 
-This setting determines the horizontal resolution of the OpenMW game window.
-Larger values produce more detailed images within the constraints of your graphics hardware,
-but may reduce the frame rate.
+.. omw-setting::
+   :title: resolution y
+   :type: int
+   :range: > 0
+   :default: 600
+   :location: :bdg-success:`Launcher > Display` :bdg-info:`In Game > Options > Video`
 
-The window resolution can be selected from a menu of common screen sizes
-in the Video tab of the Video Panel of the Options menu, or in the Display tab of the launcher.
-The horizontal resolution can also be set to a custom value in the Display tab of the launcher.
+   This setting determines the vertical resolution of the OpenMW game window.
+   Larger values produce more detailed images within the constraints of your graphics hardware,
+   but may reduce the frame rate.
 
-resolution y
-------------
+.. omw-setting::
+   :title: window mode
+   :type: int
+   :range: 0, 1, 2
+   :default: 2
+   :location: :bdg-success:`Launcher > Display` :bdg-info:`In Game > Options > Video`
 
-:Type:		integer
-:Range:		> 0
-:Default:	600
+   This setting determines the window mode.
 
-This setting determines the vertical resolution of the OpenMW game window.
-Larger values produce more detailed images within the constraints of your graphics hardware,
-but may reduce the frame rate.
+   .. list-table::
+      :header-rows: 1
 
-The window resolution can be selected from a menu of common screen sizes
-in the Video tab of the Video Panel of the Options menu, or in the Display tab of the launcher.
-The vertical resolution can also be set to a custom value in the Display tab of the launcher.
+      * - Mode
+        - Meaning
+      * - 0
+        - Exclusive fullscreen
+      * - 1
+        - Windowed fullscreen, borderless window that matches screen resolution
+      * - 2
+        - Windowed
 
-window mode
------------
+.. omw-setting::
+   :title: screen
+   :type: int
+   :range: ≥ 0
+   :default: 0
+   :location: :bdg-success:`Launcher > Display`
 
-:Type:		integer
-:Range:		0, 1, 2
-:Default:	2 (Windowed)
+   This setting determines which screen the game will open on in multi-monitor configurations.
+   This setting is particularly important when the fullscreen setting is true,
+   since this is the only way to control which screen is used,
+   but it can also be used to control which screen a normal window or a borderless window opens on as well.
+   The screens are numbered in increasing order, beginning with 0.
 
-This setting determines the window mode.
+.. omw-setting::
+   :title: minimize on focus loss
+   :type: boolean
+   :range: true, false
+   :default: true
 
-0: Exclusive fullscreen
+   Minimize the OpenMW window if it loses cursor focus. This setting is primarily useful for single screen configurations,
+   so that the OpenMW screen in full screen mode can be minimized
+   when the operating system regains control of the mouse and keyboard.
+   On multiple screen configurations, disabling this option makes it easier to switch between screens while playing OpenMW.
 
-1: Windowed fullscreen, borderless window that matches screen resolution
+   .. note::
+      A minimized game window consumes less system resources and produces less heat,
+      since the game does not need to render in minimized state.
+      It is therefore advisable to minimize the game during pauses
+      (either via use of this setting, or by minimizing the window manually).
 
-2: Windowed
+   This setting has no effect if the fullscreen setting is false.
+
+   .. note::
+
+      Corresponds to SDL_HINT_VIDEO_MINIMIZE_ON_FOCUS_LOSS.
+
+.. omw-setting::
+   :title: window border
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-success:`Launcher > Display` :bdg-info:`In Game > Options > Video`
+
+   This setting determines whether there's an operating system border drawn around the OpenMW window.
+   If this setting is true, the window can be moved and resized with the operating system window controls.
+   If this setting is false, the window has no operating system border.
+
+   This setting has no effect if the fullscreen setting is true.
+
+.. omw-setting::
+   :title: antialiasing
+   :type: int
+   :range: ≥ 0
+   :default: 0
+   :location: :bdg-success:`Launcher > Display`
+
+   This setting controls anti-aliasing. Anti-aliasing is a technique designed to improve the appearance of polygon edges,
+   so they do not appear to be "jagged".
+   Anti-aliasing can smooth these edges at the cost of a minor reduction in the frame rate.
+   A value of 0 disables anti-aliasing.
+   Other values are supported according to the capabilities of your graphics hardware.
+   Higher values do a better job of smoothing out the image but have a greater impact on frame rate.
+
+.. omw-setting::
+   :title: vsync mode
+   :type: int
+   :range: 0, 1, 2
+   :default: 0
+   :location: :bdg-success:`Launcher > Display` :bdg-info:`In Game > Options > Video`
+
+   This setting determines whether frame draws are synchronized with the vertical refresh rate of your monitor.
+   Enabling this setting can reduce screen tearing,
+   a visual defect caused by updating the image buffer in the middle of a screen draw.
+   Enabling this option (1 or 2) typically implies limiting the framerate to the refresh rate of your monitor,
+   but may also introduce additional delays caused by having to wait until the appropriate time
+   (the vertical blanking interval) to draw a frame, and a loss in mouse responsiveness known as 'input lag'.
+   Mode 2 of this option corresponds to the use of adaptive vsync. Adaptive vsync is turned off if the framerate
+   cannot reach your display's refresh rate. This prevents the input lag from becoming unbearable but may lead to tearing.
+   Some hardware might not support this mode, in which case traditional vsync will be used.
 
 
-This setting can be toggled in game using the dropdown list in the Video tab of the Video panel in the Options menu.
-It can also be toggled with the window mode dropdown in the Display tab of the launcher.
+.. omw-setting::
+   :title: framerate limit
+   :type: float32
+   :range: ≥ 0.0
+   :default: 300
 
-screen
-------
+   This setting determines the maximum frame rate in frames per second.
+   If this setting is 0.0, the frame rate is unlimited.
 
-:Type:		integer
-:Range:		>= 0
-:Default:	0
+   There are several reasons to consider capping your frame rate,
+   especially if you're already experiencing a relatively high frame rate (greater than 60 frames per second).
+   Lower frame rates will consume less power and generate less heat and noise.
+   Frame rates above 60 frames per second rarely produce perceptible improvements in visual quality,
+   but may improve input responsiveness.
+   Capping the frame rate may in some situations reduce the perception of choppiness
+   (highly variable frame rates during game play) by lowering the peak frame rates.
 
-This setting determines which screen the game will open on in multi-monitor configurations.
-This setting is particularly important when the fullscreen setting is true,
-since this is the only way to control which screen is used,
-but it can also be used to control which screen a normal window or a borderless window opens on as well.
-The screens are numbered in increasing order, beginning with 0.
+   This setting interacts with the vsync setting in the Video section
+   in the sense that enabling vertical sync limits the frame rate to the refresh rate of your monitor
+   (often 60 frames per second).
+   Choosing to limit the frame rate using this setting instead of vsync may reduce input lag
+   due to the game not having to wait for the vertical blanking interval.
 
-This setting can be selected from a pull down menu in the Display tab of the OpenMW Launcher,
-but cannot be changed during game play.
 
-minimize on focus loss
-----------------------
+.. omw-setting::
+   :title: contrast
+   :type: float32
+   :range: > 0.0
+   :default: 1.0
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   This setting controls the contrast correction for all video in the game.
+   It has been reported to not work on some Linux systems.
 
-Minimize the OpenMW window if it loses cursor focus. This setting is primarily useful for single screen configurations,
-so that the OpenMW screen in full screen mode can be minimized
-when the operating system regains control of the mouse and keyboard.
-On multiple screen configurations, disabling this option makes it easier to switch between screens while playing OpenMW.
 
-.. Note::
-	A minimized game window consumes less system resources and produces less heat,
-	since the game does not need to render in minimized state.
-	It is therefore advisable to minimize the game during pauses
-	(either via use of this setting, or by minimizing the window manually).
+.. omw-setting::
+   :title: gamma
+   :type: float32
+   :range: > 0.0
+   :default: 1.0
+   :location: :bdg-success:`Launcher > Display` :bdg-info:`In Game > Options > Video > Detail Level`
 
-This setting has no effect if the fullscreen setting is false.
+   This setting controls the gamma correction for all video in the game.
+   Gamma is an exponent that makes colors brighter if greater than 1.0 and darker if less than 1.0.
 
-Developer note: corresponds to SDL_HINT_VIDEO_MINIMIZE_ON_FOCUS_LOSS.
+   .. warning::
 
-This setting can only be configured by editing the settings configuration file.
-
-window border
--------------
-
-:Type:		boolean
-:Range:		True/False
-:Default:	True
-
-This setting determines whether there's an operating system border drawn around the OpenMW window.
-If this setting is true, the window can be moved and resized with the operating system window controls.
-If this setting is false, the window has no operating system border.
-
-This setting has no effect if the fullscreen setting is true.
-
-This setting can be toggled in game using the Window Border button
-in the Video tab of the Video panel in the Options menu.
-It can also be toggled with the Window Border check box in the OpenMW Launcher.
-
-antialiasing
-------------
-
-:Type:		integer
-:Range:		>= 0
-:Default:	0
-
-This setting controls anti-aliasing. Anti-aliasing is a technique designed to improve the appearance of polygon edges,
-so they do not appear to be "jagged".
-Anti-aliasing can smooth these edges at the cost of a minor reduction in the frame rate.
-A value of 0 disables anti-aliasing.
-Other values are supported according to the capabilities of your graphics hardware.
-Higher values do a better job of smoothing out the image but have a greater impact on frame rate.
-
-This setting can be configured from a list of valid choices in the Graphics panel of the OpenMW Launcher,
-but cannot be changed during game play
-due to a technical limitation that may be addressed in a future version of OpenMW.
-
-vsync mode
-----------
-
-:Type:		integer
-:Range:		0, 1, 2
-:Default:	0
-
-This setting determines whether frame draws are synchronized with the vertical refresh rate of your monitor.
-Enabling this setting can reduce screen tearing,
-a visual defect caused by updating the image buffer in the middle of a screen draw.
-Enabling this option (1 or 2) typically implies limiting the framerate to the refresh rate of your monitor,
-but may also introduce additional delays caused by having to wait until the appropriate time
-(the vertical blanking interval) to draw a frame, and a loss in mouse responsiveness known as 'input lag'.
-Mode 2 of this option corresponds to the use of adaptive vsync. Adaptive vsync is turned off if the framerate
-cannot reach your display's refresh rate. This prevents the input lag from becoming unbearable but may lead to tearing.
-Some hardware might not support this mode, in which case traditional vsync will be used.
-
-This setting can be adjusted in game using the VSync combo box in the Video tab of the Video panel in the Options menu.
-It can also be changed by toggling the Vertical Sync combo box in the Display tab of the launcher.
-
-framerate limit
----------------
-
-:Type:		floating point
-:Range:		>= 0.0
-:Default:	300
-
-This setting determines the maximum frame rate in frames per second.
-If this setting is 0.0, the frame rate is unlimited.
-
-There are several reasons to consider capping your frame rate,
-especially if you're already experiencing a relatively high frame rate (greater than 60 frames per second).
-Lower frame rates will consume less power and generate less heat and noise.
-Frame rates above 60 frames per second rarely produce perceptible improvements in visual quality,
-but may improve input responsiveness.
-Capping the frame rate may in some situations reduce the perception of choppiness
-(highly variable frame rates during game play) by lowering the peak frame rates.
-
-This setting interacts with the vsync setting in the Video section
-in the sense that enabling vertical sync limits the frame rate to the refresh rate of your monitor
-(often 60 frames per second).
-Choosing to limit the frame rate using this setting instead of vsync may reduce input lag
-due to the game not having to wait for the vertical blanking interval.
-
-contrast
---------
-
-:Type:		floating point
-:Range:		> 0.0
-:Default:	1.0
-
-This setting controls the contrast correction for all video in the game.
-
-This setting can only be configured by editing the settings configuration file. 
-It has been reported to not work on some Linux systems.
-
-gamma
------
-
-:Type:		floating point
-:Range:		> 0.0
-:Default:	1.0
-
-This setting controls the gamma correction for all video in the game.
-Gamma is an exponent that makes colors brighter if greater than 1.0 and darker if less than 1.0.
-
-This setting can be changed in the Detail tab of the Video panel of the Options menu.
-It has been reported to not work on some Linux systems, 
-and therefore the in-game setting in the Options menu has been disabled on Linux systems.
+      This setting is only supported on Windows platform. The setting will not be displayed in the in-game menu if not available.
diff --git a/docs/source/reference/modding/settings/water.rst b/docs/source/reference/modding/settings/water.rst
index b04b92de94..0b53190ec0 100644
--- a/docs/source/reference/modding/settings/water.rst
+++ b/docs/source/reference/modding/settings/water.rst
@@ -2,159 +2,161 @@ Water Settings
 ##############
 
 .. note::
-	The settings for the water shader are difficult to describe,
-	but can be seen immediately in the Water tab of the Video panel in the Options menu.
-	Changes there will be saved to these settings.
-	It is suggested to stand on the shore of a moderately broad body of water with trees or other objects
-	on the far shore to test reflection textures,
-	underwater plants in shallow water near by to test refraction textures,
-	and some deep water visible from your location to test deep water visibility.
+   The settings for the water shader are difficult to describe,
+   but can be seen immediately in the Water tab of the Video panel in the Options menu.
+   Changes there will be saved to these settings.
+   It is suggested to stand on the shore of a moderately broad body of water with trees or other objects
+   on the far shore to test reflection textures,
+   underwater plants in shallow water near by to test refraction textures,
+   and some deep water visible from your location to test deep water visibility.
 
-shader
-------
+.. omw-setting::
+   :title: shader
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-info:`In Game > Options > Video > Water`
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   This setting enables or disables the water shader, which results in much more realistic looking water surfaces,
+   including reflected objects and a more detailed wavy surface.
 
-This setting enables or disables the water shader, which results in much more realistic looking water surfaces,
-including reflected objects and a more detailed wavy surface.
+.. omw-setting::
+   :title: rtt size
+   :type: int
+   :range: > 0
+   :default: 512
+   :location: :bdg-info:`In Game > Options > Video > Water`
 
-This setting can be toggled with the Shader button in the Water tab of the Video panel of the Options menu.
+   The setting determines the size of the texture used for reflection and refraction (if enabled).
+   For reflection, the texture size determines the detail of reflected images on the surface of the water.
+   For refraction, the texture size determines the detail of the objects on the other side of the plane of water
+   (which have a wavy appearance caused by the refraction).
+   RTT is an acronym for Render To Texture which allows rendering of the scene to be saved as a texture.
+   Higher values produces better visuals and result in a marginally lower frame rate depending on your graphics hardware.
 
-rtt size
---------
+   This setting has no effect if the shader setting is false.
+   In the Water tab of the Video panel of the Options menu, the choices are Low (512), Medium (1024) and High (2048).
+   It is recommended to use values that are a power of two because this results in more efficient use of video hardware.
 
-:Type:		integer
-:Range:		> 0
-:Default:	512
+.. omw-setting::
+   :title: refraction
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: :bdg-info:`In Game > Options > Video > Water`
 
-The setting determines the size of the texture used for reflection and refraction (if enabled).
-For reflection, the texture size determines the detail of reflected images on the surface of the water.
-For refraction, the texture size determines the detail of the objects on the other side of the plane of water
-(which have a wavy appearance caused by the refraction).
-RTT is an acronym for Render To Texture which allows rendering of the scene to be saved as a texture.
-Higher values produces better visuals and result in a marginally lower frame rate depending on your graphics hardware.
+   This setting enables the refraction rendering feature of the water shader.
+   Refraction causes deep water to be more opaque
+   and objects seen through the plane of the water to have a wavy appearance.
+   Enabling this feature results in better visuals, and a marginally lower frame rate depending on your graphics hardware.
 
-In the Water tab of the Video panel of the Options menu, the choices are Low (512), Medium (1024) and High (2048).
-This setting has no effect if the shader setting is false.
-It is recommended to use values that are a power of two because this results in more efficient use of video hardware.
+   This setting has no effect if the shader setting is false.
 
-This setting has no effect if the shader setting is false.
+.. omw-setting::
+   :title: sunlight scattering
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-info:`In Game > Options > Video > Water`
 
-refraction
-----------
+   This setting enables sunlight scattering.
+   This makes incident sunlight seemingly spread through water, simulating the optical property.
 
-:Type:		boolean
-:Range:		True/False
-:Default:	False
+   This setting has no effect if refraction is turned off.
 
-This setting enables the refraction rendering feature of the water shader.
-Refraction causes deep water to be more opaque
-and objects seen through the plane of the water to have a wavy appearance.
-Enabling this feature results in better visuals, and a marginally lower frame rate depending on your graphics hardware.
+.. omw-setting::
+   :title: wobbly shores
+   :type: boolean
+   :range: true, false
+   :default: true
+   :location: :bdg-info:`In Game > Options > Video > Water`
 
-This setting has no effect if the shader setting is false.
+   This setting makes shores wobbly.
+   The water surface will smoothly fade into the shoreline and wobble based on water normal-mapping, which avoids harsh transitions.
 
-This setting can be toggled with the 'Refraction' button in the Water tab of the Video panel of the Options menu.
+   This setting has no effect if refraction is turned off.
 
-sunlight scattering
--------------------
+.. omw-setting::
+   :title: reflection detail
+   :type: int
+   :range: 0, 1, 2, 3, 4, 5
+   :default: 2
+   :location: :bdg-info:`In Game > Options > Video > Water`
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   Controls what kinds of things are rendered in water reflections.
 
-This setting enables sunlight scattering.
-This makes incident sunlight seemingly spread through water, simulating the optical property.
+   .. list-table::
+      :header-rows: 1
 
-This setting has no effect if refraction is turned off.
+      * - Mode
+        - Meaning
+      * - 0
+        - only sky is reflected
+      * - 1
+        - terrain is also reflected
+      * - 2
+        - statics, activators, and doors are also reflected
+      * - 3
+        - items, containers, and particles are also reflected
+      * - 4
+        - actors are also reflected
+      * - 5
+        - groundcover objects are also reflected
 
-This setting can be toggled with the 'Sunlight Scattering' button in the Water tab of the Video panel of the Options menu.
+   In interiors the lowest level is 2.
 
-wobbly shores
--------------
+.. omw-setting::
+   :title: rain ripple detail
+   :type: int
+   :range: 0, 1, 2
+   :default: 1
+   :location: :bdg-info:`In Game > Options > Video > Water`
 
-:Type:		boolean
-:Range:		True/False
-:Default:	True
+   Controls how detailed the raindrop ripples on water are.
 
-This setting makes shores wobbly.
-The water surface will smoothly fade into the shoreline and wobble based on water normal-mapping, which avoids harsh transitions.
+   .. list-table::
+      :header-rows: 1
 
-This setting has no effect if refraction is turned off.
+      * - Mode
+        - Meaning
+      * - 0
+        - single, non-normal-mapped ring per raindrop
+      * - 1
+        - normal-mapped raindrops, with multiple rings
+      * - 2
+        - same as 1, but with a greater number of raindrops
 
-This setting can be toggled with the 'Wobbly Shores' button in the Water tab of the Video panel of the Options menu.
+.. omw-setting::
+   :title: small feature culling pixel size
+   :type: float32
+   :range: > 0
+   :default: 20.0
 
-reflection detail
------------------
+   Controls the cutoff in pixels for small feature culling - see the 'Camera' section for more details,
+   however this setting in the 'Water' section applies specifically to objects rendered in water reflection
+   and refraction textures.
 
-:Type:		integer
-:Range:		0, 1, 2, 3, 4, 5
-:Default:	2
+   The setting 'rtt size' interacts with this setting
+   because it controls how large a pixel on the water texture (technically called a texel) is in pixels on the screen.
 
-Controls what kinds of things are rendered in water reflections.
+   This setting will have no effect if the shader setting is false,
+   or the 'small feature culling' (in the 'Camera' section) is disabled.
 
-0: only sky is reflected
-1: terrain is also reflected
-2: statics, activators, and doors are also reflected
-3: items, containers, and particles are also reflected
-4: actors are also reflected
-5: groundcover objects are also reflected
+.. omw-setting::
+   :title: refraction scale
+   :type: float32
+   :range: 0 to 1
+   :default: 1.0
 
-In interiors the lowest level is 2.
-This setting can be changed ingame with the "Reflection shader detail" dropdown under the Water tab of the Video panel in the Options menu.
+   Simulates light rays refracting when transitioning from air to water, which causes the space under water look scaled down
+   in height when viewed from above the water surface. Though adding realism, the setting can cause distortion which can
+   make for example aiming at enemies in water more challenging, so it is off by default (i.e. set to 1.0). To get a realistic
+   look of real-life water, set the value to 0.75.
 
-rain ripple detail
-------------------
+   This setting only applies if water shader is on and refractions are enabled. Note that if refractions are enabled and this
+   setting if off, there will still be small refractions caused by the water waves, which however do not cause such significant
+   distortion.
 
-:Type:		integer
-:Range:		0, 1, 2
-:Default:	1
-
-Controls how detailed the raindrop ripples on water are.
-
-0: single, non-normal-mapped ring per raindrop
-1: normal-mapped raindrops, with multiple rings
-2: same as 1, but with a greater number of raindrops
-
-This setting can be changed ingame with the "Rain ripple detail/density" dropdown under the Water tab of the Video panel in the Options menu.
-
-small feature culling pixel size
---------------------------------
-
-:Type:		floating point
-:Range:		> 0
-:Default:	20.0
-
-Controls the cutoff in pixels for small feature culling - see the 'Camera' section for more details,
-however this setting in the 'Water' section applies specifically to objects rendered in water reflection
-and refraction textures.
-
-The setting 'rtt size' interacts with this setting
-because it controls how large a pixel on the water texture (technically called a texel) is in pixels on the screen.
-
-This setting will have no effect if the shader setting is false,
-or the 'small feature culling' (in the 'Camera' section) is disabled.
-
-This setting can only be configured by editing the settings configuration file.
-
-refraction scale
-----------------
-
-:Type:		floating point
-:Range:		0 to 1
-:Default:	1.0
-
-Simulates light rays refracting when transitioning from air to water, which causes the space under water look scaled down
-in height when viewed from above the water surface. Though adding realism, the setting can cause distortion which can
-make for example aiming at enemies in water more challenging, so it is off by default (i.e. set to 1.0). To get a realistic
-look of real-life water, set the value to 0.75.
-
-This setting only applies if water shader is on and refractions are enabled. Note that if refractions are enabled and this
-setting if off, there will still be small refractions caused by the water waves, which however do not cause such significant
-distortion.
-
-.. warning::
-    The `refraction scale` is currently mutually exclusive to underwater shadows. Setting this to any value except 1.0
-    will cause underwater shadows to be disabled. This will be addressed in issue https://gitlab.com/OpenMW/openmw/-/issues/5709
+   .. warning::
+      The `refraction scale` is currently mutually exclusive to underwater shadows. Setting this to any value except 1.0
+      will cause underwater shadows to be disabled. This will be addressed in issue https://gitlab.com/OpenMW/openmw/-/issues/5709
diff --git a/docs/source/reference/modding/settings/windows.rst b/docs/source/reference/modding/settings/windows.rst
index dd6bb3aee5..18bc88f983 100644
--- a/docs/source/reference/modding/settings/windows.rst
+++ b/docs/source/reference/modding/settings/windows.rst
@@ -1,24 +1,12 @@
 Windows Settings
 ################
 
-:Type:	floating point
-:Range:	0.0 to 1.0
-
 This section controls the location and size of each window in GUI mode.
 Each setting is a floating point number representing a *fraction*
 of the resolution x or resolution y setting in the Video Settings Section.
 The X and Y values locate the top left corner of the window,
 while the W value determines the width of the window and the H value determines the height of the window.
 
-Unlike the documentation for most sections which lists the exact setting name,
-this page instead lists the names of the windows.
-For example, to configure the alchemy window, the actual settings would be::
-
-	alchemy x = 0.25
-	alchemy y = 0.25
-	alchemy w = 0.5
-	alchemy h = 0.5
-
 Each window in the GUI mode remembers it's previous location when exiting the game.
 By far the easiest way to configure these settings is to simply move the windows around in game.
 Hand editing the configuration file might result in some fine tuning for alignment,
@@ -28,249 +16,568 @@ but the settings will be overwritten if a window is moved.
 	To scale the windows, making the widgets proportionally larger, 
 	see the scaling factor setting in the GUI section instead.
 
-:Type:		boolean
-:Range:		True/False
-
-This section controls the state of pinnable windows: pinned or not.
-For example, to pin only the map window, the actual settings will be::
-
-	inventory pin = false
-	map pin = true
-	stats pin = false
-	spells pin = false
-
-The pinnable window can be pinned/unpinned by clicking on a button in the right upper corner of the window.
-
-stats
------
-
-:Default:
-	x = 0.015
-
-	y = 0.015
-
-	w = 0.45
-
-	h = 0.4275
-
-	pin = false
-
-The stats window, displaying level, race, class, skills and stats.
-Activated by clicking on any of the three bars in the lower left corner of the HUD.
-
-spells
-------
-
-:Default:
-	x = 0.63
-
-	y = 0.39
-
-	w = 0.36
-
-	h = 0.51
-
-	pin = false
-
-The spells window, displaying powers, spells, and magical items.
-Activated by clicking on the spells widget (third from left) in the bottom left corner of the HUD.
-
-map
----
-
-:Default:
-	x = 0.63
-
-	y = 0.015
-
-	w = 0.36
-
-	h = 0.37
-
-	pin = false
-
-The local and world map window.
-Activated by clicking on the map widget in the bottom right corner of the HUD.
-
-inventory
----------
-
-:Default:
-	x = 0.015
-
-	y = 0.54
-
-	w = 0.45
-
-	h = 0.38
-
-	pin = false
-
-The inventory window, displaying the paper doll and possessions,
-when activated by clicking on the inventory widget (second from left) in the bottom left corner of the HUD.
-
-inventory container
--------------------
-
-:Default:
-	x = 0.015
-
-	y = 0.54
-
-	w = 0.45
-
-	h = 0.38
-
-The player's inventory window while searching a container, showing the contents of the character's inventory.
-Activated by clicking on a container. The same window is used for searching dead bodies, and pickpocketing people.
-
-inventory barter
-----------------
-
-:Default:
-	x = 0.015
-
-	y = 0.54
-
-	w = 0.45
-
-	h = 0.38
-
-The player's inventory window while bartering. It displays goods owned by the character while bartering.
-Activated by clicking on the Barter choice in the dialog window for an NPC.
-
-inventory companion
--------------------
-
-:Default:
-	x = 0.015
-
-	y = 0.54
-
-	w = 0.45
-
-	h = 0.38
-
-The player's inventory window while interacting with a companion.
-The companion windows were added in the Tribunal expansion, but are available everywhere in the OpenMW engine.
-
-container
----------
-
-:Default:
-	x = 0.49
-
-	y = 0.54
-
-	w = 0.39
-
-	h = 0.38
-
-The container window, showing the contents of the container. Activated by clicking on a container.
-The same window is used for searching dead bodies, and pickpocketing people.
-
-barter
-------
-
-:Default:
-	x = 0.6
-
-	y = 0.27
-
-	w = 0.38
-
-	h = 0.63
-
-The NPC bartering window, displaying goods owned by the shopkeeper while bartering.
-Activated by clicking on the Barter choice in the dialog window for an NPC.
-
-companion
----------
-
-:Default:
-	x = 0.6
-
-	y = 0.27
-
-	w = 0.38
-
-	h = 0.63
-
-The NPC's inventory window while interacting with a companion.
-The companion windows were added in the Tribunal expansion, but are available everywhere in the OpenMW engine.
-
-dialogue
---------
-
-:Default:
-	x = 0.15
-
-	y = 0.5
-
-	w = 0.7
-
-	h = 0.45
-
-The dialogue window, for talking with NPCs.
-Activated by clicking on a NPC.
-
-alchemy
--------
-
-:Default:
-	x = 0.25
-
-	y = 0.25
-
-	w = 0.5
-
-	h = 0.5
-
-The alchemy window, for crafting potions.
-Activated by dragging an alchemy tool on to the rag doll.
-Unlike most other windows, this window hides all other windows when opened.
-
-console
--------
-
-:Default:
-	x = 0.255
-
-	y = 0.215
-
-	w = 0.49
-
-	h = 0.3125
-
-The console command window.
-Activated by pressing the tilde (~) key.
-
-settings
---------
-
-:Default:
-	x = 0.1
-
-	y = 0.1
-
-	w = 0.8
-
-	h = 0.8
-
-The settings window.
-Activated by clicking Options in the main menu.
-
-postprocessor
--------------
-
-:Default:
-	x = 0.01
-
-	y = 0.02
-
-	w = 0.44
-
-	h = 0.95
-
-The postprocessor window used to configure shaders.
-Activated by pressing the F2 key.
+.. omw-setting::
+   :title: stats window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.015
+   :location: GUI mode window position
+
+   X coordinate (top-left corner) of the stats window.
+   Displays level, race, class, skills, and stats.
+   Activated by clicking any of the three bars in the lower left HUD corner.
+
+.. omw-setting::
+   :title: stats window y
+   :type: float32
+   :range: [0, 1]
+   :default: 0.015
+   :location: GUI mode window position
+
+   Y coordinate (top-left corner) of the stats window.
+   Displays level, race, class, skills, and stats.
+   Activated by clicking any of the three bars in the lower left HUD corner.
+
+.. omw-setting::
+   :title: stats window w
+   :type: float32
+   :range: [0, 1]
+   :default: 0.45
+   :location: GUI mode window size
+
+   Width of the stats window.
+   Displays level, race, class, skills, and stats.
+   Activated by clicking any of the three bars in the lower left HUD corner.
+
+.. omw-setting::
+   :title: stats window h
+   :type: float32
+   :range: [0, 1]
+   :default: 0.4275
+   :location: GUI mode window size
+
+   Height of the stats window.
+   Displays level, race, class, skills, and stats.
+   Activated by clicking any of the three bars in the lower left HUD corner.
+
+.. omw-setting::
+   :title: stats window pin
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: GUI mode window pin state
+
+   Whether the stats window is pinned.
+   Activated by clicking any of the three bars in the lower left HUD corner.
+
+.. omw-setting::
+   :title: spells window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.63
+   :location: GUI mode window position
+
+   X coordinate of the spells window.
+   Displays powers, spells, and magical items.
+   Activated by clicking the spells widget (third from left) in the lower left HUD corner.
+
+.. omw-setting::
+   :title: spells window y
+   :type: float32
+   :range: [0, 1]
+   :default: 0.39
+   :location: GUI mode window position
+
+   Y coordinate of the spells window.
+   Displays powers, spells, and magical items.
+   Activated by clicking the spells widget (third from left) in the lower left HUD corner.
+
+.. omw-setting::
+   :title: spells window w
+   :type: float32
+   :range: [0, 1]
+   :default: 0.36
+   :location: GUI mode window size
+
+   Width of the spells window.
+   Displays powers, spells, and magical items.
+   Activated by clicking the spells widget (third from left) in the lower left HUD corner.
+
+.. omw-setting::
+   :title: spells window h
+   :type: float32
+   :range: [0, 1]
+   :default: 0.51
+   :location: GUI mode window size
+
+   Height of the spells window.
+   Displays powers, spells, and magical items.
+   Activated by clicking the spells widget (third from left) in the lower left HUD corner.
+
+.. omw-setting::
+   :title: spells window pin
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: GUI mode window pin state
+
+   Whether the spells window is pinned.
+   Activated by clicking the spells widget (third from left) in the lower left HUD corner.
+
+.. omw-setting::
+   :title: map window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.63
+   :location: GUI mode window position
+
+   X coordinate of the map window.
+   Displays local and world map.
+   Activated by clicking the map widget in the lower right HUD corner.
+
+.. omw-setting::
+   :title: map window y
+   :type: float32
+   :range: [0, 1]
+   :default: 0.015
+   :location: GUI mode window position
+
+   Y coordinate of the map window.
+   Displays local and world map.
+   Activated by clicking the map widget in the lower right HUD corner.
+
+.. omw-setting::
+   :title: map window w
+   :type: float32
+   :range: [0, 1]
+   :default: 0.36
+   :location: GUI mode window size
+
+   Width of the map window.
+   Displays local and world map.
+   Activated by clicking the map widget in the lower right HUD corner.
+
+.. omw-setting::
+   :title: map window h
+   :type: float32
+   :range: [0, 1]
+   :default: 0.37
+   :location: GUI mode window size
+
+   Height of the map window.
+   Displays local and world map.
+   Activated by clicking the map widget in the lower right HUD corner.
+
+.. omw-setting::
+   :title: map window pin
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: GUI mode window pin state
+
+   Whether the map window is pinned.
+   Activated by clicking the map widget in the lower right HUD corner.
+
+.. omw-setting::
+   :title: inventory window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.015
+   :location: GUI mode window position
+
+   X coordinate of the inventory window.
+   Displays paper doll and possessions.
+   Activated by clicking the inventory widget (second from left) in the lower left HUD corner.
+
+.. omw-setting::
+   :title: inventory window y
+   :type: float32
+   :range: [0, 1]
+   :default: 0.54
+   :location: GUI mode window position
+
+   Y coordinate of the inventory window.
+   Displays paper doll and possessions.
+   Activated by clicking the inventory widget (second from left) in the lower left HUD corner.
+
+.. omw-setting::
+   :title: inventory window w
+   :type: float32
+   :range: [0, 1]
+   :default: 0.45
+   :location: GUI mode window size
+
+   Width of the inventory window.
+   Displays paper doll and possessions.
+   Activated by clicking the inventory widget (second from left) in the lower left HUD corner.
+
+.. omw-setting::
+   :title: inventory window h
+   :type: float32
+   :range: [0, 1]
+   :default: 0.38
+   :location: GUI mode window size
+
+   Height of the inventory window.
+   Displays paper doll and possessions.
+   Activated by clicking the inventory widget (second from left) in the lower left HUD corner.
+
+.. omw-setting::
+   :title: inventory window pin
+   :type: boolean
+   :range: true, false
+   :default: false
+   :location: GUI mode window pin state
+
+   Whether the inventory window is pinned.
+   Displays paper doll and possessions.
+   Activated by clicking the inventory widget (second from left) in the lower left HUD corner.
+
+.. omw-setting::
+   :title: inventory container window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.015
+   :location: GUI mode window position
+
+   X coordinate of the inventory container window.
+   Displays player inventory when searching a container.
+   Activated by clicking a container, dead body, or during pickpocketing.
+
+.. omw-setting::
+   :title: inventory container window y
+   :type: float32
+   :range: [0, 1]
+   :default: 0.54
+   :location: GUI mode window position
+
+   Y coordinate of the inventory container window.
+   Displays player inventory when searching a container.
+   Activated by clicking a container, dead body, or during pickpocketing.
+
+.. omw-setting::
+   :title: inventory container window w
+   :type: float32
+   :range: [0, 1]
+   :default: 0.45
+   :location: GUI mode window size
+
+   Width of the inventory container window.
+   Displays player inventory when searching a container.
+   Activated by clicking a container, dead body, or during pickpocketing.
+
+.. omw-setting::
+   :title: inventory container window h
+   :type: float32
+   :range: [0, 1]
+   :default: 0.38
+   :location: GUI mode window size
+
+   Height of the inventory container window.
+   Displays player inventory when searching a container.
+   Activated by clicking a container, dead body, or during pickpocketing.
+
+.. omw-setting::
+   :title: inventory barter window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.015
+   :location: GUI mode window position
+
+   X coordinate of the inventory barter window.
+   Displays character goods while bartering.
+   Activated by clicking Barter in NPC dialog.
+
+.. omw-setting::
+   :title: inventory barter window y
+   :type: float32
+   :range: [0, 1]
+   :default: 0.54
+   :location: GUI mode window position
+
+   Y coordinate of the inventory barter window.
+   Displays character goods while bartering.
+   Activated by clicking Barter in NPC dialog.
+
+.. omw-setting::
+   :title: inventory barter window w
+   :type: float32
+   :range: [0, 1]
+   :default: 0.45
+   :location: GUI mode window size
+
+   Width of the inventory barter window.
+   Displays character goods while bartering.
+   Activated by clicking Barter in NPC dialog.
+
+.. omw-setting::
+   :title: inventory barter window h
+   :type: float32
+   :range: [0, 1]
+   :default: 0.38
+   :location: GUI mode window size
+
+   Height of the inventory barter window.
+   Displays character goods while bartering.
+   Activated by clicking Barter in NPC dialog.
+
+.. omw-setting::
+   :title: inventory companion window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.015
+   :location: GUI mode window position
+
+   X coordinate of the inventory companion window.
+   Displays companion inventory while interacting.
+   Added in Tribunal expansion, available in OpenMW.
+
+.. omw-setting::
+   :title: inventory companion window y
+   :type: float32
+   :range: [0, 1]
+   :default: 0.54
+   :location: GUI mode window position
+
+   Y coordinate of the inventory companion window.
+   Displays companion inventory while interacting.
+   Added in Tribunal expansion, available in OpenMW.
+
+.. omw-setting::
+   :title: inventory companion window w
+   :type: float32
+   :range: [0, 1]
+   :default: 0.45
+   :location: GUI mode window size
+
+   Width of the inventory companion window.
+   Displays companion inventory while interacting.
+   Added in Tribunal expansion, available in OpenMW.
+
+.. omw-setting::
+   :title: inventory companion window h
+   :type: float32
+   :range: [0, 1]
+   :default: 0.38
+   :location: GUI mode window size
+
+   Height of the inventory companion window.
+   Displays companion inventory while interacting.
+   Added in Tribunal expansion, available in OpenMW.
+
+.. omw-setting::
+   :title: container window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.49
+   :location: GUI mode window position
+
+   X coordinate of the container window.
+   Shows contents of containers.
+   Activated by clicking a container, dead body, or during pickpocketing.
+
+.. omw-setting::
+   :title: container window y
+   :type: float32
+   :range: [0, 1]
+   :default: 0.54
+   :location: GUI mode window position
+
+   Y coordinate of the container window.
+   Shows contents of containers.
+   Activated by clicking a container, dead body, or during pickpocketing.
+
+.. omw-setting::
+   :title: container window w
+   :type: float32
+   :range: [0, 1]
+   :default: 0.39
+   :location: GUI mode window size
+
+   Width of the container window.
+   Shows contents of containers.
+   Activated by clicking a container, dead body, or during pickpocketing.
+
+.. omw-setting::
+   :title: container window h
+   :type: float32
+   :range: [0, 1]
+   :default: 0.38
+   :location: GUI mode window size
+
+   Height of the container window.
+   Shows contents of containers.
+   Activated by clicking a container, dead body, or during pickpocketing.
+
+.. omw-setting::
+   :title: barter window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.6
+   :location: GUI mode window position
+
+   X coordinate of the barter window.
+   Displays goods owned by shopkeeper while bartering.
+   Activated by clicking Barter in NPC dialog.
+
+.. omw-setting::
+   :title: barter window y
+   :type: float32
+   :range: [0, 1]
+   :default: 0.27
+   :location: GUI mode window position
+
+   Y coordinate of the barter window.
+   Displays goods owned by shopkeeper while bartering.
+   Activated by clicking Barter in NPC dialog.
+
+.. omw-setting::
+   :title: barter window w
+   :type: float32
+   :range: [0, 1]
+   :default: 0.38
+   :location: GUI mode window size
+
+   Width of the barter window.
+   Displays goods owned by shopkeeper while bartering.
+   Activated by clicking Barter in NPC dialog.
+
+.. omw-setting::
+   :title: barter window h
+   :type: float32
+   :range: [0, 1]
+   :default: 0.63
+   :location: GUI mode window size
+
+   Height of the barter window.
+   Displays goods owned by shopkeeper while bartering.
+   Activated by clicking Barter in NPC dialog.
+
+.. omw-setting::
+   :title: companion window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.6
+   :location: GUI mode window position
+
+   X coordinate of the companion window.
+   Displays NPC's inventory while interacting with companion.
+   Added in Tribunal expansion, available in OpenMW.
+
+.. omw-setting::
+   :title: companion window y
+   :type: float32
+   :range: [0, 1]
+   :default: 0.27
+   :location: GUI mode window position
+
+   Y coordinate of the companion window.
+   Displays NPC's inventory while interacting with companion.
+   Added in Tribunal expansion, available in OpenMW.
+
+.. omw-setting::
+   :title: companion window w
+   :type: float32
+   :range: [0, 1]
+   :default: 0.38
+   :location: GUI mode window size
+
+   Width of the companion window.
+   Displays NPC's inventory while interacting with companion.
+   Added in Tribunal expansion, available in OpenMW.
+
+.. omw-setting::
+   :title: companion window h
+   :type: float32
+   :range: [0, 1]
+   :default: 0.63
+   :location: GUI mode window size
+
+   Height of the companion window.
+   Displays NPC's inventory while interacting with companion.
+   Added in Tribunal expansion, available in OpenMW.
+
+.. omw-setting::
+   :title: dialogue window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.15
+   :location: GUI mode window position
+
+   X coordinate of the dialogue window.
+   Used for talking with NPCs.
+   Activated by clicking an NPC.
+
+.. omw-setting::
+   :title: dialogue window y
+   :type: float32
+   :range: [0, 1]
+   :default: 0.5
+   :location: GUI mode window position
+
+   Y coordinate of the dialogue window.
+   Used for talking with NPCs.
+   Activated by clicking an NPC.
+
+.. omw-setting::
+   :title: dialogue window w
+   :type: float32
+   :range: [0, 1]
+   :default: 0.7
+   :location: GUI mode window size
+
+   Width of the dialogue window.
+   Used for talking with NPCs.
+   Activated by clicking an NPC.
+
+.. omw-setting::
+   :title: dialogue window h
+   :type: float32
+   :range: [0, 1]
+   :default: 0.45
+   :location: GUI mode window size
+
+   Height of the dialogue window.
+   Used for talking with NPCs.
+   Activated by clicking an NPC.
+
+.. omw-setting::
+   :title: alchemy window x
+   :type: float32
+   :range: [0, 1]
+   :default: 0.25
+   :location: GUI mode window position
+
+   X coordinate of the alchemy window.
+   Used for crafting potions.
+   Activated by dragging an alchemy tool onto the rag doll.
+
+.. omw-setting::
+   :title: alchemy window y
+   :type: float32
+   :range: [0, 1]
+   :location: GUI mode window position
+
+   Y coordinate of the alchemy window.
+   Used for crafting potions.
+   Activated by dragging an alchemy tool onto the rag doll.
+
+.. omw-setting::
+   :title: alchemy window w
+   :type: float32
+   :range: [0, 1]
+   :location: GUI mode window size
+
+   Width of the alchemy window.
+   Used for crafting potions.
+   Activated by dragging an alchemy tool onto the rag doll.
+
+.. omw-setting::
+   :title: alchemy window h
+   :type: float32
+   :range: [0, 1]
+   :location: GUI mode window size
+
+   Height of the alchemy window.
+   Used for crafting potions.
+   Activated by dragging an alchemy tool onto the rag doll.

From c4506d2d672a40d2e9a6fdb0d9eb1a9f160cd7b0 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Thu, 26 Jun 2025 18:37:46 -0700
Subject: [PATCH 42/44] docs - add missing inherited fields and events to
 widgets

---
 .../lua-scripting/widgets/container.rst       | 47 +++++++++++
 .../reference/lua-scripting/widgets/flex.rst  | 79 +++++++++++++++++++
 .../reference/lua-scripting/widgets/image.rst | 79 +++++++++++++++++++
 .../reference/lua-scripting/widgets/text.rst  | 79 +++++++++++++++++++
 .../lua-scripting/widgets/textedit.rst        | 64 +++++++++++++++
 5 files changed, 348 insertions(+)

diff --git a/docs/source/reference/lua-scripting/widgets/container.rst b/docs/source/reference/lua-scripting/widgets/container.rst
index a990b55c6a..366dedaca3 100644
--- a/docs/source/reference/lua-scripting/widgets/container.rst
+++ b/docs/source/reference/lua-scripting/widgets/container.rst
@@ -49,3 +49,50 @@ Properties
     - boolean (true)
     - | Modulate `alpha` with parents `alpha`.
       | If the parent has `inheritAlpha` set to `true`, the value after modulating is passed to the child.
+
+Events
+------
+
+Base widget events are special, they can propagate up to the parent widget.
+This can be prevented by changing the `propagateEvents` property, or by assigning an  event handler.
+The event is still allowed to propagate if the event handler returns `true`.
+
+.. list-table::
+  :header-rows: 1
+  :widths: 20 20 60
+
+  * - name
+    - first argument type
+    - description
+  * - keyPress
+    - `KeyboardEvent <../openmw_input.html##(KeyboardEvent)>`_
+    - A key was pressed with this widget in focus
+  * - keyRelease
+    - `KeyboardEvent <../openmw_input.html##(KeyboardEvent)>`_
+    - A key was released with this widget in focus
+  * - mouseMove
+    - `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - | Mouse cursor moved on this widget
+      | `MouseEvent.button` is the mouse button being held
+      | (nil when simply moving, and not dragging)
+  * - mouseClick
+    - nil
+    - Widget was clicked with left mouse button
+  * - mouseDoubleClick
+    - nil
+    - Widget was double clicked with left mouse button
+  * - mousePress  
+    - `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - A mouse button was pressed on this widget
+  * - mouseRelease  
+    -  `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - A mouse button was released on this widget
+  * - focusGain
+    - nil
+    - Widget gained focus (either through mouse or keyboard)
+  * - focusLoss
+    - nil
+    - Widget lost focus
+  * - textInput
+    - string
+    - Text input with this widget in focus
diff --git a/docs/source/reference/lua-scripting/widgets/flex.rst b/docs/source/reference/lua-scripting/widgets/flex.rst
index 468cb93958..e9927738f0 100644
--- a/docs/source/reference/lua-scripting/widgets/flex.rst
+++ b/docs/source/reference/lua-scripting/widgets/flex.rst
@@ -13,6 +13,38 @@ Properties
   * - name
     - type (default value)
     - description
+  * - position
+    - util.vector2 (0, 0)
+    - | Offsets the position of the widget from its parent's
+      | top-left corner in pixels.
+  * - size
+    - util.vector2 (0, 0)
+    - Increases the widget's size in pixels.
+  * - relativePosition  
+    - util.vector2 (0, 0)
+    - | Offsets the position of the widget from its parent's
+      | top-left corner as a fraction of the parent's size.
+  * - relativeSize
+    - util.vector2 (0, 0)
+    - Increases the widget's size by a fraction of its parent's size.
+  * - anchor
+    - util.vector2 (0, 0)
+    - | Offsets the widget's position by a fraction of its size.
+      | Useful for centering or aligning to a corner.
+  * - visible
+    - boolean (true)
+    - Defines if the widget is visible
+  * - propagateEvents
+    - boolean (true)
+    - Allows base widget events to propagate to the widget's parent.
+  * - alpha
+    - number (1.0)
+    - | Set the opacity of the widget and its contents.
+      | If `inheritAlpha` is set to `true`, this becomes the maximum alpha value the widget can take.
+  * - inheritAlpha
+    - boolean (true)
+    - | Modulate `alpha` with parents `alpha`.
+      | If the parent has `inheritAlpha` set to `true`, the value after modulating is passed to the child.
   * - horizontal
     - bool (false)
     - | Flex aligns its children in a row (main axis is horizontal) if true,
@@ -28,6 +60,53 @@ Properties
     - ui.ALIGNMENT (Start)
     - How to arrange the children in the cross axis.
 
+Events
+------
+
+Base widget events are special, they can propagate up to the parent widget.
+This can be prevented by changing the `propagateEvents` property, or by assigning an  event handler.
+The event is still allowed to propagate if the event handler returns `true`.
+
+.. list-table::
+  :header-rows: 1
+  :widths: 20 20 60
+
+  * - name
+    - first argument type
+    - description
+  * - keyPress
+    - `KeyboardEvent <../openmw_input.html##(KeyboardEvent)>`_
+    - A key was pressed with this widget in focus
+  * - keyRelease
+    - `KeyboardEvent <../openmw_input.html##(KeyboardEvent)>`_
+    - A key was released with this widget in focus
+  * - mouseMove
+    - `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - | Mouse cursor moved on this widget
+      | `MouseEvent.button` is the mouse button being held
+      | (nil when simply moving, and not dragging)
+  * - mouseClick
+    - nil
+    - Widget was clicked with left mouse button
+  * - mouseDoubleClick
+    - nil
+    - Widget was double clicked with left mouse button
+  * - mousePress  
+    - `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - A mouse button was pressed on this widget
+  * - mouseRelease  
+    -  `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - A mouse button was released on this widget
+  * - focusGain
+    - nil
+    - Widget gained focus (either through mouse or keyboard)
+  * - focusLoss
+    - nil
+    - Widget lost focus
+  * - textInput
+    - string
+    - Text input with this widget in focus
+
 External
 --------
 .. list-table::
diff --git a/docs/source/reference/lua-scripting/widgets/image.rst b/docs/source/reference/lua-scripting/widgets/image.rst
index df62251622..9c7d7f6c7e 100644
--- a/docs/source/reference/lua-scripting/widgets/image.rst
+++ b/docs/source/reference/lua-scripting/widgets/image.rst
@@ -13,6 +13,38 @@ Properties
   * - name
     - type (default value)
     - description
+  * - position
+    - util.vector2 (0, 0)
+    - | Offsets the position of the widget from its parent's
+      | top-left corner in pixels.
+  * - size
+    - util.vector2 (0, 0)
+    - Increases the widget's size in pixels.
+  * - relativePosition  
+    - util.vector2 (0, 0)
+    - | Offsets the position of the widget from its parent's
+      | top-left corner as a fraction of the parent's size.
+  * - relativeSize
+    - util.vector2 (0, 0)
+    - Increases the widget's size by a fraction of its parent's size.
+  * - anchor
+    - util.vector2 (0, 0)
+    - | Offsets the widget's position by a fraction of its size.
+      | Useful for centering or aligning to a corner.
+  * - visible
+    - boolean (true)
+    - Defines if the widget is visible
+  * - propagateEvents
+    - boolean (true)
+    - Allows base widget events to propagate to the widget's parent.
+  * - alpha
+    - number (1.0)
+    - | Set the opacity of the widget and its contents.
+      | If `inheritAlpha` is set to `true`, this becomes the maximum alpha value the widget can take.
+  * - inheritAlpha
+    - boolean (true)
+    - | Modulate `alpha` with parents `alpha`.
+      | If the parent has `inheritAlpha` set to `true`, the value after modulating is passed to the child.
   * - resource
     - ui.texture
     - The texture resource to display
@@ -25,3 +57,50 @@ Properties
   * - color
     - util.color (``rgb(1, 1, 1)``)
     - Modulate constant color with the color of the image texture.
+
+Events
+------
+
+Base widget events are special, they can propagate up to the parent widget.
+This can be prevented by changing the `propagateEvents` property, or by assigning an  event handler.
+The event is still allowed to propagate if the event handler returns `true`.
+
+.. list-table::
+  :header-rows: 1
+  :widths: 20 20 60
+
+  * - name
+    - first argument type
+    - description
+  * - keyPress
+    - `KeyboardEvent <../openmw_input.html##(KeyboardEvent)>`_
+    - A key was pressed with this widget in focus
+  * - keyRelease
+    - `KeyboardEvent <../openmw_input.html##(KeyboardEvent)>`_
+    - A key was released with this widget in focus
+  * - mouseMove
+    - `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - | Mouse cursor moved on this widget
+      | `MouseEvent.button` is the mouse button being held
+      | (nil when simply moving, and not dragging)
+  * - mouseClick
+    - nil
+    - Widget was clicked with left mouse button
+  * - mouseDoubleClick
+    - nil
+    - Widget was double clicked with left mouse button
+  * - mousePress  
+    - `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - A mouse button was pressed on this widget
+  * - mouseRelease  
+    -  `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - A mouse button was released on this widget
+  * - focusGain
+    - nil
+    - Widget gained focus (either through mouse or keyboard)
+  * - focusLoss
+    - nil
+    - Widget lost focus
+  * - textInput
+    - string
+    - Text input with this widget in focus
diff --git a/docs/source/reference/lua-scripting/widgets/text.rst b/docs/source/reference/lua-scripting/widgets/text.rst
index b1e7d89e59..e98eb3f30e 100644
--- a/docs/source/reference/lua-scripting/widgets/text.rst
+++ b/docs/source/reference/lua-scripting/widgets/text.rst
@@ -13,6 +13,38 @@ Properties
   * - name
     - type (default value)
     - description
+  * - position
+    - util.vector2 (0, 0)
+    - | Offsets the position of the widget from its parent's
+      | top-left corner in pixels.
+  * - size
+    - util.vector2 (0, 0)
+    - Increases the widget's size in pixels.
+  * - relativePosition  
+    - util.vector2 (0, 0)
+    - | Offsets the position of the widget from its parent's
+      | top-left corner as a fraction of the parent's size.
+  * - relativeSize
+    - util.vector2 (0, 0)
+    - Increases the widget's size by a fraction of its parent's size.
+  * - anchor
+    - util.vector2 (0, 0)
+    - | Offsets the widget's position by a fraction of its size.
+      | Useful for centering or aligning to a corner.
+  * - visible
+    - boolean (true)
+    - Defines if the widget is visible
+  * - propagateEvents
+    - boolean (true)
+    - Allows base widget events to propagate to the widget's parent.
+  * - alpha
+    - number (1.0)
+    - | Set the opacity of the widget and its contents.
+      | If `inheritAlpha` is set to `true`, this becomes the maximum alpha value the widget can take.
+  * - inheritAlpha
+    - boolean (true)
+    - | Modulate `alpha` with parents `alpha`.
+      | If the parent has `inheritAlpha` set to `true`, the value after modulating is passed to the child.
   * - autoSize
     - boolean (true)
     - | Adjusts this widget's size to fit the text exactly.
@@ -44,3 +76,50 @@ Properties
   * - textShadowColor
     - util.color (``rgb(0, 0, 0)``)
     - The color of the text shadow.
+
+Events
+------
+
+Base widget events are special, they can propagate up to the parent widget.
+This can be prevented by changing the `propagateEvents` property, or by assigning an  event handler.
+The event is still allowed to propagate if the event handler returns `true`.
+
+.. list-table::
+  :header-rows: 1
+  :widths: 20 20 60
+
+  * - name
+    - first argument type
+    - description
+  * - keyPress
+    - `KeyboardEvent <../openmw_input.html##(KeyboardEvent)>`_
+    - A key was pressed with this widget in focus
+  * - keyRelease
+    - `KeyboardEvent <../openmw_input.html##(KeyboardEvent)>`_
+    - A key was released with this widget in focus
+  * - mouseMove
+    - `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - | Mouse cursor moved on this widget
+      | `MouseEvent.button` is the mouse button being held
+      | (nil when simply moving, and not dragging)
+  * - mouseClick
+    - nil
+    - Widget was clicked with left mouse button
+  * - mouseDoubleClick
+    - nil
+    - Widget was double clicked with left mouse button
+  * - mousePress  
+    - `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - A mouse button was pressed on this widget
+  * - mouseRelease  
+    -  `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - A mouse button was released on this widget
+  * - focusGain
+    - nil
+    - Widget gained focus (either through mouse or keyboard)
+  * - focusLoss
+    - nil
+    - Widget lost focus
+  * - textInput
+    - string
+    - Text input with this widget in focus
diff --git a/docs/source/reference/lua-scripting/widgets/textedit.rst b/docs/source/reference/lua-scripting/widgets/textedit.rst
index a06599ffd6..d96b054f4e 100644
--- a/docs/source/reference/lua-scripting/widgets/textedit.rst
+++ b/docs/source/reference/lua-scripting/widgets/textedit.rst
@@ -13,6 +13,38 @@ Properties
   * - name
     - type (default value)
     - description
+  * - position
+    - util.vector2 (0, 0)
+    - | Offsets the position of the widget from its parent's
+      | top-left corner in pixels.
+  * - size
+    - util.vector2 (0, 0)
+    - Increases the widget's size in pixels.
+  * - relativePosition  
+    - util.vector2 (0, 0)
+    - | Offsets the position of the widget from its parent's
+      | top-left corner as a fraction of the parent's size.
+  * - relativeSize
+    - util.vector2 (0, 0)
+    - Increases the widget's size by a fraction of its parent's size.
+  * - anchor
+    - util.vector2 (0, 0)
+    - | Offsets the widget's position by a fraction of its size.
+      | Useful for centering or aligning to a corner.
+  * - visible
+    - boolean (true)
+    - Defines if the widget is visible
+  * - propagateEvents
+    - boolean (true)
+    - Allows base widget events to propagate to the widget's parent.
+  * - alpha
+    - number (1.0)
+    - | Set the opacity of the widget and its contents.
+      | If `inheritAlpha` is set to `true`, this becomes the maximum alpha value the widget can take.
+  * - inheritAlpha
+    - boolean (true)
+    - | Modulate `alpha` with parents `alpha`.
+      | If the parent has `inheritAlpha` set to `true`, the value after modulating is passed to the child.
   * - text
     - string ('')
     - The text to display.
@@ -52,6 +84,38 @@ Events
   * - name
     - first argument type
     - description
+  * - keyPress
+    - `KeyboardEvent <../openmw_input.html##(KeyboardEvent)>`_
+    - A key was pressed with this widget in focus
+  * - keyRelease
+    - `KeyboardEvent <../openmw_input.html##(KeyboardEvent)>`_
+    - A key was released with this widget in focus
+  * - mouseMove
+    - `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - | Mouse cursor moved on this widget
+      | `MouseEvent.button` is the mouse button being held
+      | (nil when simply moving, and not dragging)
+  * - mouseClick
+    - nil
+    - Widget was clicked with left mouse button
+  * - mouseDoubleClick
+    - nil
+    - Widget was double clicked with left mouse button
+  * - mousePress  
+    - `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - A mouse button was pressed on this widget
+  * - mouseRelease  
+    -  `MouseEvent <../openmw_ui.html##(MouseEvent)>`_
+    - A mouse button was released on this widget
+  * - focusGain
+    - nil
+    - Widget gained focus (either through mouse or keyboard)
+  * - focusLoss
+    - nil
+    - Widget lost focus
+  * - textInput
+    - string
+    - Text input with this widget in focus
   * - textChanged
     - string
     - Displayed text changed (e. g. by user input)

From 8ed5d84ff7920b089d81c9582408605a9d879fa8 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Fri, 27 Jun 2025 07:11:45 -0700
Subject: [PATCH 43/44] docs - update theme in requirements.txt

---
 docs/requirements.txt | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/requirements.txt b/docs/requirements.txt
index c044a3a21d..d22bcceae6 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -3,4 +3,4 @@ sphinx==7.1.2
 docutils==0.18.1
 jinja2==3.1.6
 sphinx-design==0.5.0
-git+https://github.com/glassmancody/sphinxawesome-theme.git@fix_dark_theme_pygment_and_flash
\ No newline at end of file
+git+https://github.com/glassmancody/sphinxawesome-theme.git@openmw
\ No newline at end of file

From 10f86c67fefb8866e409233a4576cd7a43a538e7 Mon Sep 17 00:00:00 2001
From: Cody Glassman <glassmancody.info@gmail.com>
Date: Wed, 2 Jul 2025 06:04:39 -0700
Subject: [PATCH 44/44] docs - fix spacing in example lua

---
 .../reference/lua-scripting/user_interface.rst | 18 +++++++++---------
 1 file changed, 9 insertions(+), 9 deletions(-)

diff --git a/docs/source/reference/lua-scripting/user_interface.rst b/docs/source/reference/lua-scripting/user_interface.rst
index 5be573ee24..b8d9166b8f 100644
--- a/docs/source/reference/lua-scripting/user_interface.rst
+++ b/docs/source/reference/lua-scripting/user_interface.rst
@@ -104,15 +104,15 @@ Example
             layer = 'HUD',
             type = ui.TYPE.Text,
             props = {
-            -- position in the top right corner
-            relativePosition = util.vector2(1, 0),
-            -- position is for the top left corner of the widget by default
-            -- change it to align exactly to the top right corner of the screen
-            anchor = util.vector2(1, 0),
-            text = calendar.formatGameTime('%H:%M'),
-            textSize = 24,
-            -- default black text color isn't always visible
-            textColor = util.color.rgb(0, 1, 0),
+               -- position in the top right corner
+               relativePosition = util.vector2(1, 0),
+               -- position is for the top left corner of the widget by default
+               -- change it to align exactly to the top right corner of the screen
+               anchor = util.vector2(1, 0),
+               text = calendar.formatGameTime('%H:%M'),
+               textSize = 24,
+               -- default black text color isn't always visible
+               textColor = util.color.rgb(0, 1, 0),
             },
          }