           File layout for the AOE ROSTER.DAT file
 
      I. General Remarks
         For those of you not familiar with the function of the
         ROSTER.DAT file, it is the file that contains the data
         relating to all currently active pilots in the game. By
         currently active, I mean all that appear in the Career
         screen whether still active within the game or not.
         The data for each of these pilots is stored in a record
         in the file. The data included identifies the pilot,
         his unit and A/C, his awards, the game date, the realism
         settings and much more.
         
         The first two bytes in the file contain the number of
         pilot records within the file. The first pilot record
         starts at byte 02x where byte 00x is the first byte.
         
     II. Typical Pilot Record layout.
         The data contained in the piilot record may be one of
         two types, a number or a toggle. Toggles have one of   
         two values, 00 for No/Off and 01 for Yes/On. The 
         numbers may be one (1) or two (2) bytes in length. When
         it is 2 bytes, the lower address contains the low-order
         byte. Blank entries in the CONTENTS column indicate unknown.
         Here's the pilot record structure as is known to date.    

          BYTE(S)  CONTENTS
         _________ ______________________________________________
          01-16    Pilot's name
          17-32    Always filled with 0's -- Unused ???
           33      This pilot record # in the file minus 1
           34      Pilot Nationality  (00 = U.S. 01 = British 02 = German)
           35      Branch of service  (See Table 3 below)            
           36      Rank Code (see Table 1 below)
           37      Status  00=OK, 01=POW, 02=Retired, 03=Dead
          38-39            
          40-41    Date for the beginning of this ToD - in days
                   starting with 1 Jan., 1900  (00 00)
          42-43    Unknown (but usually FF FF)
          44-45    Current date in days measured from 1 Jan.,  
                   1900
          46-47    No. of days between missions for this segment
                   of current ToD
           48      Number of missons remaining in this segment 
                   of current ToD
          49-50    No. of Missions Flown
          51-52    No. of Successful Missions Flown
          53-54    No. of Campaigns/Tours of Duty Completed
          55-56    Current A/C code (see Table 2 below)
          57-58    Airfield Code Number
          59-60    Unit Code Number
          61-62    Campaign Code Number
          63-64    Number of enemy A/C and ships destroyed.
                   Used to determine promotions and awards.
           65      Number of Reprimands for shooting down friendly A/C
           66      Dist. Service Order   (10)         
           67      Dist. Flying Cross    (25)                
           68      Victoria Cross          
           69      Croix de Guerre (Fr. but to RAF pilots)
           70      Iron Cross 2nd Class  (10)               
           71      "  " "   " 1st "   "  (25)            
                                                  
                                                  Page 1 of 3


          BYTE(S)  CONTENTS
         _________ ______________________________________________ 
           72      Knight's Cross  (40)                                 
           73      KC with Oakleaves and Swords  (60)                                     
           74      KC with Oakleaves, Swords, and Diamonds           
           75      Purple Heart                
           76      Air Medal                           
           77      Silver Star                            
           78      Legion of Merit
           79      Distinuished Flying Cross     
           80      Congressional Medal of Honor                            
                   Bytes 81 thru 92 are the current Realism
                   settings; 00 = off and 01 = on. The number
                   in parentheses following is the percentage
                   score lost if this setting is off.
           81      Sun Spots  (6) 
           82      Realistic Weather (3)
           83      Gun Jams Allowed (6)
           84      Engine Burnout (6)
           85      Blackouts Allowed (6)
           86      Limited Ammo (16)
           87      Limited Fuel (6)
           88      A/C May Be Damaged (80)
           89      Mid-Air Collisions (6)
           90      No Inflight Info (3)
           91      Combat Model   00 = Easy
                                  01 = Standard
                                  02 = Hard
           92      Flight Model   00 = Novice
                                  01 = Intermediate
                                  02 = Expert
         93-94 
         95-96 
         97-100    Total Points earned thus far in career
        101-102    Total Mission bonus points earned thus far in career
        103-104    Victories, Personal
        105-106    Ships Sunk, personal
        107-108    Strikes, Personal
        109-110    Vehicles, Personal                       
        111-112    Victories, by Units flown with
        113-114    Ships Sunk, by Units flown with
        115-116    Strikes, by Units flown with
        117-118    Vehicles, by Units flown with
        119-120                                                
        LR + 1     Number of SHAEF/OKW messages or "Greasemonkey"                                      
                   rumors received (where LR = last pilot record)
        
        For the dates used in bytes 39/40 and 43/44, see the
        file AEDATE.TXT; for the unit codes used in bytes
        58/59, see the file AEUNIT.TXT; for the airfield codes
        used in bytes 56/57, see the file AEBASE.TXT. The hex
        codes for the campaigns (bytes 60/61) are contained in 
        the file AECAMP.TXT.

        A slight anomaly exists in the realism settings. Turning
        off Limited Fuel (-6%) and Mid-Air Collisions (-6%) will
        result in a realism factor of 89 (-11%). Sometimes the
        whole isn't the sum of its parts. Actually, those two
        realism settings are probably -5.5% each but the %ages
        are rounded up to 6%.
                                                  
                                                  Page 2 of 3



                        Table 1  Codes for Pilot Rank
        Code  Rank
        ____  _________________________________
         00   2nd Lt., USAAC
         01   1st Lt., USAAC
         02 * Captain, USAAC 
         03   Pilot Officer, RAF
         04   Flying Officer, RAF
         05 * Flight Lt., RAF
         06   Leutnant, LW  
         07   Oberleutnant, LW
         08 * Hauptmann, LW
            * - Can lead a flight
         
                           Table 2 Codes for A/C
        Code  A/C
        ____  ______________________________________________
         00   Bf-190G          
         01   Bf-190K        
         02   Fw-190A        
         03   Fw-190F       
         04   Fw-190D-9         
         05   Ju-88S (*)    
         06   Me-262        
         07   Ar-234B        
         08   Hawker Typhoon V
         09   Hawker Tempest Ib
         0A   Spitfire Mk IX  
         0B   Spitfire Mk XIV
         0C   Mosquito Mk 18   
         0D   Mosquito Mk VI
         0E   P-51D  Mustang     
         0F   P-38J  Lightning          
         10   P-47D  Thunderbolt         
         11   B-26   Marauder  (*)
         12   B-25D  Mitchell  (*)
         13   B-17G  Flying Fortress (*)
         14   B-24J  Liberator (*)
                                     
         (*) Cannot be "flown" by the player, but will appear in
             the game either as an A/C to be escorted or attacked.
               

                  Table 3 -- Branch of Service (Byte 35)
         Value  Branch
         _____  _________________________________________________
           00   U.S. Army Air Corps (USAAC)
           01   Royal Air Force (RAF)
           02   Lutwaffe (LW)               
         
         These values/codes control the insigniae which appear
         in the upper right and left-hand corners of the pilot
         record screen.

         Byte pairs 63-64 and 101-102 are used to determine medal
         awards and promotions. The pair 63-64 counts aircraft
         victories and other kills and the pair 101-102 is the
         total of mission bonus points earned.

                                                J.W.Johnson
                                                "Jaybird"
                                                CSERVE 74020,1734
 
                                                Page 3 of 3
