Bonus Maps

Overview

This article describes the step by step process for packaging user created maps for easy import through the in game Bonus Maps UI.

Gather Your Maps

You may need to first create maps. Collect you BSPs into a folder. BSPs may be grouped into sub folders. Any custom materials and models should be embedded using Bspzip.

(Optional) Thumbnail Images

Custom thumbnail images can be used for the map pack, individual maps in the pack, and any sub folders. They should be 180x100 TGA files. The easiest way to create one is to play the level and create a saved game. Then you can get the auto created TGA from the <mod>/SAVE/ directory.

Create Bonus Description Files (.BNS)

Bonus description files list the maps contained in the pack and some details about them. They are standard keyvalue text files (with a .bns extention). The descriptions for the maps can be split across multiple BNS files or descriptions for all of them can be contained as multiple entries in a single BNS file. Here's an example BNS file:

"Test Map 1"
{
	"map"		"./super_test"
	"image"		"./super_test_thumbnail.tga"
	"comment"	"This map is awesome."
}
"Test Map 2"
{
	"map"		"./another_test"
	"comment"	"Part 2 of this map pack."
	"lock"		"1"
}

You can also add comments and images for the map pack and its subfolders by putting a "folderinfo.bns" in each directory.

.BNS File Key Values

• map <string>

File name of the map. The "./" at the beinning starts the file path from the same directory as this BNS, rather than starting from the <mod>/maps/ directory.

• image <string>

Thumbnail image name. The "./" at the beinning starts the file path from the same directory as this BNS, rather than starting from the <mod>/materials/ directory. If no image name is specified for a map it assumes the same name as the map with a .tga extention (super_test.bsp -> super_test.tga). If no image name is specified for a folder it assumes "foldericon.tga".

• comment <string>

A short description of the map (or directory).

• lock <boolean>

Set to 1 to have the map (or directory) initially locked. Maps (and directories) can be unlocked via point_bonusmaps_accessor.

• challenges <key>

A subset of key values that define the challenges and goals.

Challenge Key Values

Example:

"Test Map 1 With Challenges"
{
	"map"		"./super_test"
	"comment"	"Challenges for the awesome map."

	"challenges"
	{
		"Time Challenge!"
		{
			"comment"	"This one is hard!"
			"type"		"2"

			"bronze"	"100"
			"silver"	"80"
			"gold"		"60"
		}
		"Challenge for steps!!"
		{
			"comment"	"I like this one!"
			"type"		"1"

			"bronze"	"500"
			"silver"	"200"
			"gold"		"100"
		}
	}
}

• comment <string>

A short description for the challenge.

• type <integer>

The type of challenge. For Portal: 0 is Portals, 1 is Steps, and 2 is Time.

• bronze <integer>

Bronze medal goal.

• silver <integer>

Silver medal goal.

• gold <integer>

Gold medal goal.

Zip The Files

Zip all the files in to a standard uncompressed .zip file. Change the extention to .bmz (bonus map zip).

Test The BMZ

Use the "Import Bonus Maps..." button in the Bonus Maps menu and select you BMZ. If everything was done properly the new icon will be added to the Bonus Maps menu. If nothing happened, ensure that you're BMZ uses a standard uncompressed ZIP format.