WipEout 2048 Mod Manager https://screwgravity.net/firestar
Go to file
2024-07-05 12:32:39 -04:00
.idea Remove broken jpackage build hook 2024-07-03 15:46:01 -05:00
installer added desktop icon to installer 2024-07-03 16:29:06 -05:00
resources style changes 2024-07-01 14:53:13 -05:00
src Changed version string 2024-07-03 16:55:41 -05:00
.gitignore whoops 2024-07-03 16:22:10 -05:00
firestar.iml refactor; switch library to maven remote 2024-05-07 08:21:46 -05:00
LICENSE Initial commit 2024-04-09 15:00:01 -04:00
README.md Update README.md 2024-07-05 12:32:39 -04:00
titleIcon.ico Inno setup 2024-07-03 16:18:33 -05:00

Firestar is a mod manager for WipEout 2048 which automatically handles sorting mods by priority and repacking game assets based on selected add-on packs. It runs on a desktop/laptop computer and aims to allow easy installation of mods for users who have only a surface level understanding of hacking the PSVita.

Get Started: >> CLICK HERE <<

Installation

The latest version of Firestar will always be available from Releases.
If you aren't sure which file to get:

  • Windows: Download the latest installer here.
  • Linux: Install one of the packages from the Releases page:
    • Ubuntu, Mint, PopOS: sudo dpkg -i firestar_ver_arch.deb or gdebi firestar_ver_arch.deb
    • Fedora, Mageia, OpenSUSE, AlmaLinux: sudo rpm -i firestar-ver-arch.rpm
    • Arch, EndeavourOS, CachyOS, Steam Deck: sudo pacman -U firestar-ver-arch.pkg.tar.zst
  • All Platforms: Grab the Portable ZIP, extract it, and run the JAR file.

System Requirements

  • You will need a computer running Microsoft Windows, or any POSIX-compliant desktop operating system such as Mac OS X, Linux, BSD, or MINIX (Firestar does not run directly on the PSVita). Wayland support has not been tested.
  • You will also need the Java Runtime Environment installed, at least version 17 or newer. Non-Windows systems will require WINE to be installed for some functionality.
  • Please run Firestar on an EXT or NTFS partition as some of the larger file operations it performs may cause glitches in certain filesystems used on memory cards. Do NOT install Firestar directly to your PSVita's storage.

FAQ

Can I use this on a Vita without enso/HEN?

No. You need a modded Vita in order to use this. Hacking a Vita is super easy these days, but if you don't want to, you can always use Vita3K instead.

Where do I download mods?

There's no #1 place for Firestar mods as of now, but we can give you a few sample mods to test out if you are interested in seeing the program in action:

  • XP Rebalance: Reduces the amount of grinding required to level up for players who can't access the online campaign. Leaderboard safe version!
  • Pepsi Mod: Gives the FEISAR Agility ship a Pepsi makeover.
  • Gold AG-SYS Speed: Better Than Chrome™
  • Continue?: Allows you to exit the pause menu without taking your thumb off the throttle. By ThatOneBonk
  • HD Skin: Recolors the UI to look like WipEout HD. By ThatOneBonk
  • Custom Soundtrack: A custom playlist I put together. This music is copyrighted, don't play it on stream

What do I need to make my own mods?

For making your own mods, we recommend grabbing one of the many leaked PS Vita SDKs off of Archive.org since it has many of the tools you will need. I recommend using Photoshop CS5 for textures, since Sony officially provides a texture export plugin for CS5 in their SDK. There is also an included at9tool which can help with replacing sounds and music.

Many things like HUDs, custom translations, and even some game variables are kept in XML format and can be edited in any normal text editor like Microsoft Notepad, GNU Nano, GEdit or KWrite. (Play nice when you're online.)

As for models and custom tracks, we don't have a concrete way of modifying those just yet, but work is being done on that, so stay tuned.

(Non-Windows) About WINE Compatibility

psp2psarc.exe is a Windows-only tool (also like super proprietary... sorry). Firestar can run natively on the system but it needs WINE in order to pack the game assets. If you are on Mac OS X you will need an older OS version that is still compatible with 32-bit applications.

Developer Commentary

Why use a leaked Playstation SDK?

Because many third-party programs for opening PSARC files either have no ability to create new ones or are prone to corruption bugs. Using the one made by the developers of the file format is the best option as it's what the game developers would have used. Obviously this creates all kinds of legal grey areas, so I can't distribute Sony's proprietary software next to my code. It's downloaded separately during the setup process.

Why Java?

Cross-platform support with no hassle, a built-in UI framework, and I don't need to sell my soul like every Electron or React 'Native' developer is doing these days.

Why the name "Firestar"?

Firestar was a secret track in the original WipEout which you unlocked after beating the game at least once, the mod manager is just named after that. Major versions are named after pilots or tracks. Internal class names are named after Muppets characters as this is the same naming convention that Sony used to codename parts inside the PSVita's SOC.

Fast Mode vs. Compatibility Mode

"Fast Mode" was a legacy option that was scrapped before it could be developed. It skipped the creation of a PSARC file and simply dumped the final game assets to their destination folder. This works great for emulators, and doesn't require proprietary stolen SDKs from SCE. However the filesystem on the Playstation Vita really hated this method and would glitch out when this was done, causing textures to be corrupted once placed on the memory card. The WipEout engine has no fault tolerance for malformed or missing assets, so it just crashes instantly when it encounters one. This is where Compatibility mode comes from, which is the default setting for 2048.