(Note: This is only for the Steam version of the game! Unless stated otherwise, assume this patch works on latest game version!)

This mod is a code patch that "unlocks" the use of costumes 2, 3, 4 and 5 on every character slot in the game by pressing a certain button during the character select screen while picking a character.

This mod is a culmination of a lot of hours of work, in development for roughly a year!

This mod does not include any new costumes, think of it as the "base" or "framework" for mod creators (not mod users!) that enables making their mods use the new costume slots! (The costume shown in screenshots is this mod by swordsman09)

Installation
This mod contains 3 downloads, one of them will be the patch itself, the other included file is a small program I made myself that allows you to "move" mods from costume slot 1 to any desired slot (and back to costume 1 if you so desire).

The final file is a pak file containing the necessary character assets for costumes 2 to 5.

The PAK file is a "heavy" download as I have provided assets for every costume slot that didn't exist in the game originally (which is costumes 2 to 5 in most cases) so that the process for moving mods to new costume slots is as easy and painless as possible for the end users.

Where to place the patch file
Look for the game in your steam library, right click the game and then select "Manage" and then "Browse local files", this will take you to the game's install folder.



Once there, go inside the following folder path;

RED -> Binaries -> Win64 and enter the Win64 folder, located here is the game's executable.

Now extract the contents of the "GBVSRisingExtraCostumesPatch.7z" file in this folder, and it should look something like this now;



NOTE: By default, every option in the patch is disabled, please see below for what options you can toggle!

Where to place the placeholder Costumes pak file
Follow the same instructions as above for installing the patch, except this time, you want to go to the following folders instead:
RED -> Content -> Paks and enter the Paks folder, located here is the game's PAK files.
(Please note, while you are using this patch, you do not need a .sig file to load PAK mods!)



Files included in mod zip

• dsound.dll -> This file is simply Ultimate ASI Loader, which is used to load external code patches, in this case, the extra costumes patch, included is a license.txt with Ultimate ASI Loader's license
• plugins/config.toml -> This is a config file in which you can enable or disable extra features, you can edit this file with any regular text editor such as Notepad++ or VS Code
• plugins/GBVSRisingExtraCostumesPatch.asi -> This is the actual code patch that has the extra costumes patch.
  

Mod Configuration Toggles
As explained earlier, this mod contains a config.toml file, explained below is what each option does;

• Enable_Console - As the name says, this simply enables console output
• File_Access_Logging - If both this and console are enabled, it will print every file accessed by the game within the game's RED directory and subdirectories to the console
• Loose_File_Loading - If enabled, allows you to load modded files loosely instead of needing to be packed into a PAK (good for quick mod testing), if console is enabled, any time a file is replaced via this method will also be logged into console
• Costumes_Patch - Self explanatory, the actual meat of this mod, unlocks usage of the extra costume slots
• Random_Costumes - If no costume is selected on either P1 or P2 (or both), if this option is toggled, the game will randomly select from costumes 1 to 5
• Log_Script_Errors - Only useful if you do blueprint script modding, does what the name implies
  

(Note: If you change any of these toggles while the game is running, they will not take effect! So make sure to either change settings while the game is not running, or reboot game if it was and you changed a toggle).

How to Access Costumes/Usage
This mod works by reading the inputs of the player depending on which side of the screen you are, so, left side = read Player 1 inputs, and right side = read Player 2 inputs, so make sure you pick the correct side!

During the character select screen, Press and Hold any of the following buttons and then switch colors once to switch to a different costume, once the character model has changed, you are free to let go of the button and pick your color (controls based on a Playstation Controller layout);

• L1 -> Costume 2
• R1 -> Costume 3
• L2 -> Costume 4
• R2 -> Costume 5
• L3 -> Costume 1 (Reset Costume) (this is the right stick, press it in)
  

Using Keyboard (NOTE: These are NOT the number keys on the number pad on the right side of the keyboard, these are the number keys on the top row!)

• Number Key 1 -> P1 Costume 1 (Reset Costume)
• Number Key 2 -> P1 Costume 2
• Number Key 3 -> P1 Costume 3
• Number Key 4 -> P1 Costume 4
• Number Key 5 -> P1 Costume 5
  

• Number Key 6 -> P2 Costume 1 (Reset Costume)
• Number Key 7 -> P2 Costume 2
• Number Key 8 -> P2 Costume 3
• Number Key 9 -> P2 Costume 4
• Number Key 0 -> P2 Costume 5
  

Is this mod Safe to use Online?
Short Answer: Yes!
Long Answer: Everything that is done by this mod is all done locally/client sided, meaning only you see the costume changes, which will not affect other players at all (which means the mod works with Crossplay!).

Porting existing (or new) mods to new Extra CostumesWhile this requires you already know how to create your own mods for the game, it is nonetheless an "easy" process.
Included in the uploaded files is a small useful utility I made for myself for this purpose called "GBVS-Rising-CostumeStringReplacer" (included in the program is a HOWTOUSE instructions text file) that you can use to achieve this goal.

Troubleshooting

Invisible Models - This very likely means the Placeholder Costumes PAK is not installed
correctly, double check everything  to make sure the mod is
properly enabled.

KNOWN ISSUES

• Please comment if you think you found a bug with the patch!
• If you switch characters inside training mode while using a costume, the game may crash
• For Vikala, when moving costumes to slots 3/4/5, you MUST also patch the skeleton!