How To: Use the Game System

Introduction

The 'Game System' essentially allows modders to use multiple installs of Mafia II (2010) and Mafia II: DE (2020). When you first download the Mafia: Toolkit, you will notice there is only two game presets. This new system allows the modder to define a directory path and materials for each game, thus removing the need of constantly editing the setting file for each instance of Mafia II.

How Do I Add A New Game?

To add a new game, you need to open game.xml. It is in the same folder as the Mafia: Toolkit executable. You can duplicate a 'Game' Entry in the XML and replace the newly duplicated entry as your own. Once you load up the Mafia: Toolkit, you should see your new game/instance on the 'Game Selector' form. The initial XML should look like this:

<Games>
	<Game>
		<Name>Mafia II</Name>
		<Description>The original game from 2010.</Description>
		<LogoPath>Resources/m2_logo.jpg</LogoPath>
		<DirectoryKey>M2_Directory</DirectoryKey>
		<MaterialKey>M2_Materials</MaterialKey>
		<Type>MafiaII</Type>
	</Game>
	<Game>
		<Name>Mafia II: Definitive Edition</Name>
		<Description>The remastered version of the game from 2020.</Description>
		<LogoPath>Resources/m2de_logo.jpg</LogoPath>
		<DirectoryKey>M2DE_Directory</DirectoryKey>
		<MaterialKey>M2DE_Materials</MaterialKey>
		<Type>MafiaII_DE</Type>
	</Game>
</Games>

Name of Element	What it Defines
Name	Personalised name of the game/instance.
Description	Personalised description of the game/instance.
LogoPath	If you want, you can change the logo on the Game Selector screen. The size of the image should be 460x215. The path is RELATIVE to the Mafia: Toolkit executable.
DirectoryKey	This is a UNIQUE key. This key will store the directory of the game/instance, so make sure it is unique!
MaterialKey	This is a UNIQUE key. This key will store the material files to load for this game/instance, so make sure it is unique!
Type	This needs to be MafiaII or MafiaII_DE; both control different aspects of the Mafia: Toolkit, so make sure it is correct!