10 Commits

Author SHA1 Message Date
Devin Zuczek d270e9a3b1 update installer source 2026-08-30 13:43:00 -04:00
devin 76a08cc34a Update PATCH_VERSION and download URL in download.bat 2026-08-29 13:33:50 -04:00
Devin Zuczek 3a726ac711 update 2025 mirror 2026-08-29 12:52:26 -04:00
Devin Zuczek 98fb101bef update script 2026-08-22 18:52:22 -04:00
devin 6fead241df Update manifest ID for DepotDownloader command 2026-08-18 13:05:04 -04:00
Devin Zuczek e512b81145 update dll 2026-08-07 12:11:28 -04:00
Devin Zuczek ea33c3332e clobber file 2026-08-02 21:55:59 -04:00
Devin Zuczek 9ae10ce4b7 photon update 2026-08-02 18:37:00 -04:00
Devin Zuczek 647d43e545 icon 2026-07-24 13:10:40 -04:00
Devin Zuczek b7e516adea add launcher 2026-07-24 11:57:51 -04:00
6 changed files with 281 additions and 105 deletions
+2
View File
@@ -4,3 +4,5 @@
!RecRoom_Data/il2cpp_data/Metadata/global-metadata.zip !RecRoom_Data/il2cpp_data/Metadata/global-metadata.zip
!RecRoomVR.bat !RecRoomVR.bat
!RecRoomScreen.bat !RecRoomScreen.bat
!RecFlareSetup.iss
!icon.ico
-91
View File
@@ -1,91 +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
[Signing]
## Force RSA signature verification to succeed (ON by default), so the client stops checking that images are signed with Rec Room's private key. This is what lets a self-hosted server serve its own images without the baked-in modulus matching. Set false only if you actually want signed images, in which case use 'Signing Modulus Override' instead. NOTE: this forces ALL mscorlib RSA verification to pass, not just image signatures.
# Setting type: Boolean
# Default value: true
Disable Signature Verification = true
## Optional alternative to disabling verification: your own RSA public modulus, base64, RAW 2048-bit (256 bytes decoded) — NOT a PEM/DER key. When set, it is substituted for the modulus baked into global-metadata.dat and real verification still runs, so images stay signed with your keypair. Redundant while 'Disable Signature Verification' is true. Empty = leave the stock modulus alone.
# Setting type: String
# Default value:
Signing Modulus Override =
+14 -4
View File
@@ -2,14 +2,24 @@
Automatic download and setup of a game client to play [RecFlare](https://github.com/djdevin/recflare). Automatic download and setup of a game client to play [RecFlare](https://github.com/djdevin/recflare).
[BepInEx](https://github.com/BepInEx/BepInEx) and the [RecNet Plugin](https://github.com/djdevin/recnet-plugin) are installed as part of the setup. 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.
## Download/update and play ## Download/update and play
1. Check out this repository or extract the ZIP: https://github.com/djdevin/recflare-client/archive/refs/heads/master.zip ### Easy way: installer
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 applies patches and configuration.
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` 3. Run `RecRoomScreen.bat` or `RecRoomVR.bat`
## Custom server ## 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.
+255
View File
@@ -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;
+10 -10
View File
@@ -1,5 +1,6 @@
@echo off @echo off
setlocal setlocal
set "PATCH_VERSION=v0.0.5"
rem ANSI colors (Windows 10+): get the ESC character, then define color codes 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" for /F "delims=" %%a in ('forfiles /p "%~dp0." /m "%~nx0" /c "cmd /c echo 0x1B"') do set "ESC=%%a"
@@ -26,11 +27,11 @@ tar -xf DepotDownloader.zip -C DepotDownloader || goto :error
del DepotDownloader.zip del DepotDownloader.zip
echo %CYAN%=== Downloading depot via DepotDownloader (will prompt for Steam password) ===%RESET% echo %CYAN%=== Downloading depot via DepotDownloader (will prompt for Steam password) ===%RESET%
DepotDownloader\DepotDownloader.exe -remember-password -app 471710 -depot 471711 -manifest 6426603215211043630 -dir . -username "%STEAM_USERNAME%" || goto :error DepotDownloader\DepotDownloader.exe -remember-password -app 471710 -depot 471711 -manifest 1151455856673601091 -dir . -username "%STEAM_USERNAME%" || goto :error
goto :patch goto :patch
:bucket :bucket
set "CLIENT_MD5=4c4a94624eba99028bb36445ccb03253" set "CLIENT_MD5=6820e89bff41906ded7f5c066027f1d6"
if not exist client.zip goto :download if not exist client.zip goto :download
echo %CYAN%=== Checking existing client.zip ===%RESET% echo %CYAN%=== Checking existing client.zip ===%RESET%
set "LOCAL_MD5=" set "LOCAL_MD5="
@@ -43,7 +44,7 @@ echo %RED%client.zip does not match expected hash - redownloading.%RESET%
:download :download
echo %CYAN%=== Downloading game client from mirror ===%RESET% echo %CYAN%=== Downloading game client from mirror ===%RESET%
curl -f -L -o client.zip https://s3.g.megas4.com/2koayuyiwxv4groxzwdbbxg43cwustavrkvfb/recflare/client.zip || goto :error curl -f -L -o client.zip https://s3.g.megas4.com/2koayuyiwxv4groxzwdbbxg43cwustavrkvfb/recflare/2025/client.zip || goto :error
:extract :extract
echo %CYAN%=== Extracting game client ===%RESET% echo %CYAN%=== Extracting game client ===%RESET%
@@ -53,14 +54,13 @@ tar -xf client.zip -C . || goto :error
echo %CYAN%=== Writing steam_appid.txt ===%RESET% echo %CYAN%=== Writing steam_appid.txt ===%RESET%
>steam_appid.txt echo 480 >steam_appid.txt echo 480
echo %CYAN%=== Downloading BepInEx and extracting to this directory ===%RESET% echo %CYAN%=== Downloading Rec Room 2025 patch ===%RESET%
curl -s -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 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 BepInEx.zip -C . || goto :error tar -xf 2025Patch.zip -C . || goto :error
del BepInEx.zip del 2025Patch.zip
echo %CYAN%=== Downloading RecNetPlugin.dll into BepInEx\plugins ===%RESET% echo %CYAN%=== Pointing 2025patch.ini at RecFlare ===%RESET%
if not exist "BepInEx\plugins" mkdir "BepInEx\plugins" 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
curl -s -f -L -o "BepInEx\plugins\RecNetPlugin.dll" https://github.com/djdevin/recnet-plugin/releases/download/20230414.1/RecNetPlugin.dll || goto :error
echo %GREEN%=== Done ===%RESET% echo %GREEN%=== Done ===%RESET%
pause pause
BIN
View File
Binary file not shown.

After

Width:  |  Height:  |  Size: 152 KiB