Project Plus Flatpak

Installing

• Download ProjectPlus3.0.5.flatpak from releases
• Install ProjectPlus3.0.5.flatpak (sudo needed for installing single use Flatpak bundle)

sudo flatpak install ProjectPlus3.0.5.flatpak

Launching

• Launch the ProjectPlus Flatpak (Either search for the app in your menu and click it) or

flatpak run com.projectplusgame.ProjectPlus

Setup

• Set the "Config>Paths>Default ISO:" to your Brawl.iso
• Optionally change graphics options to use fullscreen and set internal resolution higher
• Optionally check "Graphics>Advanced>Load Custom Textures" for HD textures
• Optionally check "Graphics>Advanced>Wait For Prefetch" to reduce stuttering while using HD textures (Causes Dolphin to take longer to close tho)
• Play "Project+ Offline Launcher.dol" for offline play or use "Tools>Start NetPlay..." to either connect or host an online game with the"Project+ Netplay Launcher.dol"

Uninstalling

• Remove ProjectPlus Flatpak

flatpak remove com.projectplusgame.ProjectPlus

Downloading/Cloning this repo

• Click the green button to download zip and extract once downloaded or clone repo with

git clone --recurse-submodules https://github.com/ChrisHobday/com.projectplusgame.ProjectPlus

Building

• Install Flatpak builder

flatpak install flathub org.flatpak.Builder

• Install the platform this Flatpak will be using

flatpak install flathub org.freedesktop.Platform//24.08 org.freedesktop.Sdk//24.08

• Build the Flatpak with flatpak-builder (Run this from within the com.projectplusgame.ProjectPlus directory)

flatpak run org.flatpak.Builder --force-clean --repo=repo build-dir com.projectplusgame.ProjectPlus.yml

User installation while building

• Replace last Building step with

flatpak run org.flatpak.Builder --force-clean --repo=repo --user --install build-dir com.projectplusgame.ProjectPlus.yml

Building single use Flatpak bundle like in the releases (After having followed the Building steps above)

• Build the Flatpak bundle (Run this from within the com.projectplusgame.ProjectPlus directory after having followed the Building steps above)

flatpak build-bundle repo ProjectPlus3.0.5.flatpak com.projectplusgame.ProjectPlus

Known issues

• Using Vulkan backend results in black screen
• "Right Click game>Properties>Edit/View config" results in "Couldn't find open command for extension 'ini'!" error message.
• Starting a netplay game takes comparetively much longer to start up

Troubleshooting

• Check if Flatpak is installed

flatpak list | grep ProjectPlus

• Enter Flatpak in command line mode

flatpak run --command=sh com.projectplusgame.ProjectPlus

• Fix white screen at startup

rm -r ~/.var/app/com.projectplusgame.ProjectPlus/cache/

Flatpak locations

• Installation directory = /var/lib/flatpak/app/com.projectplusgame.ProjectPlus/
• Installation directory (User mode) = ~/.local/share/flatpak/app/com.projectplusgame.ProjectPlus/
• User cache directory = ~/.var/app/com.projectplusgame.ProjectPlus/cache/
• User config directory = ~/.var/app/com.projectplusgame.ProjectPlus/config/
• User data directory = ~/.var/app/com.projectplusgame.ProjectPlus/data/
• SD card = ~/.var/app/com.projectplusgame.ProjectPlus/data/FasterPPlus/Wii/sd.raw
• Launcher directory = ~/.var/app/com.projectplusgame.ProjectPlus/data/FasterPPlus/Wii/Launcher/