CHANGELOG.md.
What works
“Works” means it was observed working, not that it is finished.What is partly working
Frame rate
A flat 60 is the engine’s own frame target, not a display lock. Measured 2026-10-03 on a 240.001 Hz output with input driven the whole run: the engine was told the real rate and still held 59.9 presents a second untilDFIntTaskSchedulerTargetFps was raised past 60. Settings → General →
Graphics → Frame rate limit raises it (fastflags.md); MAILBOX
and FIFO both clear 60 with it set. What that measurement did not cover, and
the older records it replaces, are in
ADR-044.
What is broken
From the 0.23.2 release notes, the newest list:- The signed-in startup freeze is not fixed, but Cordial now restarts a stuck
start by itself (#92). When
the client’s log shows it has stopped part-way through starting, Cordial
stops it, says “Roblox got stuck starting. Restarting it (2 of 3).”, and
starts it again, at most twice per press of Roblox. If all three freeze, it
says so instead of showing a spinner; pressing Roblox again usually works.
CORDIAL_NO_FREEZE_RESTART=1turns the restart off. Not yet seen to recover a real freeze: it has only been run against a recorded freeze log, not against a live one. - Movement keys sometimes stop working after joining a game
(#29). Respawning or re-joining
brings them back. To report it, start Cordial with
CORDIAL_TRACE_KEYS=1, press W in the stuck state, and paste the[cordial] keylines from the terminal:flatpak run --env=CORDIAL_TRACE_KEYS=1 io.github.luohoa97.Cordial, orCORDIAL_TRACE_KEYS=1 cordialfor a native install.result=okonpath=nativemeans the key reached the engine;result=gatedmeans Cordial dropped it because the window had no keyboard focus. Every key is printed, including ones typed into a password box, so trim the paste to the W lines. - A touchscreen can crash the client
(#36). Fixed on
mainafter 0.26.0, so it ships in the next release; checked with a touch injected into a nested compositor, not yet on a real touchscreen. - A Roblox version released only for ARM64 is not shown on x86_64 machines.
- Some games show the mobile (touch) interface.
Not tested
- NVIDIA GPUs. Two users’ reports so far: driver 610.57 in the Flatpak (2026-10-01, fullscreen in and out held), and an RTX 4070 on 615.71.09 (2026-10-03, natively), which booted and rendered and got through one resize and fullscreen session, with one SIGSEGV at startup in eight launches. MAILBOX presented 59.9 a second on a 240 Hz output at the engine’s default target. Unverified on hybrid laptops and on 535/550; see NVIDIA graphics.
- Real ARM64 hardware. See Architectures.
- The AppImage’s web view on a machine without WebKitGTK, and on anything but Fedora. See Installing Cordial.
Installing Cordial
get it running
Checking this machine
diagnose a machine that will not start