Skip to content

Releases

Lucent 1.0.4

Choose a tag to compare

@github-actions github-actions released this 01 Nov 01:54
  • Settings has a Troubleshooting group with a Record frame generation switch, off by default.
    • It sets [FramePacing] FgRecorder in OptiScaler.ini in place (true when on, false when switched off again) and nothing else, through the journal. It takes effect the next time XIV starts.
    • OptiScaler-FFXIV then writes what frame generation does to fg-recordings in the game folder, for a bug report: only while frame generation runs, up to 144 MB a play session, the last five sessions kept.
    • Unlike the Game patches switch it is not remembered: a Reset or a tier switch writes the tested setup again, with the recorder off. A content update keeps it, as it keeps any value in the player's own ini.
    • It needs content 2026.10.31 or newer, and it is disabled with the reason while XIV runs or when the ini has no FgRecorder line.
    • The mark key (FgRecorderMarkKey) has no control in Lucent; the OptiScaler overlay's Keybinds set it.
  • A Recordings row under the switch, shown while the folder exists.
    • It has the session count, the size, Open folder and Clear….
    • Clear asks first, then deletes only the recorder's own fg-rec-* files, and the folder once it is empty; any other file in it stays.
    • It needs XIV closed. Uninstall removes the recordings, as it has since content 2026.10.31.
  • Diagnostics and the bug report.
    • Copy diagnostics has a FG recorder: line: on or off, then the session count and the newest session with its file count and size.
    • The GitHub issue template asks for the newest recording, zipped, when the problem is with frame generation.
  • Settings is tidied.
    • The groups now run Launch XIV with, XIVLauncher, Updates, Game folder, Game patches, Troubleshooting, Storage, Danger zone.
    • "After a game patch" is now Game patches, and its switch carries the same Experimental tag as the Graphics step instead of "(experimental)" in its name.
    • Why changes wait (XIV running, a failed check for it, a missing game folder) is said once, at the top of the page, instead of under each group.
    • Reset setup's button is no longer styled as the page's main action.
    • The page's subtitle names everything it holds.
  • Nothing else changes. The setup Lucent writes and every other screen are as they were in 1.0.3. No new content version is needed.

content-2026.10.31

Choose a tag to compare

OptiScaler-FFXIV is updated from v0.3.0 to v0.5.1, which includes v0.4.0 and v0.5.0. The fork’s new options ship off unless a line below says otherwise. Lucent adds the new keys to your OptiScaler.ini and keeps your values.
The Neural Rendering card has a new choice, Frame rate governor (Experimental). With Hold frame rate, Neural Rendering lowers its model resolution in steps, down to half, when the frame rate falls below your frame rate limit or your display’s refresh rate, whichever is lower, and raises it again once the frame rate recovers. It does nothing while Spatial compression or the fork’s automatic multiplier ([DLSSG] AutoMFG) is on. It is Off by default, and the fork has not tried it in game. An existing setup keeps it off; a Reset offers the choice.
Scene HDR now uses the fork’s continuous composition of world and interface light ([HDR] LegacyComposition = false), which replaces the rule that could draw a ring around the interface. Nobody has tried it on an HDR display yet. To go back to the old composition, set LegacyComposition = true in OptiScaler.ini. Off and HDR are not affected.
UI-free stays experimental. Its micro-stutter in motion was removed by the fork’s new default probe interval ([HudLess] ProbeInterval = 8, from v0.5.1) in the one play session it was tried, with DLSS-G preset C; ProbeInterval = 1 brings the old behaviour back. Recomposition with DLSS-G preset Auto, Lucent’s defaults, stays the recommended setup. If you picked UI-free, it stays; you can change the UI mode in OptiScaler’s menu (FFXIV tab, HUD-less) or with a Reset. Switching to or from Recomposition takes effect at once: frame generation restarts for a moment.
The fork removed the HUD replacement that the FFXIV Companion Dalamud plugin drove, and its [Companion] keys are now ignored. If you installed that plugin yourself, uninstall it: the fork no longer has the functions it calls. Lucent never installed it. The hidden AutomaticReShadeMotionScale key is retired too: the motion scaling it could turn off is now always on, and its line stays in your file, ignored.
The fork’s new diagnostics (a frame generation event recorder, a status file and several capture tools) are off. If you turn one on, Uninstall removes what it wrote in the game folder, recordings included, unless that folder was already there when Lucent installed or updated.
Fixes in the fork: a possible freeze at start-up while Streamline plugins load (never seen in a game), and a GPU reset when the UI mode was switched away from UI-free while the game ran.
Since 2026.10.28, OptiScaler-FFXIV has Automatic ReShade scene depth, which Lucent turns on by default. When the game renders below your screen resolution, it lines up the depth, normals and motion vectors that ReShade effects read with the upscaled picture, so ambient occlusion such as MXAO stops drawing shapes into walls. It needs ReShade, which Lucent installs, and stands down by itself if a preset scales or offsets depth by hand. It was tried on one RTX 4090 in SDR with one preset, so treat it as experimental: you can turn it off in the OptiScaler menu (FFXIV tab, ReShade depth compatibility). It is on for a new install or Reset setup, and for an update unless you had already set it yourself.
Since v0.3.0, OptiScaler-FFXIV finds the game’s code addresses by pattern search instead of relying on a table for one game build. After an XIV patch, the features that identify the game by program name or shader fingerprint (scene HDR, lighting, HUD-less, markers, mipmap bias) keep running. The features that read or hook the game’s own code stay off unless FfxivUnknownBuildHooks=true is set in OptiScaler.ini and the search found every address they need; the fork has not yet tried that on a real game patch. OptiScaler’s own update check, which asked the wrong project for releases, is now off. The new keys ship off, and Lucent adds them to your OptiScaler.ini.
Removes the Alive NEXT Stable 4K preset and the two shaders only it used (ffxiv_crashpad_4K and ffxiv_common_4K). Alive NEXT Stable stays. If the 4K preset was your selected preset, ReShade is switched to Alive NEXT Stable. If you edited the 4K preset, the update saves your copy as Alive NEXT Stable 4K (my edits).ini before it removes the original.
ReShade now loads every effect, including the ones your preset turns off, so the game can take a little longer to load, and it compiles shaders with debug information. Your keybinds and the rest of your ReShade settings stay as they are. It needs Lucent 1.0.2.
The Graphics step has three new choices inside the Neural Rendering card, in a collapsed Advanced section: the model hint each pass receives (Pass 1, Pass 2 and Pass 3 preset hint). Their effect on the picture is unverified. The defaults are what Lucent shipped before, so nothing changes unless you pick one, and they apply to a new install or Reset setup, not to an update.
The Graphics step has a new choice in the Neural Rendering card, Character preview Neural Rendering, which runs the Neural Rendering model on the character, equipment and glamour previews. It is Off by default because the model takes a lot of video memory for each open preview window; the previous setup had it on. It applies to a new install or Reset setup, so an existing setup keeps what it has.

Components and source tags:

content-2026.10.30

Choose a tag to compare

OptiScaler-FFXIV is updated to v0.3.0. Since 2026.10.28 it has Automatic ReShade scene depth, which Lucent turns on by default. When the game renders below your screen resolution, it lines up the depth, normals and motion vectors that ReShade effects read with the upscaled picture, so ambient occlusion such as MXAO stops drawing shapes into walls. It needs ReShade, which Lucent installs, and stands down by itself if a preset scales or offsets depth by hand. It was tried on one RTX 4090 in SDR with one preset, so treat it as experimental: you can turn it off in the OptiScaler menu (FFXIV tab, ReShade depth compatibility). It is on for a new install or Reset setup, and for an update unless you had already set it yourself.
OptiScaler-FFXIV v0.3.0 finds the game’s code addresses by pattern search instead of relying on a table for one game build. After an XIV patch, the features that identify the game by program name or shader fingerprint (scene HDR, lighting, HUD-less, markers, mipmap bias) keep running. The features that read or hook the game’s own code stay off unless FfxivUnknownBuildHooks=true is set in OptiScaler.ini and the search found every address they need; the fork has not yet tried that on a real game patch. OptiScaler’s own update check, which asked the wrong project for releases, is now off. The new keys ship off, and Lucent adds them to your OptiScaler.ini.
Removes the Alive NEXT Stable 4K preset and the two shaders only it used (ffxiv_crashpad_4K and ffxiv_common_4K). Alive NEXT Stable stays. If the 4K preset was your selected preset, ReShade is switched to Alive NEXT Stable. If you edited the 4K preset, the update saves your copy as Alive NEXT Stable 4K (my edits).ini before it removes the original.
ReShade now loads every effect, including the ones your preset turns off, so the game can take a little longer to load, and it compiles shaders with debug information. Your keybinds and the rest of your ReShade settings stay as they are. It needs Lucent 1.0.2.
The Graphics step has three new choices inside the Neural Rendering card, in a collapsed Advanced section: the model hint each pass receives (Pass 1, Pass 2 and Pass 3 preset hint). Their effect on the picture is unverified. The defaults are what Lucent shipped before, so nothing changes unless you pick one, and they apply to a new install or Reset setup, not to an update.
The Graphics step has a new choice in the Neural Rendering card, Character preview Neural Rendering, which runs the Neural Rendering model on the character, equipment and glamour previews. It is Off by default because the model takes a lot of video memory for each open preview window; the previous setup had it on. It applies to a new install or Reset setup, so an existing setup keeps what it has.

Components and source tags:

content-2026.10.29

Choose a tag to compare

OptiScaler-FFXIV is updated to v0.2.0. It adds Automatic ReShade scene depth, which Lucent turns on by default. When the game renders below your screen resolution, it lines up the depth, normals and motion vectors that ReShade effects read with the upscaled picture, so ambient occlusion such as MXAO stops drawing shapes into walls. It needs ReShade, which Lucent installs, and stands down by itself if a preset scales or offsets depth by hand. It was tried on one RTX 4090 in SDR with one preset, so treat it as experimental: you can turn it off in the OptiScaler menu (FFXIV tab, ReShade depth compatibility). It is on for a new install or Reset setup, and for an update unless you had already set it yourself.
Removes the Alive NEXT Stable 4K preset and the two shaders only it used (ffxiv_crashpad_4K and ffxiv_common_4K). Alive NEXT Stable stays. If the 4K preset was your selected preset, ReShade is switched to Alive NEXT Stable. If you edited the 4K preset, the update saves your copy as Alive NEXT Stable 4K (my edits).ini before it removes the original.
ReShade now loads every effect, including the ones your preset turns off, so the game can take a little longer to load, and it compiles shaders with debug information. Your keybinds and the rest of your ReShade settings stay as they are. It needs Lucent 1.0.2.
The Graphics step has three new choices inside the Neural Rendering card, in a collapsed Advanced section: the model hint each pass receives (Pass 1, Pass 2 and Pass 3 preset hint). Their effect on the picture is unverified. The defaults are what Lucent shipped before, so nothing changes unless you pick one, and they apply to a new install or Reset setup, not to an update.
The Graphics step has a new choice in the Neural Rendering card, Character preview Neural Rendering, which runs the Neural Rendering model on the character, equipment and glamour previews. It is Off by default because the model takes a lot of video memory for each open preview window; the previous setup had it on. It applies to a new install or Reset setup, so an existing setup keeps what it has.

Components and source tags:

content-2026.10.28

Choose a tag to compare

OptiScaler-FFXIV is updated to v0.2.0. It adds Automatic ReShade scene depth, an option that is off until you turn it on in the OptiScaler menu (the FFXIV tab, ReShade depth compatibility). When the game renders below your screen resolution, it lines up the depth, normals and motion vectors that ReShade effects read with the upscaled picture, so ambient occlusion such as MXAO stops drawing shapes into walls. Lucent adds its two new keys to your OptiScaler.ini switched off; nothing changes unless you turn it on.
Removes the Alive NEXT Stable 4K preset and the two shaders only it used (ffxiv_crashpad_4K and ffxiv_common_4K). Alive NEXT Stable stays. If the 4K preset was your selected preset, ReShade is switched to Alive NEXT Stable. If you edited the 4K preset, the update saves your copy as Alive NEXT Stable 4K (my edits).ini before it removes the original.
ReShade now loads every effect, including the ones your preset turns off, so the game can take a little longer to load, and it compiles shaders with debug information. Your keybinds and the rest of your ReShade settings stay as they are. It needs Lucent 1.0.2.
The Graphics step has three new choices inside the Neural Rendering card, in a collapsed Advanced section: the model hint each pass receives (Pass 1, Pass 2 and Pass 3 preset hint). Their effect on the picture is unverified. The defaults are what Lucent shipped before, so nothing changes unless you pick one, and they apply to a new install or Reset setup, not to an update.
The Graphics step has a new choice in the Neural Rendering card, Character preview Neural Rendering, which runs the Neural Rendering model on the character, equipment and glamour previews. It is Off by default because the model takes a lot of video memory for each open preview window; the previous setup had it on. It applies to a new install or Reset setup, so an existing setup keeps what it has.

Components and source tags:

Lucent 1.0.3

Choose a tag to compare

@github-actions github-actions released this 26 Oct 18:51
  • Settings has a Storage card that clears Lucent's cache and its backup copies. The Cache row shows what Lucent has downloaded and kept, and Clear… removes it; Lucent downloads what it needs again the next time you install, update, change version or repair. The Backups row, which moved here from Game folder, shows the copies of the files Lucent replaced. Clear… lists each folder and what it is: the copy from your install starts ticked, because Lucent keeps its own backups of the same files and Uninstall uses them; the copies a Reset set aside start unticked, since nothing in Lucent puts those back. The originals an Uninstall left out start unticked and warn that they can't be put back, since those are the only copies. Lucent's own backups, which Uninstall restores from, are never touched, and an Uninstall that leaves your replaced files out (the vanilla choice) writes their copies again from those backups if you had cleared them. Neither clears while Lucent is busy or needs recovery, and XIV can be running.
  • Settings has an After a game patch switch, off by default. OptiScaler-FFXIV finds the game's code addresses itself, and after a patch the features that read the game's code stay off unless this is on and every address is found. The switch sets that one key in OptiScaler.ini and nothing else, and a Reset keeps it. It takes effect the next time XIV starts, it is disabled while XIV runs, and it needs content 2026.10.30 or newer, which is published. It is experimental: the fork has not tried it on a real game patch.
  • Nothing else changes. Every other screen and the setup Lucent writes are as they were in 1.0.2.

Lucent 1.0.2

Choose a tag to compare

@github-actions github-actions released this 26 Oct 02:23
  • The Graphics step can set the Neural Rendering preset hint for each pass. Pass 1, Pass 2 and Pass 3 preset hints sit inside the Neural Rendering card, in a collapsed Advanced section, and the second and third show only when you have that many passes. They are the same hints OptiScaler's menu offers; their effect on the picture is unverified, so Lucent doesn't promise one. The defaults are what Lucent installs today, so nothing changes unless you pick one, and a hint applies to a new install or Reset setup. They appear once a content version offers them.
  • The Graphics step can turn Neural Rendering on or off for the character preview. The Character preview Neural Rendering choice sits in the Neural Rendering card and is Off by default, because the model takes a lot of video memory for each open preview window. On runs it on the character, equipment and glamour previews. It applies to a new install or Reset setup, so a setup you already have keeps what it has, and it appears once a content version offers it.
  • A content update can set a few named settings in a config file you already have. It changes only the keys it names, so the rest of the file, including your selected ReShade preset and keybinds, stays as it is. Before this, an update could only leave a config file alone, add the keys it lacked, or replace it whole.
  • Nothing happens until a content version uses these. No content version needs this release yet. The rest of the setup and every other screen are as they were in 1.0.1.

Lucent 1.0.1

Choose a tag to compare

@github-actions github-actions released this 24 Oct 16:15
  • Settings shows where your backups are. Settings → Game folder has a Backups row with the folder's path and an Open folder button, whenever Lucent holds copies of files it replaced. You no longer need the website to find it.
  • Nothing else changed. The setup, the content and every other screen are as they were in 1.0.0.

content-2026.10.27

Choose a tag to compare

The first Stable content version. It is Beta content 2026.10.26 promoted: OptiScaler-FFXIV 2026.10.23, the 310.9.16 DLSS and Neural Rendering runtimes, Streamline 2.14.16, ReShade with its shaders and presets, the Ember menu looks and the choices on the Graphics step. It needs Lucent 1.0.0.
RTX 20/30/40 is a Stable tier, tested by the maintainer on an RTX 4090 (RTX 20 and RTX 30 are untested). RTX 50 is community-verified, because the maintainer cannot test it. Radeon and other cards have no content yet.
Preset E and F in the DLSS model choice and UI-free in the UI mode are tagged Experimental. The defaults are Preset M, Recomposition and Auto.
Beta content comes first: turn on Beta in Settings to get versions before they are promoted.

Components and source tags:

Lucent 1.0.0

Choose a tag to compare

@github-actions github-actions released this 23 Oct 22:39
  • Lucent 1.0.0 is the first stable release. The app is 0.3.0-beta.10 with a new version number, so nothing in it has moved. If you were on a beta, you keep your setup and your channel setting.
  • Stable and Beta stay two channels. Settings → Beta channel decides which content versions Lucent offers you, and the Beta ones are the newest.