update installer source

Updated the section title for clarity on downloading and playing the game.

.gitignore

@@ -4,3 +4,5 @@
 !RecRoom_Data/il2cpp_data/Metadata/global-metadata.zip
 !RecRoomVR.bat
 !RecRoomScreen.bat
+!RecFlareSetup.iss
+!icon.ico

BepInEx/config/net.rec.plugin.cfg

@@ -1,79 +0,0 @@
-## Settings file was created by plugin RecNet Plugin v1.0.0
-## Plugin GUID: net.rec.plugin
-
-[Advanced]
-
-## Allows other fields below in the advanced section to be modified.
-# Setting type: Boolean
-# Default value: false
-Enabled Advanced Settings = false
-
-## Custom Photon NameServer
-# Setting type: String
-# Default value: 
-Photon NameServer = 
-
-## Custom Photon NameServer Port (if 0, it will be default)
-# Setting type: Int32
-# Default value: 0
-Photon NameServer Port = 0
-
-## Show debug logs (HTTP tracing, etc. WARNING: will include sensitive information such as passwords and auth tokens in the logs, be careful when sharing them!)
-# Setting type: Boolean
-# Default value: false
-Debug = false
-
-## Force CheckForDUIDMismatch to return TRUE (fakes the comparison only). Reproduces the hang path but does not corrupt any stored value. Leave false for normal play.
-# Setting type: Boolean
-# Default value: false
-Simulate DUID Mismatch = false
-
-## Force CheckForDUIDMismatch to return FALSE (the workaround fix, ON by default): the client never migrates and never takes the Create Account hang path. No-op on healthy machines (the real check returns false anyway); on mismatched machines it skips the hang. Set false only to observe the real mismatch behavior for debugging.
-# Setting type: Boolean
-# Default value: true
-Suppress DUID Mismatch = true
-
-## ONE-SHOT TEST: on next launch, write a truncated device id into the DUID pref via the game's own WriteDUIDs, producing a genuinely corrupt STORED value (real current id) — exactly the friend's condition. After it logs '[CORRUPT] wrote', set this back to false and relaunch to drive the real mismatch path. Use 'Restore Stored DUID' to undo.
-# Setting type: Boolean
-# Default value: false
-Corrupt Stored DUID = false
-
-## ONE-SHOT UNDO: on next launch, call WriteDUIDs with the real device id, overwriting any corrupt stored value with a good one. Set back to false after it logs '[CORRUPT] restored'.
-# Setting type: Boolean
-# Default value: false
-Restore Stored DUID = false
-
-## Replace the body of the PlayerReporting/v1/deviceId response with this text, to test what shape the client will accept. Empty = leave the server's response alone.
-# Setting type: String
-# Default value: 
-DeviceId Response Override = 
-
-## HTTP status to force on the PlayerReporting/v1/deviceId response. Only applies when the override body is set.
-# Setting type: Int32
-# Default value: 200
-DeviceId Response Status = 200
-
-[Photon]
-
-## Photon Realtime App ID
-# Setting type: String
-# Default value: 
-App Id Realtime = 8f322bdb-2b1f-4c27-a232-01436f43d14e
-
-## Photon Voice App ID
-# Setting type: String
-# Default value: 
-App Id Voice = 6b4682e1-a1a9-4e04-b44a-6db0049a4df3
-
-## Photon Chat App ID
-# Setting type: String
-# Default value: 
-App Id Chat = 55fae86e-0459-4f97-bf6c-39c9341da6ef
-
-[Server]
-
-## Host for the RecNet NameServer.
-# Setting type: String
-# Default value: https://ns.rec.net
-RecNet NameServer Host = https://ns.recflare.net
-

README.md

@@ -1,16 +1,25 @@
-# RecFlare client
+# RecFlare game client
 
-Autoamtic setup of the game client to connect to the testing [RecFlare](https://github.com/djdevin/recflare) instance.
+Automatic download and setup of a game client to play [RecFlare](https://github.com/djdevin/recflare).
 
-## Download
+The [Rec Room 2025 patch](https://github.com/recflare/patch-2025) is installed as part of the setup and configured to point at the RecFlare servers.
 
-Check out this repository or extract the ZIP: https://github.com/djdevin/recflare-client/archive/refs/heads/master.zip
+## Download/update and play
 
-## Installing
+### Easy way: installer
 
-1. Run `download.bat`. The script will download the game client from Steam and apply patches and configuration.
-2. Run `RecRoomScreen.bat` or `RecRoomVR.bat`
+Download and run `RecFlareSetup.exe` from the [releases page](https://github.com/djdevin/recflare-client/releases). The wizard asks whether you have Rec Room in your Steam library: if you do, it downloads the game client from Steam (DepotDownloader, signing in with your username or a Steam mobile app QR code); if not, it downloads the game files from a mirror instead. It then installs the 2025 patch, points `2025patch.ini` at RecFlare, and creates Start menu/desktop shortcuts for desktop and VR mode.
+
+If Windows SmartScreen shows "Windows protected your PC", click **More info** and then **Run anyway** (the installer is unsigned).
+
+To build the installer yourself, compile `RecFlareSetup.iss` with [Inno Setup](https://jrsoftware.org/isinfo.php) 6.1 or later: `iscc RecFlareSetup.iss`.
+
+### Manual way: scripts
+
+1. Check out this repository or extract the ZIP: https://github.com/djdevin/recflare-client/archive/refs/heads/2025.zip
+2. Run `download.bat`. The script will ask whether you have Rec Room in your Steam library: if you do, it downloads the game client from Steam (DepotDownloader); if not, it syncs the game files from a mirror instead. Either way it then installs the 2025 patch and writes `2025patch.ini` pointing at RecFlare.
+3. Run `RecRoomScreen.bat` or `RecRoomVR.bat`
 
 ## Custom server
 
-Fork this project and change `/BepInEx/config/net.rec.plugin.cfg` to your own instance.
+Fork this project and change the `ApiHost` and `PhotonHost` values in `download.bat` (the `powershell` line) and `RecFlareSetup.iss` (the `ApiHost`/`PhotonHost` constants) to your own instance. You can also edit `2025patch.ini` in the game folder directly after installing.

RecFlareSetup.iss

@@ -0,0 +1,255 @@
+; RecFlare installer - GUI equivalent of download.bat.
+; Build with Inno Setup 6.1+ (https://jrsoftware.org/isinfo.php):
+;   iscc RecFlareSetup.iss
+; Output: Output\RecFlareSetup.exe
+
+[Setup]
+AppId={{8E1D2A7B-6C43-4F0A-9B7E-3D5F80C21A96}
+AppName=RecFlare
+AppVersion=2025.1
+AppPublisher=RecFlare project
+AppSupportURL=https://github.com/djdevin/recflare
+DefaultDirName={sd}\Games\RecFlare
+PrivilegesRequired=lowest
+; tar.exe ships with Windows 10 1803+; the downloads and extraction depend on it
+MinVersion=10.0.17134
+WizardStyle=modern
+SetupIconFile=icon.ico
+UninstallDisplayIcon={app}\icon.ico
+DisableProgramGroupPage=yes
+OutputBaseFilename=RecFlareSetup
+SolidCompression=yes
+UninstallDisplayName=RecFlare
+
+[Tasks]
+Name: "desktopicon"; Description: "{cm:CreateDesktopIcon}"; GroupDescription: "{cm:AdditionalIcons}"
+
+[Files]
+Source: "icon.ico"; DestDir: "{app}"; Flags: ignoreversion
+Source: "RecRoomScreen.bat"; DestDir: "{app}"; Flags: ignoreversion
+Source: "RecRoomVR.bat"; DestDir: "{app}"; Flags: ignoreversion
+
+[Icons]
+Name: "{autoprograms}\RecFlare (Desktop mode)"; Filename: "{app}\recroom.exe"; Parameters: "+forcemode:screen"; WorkingDir: "{app}"; IconFilename: "{app}\icon.ico"
+Name: "{autoprograms}\RecFlare (VR)"; Filename: "{app}\recroom.exe"; Parameters: "+forcemode:vr"; WorkingDir: "{app}"; IconFilename: "{app}\icon.ico"
+Name: "{autodesktop}\RecFlare (Desktop mode)"; Filename: "{app}\recroom.exe"; Parameters: "+forcemode:screen"; WorkingDir: "{app}"; IconFilename: "{app}\icon.ico"; Tasks: desktopicon
+Name: "{autodesktop}\RecFlare (VR)"; Filename: "{app}\recroom.exe"; Parameters: "+forcemode:vr"; WorkingDir: "{app}"; IconFilename: "{app}\icon.ico"; Tasks: desktopicon
+
+[UninstallDelete]
+; The game files are downloaded, not installed, so Inno does not track them;
+; remove the whole folder on uninstall.
+Type: filesandordirs; Name: "{app}"
+
+[Code]
+const
+  PatchVersion = 'v0.0.5';
+  DepotManifest = '1151455856673601091';
+  ClientMD5 = '6820e89bff41906ded7f5c066027f1d6';
+  ClientURL = 'https://s3.g.megas4.com/2koayuyiwxv4groxzwdbbxg43cwustavrkvfb/recflare/2025/client.zip';
+  DepotDownloaderURL = 'https://github.com/SteamRE/DepotDownloader/releases/download/DepotDownloader_3.4.0/DepotDownloader-windows-x64.zip';
+  PatchURL = 'https://github.com/recflare/patch-2025/releases/download/' + PatchVersion + '/2025Patch-' + PatchVersion + '-x64.zip';
+  { Points the client at the RecFlare server; to use your own instance, fork and
+    change these, then rebuild the installer (see README "Custom server"). }
+  ApiHost = 'ns.recflare.net';
+  PhotonHost = 'photon.recflare.net';
+
+var
+  SourcePage: TInputOptionWizardPage;
+  SteamPage: TInputQueryWizardPage;
+  DownloadPage: TDownloadWizardPage;
+  ReuseLocalClientZip: Boolean;
+
+function UsingSteam: Boolean;
+begin
+  Result := SourcePage.Values[0];
+end;
+
+function OnDownloadProgress(const Url, FileName: String; const Progress, ProgressMax: Int64): Boolean;
+begin
+  if Progress = ProgressMax then
+    Log(Format('Downloaded %s', [FileName]));
+  Result := True;
+end;
+
+procedure InitializeWizard;
+begin
+  SourcePage := CreateInputOptionPage(wpSelectDir,
+    'Game client source', 'Where should the game files come from?',
+    'Setup needs a copy of the Rec Room game client. Pick the option that applies to you, then click Next.',
+    True, False);
+  SourcePage.Add('I have Rec Room in my Steam library - download it from Steam');
+  SourcePage.Add('I do not have it on Steam - download from the community mirror');
+  SourcePage.SelectedValueIndex := 0;
+
+  SteamPage := CreateInputQueryPage(SourcePage.ID,
+    'Steam sign-in', 'How should the Steam download sign in?',
+    'Enter your Steam username, or leave it blank to sign in by scanning a QR code with the Steam mobile app. ' +
+    'A separate Steam window will open during installation to finish signing in; ' +
+    'this installer never sees your password.');
+  SteamPage.Add('Steam username (optional):', False);
+
+  DownloadPage := CreateDownloadPage(SetupMessage(msgWizardPreparing),
+    SetupMessage(msgPreparingDesc), @OnDownloadProgress);
+end;
+
+function ShouldSkipPage(PageID: Integer): Boolean;
+begin
+  Result := (PageID = SteamPage.ID) and not UsingSteam;
+end;
+
+function NextButtonClick(CurPageID: Integer): Boolean;
+begin
+  Result := True;
+  if CurPageID = wpReady then begin
+    DownloadPage.Clear;
+    ReuseLocalClientZip := False;
+    if UsingSteam then
+      DownloadPage.Add(DepotDownloaderURL, 'DepotDownloader.zip', '')
+    else begin
+      { A client.zip left behind by download.bat (or a previous run) is reused
+        when it matches the expected hash, like the .bat does. }
+      if FileExists(ExpandConstant('{app}\client.zip')) and
+         SameText(GetMD5OfFile(ExpandConstant('{app}\client.zip')), ClientMD5) then
+        ReuseLocalClientZip := True
+      else
+        DownloadPage.Add(ClientURL, 'client.zip', '');
+    end;
+    DownloadPage.Add(PatchURL, '2025Patch.zip', '');
+    DownloadPage.Show;
+    try
+      try
+        DownloadPage.Download;
+        if not UsingSteam and not ReuseLocalClientZip and
+           not SameText(GetMD5OfFile(ExpandConstant('{tmp}\client.zip')), ClientMD5) then begin
+          SuppressibleMsgBox('The downloaded game client did not match the expected checksum. ' +
+            'Please run Setup again.', mbCriticalError, MB_OK, IDOK);
+          Result := False;
+        end;
+      except
+        if DownloadPage.AbortedByUser then
+          Log('Download aborted by user.')
+        else
+          SuppressibleMsgBox(AddPeriod(GetExceptionMessage), mbCriticalError, MB_OK, IDOK);
+        Result := False;
+      end;
+    finally
+      DownloadPage.Hide;
+    end;
+  end;
+end;
+
+procedure SetPreparingStatus(const Msg: String);
+begin
+  WizardForm.PreparingLabel.Visible := True;
+  WizardForm.PreparingLabel.Caption := Msg;
+  WizardForm.Refresh;
+end;
+
+function ExtractZip(const ZipPath, DestDir: String): Boolean;
+var
+  ResultCode: Integer;
+begin
+  Result := ForceDirectories(DestDir) and
+    Exec(ExpandConstant('{sys}\tar.exe'), Format('-xf "%s" -C "%s"', [ZipPath, DestDir]),
+      '', SW_HIDE, ewWaitUntilTerminated, ResultCode) and (ResultCode = 0);
+end;
+
+function RunDepotDownloader(var ErrorMsg: String): Boolean;
+var
+  Args: String;
+  ResultCode: Integer;
+begin
+  Result := False;
+  if not ExtractZip(ExpandConstant('{tmp}\DepotDownloader.zip'), ExpandConstant('{tmp}\DepotDownloader')) then begin
+    ErrorMsg := 'Could not extract DepotDownloader.';
+    Exit;
+  end;
+  Args := '-app 471710 -depot 471711 -manifest ' + DepotManifest + ' -remember-password' +
+    ' -dir "' + ExpandConstant('{app}') + '"';
+  if Trim(SteamPage.Values[0]) <> '' then
+    Args := Args + ' -username "' + Trim(SteamPage.Values[0]) + '"'
+  else
+    Args := Args + ' -qr';
+  SetPreparingStatus('Downloading the game from Steam - follow the sign-in steps in the window that just opened...');
+  if not Exec(ExpandConstant('{tmp}\DepotDownloader\DepotDownloader.exe'), Args,
+      ExpandConstant('{tmp}\DepotDownloader'), SW_SHOWNORMAL, ewWaitUntilTerminated, ResultCode)
+     or (ResultCode <> 0) then begin
+    ErrorMsg := 'The Steam download did not complete (exit code ' + IntToStr(ResultCode) + '). ' +
+      'Check that your sign-in succeeded and that Rec Room is in your Steam library, then run Setup again.';
+    Exit;
+  end;
+  Result := True;
+end;
+
+{ Sets Key=Value in the ini shipped by the patch, replacing an existing line
+  for that key or appending one, so other settings in the file are kept. }
+procedure SetIniKey(var Lines: TArrayOfString; const Key, Value: String);
+var
+  I: Integer;
+  L: String;
+begin
+  for I := 0 to GetArrayLength(Lines) - 1 do begin
+    L := Trim(Lines[I]);
+    if (Pos('=', L) > 0) and SameText(Trim(Copy(L, 1, Pos('=', L) - 1)), Key) then begin
+      Lines[I] := Key + '=' + Value;
+      Exit;
+    end;
+  end;
+  SetArrayLength(Lines, GetArrayLength(Lines) + 1);
+  Lines[GetArrayLength(Lines) - 1] := Key + '=' + Value;
+end;
+
+function WritePatchIni(const IniPath: String): Boolean;
+var
+  Lines: TArrayOfString;
+begin
+  if not FileExists(IniPath) or not LoadStringsFromFile(IniPath, Lines) then begin
+    SetArrayLength(Lines, 1);
+    Lines[0] := '[config]';
+  end;
+  SetIniKey(Lines, 'ApiHost', ApiHost);
+  SetIniKey(Lines, 'PhotonHost', PhotonHost);
+  Result := SaveStringsToFile(IniPath, Lines, False);
+end;
+
+function PrepareToInstall(var NeedsRestart: Boolean): String;
+var
+  ClientZip: String;
+begin
+  Result := '';
+  if not ForceDirectories(ExpandConstant('{app}')) then begin
+    Result := 'Could not create the installation folder.';
+    Exit;
+  end;
+
+  if UsingSteam then begin
+    if not RunDepotDownloader(Result) then
+      Exit;
+  end else begin
+    if ReuseLocalClientZip then
+      ClientZip := ExpandConstant('{app}\client.zip')
+    else
+      ClientZip := ExpandConstant('{tmp}\client.zip');
+    SetPreparingStatus('Extracting the game client (this can take a few minutes)...');
+    if not ExtractZip(ClientZip, ExpandConstant('{app}')) then begin
+      Result := 'Could not extract the game client archive.';
+      Exit;
+    end;
+  end;
+
+  if not SaveStringToFile(ExpandConstant('{app}\steam_appid.txt'), '480', False) then begin
+    Result := 'Could not write steam_appid.txt.';
+    Exit;
+  end;
+
+  SetPreparingStatus('Installing the Rec Room 2025 patch...');
+  if not ExtractZip(ExpandConstant('{tmp}\2025Patch.zip'), ExpandConstant('{app}')) then begin
+    Result := 'Could not extract the Rec Room 2025 patch.';
+    Exit;
+  end;
+
+  if not WritePatchIni(ExpandConstant('{app}\2025patch.ini')) then begin
+    Result := 'Could not write 2025patch.ini.';
+    Exit;
+  end;
+end;

download.bat

@@ -1,5 +1,6 @@
 @echo off
 setlocal
+set "PATCH_VERSION=v0.0.5"
 
 rem ANSI colors (Windows 10+): get the ESC character, then define color codes
 for /F "delims=" %%a in ('forfiles /p "%~dp0." /m "%~nx0" /c "cmd /c echo 0x1B"') do set "ESC=%%a"
@@ -8,6 +9,10 @@ set "GREEN=%ESC%[92m"
 set "RED=%ESC%[91m"
 set "RESET=%ESC%[0m"
 
+choice /C YN /M "Do you have Rec Room in your Steam library? "
+if errorlevel 2 goto :bucket
+
+:steam
 set "STEAM_USERNAME="
 set /p STEAM_USERNAME=Enter your Steam username:
 if "%STEAM_USERNAME%"=="" (
@@ -16,28 +21,46 @@ if "%STEAM_USERNAME%"=="" (
 )
 
 echo %CYAN%=== Installing DepotDownloader ===%RESET%
-curl -f -L -o DepotDownloader.zip https://github.com/SteamRE/DepotDownloader/releases/download/DepotDownloader_3.4.0/DepotDownloader-windows-x64.zip || goto :error
+curl -s -f -L -o DepotDownloader.zip https://github.com/SteamRE/DepotDownloader/releases/download/DepotDownloader_3.4.0/DepotDownloader-windows-x64.zip || goto :error
 if not exist "DepotDownloader" mkdir "DepotDownloader"
 tar -xf DepotDownloader.zip -C DepotDownloader || goto :error
 del DepotDownloader.zip
 
-echo %CYAN%=== Downloading Rec Room depot via DepotDownloader (will prompt for Steam password) ===%RESET%
-DepotDownloader\DepotDownloader.exe -remember-password -app 471710 -depot 471711 -manifest 7859140924515540835 -dir . -username "%STEAM_USERNAME%" || goto :error
+echo %CYAN%=== Downloading depot via DepotDownloader (will prompt for Steam password) ===%RESET%
+DepotDownloader\DepotDownloader.exe -remember-password -app 471710 -depot 471711 -manifest 1151455856673601091 -dir . -username "%STEAM_USERNAME%" || goto :error
+goto :patch
 
+:bucket
+set "CLIENT_MD5=6820e89bff41906ded7f5c066027f1d6"
+if not exist client.zip goto :download
+echo %CYAN%=== Checking existing client.zip ===%RESET%
+set "LOCAL_MD5="
+for /f "skip=1 delims=" %%h in ('certutil -hashfile client.zip MD5') do if not defined LOCAL_MD5 set "LOCAL_MD5=%%h"
+if /i "%LOCAL_MD5%"=="%CLIENT_MD5%" (
+    echo %GREEN%client.zip already matches expected hash - skipping download.%RESET%
+    goto :extract
+)
+echo %RED%client.zip does not match expected hash - redownloading.%RESET%
+
+:download
+echo %CYAN%=== Downloading game client from mirror ===%RESET%
+curl -f -L -o client.zip https://s3.g.megas4.com/2koayuyiwxv4groxzwdbbxg43cwustavrkvfb/recflare/2025/client.zip || goto :error
+
+:extract
+echo %CYAN%=== Extracting game client ===%RESET%
+tar -xf client.zip -C . || goto :error
+
+:patch
 echo %CYAN%=== Writing steam_appid.txt ===%RESET%
 >steam_appid.txt echo 480
 
-echo %CYAN%=== Downloading BepInEx and extracting to this directory ===%RESET%
-curl -f -L -o BepInEx.zip https://github.com/BepInEx/BepInEx/releases/download/v6.0.0-pre.2/BepInEx-Unity.IL2CPP-win-x64-6.0.0-pre.2.zip || goto :error
-tar -xf BepInEx.zip -C . || goto :error
-del BepInEx.zip
+echo %CYAN%=== Downloading Rec Room 2025 patch ===%RESET%
+curl -s -f -L -o 2025Patch.zip https://github.com/recflare/patch-2025/releases/download/%PATCH_VERSION%/2025Patch-%PATCH_VERSION%-x64.zip || goto :error
+tar -xf 2025Patch.zip -C . || goto :error
+del 2025Patch.zip
 
-echo %CYAN%=== Downloading RecNetPlugin.dll into BepInEx\plugins ===%RESET%
-if not exist "BepInEx\plugins" mkdir "BepInEx\plugins"
-curl -f -L -o "BepInEx\plugins\RecNetPlugin.dll" https://github.com/djdevin/recnet-plugin/releases/download/0.0.3/RecNetPlugin.dll || goto :error
-
-echo %CYAN%=== Extracting bundled global-metadata into RecRoom_Data\il2cpp_data\Metadata ===%RESET%
-tar -xf "RecRoom_Data\il2cpp_data\Metadata\global-metadata.zip" -C "RecRoom_Data\il2cpp_data\Metadata" || goto :error
+echo %CYAN%=== Pointing 2025patch.ini at RecFlare ===%RESET%
+powershell -NoProfile -Command "$p='2025patch.ini'; $h=@{ApiHost='ns.recflare.net';PhotonHost='photon.recflare.net'}; $t=@(if (Test-Path $p) { Get-Content $p } else { '[config]' }); foreach ($k in $h.Keys) { $r='^\s*'+$k+'\s*='; if ($t -match $r) { $t = $t -replace ($r+'.*'), ($k+'='+$h[$k]) } else { $t += ($k+'='+$h[$k]) } }; Set-Content -Path $p -Value $t -Encoding ASCII" || goto :error
 
 echo %GREEN%=== Done ===%RESET%
 pause