[XML2] Mod Installation Guide for Consoles

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 1: WELCOME

By BaconWizard17

Introduction
    Welcome to the XML2 Mod Installation Guide! This tutorial covers everything you need to know to mod your copy of X-Men Legends II: Rise of Apocalypse. This tutorial discusses how to add mods to the original console releases (GameCube, PS2, PSP, Xbox).

YouTube video for this chapter (Coming soon!)

How to Use This Tutorial
    This tutorial is broken up into several chapters:

• Chapter 1, which is this chapter, is the introduction and connects everything together. It's where you start.
• Chapter 2 teaches you how to install the game.
• Chapter 3 teaches you how to extract and rebuild assets, which is very important for the console releases.
• Chapters 4-11 show you how to install different kinds of mods.
• Chapter 12 shows you how to play the game and provides tips for unlocking characters.
• Chapter 13 contains additional tutorials and information that may help you mod your game.
• Chapters 14-16 will help with solving issues you may have.

    This tutorial is long, but it contains almost everything that you need to mod your game. You only need to follow the steps that apply to the types of mods that you want to install. The steps are not difficult, but take your time reading through the information, and only change a few things at a time. If you're struggling, try working through the tutorial with a friend or family member. After all, two heads are better than one!
    Most community members had never modded any games before, but have been able to install all the mods that they want to use using the tutorials and information from our community. If you run into any issues on your modding journey, we're always happy to help. Read through chapters 13 and 14 first to check for common issues. If nothing in the tutorial helps you, you can visit Chapter 15 to see how to properly ask for help in the #help❗ channel of our Discord server.
    If you're more of a visual learner, this tutorial will gradually be filled in with video tutorials on our YouTube Channel. You can already find some older videos there that may contain helpful information. The Library of Links is your one-stop shop for all additional links that you may need.

Marvel Mods Discord Server

Library of Links

Marvel Mods YouTube Channel

Helpful Tips
    Before you get started, there are a few more things you need to know that will make modding (and using this tutorial) much easier.
    First, enable file extensions and hidden folders in File Explorer. To do this on Windows 10, go into any window of File Explorer and click "View" at the top. Check the boxes for "File name extensions" and "Hidden items". On Windows 11, go into any window of File Explorer and click "View," go to "Show", and click "File name extensions."

    Next, Windows Defender or other antivirus programs may say that the programs or mods here are unsafe or contain some sort of virus. All the mods and programs have been tested to be safe by our community. If you have any concerns about a download, you can ask in our Discord server. You can set these programs and your game files to be on your antivirus program's exception list to prevent any issues. Each antivirus software has a different process for this, but you can easily find out how to do this online.
    In this tutorial, I've put some information inside of sections that can be expanded. This makes it easier to look through the information and only expand what you need to see. Whenever you see one of these sections, it will say "Expand to see Steps". Click on the bar to expand it, and you'll see the additional information.

    Lastly, if you see an image that's too small, you can click on it to make it bigger. When you're done with the image, you can click on it again to make it smaller. This will only apply to static images; gifs will be shown in their original size.

Where to Go Next
    To get started modding the game, go to Chapter 2 of this tutorial. If you have a particular topic you want to know more about, you can visit the chapter that discusses it. Each chapter is linked below in the Table of Contents. Each chapter also has links that will tell you where to go next. Just click the link and you'll go to the chapter that you need! 

Table of Contents

• Chapter 1: Welcome and Introduction
• Chapter 2: Getting and Installing the Game
• Chapter 3: Extracting and Rebuilding Assets
• Chapter 4: Installing Base Mods (This is a placeholder chapter. MUA1 consoles have no base mods yet.)
• Chapter 5: Installing Character Mods and Boosters
• Chapter 6: Editing the Herostat
• Chapter 7: Editing Data Files
• Chapter 8: Installing Skins, Portraits, and 3D Heads
• Chapter 9: Installing Sounds
• Chapter 10: Installing Misc Mods and Loose Files
• Chapter 11: Playing the Game
• Chapter 12: Additional Useful Links and Tutorials
• Chapter 13: Frequently Asked Questions (FAQ)
• Chapter 14: Troubleshooting
• Chapter 15: How to Report an Issue and Ask for Help

Credits/Thanks
    Man, how can I possibly thank everyone who's helped with this tutorial. There are so many people that have had a hand in different aspects of this tutorial, from giving advice and instructions to creating new useful tools. This list is non-exhaustive, and I would be happy to add you if you're missing. But a huge thanks to ak2yny, BLaw, Ceamonks890, Enchlore, Enigma, jayglass, Kako Clanworth, Lags, LarsAlexandersson, Maegawa, MelloMods, MrKablamm0fish, Nicaras, Norrin Radd, Outsider, Rampage, Teancum, THX, Tony Stark, UltraMegaMagnus, and all the other hardworking members of our community. Thank you for all that you do! If you feel you've contributed to this tutorial and I've forgotten to include your name, please let me know.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 2: GETTING AND INSTALLING THE GAME

By BaconWizard17

Introduction
    This chapter shows how to install the console versions of X-Men Legends II: Rise of Apocalypse. Most of the XML2 mods on the forums are created for the PC version of the game, so the consoles do not have as many mods available. The console releases of the game have been archived, meaning that a free, legal download of the game is now available.

YouTube video for this chapter (Coming soon!)

Downloading the Game
    If you don't already own the game, you can find a free, legal, archived copy of each version of the game on Archive.org. Here are the links:

• GameCube
• PS2
• PSP
• Xbox

    Even if you do have a physical copy of the game, it's best to download the archived copy so that you can follow along and have the exact same files. Here's how to properly download the different versions:

Expand to see steps

• Go to the download link provided above.
• On the right side of the screen, download the file. Depending on the download, you may need to download a different file:
  • GameCube: Download the "ZIP" file
  • PS2: Download the "ZIP" file
  • PSP: Download the "ISO IMAGE" file
  • Xbox: Download the "ZIP" file
  
• A download for the game will begin. Once the file has downloaded, proceed below to learn how to install/use the game.

Playing the Game on An Emulator
    One method for playing the game on consoles is with an emulator. Emulation is the easiest way to play the console versions. A few notes on emulators:

• Most emulators are available for PC. Some are available for other devices, such as mobile phones. However, modding programs are only compatible with PCs. If you're emulating on another device, you will need a PC to set up the files.
• PCSX2 and xemu require you to have certain files (such as BIOS or firmware) from an actual console. They will not work without these files. Per our rules, we do not support discussions of piracy in our community.
• This tutorial will not discuss how to set up or use emulators. All of these programs have their own dedicated communities and tutorials online. You'll be able to easily find resources if you look.

    If you're choosing to emulate on PC, you may want to play the PC version instead. Most mods on the forums are available for the PC version. You can learn more about modding the PC version in the XML2 Mod Installation Guide for PC - MO2 Method and the XML2 Mod Installation Guide for PC - Direct Method.
    Each console has its own emulator. Here's a list of the available console emulators for PC:

Expand to see emulators

Console	Emulator	Additional Information
GameCube	Dolphin	None
PS2	PCSX2	None
PSP	PPSSPP	None
Xbox	xemu or CXBX Reloaded	Both CXBX Reloaded and xemu emulate the game well. However, CXBX has an issue with looping sounds not stopping when they should. xemu does not have this issue, but it is slightly more difficult to set up.

Playing the Game on a Modded Console
    Many people prefer to play the modded games on a console instead. However, MODDED GAMES CANNOT BE PLAYED ON A STOCK CONSOLE. You must use a modified console to play modified games. Different consoles have their own online guides and communities if you want to learn to modify your own console. A quick google search for "how to mod a (name of your console)" will generally get you lots of useful results. You can also purchase modified consoles online in different places.
    Note: other terms for a modified console include "softmodded", "hardmodded", "mod chipped", "jailbroken", or "hacked". This tutorial will use the terms "modded" or "modified."

Final Notes
    Before continuing through this tutorial, I recommend making a full backup of your game files. To do this, simply copy your downloaded file and paste it in another place. I recommend compressing it into a .zip file or .rar file and putting it on a flash drive for safekeeping. You can find a tutorial on how to do that here.

Game Limits
    Before you start modding your game, you can get familiar with the game's limits. This isn't required, but it will help avoid issues when modding. This game is old, so it can have issues if you exceed the limits set by the developers. For consoles, very few (if any) limits have been documented. If you're interested in helping with these efforts, feel free to come by our Discord server and talk to the folks there! GameCube limits can be found in the XML2 GCN Limit Documentation topic. PC limits can be found in the XML2 Limit Documentation topic, and some may be the same as the consoles.


Where to Go Next
    Before you can begin installing mods, you will need to understand the file structure of the console versions. Proceed to Chapter 3 of this tutorial to learn more.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 3: EXTRACTING AND REBUILDING ASSETS

By BaconWizard17

Introduction
    Console releases of X-Men Legends II: Rise of Apocalypse have their assets stored in a more compressed way, making it more difficult to mod them. This chapter shows you how to extract and rebuild the assets.

YouTube video for this chapter (Coming soon!)

Extracting and Rebuilding the ISO
    The ISO is the outer-most layer of compression for the game. The ISO is a digital version of the actual disc. All versions of the game come as an ISO and must be extracted. Additionally, some emulators and modded consoles require the game to be rebuilt into an ISO to properly play. Standard Windows ISO methods (like mounting) can't be used. Here's an overview of special programs that you need to use for the console releases:

Expand to see steps

    The ISO programs that are available for each console differ. This tutorial will not show you how to work these programs, as each one is different. However, I will provide a link to each program and explain when it should be used. You can find more in-depth tutorials for these programs online. Here's a table with all that information:

Console	Extract Method	Rebuild Method
GameCube	Dolphin Emulator* (recommended) or GCRebuilder. You must use the same program to extract and rebuild the ISO.	Dolphin emulator does not require the ISO to be rebuilt, but you can do it if you want. For a modded console (or Dolphin Emulator if you choose to), use Dolphin Emulator* (recommended) or GCRebuilder to rebuild the ISO. You must use the same program to extract and rebuild the ISO.
PS2	UltraISO* (recommended) or Apache3. You must use the same program to extract and rebuild the ISO.	UltraISO* (recommended) or Apache3. You must use the same program to extract and rebuild the ISO.
PSP	UMDGen (recommended) or UltraISO*. You must use the same program to extract and rebuild the ISO.	UMDGen (recommended) or UltraISO*. You must use the same program to extract and rebuild the ISO.
Xbox	XDVD Mulleter	CXBX Reloaded and modded consoles do not require the ISO to be rebuilt. For xemu, the game must be rebuilt into an XISO format using Extract XISO GUI

    *UltraISO has a free version and a paid version. The free version can't be used to rebuild large ISOs that are the size of XML2. The paid version requires a code to access. Remember that discussions of piracy are not allowed within our community.
    Once you have the necessary program(s), here's the general process for extracting and rebuilding the ISO:

• Create a folder to store the game and its WIP files. I recommend a folder on your documents or desktop.
  
  
• Inside this folder, create two folders: Extracted Files and Rebuilt ISO
  
  
• If your game downloaded as a .zip file, extract it from the .zip file.
  
  
• Place the ISO inside the Extracted Files folder.
  
  
• Use the required tool to extract the ISO. The Extracted Files folder should be the output directory.
  
  
• Delete the ISO (or back it up to a safe place). You only need to extract the ISO once. You can work from the same extracted files over and over.
• Make a backup of the extracted files just in case you mess something up. To do this, simply copy your Extracted Files folder and paste it in another place. I recommend compressing it into a .zip file or .rar file and putting it on a flash drive for safekeeping. You can find a tutorial on how to do that here.
• Using the methods in the rest of this chapter (and the rest of this tutorial), edit your files to install the mods that you want.
• If necessary, rebuild the ISO for your game using the required program. The input directory will be Extracted Files, and you should output to Rebuilt ISO.
  
  
• If your console or emulator required you to rebuild the ISO, you can now send the ISO to the console or copy the ISO to the emulator's game directory. If the console or emulator does not require the assets to be rebuilt, you can copy the contents of your Extracted Files to the emulator's game directory or send this to your console. Each console and emulator has a different process for this, so be sure to check out the right methods for what you're using.

Extracted File Contents
    In the previous section, you learned how to extract the contents of the console ISOs. The game data for each version is in the same structure, but it can be found in different places because each console requires different files to run. Here's how to find the important files for modding for each version of the game:

Expand to see steps

    Regardless of your version of the game, there are always 2 main folders related to the game's assets that you will generally interact with: sounds, and z. Here's how to find these on each console:

• GameCube: It will depend on the extraction method.
• PS2: The two folders can be found at the root of extracted files.
• PSP: The two folders can be found in PSP_GAME\USRDIR of the extracted files.
• Xbox: The two folders can be found at the root of extracted files.

    Once you know where to look to find the common folders, you can learn more about extracting files. Proceed below.

The assetsfb File
    Within the z folder of each version of the game is a file called assetsfb.wad, which is extremely important to the console versions. Here's how to access it and how it works:

Expand to see steps

    Like previously mentioned, assetsfb.wad is a very important file for the console releases. It can be found in the z folder. In order to access it, you will need an archive software like WinRAR or 7-zip.
    This file on the GameCube, PS2, and Xbox cannot be modified normally. You must replace assetsfb.wad with a custom version for these consoles. The PSP does not have this issue. Here's the download:

• GameCube
• PS2
• Xbox

    Within assetsfb.wad, you'll find many of the common game folders, like actors, data, or hud. However, you'll see that there aren't many files in these folders. That's because many files are packaged away in FB packages. These can be found in packages\generated, and the next part of this chapter tells you how to modify them. Unlike the PC version, packages contain files instead of simply referencing them. Many mods only require you to drop files into assetsfb.wad, and they don't require you to extract/rebuild FB packages.

FB Tools
    Unlike the PC version, packages actually contain files on consoles, rather than just referencing them. The console packages are .fb files. There are times (such as editing data files or installing skins) where it is necessary to edit the contents of the packages. In order to do so, you need proper tools. Here's how to set them up:

Expand to see steps

    In order to properly extract and rebuild the fb packages, you'll need to download the FB Tools from the latest release of the Marvel Mods Batch Scripts. Here's how to properly install those:

• From the download, pick the "FB Tools" option.
  
  
• Extract the file that you downloaded.
  
  
• You'll see a folder (FB Tools) and a batch file (FBTools.bat). Go into the FB Tools folder first.
  
  
• Take the files from the FB Tools folder and move them to C:\Windows. This will allow you to run the operations in any folder.
  
  
• Next, move FBTools.bat anywhere that's convenient for you to access, such as your Desktop. Later on if you install QuickBatch, you can keep FBTools.bat in the same place as QuickBatch.
  
  

    The batch files is the tool that you actually use to extract and rebuild fb files. Before you use it, there are a few configuration options that you have the option to change (although you don't have to; the default options will work for most people). Here's how:

• Right click on the tool and choose to edit it with your text editor of choice.
  
  
• The 3 options that you can change are in lines 14, 16, and 18:
  • Line 14: subfolder. This option lets you control if the extracted files are added to a subfolder or not.
    • If you are extracting multiple packages, it is a good idea to use subfolders, especially if you're extracting multiple maps. If that's the case, change it to say set subfolder=true. This option is much safer, because you'll never overwrite a file from another package. On consoles, the packages for maps all have a file that is different but shares a name, so you should always have this option set to true when extracting maps. The only downside to this option is that you have to replace multiple files individually.
    • If you are only extracting one package, or you're extracting multiple packages for one skin for a playable character, then you can change it to say set subfolder=false. Do not do this if you're extracting more than one map package.
  • Line 16: deletepkg. This option lets you control if pkg files extracted with the tool are deleted. These files aren't needed for most players, so you can leave this line alone (set deletepkg=true).
  • Line 18: copybuild. This option lets you control if a separate build batch file is added to the extracted files. This generally isn't necessary, so you can leave this line alone (set copybuild=false).
  

Extracting and Rebuilding FB Packages
    Once you have the tools to edit the fb packages, you'll be able to extract and rebuild them. Here's how to do that:

Expand to see steps

• In assetsfb.wad, locate an fb file that you want to edit the contents of. A mod will generally tell you which fb file you need to edit, if any. Later chapters of this tutorial will tell you which fb files to pick for certain types of mods as well. For now, I'm just going to demonstrate the overall process. In this case, I'm looking at the two packages for Wolverine's main skin.
  
  
• Go to the place where your game is stored. Create a folder called WIP. Inside the WIP folder, create a descriptive folder for these packages. For this example, I'll create one called Wolverine.
  
  
• Drag the selected fb packages from assetsfb.wad to your new folder.
  
  
• Drag and drop your selected package(s) onto FBTools.bat. The program will run through several lines of code and then exit. If you don't see the several lines of code, then you didn't properly install the FB Tools to C:\Windows. Warning: drag and drop batch files only support up to 10 files at a time. If you want to extract more than 10, you'll need to place the batch file in the same folder as the fb files and double click it to run it.
  
  
• The contents of the package will be extracted, and each package will have a cfg file created as well. If you picked set subfolder=true, the files will be in a subfolder with the same name as the package. If you picked set subfolder=false, they'll be in the same folder as the package(s). Since I'm only editing the packages for one skin, I picked set subfolder=false, and the files were extracted to the same folder as the packages.
  
  
• Make any necessary modifications to the packages. A mod (or later chapters of this tutorial) will tell you what to change. This can include replacing files (which is more common) or adding files (which also requires you to edit the cfg file, but is less common).
• Drag and drop your selected cfg file(s) onto FBTools.bat. The program will run through several lines of code and then exit. Warning: drag and drop batch files only support up to 10 files at a time. If you want to extract more than 10, you'll need to place the batch file in the same folder as the fb files and double click it to run it.
  
  
• If there wasn't a package in the folder, a new one will be created. If there was a package in the folder, then its "Last Modified" date will be update. If this doesn't happen, then you didn't properly install the FB Tools to C:\Windows.
  
  
• You can now drag and drop these files back into the correct place in assetsfb.wad.
  
  
• If the "Modified" date changes to be correct in assetsfb.wad, you'll know that the fb files were overwritten successfully..
  
  

Where to Go Next
    Now that you understand how to edit the various files in the console versions, you can begin installing mods! You can proceed to any chapter that discusses a mod that you want to install. The console releases of XML2 do not have any base mods available right now, so you can skip Chapter 4 of this tutorial.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 4: INSTALLING BASE MODS

By BaconWizard17

Introduction
    Unlike the PC, the console releases of XML2 don't currently have any package mods. Character mods are the main type of mods for those versions of the game. This section is a placeholder until the release of the X-Men Legends 2 Ultimate Patch (X2UP).

Where to Go Next
    The next type of mod that you can install is character mods and boosters. Character mods are individual new characters that you can add to your game, and boosters are mods that modify existing characters and mods. Proceed to Chapter 5 of this tutorial to learn how to install these mods. If you have another topic that you want to learn about instead, you can move on to that chapter instead.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 5: INSTALLING CHARACTER MODS AND BOOSTERS

By BaconWizard17

Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) is complete, this tutorial is going to be unfinished. However, you can use Chapter 5 of the MUA1 Mod Installation Guide for Consoles for a general idea of how to install equivalent mods for XML2. Here are the important differences:

• Character mods can be found in the XML2 Console Releases Board

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 6: EDITING THE HEROSTAT

By BaconWizard17

Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) is complete, this tutorial is going to be unfinished. However, you can use Chapter 6 of the MUA1 Mod Installation Guide for Consoles for a general idea of how to edit the herostat for XML2. Here are the important differences when using OpenHeroSelect:

• With XML2, use the xml2/xml folder instead of the mua/xml folder.
• You can control character unlocks in the XML2 roster config files, but you can't control which characters are the starting characters.
• XML2 does not use roster layouts, so OHS will skip this step for XML2. However, it will ask about the roster size. The PSP allows 23, and the other consoles allow 19.
• IMPORTANT: In the console versions, the herostat can be found in two places: the data folder and permanent.fb (the permanent package) in packages\generated\maps\package. The game reads the herostat that is found in the permanent package, so you will need to decompile that package using the steps found in Chapter 3 of this tutorial and replace the herostat there. If OHS creates a new_game.py file, it goes in scripts/menus within assetsfb.wad.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 7: EDITING DATA FILES

By BaconWizard17

Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) is complete, this tutorial is going to be unfinished. However, you can use Chapter 7 of the MUA1 Mod Installation Guide for Consoles for a general idea of how to edit data files for XML2.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 8: INSTALLING SKINS, PORTRAITS, AND 3D HEADS

By BaconWizard17

Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) is complete, this tutorial is going to be unfinished. However, you can use Chapter 8 of the MUA1 Mod Installation Guide for Consoles for a general idea of how to install skins for XML2. Here are the important differences:

• Skins are referenced differently in the herostat for XML2. There can be up to 9: skin, skin_astonishing, skin_aoa, skin_60s, skin_70s, skin_weaponx, skin_future, skin_winter, and skin_civilian. That's the order that they'll appear when cycling through skins.
• In addition to having conversation portraits (HUDs), XML2 skins use 3D heads. These go in ui\models\mannequin
• The PSP version of XML2 is the most restrictive when it comes to skin support. Only reskins from XML2 PSP, MUA1 PSP, and XML2 PSP are supported.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 9: INSTALLING SOUNDS

By BaconWizard17

Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) is complete, this tutorial is going to be unfinished. However, you can use Chapter 9 of the MUA1 Mod Installation Guide for Consoles for a general idea of how to install sounds for XML2.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 10: INSTALLING MISC MODS AND LOOSE FILES

By BaconWizard17

Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) is complete, this tutorial is going to be unfinished. However, you can use Chapter 10 of the MUA1 Mod Installation Guide for Consoles for a general idea of how to install misc mods for XML2. Here are the important differences:

• Misc mods can be found in the XML2 Misc Modifications board of the forums

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 11: PLAYING THE GAME

By BaconWizard17

Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) is complete, this tutorial is going to be unfinished. However, you can use Chapter 11 of the MUA1 Mod Installation Guide for Consoles for a general idea of how to install misc mods for XML2. Here are the important differences:

• Use Chapter 13 of this tutorial to try to determine your issue and solve it.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 12: ADDITIONAL USEFUL LINKS AND TUTORIALS

By BaconWizard17

Introduction
    You're almost at the end of this tutorial! This chapter contains a series of useful links for additional information related to modding your game.

General Helpful Links

• Library of Links: Links to all the important content on the site.
• ak2yny's YouTube playlist: A YouTube playlist with a variety of tutorials from different creators. Some of these videos are older and may be outdated.

Gameplay

• Cheat Codes: A list of cheat codes for all games.
• Online Co-Op with Parsec: Learn how to play online with your friends! This is only for emulators.

Additional Modding

• Fixing Clashing Mods: Fix two mods that share the same character number.

Creating Your Own Mods

• The Outsider's Guide to Modding: Learn how to create your own character mods.
• Marvel Mods Modeling Tutorial: Learn how to create new skins and custom models.
• Alchemy 5 Texture Replacement Method: Learn how to retexture existing default and custom assets. This only works with XML2 PSP.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 13: FREQUENTLY ASKED QUESTIONS (FAQ)

By BaconWizard17

Introduction
    This chapter covers some frequently asked questions related to modding XML2. Search through here for answers to questions that you may have during the modding process.

Common Game Errors

• Q: Why is my mod/game not working?
  
  • A: You'll have to be more specific. What issues are you having? When do they happen? Answer these questions to yourself, and then use this FAQ to find solutions.
• Q: Why is my game crashing/freezing/locking up/stuck on a loading screen/not launching?
  
  • A: There are several possible causes for this. Check out our troubleshooting guide in Chapter 14 of this tutorial.
• Q: Why are character powers not functioning properly in my game?
  
  • A: There are several possible causes for this. Check out our troubleshooting guide in Chapter 14 of this tutorial.
• Q: Why are new mod characters locked whenever I try to select them?
  
  • A: Character mods will be locked in-game whenever you first add them. If you use OpenHeroSelect (OHS), you can unlock characters through that program. If you're editing the herostat manually, you can unlock characters through a script. For more information on this, check out Chapter 6 of this tutorial.
• Q: Defaultman appears whenever I remove Storm, Magneto, Wolverine, or Cyclops. Why is that?
  
  • A: Defaultman is a placeholder character that fills in when the game can't find a character. You can remove him at the next extraction point for a proper character.
• Q: The new characters that I added don't have a portrait in the character select screen. What do I do?
  
  • A: You will need to add their portrait to packages\generated\maps\package\menus\characters_heads.fb in assetsfb.wad.
• Q: My character has a power where they swap skins, but they don't change to the right skin. Why is that?
  
  • A: This means that the skins aren't hex edited. Learn more about hex editing in Chapter 8 of this tutorial.
• Q: In Murderworld, the robots aren't taking the appearance of my character. Why is that?
  
  • A: This means that the skins aren't hex edited. Learn more about hex editing in [Chapter 8 of this tutorial.
• Q: What do I do if my question isn't answered here?
  
  • A: Go to Chapter 15 of this tutorial to learn how to properly ask for help.

Setup, Graphics, and Gameplay

• Q: Does online play or multiplayer or coop/co-op still work?
  
  • A: No, not natively, since the servers were shut down for a long time ago. Different modded consoles may have their own ways of playing online. Communities for those consoles are a good place to look for that information. For emulated games, you can use a program called Parsec. The guide for that is in Chapter 12 of this tutorial.

Locating and Downloading Mods

• Q: I can't find a particular mod, booster, or skin. I've checked the catalogs and the search bar. What do I do?
  
  • A: You can check Ceamonks890's archive, as he's backed up almost everything. If you can't find it there either, then it probably doesn't exist.
• Q: The link to a wanted mod, booster, or skin is broken. What should I do?
  
  • A: First, let us know of the broken link, so we can replace it. Then, check Ceamonks890's archive as he has backed up almost everything.
• Q: I want to request a new mod, booster, or skin for someone to create. How do I do that?
  
  • A: Currently, most modders do not accept requests. If a modder does state that they accept requests, you can ask them nicely, once. If they turn you down, do not pester them. If you can't find someone to take your request, you can post about it in the the common request topics or in the #suggestion-box channel on our Discord server, but keep in mind that no one is obligated to take your suggestion. Keep in mind that the best person to create a mod is you! Chapter 12 of this tutorial has a wide variety of tutorials for making your own mods.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 14: TROUBLESHOOTING

By BaconWizard17

Introduction
    This chapter is a troubleshooting guide for common issues with XML2. You can find solutions to the most common problems here.

Game Crashes
    This section is for game crashes. The following are considered crashes:

• If the game closes unexpectedly
• If the game freezes and does not unfreeze
• If the game does not launch
• If the game gets stuck on an infinite loading screen
• If the emulator gives some sort of error

Expand to see solutions

    Different types of crashes and their solutions:

• The game does not launch
  
  • There are a few possible reasons for this, depending on when it occurs in the modding process:
    
    • After changing the herostat: If you exceed the roster size limit for your version of the game (19 for most consoles, 23 for PSP), the game will crash when you try to launch it. If you're using OpenHeroSelect (OHS) to edit your herostat, make sure that you're selecting the correct roster size for your version of the game. If you're using XMLBCUI, make sure that you are not adding too many characters to your roster.
    • If none of these issues are the cause, it's possible that you have a corrupt file or some similar issue. The only solution is to restore the default files and try again. Test after installing each mod to see what causes the issue.
• The game crashes when you start a new game (before or after the opening cutscene):
  
  • This type of crash is less common, but it can also be the hardest to diagnose. Here are a few possible solutions:
    
    • First, make sure that you delete your existing save files.
    • If this doesn't solve your issue, it's possible that you have a corrupt file or some similar issue. You may need to start fresh and reinstall mods, checking them one at a time.
• The game crashes when you select a character:
  
  • There are a few possibilities here:
    
    • If the character's character select portrait is also missing from the character select screen, then this means that you didn't install the character correctly or at all. Remember that adding the character to the herostat is only part of the process of installing a character, and the character's files must be installed in the correct place. Revisit Chapter 5 of this tutorial to see how to properly install a character.
    • If the character's character select portrait does appear, but selecting them crashes the game, it's possible that the skin file is missing/corrupt. This is unlikely with released mods, but it can happen if you modified or hex edited the skin incorrectly. It can also happen if the skin is not compatible with your console. Download a fresh, unmodified copy of the skin and check its compatibility. Then, you can reinstall it. You can learn more in Chapter 8 of this tutorial.
• The game crashes during a loading screen:
  
  • This means that your currently selected team has exceeded one of the game's limits. Reduce your team to 2 or 3 characters and try again. If 2 or 3 won't work, try using one character by themselves. You can find more information about limits in the XML2 PC Limit Documentation thread and the XML2 GCN Limit Documentation topic.

Power Malfunctions
    There are many ways in which a power can fail, but there are usually just a few causes for this. Malfunctions include:

• Effects not appearing
• Powers not activating
• Incorrect animations
• Powers doing no damage
• Boosts/passives not applying to characters
• Characters not swapping to the right skin

Expand to see solutions

    Here is a general guide for dealing with these issues:

• Skin-related issues (like if a character swaps to the wrong skin) generally occur if the skin is not hex edited correctly. Learn more about hex editing in Chapter 8 of this tutorial.
• For other power issues, there are several things you can check. First, if you modified any data files (.engb, .xmlb, .pkgb, etc.), including the herostat, make sure that you start a new game and delete your old save files. This is a required step and will help with many power issues. If you've already done this and it hasn't helped, try the next option in this list.
• Next, reduce the size of your team. Instead of using 4 characters, try using 2 or 3. This will generally help with issues like effects not appearing. If 2 or 3 characters doesn't work, try using just one. If this still doesn't work, try the next option in this list.
• The next thing that you can try is the cheat code to unlock all powers. This will generally solve issues like powers not activating or passives not applying their effects to characters. These errors are more commonly seen if you have a roster hack installed. Cheat codes are linked in Chapter 12 of this tutorial. The cheat code to unlock all powers only works on the currently selected team of characters, and sometimes you have to enter it twice for it to take effect.
• If the above options don't work for you, it's possible that you have a corrupt file. It's also possible that the mod itself has issues. If this is the case, you may need to start fresh and reinstall your mods, checking them one by one.

[BaconWizard17]

XML2  MOD  INSTALLATION  GUIDE  FOR  CONSOLES
CHAPTER 15: HOW TO REPORT AN ISSUE AND ASK FOR HELP

By BaconWizard17

Introduction
    You've gone through the entire tutorial, the FAQ, and the troubleshooting guide, and you still can't find what you're looking for or can't figure out what's wrong. It happens to all of us! This chapter discusses how to ask for help.

Identifying the Issue
    Before reporting an issue, it's important that you're able to say exactly what it is. Here are some tips:

• Determine when the issue is happening. Does it start happening after you do a certain action? Is it only occuring in a certain area of the game? With a certain character?
• Determine when you first noticed the issue. Is it ongoing? Did it start after you installed a certain mod? Has it always been the case for you?
• Determine if there's something that impacts this issue. Do certain actions make it more or less noticeable?

Describing the Issue
    Once you know your issue, you need to be able to properly describe it. Here are some tips:

• Type up a description of what you've found. Be as detailed as you can, and include all the information from above.
• In your description, you should include the game that you're playing (MUA1 in this case), the console that you're using, and the tutorial chapter that covers your issue, if any.
• Also include anything that you've tried to do to fix the issue.
• Lastly, get some visual representations of the issue. Screenshots and screen recordings can tell a lot more than words by themselves. If you don't know how to take screenshots, here is a tutorial for Windows 10. Most of these methods work on Windows 7 and Windows 11 as well. You can use OBS Studio, an open-source (free) screen recording software, to record your screen. The built-in Xbox Game Bar in Windows 10/11 also allows you to record footage from the game easily.

Reporting the Issue/Asking for Help
    Once you've gathered your information, you can ask us for help on your issue. Here's the best way to do this:

• Do not reach out to a modder by DMs to ask them for help. It's best to ask for help publicly.
• For public help, the best place to ask is the #help❗ channel on the Marvel Mods Discord Server. You can also ask for help in the Technical Problems board on our site, but response times will be much slower, and you'll likely be told to come to our Discord server anyways.
• When asking for help, send all the information you've gathered, including the written description and any images/screen recordings.
• Be sure to mention which tutorial chapters you checked to find solutions (such as the FAQ or troubleshooting guide).
• You may not get help right away. Be patient. On the Discord server, if it's been more than a day, you can follow up, but be respectful. Don't tag people unless they're actively helping you, and don't tag people more than once in a row.
• If someone offers to help you, be respectful to them. They may ask you for more information, including additional screenshots.