GameMode.dat

Every Game Mode must contain a GameMode.dat file which gives the player details about the Game Mode, defines the folders in which the game should look for content, defines the rules of the Game Mode, and tells the game what to do when a new game is started with the Game Mode.

Example

The following example is made by the game after the game has been started once.

Name|Kolben
Description|The normal game mode.
Version|0.60
Author|Kolben Games
MapPath|\Content\Data\maps\
ScriptPath|\Content\Data\Scripts\
PokeFilePath|\Content\Data\maps\poke\
PokémonDataPath|\Content\Pokémon\Data\
ContentPath|\Content\
LocalizationsPath|\Content\Localization\
WaterSpeed|8
GameRules|(MaxLevel|100)(OnlyCaptureFirst|0)(ForceRename|0)(DeathInsteadOfFaint|0)(CanUseHealItems|1)(Difficulty|0)(LockDifficulty|0)(GameOverAt0Pokemon|0)(CanGetAchievements|1)(ShowFollowPokemon|1)(OverworldPoison|0)(SavingDisabled|0)(SingleUseTM|0)(CanForgetHM|0)(CoinCaseCap|0)
HardGameRules|(OverworldPoison|1)
StartMap|newgame\intro0.dat
StartPosition|1,0.1,3
StartRotation|1.570796
StartScript|startscript\main
StartLocationName|Your Room
StartDialogue|
StartColor|59,123,165
PokémonAppear|0
IntroMusic|welcome
IntroType|1
SkinColors|248;176;32,248;216;88,56;88;200,216;96;112,56;88;152,239;90;156
SkinFiles|Ethan,Lyra,Nate,Rosa,Hilbert,Hilda
SkinNames|Ethan,Lyra,Nate,Rosa,Hilbert,Hilda
SkinGenders|Male,Female,Male,Female,Male,Female

Explanation

Property	Description
Name|	The name to be listed in info portion of the "New Game" menu.
Description|	A brief description of the Game Mode. Displays in the info portion of the "New Game" menu.
Version|	Lists the current version of the Game Mode. Displays in the info portion of the "New Game" menu.
Author|	Lists the author of the Game Mode. Displays in the info portion of the "New Game" menu.
MapPath|	The location the game should look in for map files.
ScriptPath|	The location the game should look in for script files.
PokeFilePath|	The location the game should look in for the wild encounter definition files.
PokémonDataPath|	The location the game should look in for the Pokémon definition files.
ContentPath|	The location the game should look in for the general content files.
LocalizationsPath|	The location the game should look in for the localization files.
WaterSpeed|	The speed at which water should animate (8 is the default value).
GameRules|	Specific rules used in this Game Mode. See below for a list of all possible Game Rules.
HardGameRules|	Specific rules used in this Game Mode on harder difficulties. See below for a list of all possible Game Rules.
StartMap|	The map that the game should place the player in at the start of the game (relative to the MapPath, including subfolders if any).
StartPosition|	The position that the player should have in the StartMap at the start of the game.
StartRotation|	The rotation that the player should have at the start of the game.
StartScript|	A script that the game should execute every time a save file using the Game Mode is started and also when starting a new game (relative to the ScriptPath, including subfolders if any).
StartLocationName|	The name that pops up in the top left corner at the start of the game.
StartDialogue|	Only used if IntroType property is set to 0. Defines the dialogue during the introduction with Prof Oak. Leaving it blank uses the default dialogue.
StartColor|	Only used if IntroType property is set to 0. Sets the color of the background during the intro.
PokémonAppear|	Only used if IntroType property is set to 0. Sets the Pokémon to appear during the intro. 0 = random.
IntroMusic|	Only used if IntroType property is set to 0. Name of the music file to play during the intro (relative to the Songs folder, including subfolders if any) without the extension.
IntroType|	Sets the type of intro that the Game Mode should use. 1 = 3D Intro (which allows for more creative freedom but requires scripting), 0 = 2D Intro (easier to use, but allows for less creative freedom)
SkinColors|	The color of the transparent background to display for each skin when selecting a skin for your trainer. The Red, Green and Blue (RGB) values are separated by semicolons (;) while each set of background colors is separated by commas (,).
SkinFiles|	The file names of the skins a player can choose from (relative to the "Textures\NPC" folder, including subfolders if any).
SkinNames|	The default names for each skin to display when selecting a skin for your trainer.
SkinGenders|	The gender of each skin you can select. Using the <player.gender> script construct Game Mode creators can display different dialogue depending on the player's gender.

Putting $Mode into a file path will include the file path of GameMode.dat. For example:

GameMode.dat is in \GameModes\Example\
The content for the Game Mode 'Example' is in \GameModes\Example\Contents\
To have the Game Mode work properly you must add this line:
ContentPath|$Mode\Contents\

Game Rules

Multiple different Game Rules can be set to change the game play.

GameRule (with default value)	Description
(MaxLevel|100)	Sets the maximum level a Pokémon can reach.
(OnlyCaptureFirst|0)	If set to 1, only allows the player to catch the first Pokémon that the player encounters in a location.
(ForceRename|0)	If set to 1, forces the player to rename their Pokémon upon receiving/catching one.
(DeathInsteadOfFaint|0)	If set to 1, Pokémon that faint in and outside of battle are removed from the party.
(CanUseHealItems|1)	If set to 1, allows the player to use healing items.
(Difficulty|0)	Sets the default difficulty of the game. 0 = Easy, 1 = Hard, 2 = Super Hard.
(LockDifficulty|0)	If set to 1, locks the difficulty to the value in the "Difficulty" Game Rule.
(GameOverAt0Pokemon|0)	If set to 1, ends the game if a player has no Pokémon in their party after a battle or when the last Pokémon in their party faint in the overworld due to poison damage.
(CanGetAchievements|1)	If set to 0, prevents the player from getting achievements.
(ShowFollowPokemon|1)	If set to 0, the game won't show the first Pokémon in the player's party walking behind the player.
(OverworldPoison|0)	Sets the behaviour of poison on Pokémon while outside of battle. 0 = Pokémon don't receive poison damage outside of battle. 1 = Pokémon lose 1 HP every 4 steps if they are poisoned, but are cured when they have 1 HP left. 2 = Pokémon lose 1 HP every 4 steps if they are poisoned until they faint at 0 HP.
(SavingDisabled|0)	If set to 1, prevents the player from saving their game.
(SingleUseTM|0)	If set to 1, makes it so that TMs can only be used once, after which they are removed from the inventory.
(CanForgetHM|0)	If set to 1, makes it so that HM moves can be forgotten.
(CoinCaseCap|0)	If set to anything higher than 0, the player can't earn more coins than that by playing Voltorb Flip.

Game Mode.png

If an image is included with the Game Mode in the same location as the GameMode.dat and named GameMode.png it will display in the background when the Game Mode is selected in the "New Game" menu.

Game Folder
Content									ContentPacks		GameModes	Saves			Screenshots	Game Executable
Pokemon	Data								ContentPack Folder		GameMode folder	Savegame folder				Version History
Data	Maps			Moves	Scripts				Control Files	Content	GameMode.dat	Party.dat	Player.dat	Options.dat
	poke	battle	structures		V1	V2	trainer	worldmap