How to run

[mfnalex]

Hi, maybe I'm stupid but there's absolutely no documentation on how to actually run this. Can someone help me please? Simply cloning the repo into the LRR folder doesn't work, the .exe says it's missing openllr.dll (or openllr-d.dll)

[trigger-segfault]

I can try to explain, But I absolutely need to write these instructions down somewhere, and have been putting it off for too long. (Sorry for the late response).

First, this project will need to be built to run, second you'll need Visual Studio 2019. At some point, I'll get around to distributing builds for openlrr.dll so that it can be run without needing to build the project.

Most of these instructions are identical for getting a normal copy of LRR to run.

Requirements

The following all need to be moved to <project>/bin (or wherever you plan to run the game from, which shouldn't be in Program Files).

Project files

• OpenLRR.exe (for running release builds)
• OpenLRR-d.exe (for running debug builds)

LRR install files

• Data/ folder
• LegoRR0.wad
• LegoRR1.wad

AVIs without CD

See the master guide and search for the section on "AVI" files. You'll need to copy a handful of files from your LRR CD into the Data/AVI folder.

Compatibility fixes

Direct3D Retained Mode support

• D3DRM.dll

DirectDraw speed fix

DDrawCompat is an alternative to this, but testing is always done with dgVoodoo.

• dgVoodoo.conf
• dgVoodooCpl.exe
• D3D8.dll
• D3DImm.dll
• DDraw.dll

Media Control Interface without CD fix

This is probably optional, but testing is never done without it.

• Music/ folder
• libogg-0.dll
• libvorbis-0.dll
• libvorbisfile-3.dll
• winmm.dll

Building

1. Open up OpenLRR.sln in VS 2019.
2. Change the configuration to x86, and Debug or Release.
3. Build the project openlrr, which should automatically output openlrr.dll (or openlrr-d.dll for Debug configuration) to the <project>/bin folder.

Running

Preparing the executable

1. Right click Properties on OpenLRR.exe in the <project>/bin folder.
2. Go to the Compatibility tab.
3. Under Settings, check Reduced color mode.
4. Select 16-bit color from the dropdown below the checkbox.
5. Repeat these steps for OpenLRR-d.exe.

Running from executable

Run OpenLRR.exe or OpenLRR-d.exe from the <project>/bin folder.

Running in VS debugger

1. Right click Properties for the openlrr project in VS 2019.
2. In the Debugging tab, change the following settings:
   1. Command: $(TargetDir)OpenLRR.exe (or $(TargetDir)OpenLRR-d.exe for Debug configurations)
   2. Working Directory: $(TargetDir)
   3. Debugger Type: Native Only

[mfnalex]

Thanks very much, I'll try it out and close this issue when I got it to work :)

[mfnalex]

Awesome, I got it to run, thank you :)