Changelog

1.1.0 stable 2026-10-23

S3LightFixes finds OpenMW's own configuration when none is named, as the original does.

Added

• With neither --config nor OPENMW_CONFIG, the openmw.cfg in the folder OpenMW keeps its own in on this platform: Documents\My Games\OpenMW on Windows, wherever Documents was moved, Library/Preferences/openmw on macOS, and the XDG config folder elsewhere. Its ?userconfig? and ?userdata? are OpenMW's own folders. Needs jess 0.2.1 or later.

1.0.0 stable 2026-10-21

S3LightFixes is a Jess package, written in Luau; the Rust program continues on the rust branch at 0.5.0.

Breaking changes

• The tool is the Jess package org.dreamweave.s3lightfixes, run through jess rather than as a downloaded binary, so the per-platform downloads, the PortMaster build and the AUR package end with 0.5.0. The Rust program stays on its GitHub releases and this repository's rust branch, and is no longer developed on main.

0.5.0 stable unreleased 2026-09-29

A cleaned-up command line, runs that check or preview without writing anything, a log of every change, RGB colors in overrides, and the MIT license.

Breaking changes

• -V is --version, and --colored-value no longer has a short form.
• -i, --info is gone: use --version.
• -l, --write-log and save_log, which wrote the whole plugin as text, are gone: every run writes lightconfig.log instead.
• Light flags in overrides are spelled as in the Construction Set, FLICKER_SLOW and PULSE_SLOW; FLICKERSLOW and PULSESLOW are errors.
• --ambient colors on the command line are red, green and blue, 0 to 255, not hue, saturation and value. lightconfig.toml still reads the old form.
• --openmw-cfg takes a folder holding openmw.cfg, or a file named exactly openmw.cfg, and stops the run with exit code 127 on anything else.

Added

• --dry-run reads everything and prints every change without writing a file.
• --validate-config checks lightconfig.toml, the options and every pattern, and stops. It fails on a key in lightconfig.toml it does not know, which a run warns about and ignores.
• dry_run and validate_config in lightconfig.toml.
• red, green and blue as a fixed color in light overrides, and red_mult, green_mult and blue_mult, applied last.
• flag in light overrides takes any of the nine light flags, or a list of them, so an override can keep CAN_CARRY.
• --disable-negative-lights and disable_negative_lights: negative lights can be kept.
• lightconfig.log: the config, output and counts of a run, and one line per changed record. Every run also prints it.
• --auto-enable backs up openmw.cfg to openmw.cfg.s3lightfixes.bak before editing it, and edits nothing if the backup fails.
• --generate-completion for bash, elvish, fish, PowerShell and zsh, and --generate-manpage.
• Android and PortMaster archives.
• A Rust library, s3lightfixes, with the settings, overrides and light arithmetic the program uses.

Changed

• Licensed MIT, instead of GPL-3.0-or-later.
• openmw.cfg is found as OpenMW finds its root config: OPENMW_CONFIG, OPENMW_CONFIG_DIR, beside the program, the Linux global config, then the user's.
• The Linux builds need glibc 2.34 or newer, down from 2.39.
• Every archive holds s3lightfixes, s3lightfixes-README.md, s3lightfixes-LICENSE and a Sigstore bundle.
• openmw-config 1.1, and updated dependencies.

Fixed

• The user openmw.cfg is read when no other is found, on Windows and macOS too.
• Exclusions and light and ambient overrides match ids and plugin names in any case. An override pattern with a capital letter matched nothing.
• Infinite lights stay infinite, unless an override gives them a fixed duration.
• A plugin named S3LightFixes is never read as input, whatever its extension.
• An unreadable lightconfig.toml exits with status 1. On Linux and macOS it exited 0.
• Messages are printed when no dialog can be shown, such as on Linux without zenity, kdialog or yad.
• Saving rewrites lightconfig.toml under the name it was found with, instead of adding a second file on a case-sensitive system.
• A dry run piped into head no longer ends in an error.

Migration

Most runs need no change. Scripts and launchers that pass options do: -V is now --version, so give --colored-value in full; use --version for -i; drop -l, since every run writes lightconfig.log. Spell light flags FLICKER_SLOW and PULSE_SLOW, and give --ambient colors as red, green and blue. --openmw-cfg needs a folder, or a file named exactly openmw.cfg. Then run s3lightfixes --validate-config: it says save_log can be deleted from lightconfig.toml, and fails on any other key it does not read.

0.4.6 stable 2026-04-06

openmw-config 0.1.93 and an updated tes3. This build reports its version as 0.4.59.

Changed

• OpenMW's configuration is read with openmw-config 0.1.93.

0.4.58 stable 2025-12-22

A regular expression that does not compile is reported instead of dropped.

Fixed

• An invalid excluded_ids or excluded_plugins pattern shows a notification naming it.

0.4.57 stable 2025-12-20

Release workflow changes only. The program is unchanged.

0.4.55 stable 2025-12-19

Release workflow changes only. The program is unchanged.

0.4.56 stable 2025-12-19

Release workflow changes only. The program is unchanged.

0.4.53 stable 2025-12-18

Archives are named s3lightfixes-<platform>.zip. The program is unchanged.

0.4.51 stable unreleased 2025-12-17

Excluded plugins are excluded again.

Fixed

• excluded_plugins is applied again, without regard to case. From 0.4.2 on it had been read and ignored.

0.4.52 stable unreleased 2025-12-17

A build for Intel Macs.

Added

• An Intel macOS archive, beside Apple silicon, Windows and Linux.

0.4.50 stable unreleased 2025-10-19

Overrides apply in the order lightconfig.toml lists them, and excluded ids also exclude cells.

Changed

• excluded_ids also matches interior cell ids.
• Light and ambient overrides keep the order they have in lightconfig.toml, so the first match is the first listed.

Fixed

• Builds on macOS again, with an updated native-dialog.

0.4.46 stable unreleased 2025-10-03

An openmw-config update that fixes how the user openmw.cfg is handled, and the license in every archive.

Added

• LICENSE in every release archive.

Fixed

• Handling of the user openmw.cfg, through an updated openmw-config.

0.4.45 stable unreleased 2025-09-26

Dependency updates and a corrected linker for ARM64 Linux builds.

0.4.44 stable unreleased 2025-09-02

Licensed GPL-3.0-or-later, with dependencies updated.

Added

• A license: GPL-3.0-or-later.

0.4.43 stable unreleased 2025-08-15

Cells the plugin replaces are written without a water height.

Fixed

• Every cell the plugin replaces is written without the water height of the plugin it was copied from.

0.4.42 stable unreleased 2025-08-07

The same program as 0.4.4: 0.4.41's lookup of openmw.cfg in the working directory and its parent is reverted.

0.4.4 stable unreleased 2025-07-07

vfstool_lib 0.2.0, which no longer pulls in DirectXTex. The program is unchanged.

0.4.3 stable unreleased 2025-07-04

Builds with stable Rust. The program is unchanged.

0.4.2 stable unreleased 2025-07-04

Per-light and per-cell overrides, and plugins read in parallel.

Added

• --light and [light_overrides]: color, radius, duration and flags for the lights whose id matches a regular expression.
• --ambient and [ambient_overrides]: ambient, sunlight and fog colors and fog density for the interior cells whose id matches.
• -U, --update-light-config, and save_config save the settings of a run into lightconfig.toml.
• disable_interior_sun in lightconfig.toml, the setting behind --classic.

Changed

• Plugins are read in parallel, and only their cell and light records.

Fixed

• A relative --openmw-cfg path is resolved from the working directory.
• Only cells that were changed are written to the plugin.
• Interior cells without ambient data are no longer reported as changed.

Known issues

• excluded_plugins is read but not applied, until 0.4.51.

0.4.0 stable unreleased 2025-06-17

Pulsing lights, carried-light duration and exclusions become settings, and openmw.cfg is read through openmw-config.

Added

• disable_pulse and --no-pulse remove the pulse flags from every light.
• duration_mult and --duration-mult multiply light durations.
• excluded_ids and excluded_plugins: regular expressions for light ids and plugins to leave alone, with a built-in list of plugins that do not parse.

Changed

• OpenMW's configuration is read with the openmw-config crate.
• A lightconfig.toml that leaves out a setting uses its default instead of failing.

Fixed

• The generated plugin's header counts its records correctly.

0.4.1 stable unreleased 2025-06-17

Finds the OpenMW config in its default Windows location, and reports every handled error in a notification.

Fixed

• Finding openmw.cfg in its default Windows location, including a Documents folder that OneDrive has moved.
• Every error the program handles is shown as a notification, not only some of them.

0.3.3 stable unreleased 2025-05-08

lightconfig.toml is read again.

Fixed

• lightconfig.toml is read from the folder of openmw.cfg. From 0.3.0 on it was looked for in the wrong place, so every run used the defaults and wrote them over it.

0.3.21 stable unreleased 2025-04-25

Release workflow changes only. The program is unchanged.

0.3.22 stable unreleased 2025-04-25

Release workflow changes only. The program is unchanged.

0.3.23 stable unreleased 2025-04-25

Release workflow changes only. The program is unchanged.

Known issues

• Its GitHub release has only the Windows archive.

0.3.25 stable unreleased 2025-04-25

Release workflow changes only. The program is unchanged.

Known issues

• Its GitHub release has no Linux archive.

0.3.24 stable unreleased 2025-04-25

Release workflow changes only. The program is unchanged.

0.3.29 stable unreleased 2025-04-25

Updated dependencies, and the readme in every archive.

Added

• Readme.md in every archive.

Changed

• Updated tes3, openmw-cfg and clap.

0.3.28 stable unreleased 2025-04-25

Release workflow changes only, which add development builds. The program is unchanged.

Known issues

• Its GitHub release has no Linux archive.

0.3.27 stable unreleased 2025-04-25

Release workflow changes only. The program is unchanged.

Known issues

• Its GitHub release has no archives.

0.3.2 stable unreleased 2025-04-25

The Linux build moves to Ubuntu 22.04. The program is unchanged.

Changed

• The Linux build is made on Ubuntu 22.04, and needs a system at least that new.

Known issues

• Its GitHub release has only the Windows archive.

0.3.1 stable unreleased 2025-04-24

Negative lights are black as well as off.

Fixed

• Negative lights are also made black, so vtastek's classic light falloff no longer shows them.

Known issues

• Its GitHub release has no Linux archive.

0.3.0 stable unreleased 2025-03-08

Command-line options for every setting, and nothing installed or enabled unless asked.

Breaking changes

• The plugin is written to the working folder, or --output, instead of data-local, and one left in data-local is deleted.
• The plugin is enabled in openmw.cfg only with --auto-enable. auto_install is no longer read.
• Interior sunlight is taken out only with --classic.
• Only the lightconfig.toml beside openmw.cfg is read, not one beside the program or in data-local.

Added

• A command-line option for every lightconfig.toml setting, which takes the file's place for that run.
• -c, --openmw-cfg: the folder of the openmw.cfg to read.
• -o, --output: the folder to write the plugin to.
• -e, --auto-enable: enable the plugin in openmw.cfg.
• -7, --classic: for vtastek's shaders on OpenMW 0.47, a standard radius of 2.0 and no interior sunlight.
• -l, --write-log, -n, --no-notifications, -d, --debug and -i, --info.

Changed

• The default standard radius is 1.2, down from 2.0, and the standard hue 0.62, up from 0.6.

Fixed

• standard_saturation in lightconfig.toml is read.

Known issues

• lightconfig.toml is looked for in the wrong place, so every run uses the defaults and writes them over it, until 0.3.3.

0.2.0 stable unreleased 2025-01-26

Negative lights are turned off, as they were always meant to be.

Fixed

• Negative lights are written to the plugin, with the flag removed and a radius of 0. Before, they were left out.
• Enabling the plugin starts a new line when openmw.cfg does not end with one.

0.1.9 stable unreleased 2025-01-20

Signed builds.

Added

• Every archive holds a Sigstore bundle, S3LF-<runner>.bundle, to check the program with cosign verify-blob.

0.1.7 stable unreleased 2025-01-16

Refuses to write an empty plugin, and builds for Android.

Changed

• Updated openmw-cfg and tes3.

Fixed

• A plugin with no masters stops the run with a message instead of being written.
• Builds for Android, where messages are printed instead of shown in a dialog.

0.1.6 stable unreleased 2025-01-04

Dialogs for success and failure.

Added

• A dialog reports a finished run, or an openmw.cfg or plugin list that cannot be read. With S3L_NO_NOTIFICATIONS set, the message is printed instead.

Fixed

• The message for a plugin that fails to load reads properly.

0.1.5 stable unreleased 2025-01-02

Reads plugins whose extension is in capitals, and runs on older Linux systems.

Changed

• The Linux build is made on Ubuntu 20.04, so it runs on older systems.

Fixed

• Plugins with a capitalized extension, like .ESP, are read instead of skipped.
• A value of the wrong type in lightconfig.toml is reported as one.

0.1.4 stable unreleased 2025-01-01

Debug output, and clearer failures when openmw.cfg cannot be used.

Added

• S3L_DEBUG prints the config, the plugins and the data folders that were found, and the plugin's header.

Fixed

• A crash on a missing folder, through an updated openmw-cfg.
• An openmw.cfg that lists no plugins stops the run with a message.
• An openmw.cfg that cannot be read is reported with the reason.

0.1.2 stable unreleased 2024-12-14

Works with an OpenMW config file of any name.

Fixed

• lightconfig.toml is written beside, and the plugin enabled in, the config file that was read, whatever its name.

0.1.3 stable unreleased 2024-12-14

The log goes beside the config file too.

Fixed

• save_log writes lightconfig.log beside the config file that was read, whatever its name.

0.1.1 stable unreleased 2024-12-04

The first release: a program of its own that writes S3LightFixes.omwaddon for the load order in openmw.cfg, where Lightfixes.pl and Waza-lightfixes needed tes3cmd.

Added

• Every light in the load order recolored and resized, with hue, saturation, value and radius multipliers for standard (orange) lights and for colored ones.
• Sunlight taken out of interior cells.
• disable_flickering removes the flicker flags from every light.
• The plugin is saved in OpenMW's data-local folder, and auto_install enables it in openmw.cfg.
• lightconfig.toml beside openmw.cfg, written with the defaults when there is none. save_log writes the plugin as text to lightconfig.log.
• OPENMW_CONFIG and OPENMW_CONFIG_DIR point it at a portable install's openmw.cfg.

Known issues

• Negative lights are meant to be turned off, but are left out of the plugin instead, until 0.2.0.
• standard_saturation in lightconfig.toml is not read, so its default is always used, until 0.3.0.