Costume X Versus Mod
Formerly the Expired Beta Versus Mod (Oct 2022-June 2023)



The Costume X Versus Mod is a REFramework script that allows you to rapidly launch matches via an imgui window, and to model-swap costumes (including entirely new modded costumes) over any character in Fighting Ground (OFFLINE ONLY). Online unfortunately doesn't work currently, but maybe I can do something about that in the future.

The script was initially created as a tool for exploring the SF6 Closed Beta Test, and was the primary tool used to play and mod the beta for the ~8 months leading up to SF6's release.

Features

• Costume Slots - Mod makers can convert their mods so that they do not overwrite any default Capcom costumes, and will only be loaded through the Versus mod's menus
• Model Swaps - Actively use the Movesets menu or passively swap any VS Mod Costume over any character you selected in the Character Select screen to model swap that costume's appearance over that character, with your selected character's moves, audio, VFX etc.
• Mode Select - Choose from any of the Extreme Battle Modes as well as a version of up to 3v3 team battle
• Configurable Shortcuts - Various functions of the mod can be set to shortcuts for fast use without going through any menus
• Randomizer - Have the mod randomize P1 or P2 character selection, color, costume (including modded), stage, gimmick, mode, music and more, every time you launch a Versus mod battle.
• Multiple Gimmicks - The 2nd and 3rd players of each Team Battle team can be changed into Extreme Battle gimmicks such as the Bull, drone or bomb, for multiple of these gimmicks at once.
• Music Selection - You can select and play fight music from a list at any time during a match
  

Be sure to check out the Versus Mod Costume Pack as a selection of example mods you can use with the Versus Mod.
Ryu Master Chief also uses it.

Installation

• Download and install Fluffy Mod Manager
• Download REFramework and place ONLY its dinput8.dll file into your game folder.
• Download this mod and place its RAR file inside Fluffy Mod Manager's SF6\Mods\ folder
• Install this mod using Fluffy Mod Manager
  

Usage

REFramework creates a window that can be displayed or hidden by pressing Insert (default). In the "Script Generated UI" section of this window, the Versus Mod has a large control panel.

There are several buttons at the top of the script for quickly launching modes:

• Main Menu - Loads the main menu
• Training - Loads Training Mode
• CPU Exam - A 1v1 versus mode where you can play against a friend (locally), play against CPU, or watch CPU vs CPU.
• Team Battle - A match with up to 3 fighters on each team
• Exit Game - Immediately close the game
  

Open the "Configuration" sub menu to set up your character selections, stage selection and mode/gimmick selections for your matches.
Check the "Teams" checkbox inside it to customize up to 3 members per team, or turn team members into gimmicks such as Bull or Bomb.

An option called "Override Game Selections" allows for model swaps and modded costume in modes outside of the CPU Exam and Team Battle buttons.
Your selections in SF6's Character Select screen will update the mod menus in the Versus Mod as you cycle through selections. You can change which character is selected after picking them in SF6, and the Versus mod will override your SF6 selection with what you changed it to in the mod.
This goes for costumes, colors and whole characters. The moveset and voice etc of the character you picked in the SF6 screen will form the base of the character, but their appearance will be overridden by the Versus mod.

Model Swaps can also be performed through the mod's build-in "Swap Movesets" option, which will create combo boxes for selecting a moveset separate from your chosen character when launching the mod's Training, CPU Exam and Team Battle modes:




With Override Game Selections enabled, the characters in the below screenshots have been changed from P1-Juri to Cammy and P2-Kimberly to Juri, with a Versus Mod costume slot called "Alternate - No Straps" for Cammy, and Juri's default alternate costume (even though it has not been unlocked, nor the color slots):


And the result is that you have complete Cammy (color 5) with no straps swapped over Juri with Juri's animations as P1, and complete Juri color 2 swapped over Kimberly as P2:

This is great for testing and developing mods as well, since you can quickly load any costume or color on any character without having to spend the time to unlock everything in World Tour.

* Remember to turn "Override Game Selections" off when you dont intend to use it. It can cause unforseen problems in certain contexts.

* Some combinations of characters may not load using this method, and you will see "Perfect KO!" as soon as the round starts. You should try to return to the main menu using the versus mod immediately if this happens.

Music can also be changed live using this mod, by selecting a new music track under the "Stage Select" section of the mod during a match. Clicking "Randomize Music" will also load a new music track. 

Additionally, the character select music can be suppressed and overridden by the main Fighting Ground menu music, if the General Option "Suppress character select music" is checked.

Randomizer

The Costume X Versus mod features a powerful randomizer for its CPU Exam and Team Battle modes.
Click on "Random Play" near the top of the script to enable Randomization. Then you can open the "Random Play Settings" sub menu to specify which options you want to be randomized each time you launch a battle with the mod.



Custom Costume Slots
The mod features a Costume Slots system, wherein a modder can tailor their mod to be loaded only by the Versus mod menus and not overwrite any default assets. An unlimited number of costumes with up to 10 colors each can be added.
If you would like to convert or create a mod to work as a VS Mod costume slot, check out this costume slot making guide

Custom Stages
With version 3.7.2+, entirely new custom stages can be added to the game, without replacing any default stages. Stages are loaded from only two SCN files, so to create a new stage mod you only need to create a json file like this to tell the versus mod the name of the new stage (which will be added to the mod's "Stages" drop-down list) and the two SCN files that that stage will load:

Then you can use a hex editor or tool such as RE_RSZ to edit your JSON's SCN file and give it custom filepaths for the scns, meshes, textures etc that it loads.
In this case I simply made an edited copy of product/level/scene/ess/ess0401_00v.scn that has its own custom scn files linked inside it, and then included those custom scn files within the stage mod:

Other Features

- Select battle music from any stage or character (or completely randomized music) and quick switch between P1, P2 and Stage music during a match.
- Swap P1 and P2's appearance with the "Swap P1 P2 Appearance" button or shortcut (execute it during a throw for best results)
- Load Commentators
- Configurable shortcuts, just click the button for an action to change its hotkey:

- With EMV Engine installed, edit gameplay properties of the battle and players, under a menu called "Game Info":


Most other options in the script are described by tooltips that appear when you hover your mouse over them.

DISCLAIMER:
- Some features may still be outdated or broken; this script has a lot of features from modding the beta and not all have been tested that much in the full game.
- Crashes may occur occasionally when using "Override Game Selections", as the new method of swapping costumes is still slightly experimental.

To use Rashid in the mod, you must go to the character select screen once to verify that you own the content.

Modding Haven Discord