/PBPModSwitch

A utility to load in runtime modded maps on Penumbra Black Plague

Primary LanguageC#MIT LicenseMIT


Penumbra Black Plague

Penumbra Black Plague - Mod Switch

Version Issues Issues

AboutUsageContributingAuthorsLicense

About

This repository contains the C# project of this utility.

This utility was developed with OOB maps in mind. The goal is to be able to switch from official maps to OOB maps without manipulating folders (including the game cache) and without having to restart the game.

This tool supports the following versions of Penumbra Black Plague:

  • The Steam version
  • The GOG version with the 1.1 patch

Usage

  • First of all download the latest version (compressed archive) you can find here.
  • Then move the files and the mods folder to your game folder in the same place as Penumbra.exe (in the redist folder). The game path can be found via Steam: Properties -> Local files -> Browse local files...
    The path generally used by Steam is C:\Program Files (x86)\Steam\steamapps\common\Penumbra Black Plague\redist.
  • You can run PBPModSwitch.exe then Penumbra but it also works the other way around!
  • A few seconds after the game is initialized the utility should load the maps
  • Once the interface with the list of modded maps appears, you can activate all the modded maps with the main button or select the ones you want from the list below. Unchecking them will return the normal maps.
  • Note: This program will create a secondary cache for the game so as not to pollute the real game cache with files from modded maps. This cache is automatically deleted when you close the utility and the modded maps are automatically disabled.

Contributing

I would be happy to see you contribute to the development of this tool!

You can open a issue in case of a problem or fork this repository to propose a modification via a pull request.

Authors

Github profile Discord
Astropilot Astropilot [Anos]#2347

License

MIT - See LICENSE file