General Configuration
Previous  Next

Starting in BSP .96, Bsp.ini and Game.ini files have been reformatted and renamed to Bsp.cfg and Game.cfg. Many settings have been renamed or cleaned up from previous versions. The new format for these files is as follows:

//comment
/*comment*/
setting_name1 value
setting_name2 "value containing spaces"

Settings are now interchangeable between Bsp.cfg and Game.cfg. This means that any setting from Bsp.cfg can be set in Game.cfg. This would allow further game-specific configuration when BSP is configured to edit multiple games.

Important! Saving config files from within BSP will reformat the file - When saving Bsp.cfg or Game.cfg files in BSP, there are some important things to remember. First, the files will be completely rewritten so any customizations or comments in the files will be lost. Second, Bsp.cfg will receive settings from all groups except for "Game", and Game.cfg will receive settings from the "Game" group only.

Bsp.ini is still used to store the recent file list. The file Bspwin.ini has been merged into Bsp.ini. The upgrade process simply appends Bspwin.ini contents to Bsp.ini.

Many settings, such as those that affect fonts or UI layout, cannot take effect until BSP is restarted. If changing a setting seems to have no effect, try restarting BSP to load with the new settings.

BSP .96 includes a converter utility bspupd96.exe that will convert old BSP config files to be usable with the new version. It has three conversion modes. The first is a settings converter that will perform any renames and convert .ini key=pair format lines to "key" "pair". The second mode is a command replacer that will find obsolete command names in a file and do in-place replacements. The third option will copy the Window Placement section from bspwin.ini to bsp.ini. For more information, refer to bspupd96.txt or run bspupd96 /? .

New config files

Three new config files have been added to BSP .96.

Menu.cfg - Script that allows full customization of the BSP main menu. Currently, allows configuration of the main menu only. See menu.cfg for script format details.

Cmdstr.cfg - Meta information for commands, including menu name and info text.

Setinfo.cfg - Settings info, meta information for settings. With this file, allowed values for a setting can be explicitly named and each given a description. This information is used primarily for the new Settings dialog.

Toolbar Images

Toolbar images have been moved from the BSP executable and placed in the BSP\Settings\gfx\toolbar directory. The name of each bitmap matches to a command name. Main toolbar buttons must be 20x20 pixels, and Group Window buttons must be 16x15 pixels.