Marvel Mods

Welcome to Marvel Mods => Rules and Information => Topic started by: BaconWizard17 on January 07, 2023, 04:23PM

Title: [XML2] Mod Installation Guide for PC - MO2 Method
Post by: BaconWizard17 on January 07, 2023, 04:23PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
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 PC version. Specifically, this tutorial covers the Mod Organizer 2 (MO2) method for installing mods. There are two methods for installing mods on PC: The MO2 method and the direct method. The MO2 method is beneficial for the following reasons:
    Although there are more steps when using MO2, it has great benefits in the long run. You will need a 64-bit PC to run MO2, and you also need Windows 10 or 11. If you don't have a 64-bit PC or the correct version of Windows, or you would prefer to use the direct method to install mods, you can check out the XML2 Mod Installation Guide for PC - Direct Method (https://marvelmods.com/forum/index.php/topic,11334.0.html).

YouTube video for this chapter (Coming soon!)



How to Use This Tutorial
    This tutorial is broken up into several chapters:
    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 (https://discord.gg/DtdWGxB)
Library of Links (https://marvelmods.com/forum/index.php/topic,10301.0.html)
Marvel Mods YouTube Channel (https://www.youtube.com/channel/UCwziCGGqerG0k5PBD6EL0gA)



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."

(https://b.l3n.co/i/7TqJoz.png)(https://a.l3n.co/i/7TqV8T.png)

    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.

(https://b.l3n.co/i/7Tq9Jb.gif)

    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.

(https://c.l3n.co/i/7Tqde7.gif)



Where to Go Next
    To get started modding the game, go to Chapter 2 of this tutorial (https://marvelmods.com/forum/index.php/topic,11322.msg203639.html#msg203639). 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



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.
Title: Chapter 2: Getting and Installing the Game
Post by: BaconWizard17 on January 07, 2023, 04:24PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 2: GETTING AND INSTALLING THE GAME

By BaconWizard17



Introduction
    This chapter shows how to install the PC version of X-Men Legends II: Rise of Apocalypse. Most of the XML2 mods on the forums are created for this version of the game. The PC release of the game has 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 the game at this link (https://archive.org/details/xml2dvd). 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 it:

Expand to see steps
  • Go to the download link provided above.
  • On the right side of the screen, choose to download the "ISO IMAGE".
    (https://a.l3n.co/i/7TM5NK.png)
  • Above that, choose to download the "7Z" file.
    (https://c.l3n.co/i/7TMaiZ.png)
  • Downloads for XML2DVD.iso and No Disc EXE.7z will begin. Once the files have downloaded, proceed below to learn how to install the game.
    (https://b.l3n.co/i/7TMh9P.png)



Installing the Game
    Now that you have the game downloaded, you can begin to install it. Here's how:

Expand to see steps
  • Right click on XML2DVD.iso and choose "Mount". Some PCs may not have this option, in which case you'll need to double click on the ISO. If neither option works, use an external program like WinCDEmu (https://wincdemu.sysprogs.org/download/).
    (https://c.l3n.co/i/7TY2Lm.gif)
  • If it doesn't automatically open, go to the drive where the ISO has been mounted in File Explorer. It will be listed on the left side under "This PC". Click to open it.
    (https://a.l3n.co/i/7ToLmq.png)
  • Double-click Setup.exe to begin the installation.
    (https://c.l3n.co/i/7TYil9.png)
  • You'll first be asked which language you want to use. Choose English, as all mods are released in English. Mods will not work if you choose another language.
    (https://a.l3n.co/i/7TYjb2.png)
  • Follow the instructions on the installer. Don't change any of the settings. The default install path will be C:\Program Files (x86)\Activision\X-Men Legends 2. Don't change it. You will be moving it later.
    (https://c.l3n.co/i/7TYIrv.png)(https://b.l3n.co/i/7TYZ4C.png)(https://c.l3n.co/i/7TYgN5.png)
    (https://a.l3n.co/i/7TYtiz.png)(https://b.l3n.co/i/7TY1dT.png)(https://c.l3n.co/i/7TYTa7.png)
  • When the game finishes installing, the installer will ask if you want to create a desktop shortcut. Since you will be moving the game files, say "No."
    (https://c.l3n.co/i/7ToMuA.png)
  • If you haven't installed it before, be sure to also install DirectX9 when prompted.
    (https://b.l3n.co/i/7TDgP1.png)(https://a.l3n.co/i/7TYQt0.png)
  • Once the DirectX installation is complete, press "Finish". When you see the launcher, you'll know that the game has installed. You can now press "Quit", since it won't start when you press "Play".
    (https://b.l3n.co/i/7TYV4D.png)(https://a.l3n.co/i/7TY9Pq.png)
  • Go to No Disc EXE.7z, right click it, and extract it. A new folder will be created with the cracked exe inside.
    (https://c.l3n.co/i/7ToDea.gif)
  • Copy XMen2.exe from this new folder into your game files, replacing the original. This will allow you to play without the disc, and it improves compatibility.
    (https://c.l3n.co/i/7TuKgH.gif)
  • The next thing you'll want to do is move your game to a folder that won't cause any access issues. My recommendation is C:\Games\Activision. To do this:
    • If it doesn't already exist, create the C:\Games\Activision folder.
    • Go to C:\Program Files (x86)\Activision.
    • Select the entire X-Men Legends 2 folder and move it to C:\Games\Activision.
    It is no longer recommended to move your game files to your Documents or Desktop, because this can cause problems with OneDrive. Do not leave the game in C:\Program Files (x86)\Activision, because this will cause issues with administrator access.
    (https://a.l3n.co/i/eSSeaq.gif)
    Before continuing through this tutorial, I recommend making a full backup of your game files. To do this, simply copy your X-Men Legends 2 game 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 (https://support.microsoft.com/en-us/windows/zip-and-unzip-files-8d28fa72-f2f9-712f-67df-f80cf89fd4e5).



Cleaning Up the Game Files
    After backing up your files, you have the option to clean up the game files. This is completely optional and will not impact game performance. However, it removes a lot of useless files and visual clutter. Here's how to do it if you choose to:

Expand to see steps
  • Download the File Cleanup Script from the latest release of the Marvel Mods Batch Scripts (https://marvelmods.com/forum/index.php/topic,11505.0.html).
    (https://c.l3n.co/i/7Tul9Z.png)
  • Extract the .zip file, and you'll see MarvelModsFileCleanup.bat.
    (https://b.l3n.co/i/7TYMCi.gif)
  • Move MarvelModsFileCleanup.bat into your X-Men Legends 2 folder.
    (https://c.l3n.co/i/7TD1dK.gif)
  • Double click the batch file to run it. Type 2 to select X-Men Legends 2. The script will perform the cleanup. 
    (https://c.l3n.co/i/7TDVK2.gif)
  • The script will then allow you to pick if you want to change file extensions and folder names to lowercase. This is optional, but I recommend it because it makes the files look more presentable. Changing the file names to lowercase will take several minutes because there are so many. Sometimes, you may get an access error during the lowercase folder step. This can happen somewhat randomly and inconsistently, but you can rename any lingering folders manually. When the script is complete, you can press Enter. The folders may not appear lowercase until you exit the folder and return to it.
    Note: The gif is sped up significantly so that you can see the whole process. For me, it takes about 5 minutes to change everything to lowercase.
    (https://c.l3n.co/i/7TYcYT.gif)
  • When you're done, delete the script.
    (https://b.l3n.co/i/7TYxSr.gif)



Setting the Resolution
    The resolution of the base game is often too small for modern monitors to properly display the game, which means that the game won't start or will give you an error. To get around this, you should set the resolution before starting the game for the first time. Here's how:

Expand to see steps
  • Download the Resolution Setter for XML2 from the latest release of the Marvel Mods Batch Scripts (https://marvelmods.com/forum/index.php/topic,11505.0.html).
    (https://a.l3n.co/i/lwYC8M.png)
  • Extract the file that you downloaded. You'll get a file called resolutionSetterXML2.bat.
    (https://a.l3n.co/i/7TOF5c.gif)
  • Double click the batch file to run it. You'll first be asked if you want to create a backup profile first. Type Y for yes.
    (https://a.l3n.co/i/7TOxgm.gif)
  • You'll be asked for a name for the backup profile. Name it something like "registryDisplay" and press Enter to accept the name.
    (https://b.l3n.co/i/7TOy3i.gif)
  • You'll get a popup asking if you want to allow the script to edit the registry. Allow it to do so.
    (https://a.l3n.co/i/7TO5Do.png)
  • You'll be asked which profile you want to restore. Type the number next to the profile that you saved in the previous step. (Note: if your game files are stored in the default save folder, C:\Users\(your username)\Documents\Activision\X-Men Legends 2, you'll see all of the game folders listed. Type 0 to see more options and then copy or type the name of the backup profile you created.)
    (https://b.l3n.co/i/7TOaW9.gif)
  • You'll now have the option to change the resolution. Type S to cycle through the available options. When you get to the correct resolution for your monitor, type A.
    (https://c.l3n.co/i/7TH2vv.gif)
  • You'll get a popup asking if you want to allow the script to edit the registry. Allow it to do so.
    (https://a.l3n.co/i/7TH8GC.png)
  • You'll get another popup asking if you're sure if you want to continue. Press Yes.
    (https://b.l3n.co/i/7THWE5.png)
  • One final popup will confirm that the changes have been made.
    (https://c.l3n.co/i/7THiHz.png)



Testing the Game
    Now that you have the game installed, it's a good idea to test it before you start modding. You can also set up the proper resolution for your monitor.

Expand to see steps
  • First, run the game and make sure that it starts. If it doesn't start at all, that means that you didn't install the cracked exe correctly, you didn't move the game files to a non-admin folder, or you didn't properly set the resolution. If you've already tried to run the game and it didn't start, you will have to reinstall the game before you can apply the fixes.
    (https://c.l3n.co/i/7Toa5i.png)
  • If the game starts but you get an error that says "Unable to initialise graphics display. Resolution and FSAA have been reverted to default", then the starting resolution is too low for your computer. Goo back to the section above called "Setting the Resolution."
    (https://a.l3n.co/i/7TDBd5.png)
  • If you get errors stating that various .dll files can't be loaded, this is usually something that can be ignored, and the game will run without issues. If the game still doesn't run, you will need to reinstall it and reinstall DirectX9.
    (https://c.l3n.co/i/7TYhfD.png)
  • If the game runs successfully without using the resolution setter, it will start at 800x600 resolution. Most monitors are higher resolution these days, so now is a good time to change this. Even if you used the resolution setter, you can still customize this and other graphics settings at this point. To get to the settings, go to the "Options" on the main menu screen. You can navigate with the arrow keys and select with Enter on your keyboard. Next, go to the "Advanced Options" by pressing Space or clicking on the option.
    (https://a.l3n.co/i/7TuiZv.png)(https://a.l3n.co/i/7ToWYM.png)
  • In the advanced options screen, you will now be on the resolution options. You can use the arrow keys to cycle left and right. The highest resolution is 1920x1080, but you can go beyond 1920x1080 with this method (https://marvelmods.com/forum/index.php/topic,10578.0.html). You can change any other graphics settings that you want now, such as increasing the anti-aliasing ("FSAA"). The 8x value for FSAA will not work and will cause your graphics settings to not apply. Unfortunately, there is no method for running the game in windowed mode. When you're satisfied, scroll down to "Accept" and press Enter on your keyboard. The game will announce that the changes will apply when you restart the game.
    (https://c.l3n.co/i/7Tu0u5.gif)
  • The next time you start the game, it will be at the resolution that you set.
    (https://c.l3n.co/i/7TuP9z.png)



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 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. Not all limits have been documented yet, but the ones that we are aware of can be found in the XML2 Limit Documentation topic (https://marvelmods.com/forum/index.php/topic,10885.0.html). 



Where to Go Next
    Now that you've installed the game, you can install Mod Organizer 2 (MO2). You'll need this in order to begin installing mods. These instructions are in Chapter 3 of this tutorial (https://marvelmods.com/forum/index.php/topic,11322.msg203640.html#msg203640).
Title: Chapter 3: Setting up MO2
Post by: BaconWizard17 on January 07, 2023, 04:24PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 3: SETTING UP MO2

By BaconWizard17



Introduction
    Mod Organizer 2 (MO2) is a program for installing, organizing, and managing mods. It's incredibly useful. It allows you to install mods to your game without overwriting any files. This means that you can easily install and uninstall mods and restore default content. It also makes it much easier to remove files that are causing problems in your game. With MO2, you don't have to reinstall the game any time you mess something up. It allows you to always know what mods you have installed, and you can easily reinstall mods that are updated. Note that MO2 only works on 64-bit PCs, and you must have Windows 10 or 11.

YouTube video for this chapter (Coming soon!)



Adding XML2 to an Existing Installation of MO2
    If you already have MO2 for another game (such as MUA1), you can easily add XML2 as a new game without having to install a new instance. Here's how to do it:

Expand to see steps
  • First, it's important that you have a global instance of Mod Organizer 2 set up, not a portable instance. Portable instances only support one game. If you set up MO2 for MUA1 using the MUA1 PC Mod Installation Guide - MO2 Method (https://marvelmods.com/forum/index.php/topic,11326.0.html), you already have a global instance. You may have one from another game as well.
  • The first thing that you need to do is download the handler plugins for XML2. You can download them here (https://marvelmods.com/forum/index.php/topic,11447.0.html). The file is called XML2.MO2.Plugins.zip.
    • The current version of the plugin-in require MO2 version 2.5.2 or later. If you have an older version, it's recommended that you update to the latest version. Otherwise, the plug-ins won't be compatible. Come speak to us on the Discord server if there's something preventing you from updating to the newest version.
    (https://a.l3n.co/i/ejH469.png)
  • After downloading the plugins, you'll need to extract them. Right click and choose the option to do so.
    (https://b.l3n.co/i/ejOS5x.gif)
  • Once you've extracted the plugins, go into the extracted folder. You should see a basic_games folder, XML2Patch.zip, and XML2Tools.py. Select them all and put them in your MO2 files in MO2\plugins. This folder is in the install location for MO2. By default, this is C:\Modding, but you may have installed it elsewhere. If you don't install this plugin, MO2 will not be able to recognize XML2, and you won't be able to use MO2. Make sure you add this plugin when MO2 is not open.
    (https://a.l3n.co/i/ejOvH1.gif)
  • The next step is to launch MO2. Go up to the top left of the screen and click on the Instance Manager (the very top left button). This will bring up the "Instance manager" window. Once you're there, click the button at the top left that says "Create new instance". That will bring up the "Creating new Instance" window. To continue, go to the part of this section called "Configuring MO2."
    (https://a.l3n.co/i/7ESuU5.gif)



Installing MO2
    If you haven't previously installed MO2, or if you previous installation was not a global installation, you'll need to install MO2 before you use it. Here's how:

Expand to see steps
  • You can download MO2 from this link on NexusMods (https://www.nexusmods.com/skyrimspecialedition/mods/6194?tab=files), where you can also find more information about the program and its creators. Go to the Files tab and choose "Manual Download." You need to have an account with NexusMods to be able to download files. You must download version 2.4 or later, which should be the default option. If you don't want to create a NexusMods account, you can also download it directly from the program's GitHub link (https://github.com/ModOrganizer2/modorganizer/releases/latest).
    (https://c.l3n.co/i/7ESNZz.png)
  • Next, double-click the installer to start it. If Windows Defender tells you not to run the program, simply press "More info" and then "Run anyway." It has been tested to be safe as long as you are downloading it directly from the creators.
    (https://a.l3n.co/i/7ESPsT.png)
  • The installer will now come up. First, accept the licensing agreement. Then, choose where the main files for MO2 should be installed (the default location, C:\Modding\MO2, is recommended). Choose the settings for a recommended install. You can choose to create a start menu folder and desktop shortcut if you wish. I recommend creating a shortcut. At the end, you'll be asked to confirm your choices, and then the program will install.
    (https://c.l3n.co/i/7ESfub.png)(https://a.l3n.co/i/7ESUA7.png)(https://c.l3n.co/i/7EScVr.png)
    (https://b.l3n.co/i/7ESXnF.png)(https://a.l3n.co/i/7ESb53.png)(https://c.l3n.co/i/7ESxE0.png)
  • When you've finished the installation, don't launch MO2 just yet. You can now press "Finish" on the installer.
    (https://a.l3n.co/i/7ESyOD.png)
  • The next thing that you need to do is download the handler plugins for XML2. You can download them here (https://marvelmods.com/forum/index.php/topic,11447.0.html). The file is called XML2 MO2 Plugins.zip.
    • The current version of the plugin-in require MO2 version 2.5.2 or later. If you have an older version, it's recommended that you update to the latest version. Otherwise, the plug-ins won't be compatible. Come speak to us on the Discord server if there's something preventing you from updating to the newest version.
    (https://a.l3n.co/i/ejH469.png)
  • After downloading the plugins, you'll need to extract them. Right click and choose the option to do so.
    (https://b.l3n.co/i/ejOS5x.gif)
  • Once you've extracted the plugins, go into the extracted folder. You should see a basic_games folder, XML2Patch.zip, and XML2Tools.py. Select them all and put them in your MO2 files in MO2\plugins. This folder is in the install location for MO2. By default, this is C:\Modding, but you may have installed it elsewhere. If you don't install this plugin, MO2 will not be able to recognize XML2, and you won't be able to use MO2. Make sure you add this plugin when MO2 is not open.
    (https://a.l3n.co/i/ejOvH1.gif)
  • Now that you've done all this, launch MO2, and then proceed to the part of this section called "Configuring MO2."



Configuring MO2
    Now that MO2 is installed and ready to recognize XML2, it's time to configure a new instance for it. You must do this before you can install mods. Here's how:

Expand to see steps
  • Whether you just installed MO2 for the first time, or if you're just adding a new instance, you'll get the dialog for creating a new instance. You should choose the option to create a global instance. Portable instances store their files all in one place, but they only allow one single game. Global instances allow you to manage multiple instances and games from a single installation. So, choose the option for a global instance.
    (https://b.l3n.co/i/7ES5cq.png)
  • Next, browse for your X-Men Legends II game files. Mine are in C:\Users\(my user)\Documents\Activision\X-Men Legends 2\, but yours may be in a different location (you moved them earlier in Chapter 2 of this tutorial). Navigate to this folder and select it.
    (https://a.l3n.co/i/7ESagA.png)(https://b.l3n.co/i/7EShsM.png)
  • If you installed the handler plugin correctly, you'll be able to proceed. If you get an error saying that the game is not recognized, close MO2, go back to the earlier steps, and make sure you correctly installed the plugin file.
    (https://c.l3n.co/i/7Ee2DQ.png)
  • Once you've located your game files, you can choose a name for the instance. The default name will be "X-Men Legends II - Rise of Apocalypse."
    (https://a.l3n.co/i/7EeAAa.png)
  • Next, you'll be able to choose where the specific data for your game is stored. The most important thing that will be stored here are the mods that you install for your game. Make sure it's a folder you can easily find, or one that you know the location of. The default location is C:\Users\(your user)\AppData\Local\ModOrganizer\X-Men Legends II - Rise of Apocalypse. I personally prefer to use a folder that I have set up on my desktop. The choice is up to you.
    (https://b.l3n.co/i/7EeWVe.png)(https://c.l3n.co/i/7Eeivk.png)
  • Next, you may see a screen that asks if you want to connect to your NexusMods account. Feel free to do so, but it's not required, and it won't impact your experience with Marvel Mods. Lastly, you'll see all your settings one last time, and you can either go back and change them or continue along. If you proceed, MO2 will set everything up, and you'll be ready to install mods!
    (https://a.l3n.co/i/7Eej5x.png)



The MO2 Interface
    Before you begin installing mods, you should get familiar with the user interface of MO2.

Expand to see steps
    When you start MO2 for the first time in your instance, you'll get a small tutorial made by the developers of MO2. I would recommend going through it to get a basic understanding of the program, but not all of it is relevant to Marvel Mods content.
    This is the user interface of MO2. There are 4 areas you'll want to be aware of. I'll walk through each of these individually:
  • The toolbar icons
  • The mod list
  • The file list
  • The run section

(https://c.l3n.co/i/7EeIEH.png)

    The toolbar icons have some of the important actions you'll be using often. I've circled the ones that are important for Marvel Mods content. From left to right:
  • The "Switch Instance" icon allows you to switch between any global instances that you have installed with MO2. Through this dialog, you can switch to other games that MO2 manages and add new games as well.
  • The "Install Mod from Archive" icon allows you to install mods to your game. This is how you'll install the majority of the mods you download from Marvel Mods, but don't start using it yet.
  • The "Refresh" icon allows you to refresh MO2. Pressing this will refresh the mod list and files list. This is useful if you make changes to any of the files of your mods outside of MO2.
  • The "Tools" icon contains tools that are useful for modding the game. These tools will be covered later.
  • The "Settings" icon has all the important settings for MO2, including visual settings like theme and icons. You can also find important information here, including file paths.
    • The icons can be a bit confusing, since the icon of tools is for the settings function, and tools function has a different icon. This tutorial will always point out which icon to use so that it's clear.

(https://a.l3n.co/i/ejOfvo.png)

    The mod list shows you all of the mods you currently have installed, as well as important information about them. Right now, you don't have anything there, but mods will appear here when you begin installing them. It will show you information such whether the mods is selected, the name of the mod, its priority, and if there are conflicts with other mods (which is normal).

(https://c.l3n.co/i/7Eegcc.png)

    The file list shows all the files that are currently in use. This includes the base game files, plus the files of any active mods. Any files that exist in multiple mods or in a mod and the base game files will show up in red, meaning that there is a conflict. Conflicts are normal and will occur when you're installing mods. This list will also show you what mod the files belong to, which is useful for debugging.

(https://a.l3n.co/i/7EetgK.png)

    The run section is how you actually launch the game whenever you want to play it. There are a few other options here, such as the ability to change which exe you're running and browse a virtual folder that shows only the active files.

(https://c.l3n.co/i/7Ee13Z.png)



Customizing MO2's Theme
    One other thing that I prefer to do with MO2 before I start modding is change the theme. Feel free to do this too if you'd like, but it's not required. The theme that I pick will be used for the rest of the tutorial, so my MO2 may look a bit different from yours.

Expand to see steps
  • Click to the settings icon in MO2.
    (https://a.l3n.co/i/7EeRDP.png)
  • Go to the "Theme" tab.
    (https://c.l3n.co/i/7EeEWm.png)
  • Click the drop down for "style". Several options will be presented. I prefer "1809 Dark Mode". Press OK once you've selected a theme.
    (https://a.l3n.co/i/7Eek9i.png)
  • MO2 will now have the new theme.
    (https://c.l3n.co/i/7Ee6vo.png)



Priorities in MO2
    Before you get started installing mods, it's important to understand priorities in MO2. The order that you install mods in in MO2 doesn't matter, but the priorities of the mods do matter. Whenever you start installing mods, you'll notice a column appear in the left panel that shows the priority. You'll want to sort the list by this column. If a mod is higher up on the list, it will have a lower priority, so its files can get overwritten in a conflict. If a mod is lower on the list, it will have a higher priority, which means that its files will be more likely to be used if files conflict. Conflicts are normal in MO2 because many mods will have their own version of certain files. So in review:
    The "order" essentially corresponds to the priorities. Throughout this tutorial, I will specify what the priorities of different mods should be. I will also provide a screenshot at the very end of this chapter that shows what priorities I give to different mods in my game.



What to do Next
    Once you've successfully installed and configured MO2, you can begin learning how to use it to install mods! Different kinds of mods are discussed in chapters 4 through 11 of this tutorial. Currently, XML2 does not have any required mods, though this will change in the future. All other mods are optional. Proceed to the section that interests you to move on with the tutorial.
Title: Chapter 4: Installing Base Mods (Package Mods)
Post by: BaconWizard17 on January 07, 2023, 04:24PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 4: INSTALLING BASE MODS (PACKAGE MODS)

By BaconWizard17



Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) (https://marvelmods.com/forum/index.php/topic,11057.0.html) is complete, this tutorial is going to be unfinished. However, you can use Chapter 4 of the MUA1 Mod Installation Guide for PC - MO2 Method (https://marvelmods.com/forum/index.php/topic,10809.msg199944.html#msg199944) for a general idea of how to install equivalent mods for XML2. Here are the important differences:



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 (https://marvelmods.com/forum/index.php/topic,11322.msg203642.html#msg203642) 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.
Title: Chapter 5: Installing Character Mods and Boosters
Post by: BaconWizard17 on January 07, 2023, 04:24PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 5: INSTALLING CHARACTER MODS AND BOOSTERS

By BaconWizard17



Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) (https://marvelmods.com/forum/index.php/topic,11057.0.html) is complete, this tutorial is going to be unfinished. However, you can use Chapter 5 of the MUA1 Mod Installation Guide for PC - MO2 Method (https://marvelmods.com/forum/index.php/topic,11326.msg203746.html#msg203746) for a general idea of how to install equivalent mods for XML2. Here are the important differences:
Title: Chapter 6: Editing the Herostat
Post by: BaconWizard17 on January 07, 2023, 04:24PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 6: EDITING THE HEROSTAT

By BaconWizard17



Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) (https://marvelmods.com/forum/index.php/topic,11057.0.html) is complete, this tutorial is going to be unfinished. However, you can use Chapter 6 of the MUA1 Mod Installation Guide for PC - MO2 Method (https://marvelmods.com/forum/index.php/topic,11326.msg203848.html#msg203848) for a general idea of how to edit the herostat for XML2. Here are the important differences:
Title: Chapter 7: Editing Data Files
Post by: BaconWizard17 on January 07, 2023, 04:24PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 7: EDITING DATA FILES

By BaconWizard17



Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) (https://marvelmods.com/forum/index.php/topic,11057.0.html) is complete, this tutorial is going to be unfinished. However, you can use Chapter 7 of the MUA1 Mod Installation Guide for PC - MO2 Method (https://marvelmods.com/forum/index.php/topic,11326.msg203849.html#msg203849) for a general idea of how to edit data files for XML2.
Title: Chapter 8: Installing Skins, Portraits, and 3D Heads
Post by: BaconWizard17 on January 07, 2023, 04:24PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 8: INSTALLING SKINS, PORTRAITS, AND 3D HEADS

By BaconWizard17



Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) (https://marvelmods.com/forum/index.php/topic,11057.0.html) is complete, this tutorial is going to be unfinished. However, you can use Chapter 8 of the MUA1 Mod Installation Guide for PC - MO2 Method (https://marvelmods.com/forum/index.php/topic,11326.msg203914.html#msg203914) for a general idea of how to install skins, portraits, and 3D heads for XML2. Here are the important differences:
    You can find another explanation on installing skins for XML2 in this post (https://marvelmods.com/forum/index.php/topic,10629.msg203371.html#msg203371).
Title: Chapter 9: Installing Sounds
Post by: BaconWizard17 on January 07, 2023, 04:24PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 9: INSTALLING SOUNDS

By BaconWizard17



Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) (https://marvelmods.com/forum/index.php/topic,11057.0.html) is complete, this tutorial is going to be unfinished. However, you can use Chapter 9 of the MUA1 Mod Installation Guide for PC - MO2 Method (https://marvelmods.com/forum/index.php/topic,11326.msg203915.html#msg203915) for a general idea of how to install sounds for XML2. Here are the important differences:
Title: Chapter 10: Installing Misc Mods and Loose Files
Post by: BaconWizard17 on January 07, 2023, 04:24PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 10: MISC MODS AND LOOSE FILES

By BaconWizard17



Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) (https://marvelmods.com/forum/index.php/topic,11057.0.html) is complete, this tutorial is going to be unfinished. However, you can use Chapter 11 of the MUA1 Mod Installation Guide for PC - MO2 Method (https://marvelmods.com/forum/index.php/topic,11326.msg203916.html#msg203916) for a general idea of how to install misc mods and loose files for XML2. Here are the important differences:
Title: Chapter 11: Playing the Game and Setting up Controls
Post by: BaconWizard17 on January 07, 2023, 04:24PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 11: PLAYING THE GAME AND SETTING UP CONTROLS

By BaconWizard17



Introduction
    Until the X-Men Legends 2 Ultimate Patch (X2UP) (https://marvelmods.com/forum/index.php/topic,11057.0.html) is complete, this tutorial is going to be unfinished. However, you can use Chapter 12 of the MUA1 Mod Installation Guide for PC - MO2 Method (https://marvelmods.com/forum/index.php/topic,11326.msg203917.html#msg203917) for a general idea of how to play the game. Here are the important differences:
Title: Chapter 12: Additional Useful Links and Tutorials
Post by: BaconWizard17 on January 07, 2023, 04:24PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 12: ADDITIONAL USEFUL LINKS AND TUTORIALS

By BaconWizard17



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



General Helpful Links



Gameplay



Additional Modding



Creating Your Own Mods
Title: Chapter 13: Frequently Asked Questions (FAQ)
Post by: BaconWizard17 on January 07, 2023, 04:25PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
CHAPTER 13: FREQUENTLY ASKED QUESTIONS (FAQ)

By BaconWizard17



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



Common Game Errors



MO2 Issues



Setup, Graphics, and Gameplay



Locating and Downloading Mods
Title: Chapter 14: Troubleshooting
Post by: BaconWizard17 on January 07, 2023, 04:25PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
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:

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 (21 for PC), 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 (https://marvelmods.com/forum/index.php/topic,11322.msg203642.html#msg203642) 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 (https://marvelmods.com/forum/index.php/topic,11322.msg203645.html#msg203645).
  • 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 (https://marvelmods.com/forum/index.php/topic,10885.0.html).



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

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 (https://marvelmods.com/forum/index.php/topic,11322.msg203645.html#msg203645).
  • 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.
  • 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, it is extremely difficult to pinpoint the cause when using the Direct method to install mods. You will need to do a fresh reinstallation of the game and test it after adding each mod to see what the possible issue is. If you don't want to have to keep reinstalling your game and mods, you can switch to using the MO2 Method for installing mods (https://marvelmods.com/forum/index.php/topic,11322.0.html).
Title: Chapter 15: How to Report an Issue and Ask for Help
Post by: BaconWizard17 on May 25, 2024, 02:42PM
XML2  MOD  INSTALLATION  GUIDE  FOR  PC  -  MO2  METHOD
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:



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



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: