Skip to content

Latest commit

 

History

2,353 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Rai Pal

Raicuparta's VR mods

rai-pal

Install

Windows

Download the installer:

Download for Windows

or install via winget:

winget install Raicuparta.RaiPal

Linux

Download the AppImage:

Download for Linux

What's this?

A tool that helps you use and make universal game mods. That means mods that aren't made for any specific game, but work across multiple games, usually of the same game engine. Popular examples are UEVR and UUVR. Some features:

  • Auto-find installed games from supported providers.
  • Auto-find owned (but not necessarily installed) games from supported providers.
  • Detect relevant information about each game, such as their game engine and engine version.
  • Easily install/run the correct version of universal mods.
  • Easily update universal mods.

Automatically finding games

Rai Pal analyzes files on your system to determine which games you own, and which games you have currently installed. There's some guesswork involved in this, especially since Rai Pal tries to give you this information as quickly as possible, without the need to log in with each provider's account. Here is how Rai Pal handles finding games from each provider:

Provider Installed games Owned games Notes
Steam ✅ ✅* Also detects non-Steam games added to the Steam library.
GOG ✅ ✅
Epic ✅ ✅
Itch ✅ ✅* Does not include games from bundles, unless you add them to your library. There are scripts for adding all games from a bundle to your library, but they're slow and not recommended by the Itch team.
PC Xbox ✅* ❌ Only finds installed games marked as moddable (the ones where you can open the game files folder via the Xbox app)

For all other providers, you'll have to manually add the games to Rai Pal using the "add game" button on the installed games tab, or by just dropping the game exe on the Rai Pal window.

Game engine detection

Rai Pal also uses a few different methods for detecting game engines. There's a lot of guesswork here as well. For installed games this is usually pretty straightforward, but for owned games it involves using remote sources, and often going by the game's name. Here is how Rai Pal handles detecting the game engine from each provider:

Provider Engine
(installed games)
Engine version
(installed games)
Engine
(owned games)
Engine version
(owned games)
Steam ✅ ✅ ⭐ Great guess 👍 Good guess
GOG ✅ ✅ 👍 Good guess 👍 Good guess
Epic ✅ ✅ 🤏 Decent guess 🤏 Decent guess
Itch ✅ ✅ 🤏 Decent guess 🤏 Decent guess
PC Xbox ✅ Unity only 👎 Not available 👎 Not available

Deep links

Rai Pal registers the rai-pal:// URL scheme (also known as protocol urls).

Link Description
rai-pal://add-mod-source?url=<url> Ask the user to add a custom mod database (same as pasting a URL in the mod sources dialog).
rai-pal://install-mod?providerId=<id>&gameId=<id>&modId=<id> Install a mod for a game.
rai-pal://uninstall-mod?providerId=<id>&gameId=<id>&modId=<id> Uninstall a mod from a game.
rai-pal://run-mod?providerId=<id>&gameId=<id>&modId=<id> Run a game with a mod.

To know what values you can pass to providerId, gameId, and modId, check the "Debug Data" buttons in Rai Pal (available in the games tab when selecting a game, and in the mods tab when selecting a mod).

License

Rai Pal
Copyright (C) 2024  Raicuparta

This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.

This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
GNU General Public License for more details.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

About

Mod manager for universal game mods

Topics

Resources

Contributing

Stars

719 stars

Watchers

9 watching

Forks

Releases

Packages

Used by

Contributors

Languages