Click Here to Install Silverlight*
United StatesChange|All Microsoft Sites
Microsoft Game Studios
|Buy It|Support|Sign Up



SDK: Using the Country Config File
12 June 2001

With the country config file you can add new nationalities and alliances to CFS2, and change the graphics displayed in the user interface (UI) as well as award images.

Note: If you are downloading new CFS campaigns, you should replace the version of the country.cfg file currently in your C:\Program Files\Microsoft Games\Combat Flight Simulator 2 folder with the new .cfg file provided with this article. This new version of the file then becomes the new (and officially Microsoft-sanctioned) default country.cfg file.

This article will take you through the sections of the .cfg file that you can customize. You may also download a sample file which we have created for you. After making a backup of your original file, just click on the link below and save the file to your Combat Flight simulator 2 folder.

SAMPLE COUNTRY.CFG FILE (country.cfg / 10 kb)

The file is divided up into three main sections:

  • Defaults definition section
  • Alliance definitions section
  • Country definitions section

    The Defaults section
    The Defaults section supports only one parameter-the default country (currently, U.S. (3)). This value is used by:

    • The UI shell to display an appropriate background image on the Select Nationality dialog box for the first time in a session.

    • The UI shell to assign the default nationality to the player in Quick Combat and Free Flight modes when allegiance can't be determined from the aircraft type (for example, if the "allegiance" parameter (in section "MISC_DATA") hasn't been specified in the aircraft's DP file).

    • The Mission Builder to choose a country the first time you place a new object (aircraft or vehicle or ship) in the current session.
      [defaults]
      country=3
    The Alliance section
    Each Alliance definition section describes which countries, described in the countries section, belong to the alliance. There can only be two alliances in CFS2 (alliance.0 and alliance.1). Any number of countries can be in each alliance. You can, however, only define 19 countries total in the country definitions sections of the config file.

    In the following example, Name= defines the name of the alliance (displayed only in the Mission Setup dialog box). Country.# defines which countries are in the alliance.

    [alliance.0]
    name=Allies
    country.0=1
    country.1=3
    country.2=5
    country.3=7
    country.4=9
    country.5=10
    country.6=11
    country.7=13
    country.8=14
    country.9=17
    country.10=18

    [alliance.1]
    name=Axis
    country.0=2
    country.1=4
    country.2=6
    country.3=8
    country.4=12
    country.5=15
    country.6=16
    country.7=19

    The Country section
    The Country section defines how the nationality variables are presented in the game.

    Name= defines the name of the country.

    Short_name= defines the acronym for the country (USA, GER, GBI, etc.). This value is implicitly used by the program to identify voicepacks (stored in the "sound/radio" subfolder) for each country. It is also used to filter out training missions by country (see Lessons subfolder)

    Nationality= defines the name of the pilot nationality required for some UI elements (for example, for the drop-down list box in the Select Nationality screen).

    Heading= defines how magnetic directions are displayed in text in the simulation. Only two values are currently supported: "bearing" or "oclock."
    [country.3]
    name=USA
    short_name=USA
    nationality=American
    heading=oclock

    award_scores= defines the number of aerial kills that must be made in order to receive a higher award.

    award_names= not used

    award_scores=1, 3, 5, 15, 35
    award_names=

    award_images= tells the game what bitmap images to display for each award. You can make your own images by placing them in the UIRES folder. For each award there is a large and a small image. The name of the award image file is generated by concatenating a prefix (defined by the award_prefix_large or award_prefix_small parameter) with the base award name (defined in the award_images parameter). For missing award images, you must specify an asterisk (*).

    award_images=merit.bmp, air.bmp, *, flying.bmp, services.bmp
    award_prefix_large=medal_amer_lrg_
    award_prefix_small=medal_amer_sm_

    award_text.#= defines what text will be displayed with each award.
    award_text.0=The President of the United States takes pleasure in presenting the Legion of Merit to you for achieving your first kill in combat.

    award_text.1=For meritorious achievement in aerial flight as Pilot of a fighter plane, you have been awarded the Air Medal. Your skill in maneuvering your plane, your determination, and your courage were in keeping with the best standards of the United States Armed Services.

    award_text.2=A grateful nation issues this commendation to you in recognition of your combat efficiency against enemy forces. Your courage and determination are in keeping with the highest standards of the United States Armed Services.

    award_text.3=For conspicuous gallantry and intrepidity in action above and beyond the call of duty, you have been awarded the Distinguished Flying Cross. Your constant aggressiveness, skill, and leadership during these engagements were worthy of the highest tradition of the United States Armed Services.

    award_text.4=For extraordinary heroism and conspicuous courage in the face of enemy fire, you have been awarded the Distinguished Service Cross. Your unwavering devotion to duty reflects the highest credit upon you and the United States Armed Services.

    Woundaward_scores= defines how many times a pilot must be wounded in order to receive a wound award.

    Woundaward_images= defines what image will be displayed in the game if you receive a wound award. You may substitute any bitmap image by placing it in the UIRES folder.

    Woundaward_text.#= defines what text will be displayed in the game with the wound award.

    woundaward_scores=1
    woundaward_images=heart.bmp
    woundaward_text.0=For wounds honorably received in the line of duty, you have been awarded the Purple Heart.

    Rank_scores= defines how many points must be earned by completing mission goals in order to receive a promotion in rank. Note that rank_scores must have the same number of items as rank_names has, and that the game ignores the last entry in rank_scores (-1).

    Rank_names= defines the flying ranks associated with each nationality's armed forces.

    Rank_prefix_large= is used, together with names from Rank_images, to generate names of rank image files (large).

    Rank_prefix_small= is used, together with names from Rank_images, to generate names of rank image files (small).

    Rank_images= defines what image will be displayed in the game when a new rank is awarded. For each rank there is a large and a small image.
    Note: rank_scores must have the same item count as rank_names and the last item in rank_scores is ignored

    rank_scores=1000, 2500, 5000, 7500, -1
    rank_names=Ensign, Lieutenant JG, Lieutenant, Lieutenant Commander, Commander
    rank_prefix_large=rank_amer_lg_
    rank_prefix_small=rank_amer_sm_
    rank_images=ensign.bmp, lieutenantjg.bmp, lieutenant.bmp, ltcommander.bmp, commander.bmp

    Debrief_images= defines what outcome bitmap image will be displayed on the mission debriefing screen. You can substitute any bitmap image by placing it in the UIRES directory. Note that the order of images in this parameter is predefined and can't be changed.

    Outcome_images= defines what outcome bitmap image will be displayed at the end of a mission. You may substitute any bitmap image by placing it in the UIRES directory. Note that the order of images in this parameter is predefined and can't be changed.

    Note: Debrief image order: alive, crashed, shot down, captured, rescued, died in bailout, aborted

    debrief_images=scr_db_landed_safe_amer.jpg, scr_db_crashed_amer.jpg, scr_db_shot_down_amer.jpg, scr_db_bailed_amer.jpg, scr_db_ditched_amer.jpg, scr_db_shot_down_amer.jpg, scr_db_bailed_amer.jpg

    outcome_images=out_back_at_base_amer.jpg, out_back_at_base2_amer.jpg, out_failure_amer.jpg, out_wounded_amer.jpg, out_death1_amer.jpg, out_death2_amer.jpg, out_death3_amer.jpg, out_submarine_amer.jpg, out_captured_amer.jpg, out_warning_amer.jpg, out_promotion_amer.jpg, out_commendation_amer.jpg, out_failure_amer.jpg

    Screen_images= defines what bitmap is displayed on the various UI screens. You can substitute any bitmap image by placing it in the UIRES directory. The order of images in this parameter is predefined and can't be changed.

    screen_images=scr_nationality_amer.bmp, scr_singlemission_amer.bmp, scr_briefing_amer.bmp, scr_selectpilot_amer.bmp, scr_trainingmission_amer.bmp, scr_squadron_amer.bmp, scr_advancedinfo_amer.jpg, scr_advancedinfo_amer.jpg, dlg_pilotdetails_amer.bmp, dlg_certificate_amer.bmp

    scuttlebutt_images= defines what bitmap is displayed on the scuttlebutt screen. You can substitute any bitmap image by placing it in the UIRES directory. The order of images in this parameter is predefined and can't be changed.

    scuttlebutt_images=dlg_scuttlebutt_amer.bmp

    first_names= defines a list of first names for pilots. The game selects a random first name from this list when creating wingmen.

    first_names=Ed, Scot, Bruce, Darryl, Rob, Patrick, Jon, Ken, Kevin, Leon, Craig, Andrew, Todd, Michael, Russ, Steve, Jim, Richard, Phillip, Anthony, Brian, Jack, John, Rob, Peter, Jason, Hal, Caleb, Brent, Doug, Roy, Tony, Lee, Mason, Vern, Cappy

    last_names= defines a list of last names for pilots. The game selects a random last name from this list when creating wingmen.

    last_names=Fries, Bayless, Williams, Saunders, Brown, Rauda, Barnes, Seal, Hatfield, Lavering, Griffin, Rosenshein, Beeck, Cook, Bezruchkin, Cook, Dent, Fokin, Fomichev, Laney, Martynov, Zukin, Stone, Szofran, Schroeter, Braginskiy, Glaeser, Haimberg, Lacey, Napier, Patrick, Santodomingo, Setzler, Teschner, Gardner, Walp, Hunt, Osborne, Schmidt, Singer, Sullivan, Sutherland, Turk, Barrett, Bigel, Deal, Feldman, Gale, Howell, Gee, Johnstone, Kaufman, Keller, Kruske, LaPadula, Miller, Nealy, O'Bryan, Olson, Poulos, Quevedo, Rezek, Sharp, Waskey, Welsh, Wood, Yuen, Zahn, Barker, Bryan, Cha, Conklin, Connolly, Duong, Grimes, Holland, Jelen, Lambert, McDowell, McMillion, Oliver, Park, Schultz, Stanley, Swanson, Wilson, Zander, Zyskowski, Nelson

     


  • © 2009 Microsoft Corporation. All rights reserved. Contact Us |Terms of Use |Trademarks |Privacy Statement
    Microsoft