how to use Portal Revolution with this mod

[Digitalgaming1]

STUFF:
Since this game runs on an enhanced version of Portal 2 (P2:CE) some levels may not look or work correctly due to missing entities or values.

It is STRONGLY recommended to install Digital Additions here as the game may be severely dark and missing sunlight
https://www.moddb.com/mods/digital-additions
Without it many more things may appear incorrect or broken.

Summary cuz why not
(put the Revolution folder into your portal 2 folder then Recompile the models using the portal 2 compiler and put them back into the revolution folder and then drag and drop the contents of the premade files)

STEP 1:
Drag and drop the "revolution" folder from your Portal Revolution install into your main Portal 2 folder.
(See Image 1 for reference.)

STEP 2:
go to the portal2 folder and then into bin copy the server, matchmaking and client.dll
then go to the revolution folder then into bin and replace the files with the new dll's

STEP 3:
Create a new folder anywhere and name it:
decompile and recompile

Inside that folder create these 3 folders:

• decompile input
• decompile output
• recompile output

STEP 4
Download these
Crowbar:
https://github.com/ZeqMacaw/Crowbar

VPKEdit:
https://github.com/craftablescience/VPKEdit

STEP 5:

1. Install VPKEdit and open it
2. Go to your Portal 2 installation open the "revolution" folder and then open "pak_01_dir.vpk"
3. Inside it right-click the "models" folder and select "Extract Folder" to your "decompile input" folder
   4.After extraction delete the "models" folders from inside the VPK

STEP 6:

1. Press CTRL + P
2. Under Versions change the version to "Version 1"
3. Press CTRL + S and wait for it to finish saving

STEP 7:

1. Open Crowbar.
2. In the "Game Setup" tab
   3.configure it as shown in Image 3 (if needed change the portal 2 location's to where you installed it)

STEP 8:

1. Go to the "Decompile" tab
2. Set "MDL Input" to "Folders and Subfolders"
3. Set the input path to your "decompile input" folder
4. Set the output path to your "decompile output" folder
5. Click "Decompile" and wait for it to finish. (This may take a while.)

STEP 9:

1. Once done click "Use in Compile"
2. Set "QC Input" to "Folders and Subfolders"
3. Set the QC Path to your "decompile output" folder
4. Set the output path to your "recompile output" folder
5. Click "Recompile" and wait again. (This may/will take longer)

STEP 10:

1. After recompiling open your "recompile output" folder
   2 Copy the "models" folder
2. Go to: the portal2 folder
3. Paste the "models" folder inside. (See Image 4.)

STEP 11:

1. Open the "Premade Files" folder included in this Directory and
2. Drag everything inside that folder directly into your Portal 2 root folder
3. Replace files if/when prompted

STEP 12:
Its finally time to launch it!
Open portal 2 with the provided run-Revo-rtx
run-Revo-rtx.bat

==============================
HOW TO UNINSTALL

what I Do is go into the portal_dlc3 folder create a new folder called revo or whatever you want
and move "pak03_dir and pak04_dir.vpk" to the new folder and just dont run the "run-Revo-rtx.bat"

Or do you want to save space? just delete the "pak03_dir and pak04_dir.vpk" and remove the "Revolution folder" (if you do it this way and want to play again you need to redo the installation steps)

==============================
KNOWN ISSUES

• Getting stuck on 2 dots then crashing (see Troubleshooting)
• Act 4 loading screens appear messed up
• Some doors do not open
• Menu is bugged (Fun Fact when revo was still using the p2 branch it looked like that minus the main menu i think (or they just deleted a bunch of old stuff resource files before shipping it any way this is too long)
• Spire Core particles overflowing (what?)
• Missing collision on some props/models (Finale missing Window Collison (fixed for player)
• "Already open" doors lack open skin - Also may Not even open
• Fling panels may fling with low velocity (I think i fixed this?)
• Certain sounds loop infinitely (engine bug..... breh)
• Missing sounds ↑
• Some maps are dark or have purple water
• End credits glitchy (compressed)
• Oversized props/models
• sp_a2_tbeam_flings Button just refuses cubes or spheres things
• Performance may/will be bad on some maps

Oh and more I Just forget them sometimes 🙂

==============================
TROUBLESHOOTING

Q: All my models are gone?
A1: Move the "models" folder into "revolution".
A2: Make sure it was inside "portal2" when you started.

Q: Game stuck on 2 dots and crashes?
A1: Check that you recompiled the models correctly.
A2: Try using the Portal 2 model compiler
A3: Not working? try Load another map

Q: Audio sounds low quality or phone-like?
(honestly not sure why this happens but doing this fixed it)
A: Download the latest dxwrapper from:
https://github.com/elishacloud/dxwrapper
Copy "dxwrapper.asi" and "dxwrapper.dll" into the "bin" folder (not the one with server.dll)
Then remove "winmm.dll" Then download version 2.1 of the compat mod and then go into the bin folder of that
Then copy and paste the dxwrapper.ini into your bin folder then open the replace the "./p2-rtx.dll" line with "plugins/p2-rtx.asi"
Then finally add everything from "run-Revo-rtx.bat" to Steam launch options and start the game via Steam

View the "troubleshoot image"

A2:If that doesn't work remove the dxwrapper.dll

A3:If that also doesn't work restore the dxwrapper.dll and remove the "dxwrapper.asi" file

Q: RTX not working/a error when launching the "run-Revo-rtx" file?
A: Make sure you copied the Premade Files to the Portal 2 root folder installed correctly.

==============================
Q & A

Q: Can I use this on custom Portal Revolution maps?
A: Yes but you must decompile and recompile the maps and fix any issues manually.

Q: Can I use this on other Portal 2 community edition games?
A: Technically yes but you will need to make your own files For that game (Portal Intrusion your next... muhahahaha)

Q: Can I use the -game Revolution in Steam Launch Options?
A: Yes

[Nonmthing]

why has the sound in my game disappeared?

[Nonmthing]

fix that please

[Digitalgaming1]

fix that please

never had that issue try the trouble shooting steps on the main p2 rtx

"Either copy _master.cache from root/portal2/maps/soundcache to root/portal2_dlc3/maps/soundcache
Or paste this into the in-game console and execute: snd_rebuildaudiocache;snd_updateaudiocache;exit "

[Nonmthing]

fixed,thx!

[Nonmthing]

Describe the bug
Portal: Revolution stops responding when loading most maps and reports an error after a while

To Reproduce
Steps to reproduce the behavior:

1. use .bat script to boot the game
2. load a random map
3. get stuck

Expected Behavior
The game successfully loaded the map and let me to play normally

Screenshots

Additional context
About my PC:
CPU: Intel® Core™ i7-14700KF 3.40GHz
GPU: NVIDIA GeForce RTX 4060 8GB
RAM: 24GB DDR4
OS: Microsoft Windows 11 Pro for Workstations Insider Preview OS build 29531.1000

[Nonmthing]

like this?

[Nonmthing]

but i now i can't even start the game

[Nonmthing]

alright, I get it now, and my problem is solved, thx! :)

[Digitalgaming1]

all maps launch now?

[Nonmthing]

yes

[Blizzardfire]

I just am wondering if there is a different way to do this.

[Digitalgaming1]

In like what way?

[Blizzardfire]

Its a long method and it concerns me that it could be a safety risk

[Digitalgaming1]

If anything you can copy your portal 2 installation and paste it some where else so if somehow something goes wrong you can delete the your existing then restore your backup