Skip to content

Document recovery from blocked desktop updates #55

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
JamieW105 merged 1 commit into from
Oct 21, 2026
Merged

Document recovery from blocked desktop updates #55

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
20 changes: 19 additions & 1 deletion content/user/installation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -34,6 +34,12 @@ are supported. Reopened applications run as the original user.

You can cancel closing and keep working. Close standalone games/workers separately;
installation waits for all Rustic processes from that installation. An automatic
update request does not close windows you open afterward. If another process still
blocks a requested update after two minutes, the updater cancels the close request
and restores closed windows with the currently installed version and original
projects. **Update** stays available, and installation can run after a later normal
exit. A process whose installation path cannot be read also blocks Setup safely.
An automatic
update after a normal app exit does not reopen it, and failed installations do not
replay sessions. The updater never force-closes editors or reboots Windows.
Setup retains the installation
Expand All @@ -50,9 +56,21 @@ to compare releases.
For download, checksum, API rate-limit or Setup failures, inspect
`%LOCALAPPDATA%\Rustic Game Engine\updates\<installation-key>\update.log` and
`update-setup.log` in the same folder. Failed checks retry hourly while Rustic is
open or on a later launch. If an update is waiting, close all Rustic processes;
open or on a later launch. While waiting, `update.log` lists remaining Rustic
process names and IDs once a minute. Retries reuse downloaded installers after
rechecking their size and checksum. If an update is waiting, close all Rustic processes;
you can also install the release manually from its GitHub page.

If an older build immediately closes newly opened editors while an update waits,
close Project Manager, run this PowerShell command, then reopen Rustic:

```powershell
Get-ChildItem "$env:LOCALAPPDATA\Rustic Game Engine\updates" -Filter install-request.txt -Recurse -File | Remove-Item
```

This only clears the queued close request. It does not remove projects, update
settings or downloaded installers. Install a corrected release to prevent repeats.

## System requirements and platform status

| Platform | What the available evidence supports |
Expand Down
Loading