TES2 creates a detailed character report from a Daggerfall saved game file.

The command line syntax is shown below:

        tes2  [-diIlpPQrRxX]  slot#  [field1  value1 ...]
                 or
        tes2  -g[dfkmtu]  slot#
                 or
        tes2  -q  slot#  [item#1=item#2]

where slot# is a number between 0 and 5, corresponding to one of the six saved game slots.

When no switches are supplied, the character sheet for the player is displayed.

-d specifies the maximal detail setting, larger than can be given in the Daggerfall control panel. Use this switch cautiously. If you don't like the result, you'll have to find a way to undo this change on your own. Making a trial save in a spare save slot is one way to test whether or not you like the results.

-gd revokes the character's affiliation with the Dark Brotherhood.

-gf revokes the character's affiliation with the Fighter's guild.

-gk revokes the character's affiliation with the Knightly order.

-gm revokes the character's affiliation with the Mage's guild.

-gt revokes the character's affiliation with the temple.

-gu revokes the character's affiliation with the Thief's guild.

-i specifies the display of the items in the player's inventory, cart, and ship.

-I specifies the display of all the items in the save game, including corpses and unslain foes.

-l (ell) specifies the display of the player record, including guild affiliations and rank, as well as any open quests. This is the default if no switches are supplied.

-p specifies that changes to the player character record follow the save game slot number on the command line. Modifiable fields are listed in the tables below. Changes to advantange or disadvantage attributes are automatically carried over to the difficulty dagger field.

If the new field value is unsigned, that value replaces the present contents of the field in the player record. However, if the value is signed (+/-) then the present value in the field is increased (or decreased) by the specified amount.

For the non-numeric attributes, use Yes/No (or fewer letters) or 1/0. Note that spell points times Int is a little special. Turning one off reverts the character to 0.5 x Int.

With -p, changes can be read from a file where the field-value pairs have been previously stored by including @aFileName on the command line. Comments may be included in that file by writing a hyphen (-) in column one. E.g. if the file myChar contains the following

    -  Increase the hit points per level
    hpPerLevel      +10
    -  Rename the player
    name            Gwahla_the_Buffed
    -  Fend off nasty Ancient foos
    immuneMagic     y

it can be processed by

    tes2 -p 0 @myChar

Field-value pairs can surround the file on the command line as well.

    tes2 -p 0 merchants +2 @myChar gold +100

changes the repute base with merchants and adds 100 gold along with the changes in myChar.

Any number of @files may be included on the command line.

-P specifies changes to the character record in the same way as -p, with the following difference. When -p changes disadvantages and advantages, it automatically updates the difficulty dagger setting to correspond to the new features. Use -P to suppress the automatic update of the difficulty dagger. The difficulty dagger may be set manually with the difficultyDagger field in case you need to control them seperately.

-q by itself displays a list of all the quest items from all the open quests in the specified save game.

In its second form, an existing, non-quest item in the player's inventory (item#1) can be sacrificed to create (or counterfeit) the specified quest item (item#2). Use the first form of -q without any arguments to obtain the possible values for item#2. Use the -i form to obtain the possible values for item#1.

-Q extracts all the open quests in the specified save game into a pseudo-qbn format in the file player.qbn. The seperate tool, saveqbn can be used to extract individual quests for display with the seperate qbn tool.

-r specifies to repair all the used items in the player's inventory, cart, and ship.

-R specifies to reset all the Daedra prince quest-completed flags in savevars.dat. Now, resummoning a Daedra prince will no longer spurn the player, but will instead, reoffer an artifact quest.

-x dumps selected chunk records as a stream of hexadecimal digits. The chunk record numbers to display follow the save game slot number on the command line.

-X documents all the chunk records in the save game, as well as all the item records found with -I.

When the environment symbol TES2 is defined, it is used to locate the installation directory of the Daggerfall game. Otherwise, the tool expects to run out of the installed game directory.

Numerical player settings that can be changed using the -p switch:

alteration archery axe
backStab baseHealth blunt
centaur climb commoners
criticalHit currentAgility currentEndurance
currentHealth currentIntelligence currentLuck
currentMana currentPersonality currentSpeed
currentStrength currentWill deadric
destruction dodging dragon
etiquette gender giant
gold handToHand harpy
illusion impish jump
level lockPick longBlade
maxAgility maxEndurance maxHealth
maxIntelligence maxLuck maxMana
maxPersonality maxSpeed maxStrength
maxWill medical merchant[1]
merchants[2] mysticism name
nobility nymph orc
pickpocket portrait race
restoration running scholars
shortBlade spriggan startingAgility
startingEndurance startingIntelligence startingLuck
startingPersonality startingSpeed startingSkill
startingStrength startingWill stealth
street swim thaumaturgy
underworld

[1]Merchant refers to the player's merchant skill.
[2]Merchants refers to the player's repute with the merchant class.

Modifying the startingXXX isn't notably helpful once the character generation is completed. Changing the currentXXX or maxXXX while stat-enhancing trinkets are equipped isn't really recommended, as the game refigures those when the save game is reloaded, usually with unexpected, and unwanted, side-effects.

Non-numerical attributes that can be changed with the -p switch:

0.5xInt 1.0xInt 1.5xInt
1.75xInt 2.0xInt 3.0xInt
acuteHearing adrenaline athleticism
bonusAnimals bonusDaedra bonusHumans
bonusUndead criticalDisease criticalFire
criticalFrost criticalMagic criticalParalysis
criticalPosion criticalShock darkAbsorb
darkHealing darkRegen dreadAnimals
dreadDaedra dreadHumans dreadUndead
expertAxe expertH2H expertLongBlade
expertShortBlade forbidAdamantium forbidDaedric
forbidDwarven forbidEbony forbidElven
forbidIron forbidMithril forbidOrcish
forbidSilver forbidSteel generalAbsorb
generalHealing generalRegen holyDamage
immuneDisease immuneFire immuneFrost
immuneMagic immuneParalysis immunePosion
immuneShock lessDarkMana lessLightMana
lightAbsorb lightHealing lightRegen
lowDisease lowFire lowFrost
lowMagic lowParalysis lowPosion
lowShock noDarkMana noLightMana
noManaRegen resistDisease resistFire
resistFrost resistMagic resistParalysis
resistPosion resistShock sunlightDamage
waterRegen

In the player skill section, skill settings are reported in two columns. The first, is the skill level, as seen from the character sheet within the game. The second is, I think, the number of uses of the skill accruing to a skill level increase, and is merely a field from the character record that I'm tracking at the moment.

Also note, if you run FIXSAVE and then immediately run TES2 on the fixed save game, it will be unable to find any items in the inventory. FIXSAVE reformats the item records in such a way as to hide them from TES2 and its item detection. Once the game has rewritten that saved game, TES2 will once again be able to report the inventory contents.


Sample character sheet preparation
   C> set tes2=g:\game\dag
   C> tes2 -l 5
produces the following report
-- Using slot 5 `g:\game\dag\save5\savetree.dat' for input.
-- Savetree is 158783 bytes.

                  Gwahla, the Dark Elf Acrobat

          Strength 75/75                          Gender Female               
      Intelligence 50/50                            Will 50/50                
    Starting skill 161                           Agility 100/80               
       Base health 99                          Endurance 68/68                
    Current health 105/105                   Personality 55/55                
          Portrait 00                              Speed 85/85                
             Level 9                                Luck 97/66                
              Gold 500                      Current mana 25/25                


                                  Reputation
         Merchants -2            Commoners 0                Scholars -2     
          Nobility 2            Underworld 2      

                             Player skill levels

         Medical 17/30         Etiquette 11/2               Street 6/0      
            Jump 22/12               Orc 11/33               Harpy 3/0      
           Giant 8/7              Dragon 3/0                 Nymph 5/0      
         Deadric 6/5            Spriggan 3/0               Centaur 6/0      
           Impsh 5/3            LockPick 15/2             Merchant 31/137   
      Pickpocket 18/7            Stealth 53/22                Swim 22/2     
           Climb 41/11          BackStab 25/7              Dodging 39/44    
         Running 48/670      Destruction 6/0           Restoration 3/0      
        Illusion 3/0          Alteration 5/0           Thaumaturgy 28/0     
       Mysticism 28/0        Short Blade 51/0           Long Blade 44/2     
    Hand-to-hand 48/13               Axe 3/0                 Blunt 6/0      
         Archery 42/0       Critical Hit 45/45    

                                        Low       Critical  
            Resistances  Immunities  Tolerances  Weaknesses 
   Paralysis     No          No          No          No
       Magic     No          No          No          No
      Poison     No          No          No          No
        Fire     No          No          No          No
       Frost     No          No          No          No
       Shock     No          No          No          No
     Disease     No          No          No          No

                             Other attributes

               Acute hearing No                    Athleticism Yes    
             Adrenaline rush Yes          Damage from sunlight No     
       Damage in holy places No           No mana regeneration Yes     
         No mana in darkness No       Reduced mana in darkness No     
       Reduced mana in light No               No mana in light No     
                   Mana 0.5x Yes    


                       Light        Dark      General     In water  
       Rapid healing     No          No          Yes    
        Regen health     No          No          No          No
    Spell absorption     No          No          No     

                     Undead  Daedra  Humans Animals 
        Bonus to hit   No      No      No      No
            Dread of   No      No      No      No

         Forbid iron No         Forbid steel No          Forbid silver No   
        Forbid elven No       Forbid dwarven No         Forbid mithril No   
   Forbid adamantium No         Forbid ebony No          Forbid orcish No   
      Forbid daedric No 

         Short blade  Long blade Hand-to-hand    Axe        Blunt      Missile   
Expert at     No          No          No          No          No          No
   Forbid     No          No          No          Yes         No          No

Forbid leather armor Yes   Forbid chain mail Yes     Forbid plate mail Yes  
      Forbid buckler Yes Forbid round shield Yes    Forbid kite shield No   
 Forbid tower shield Yes

                               Primary skills
     Running                 Hand-to-hand              Short Blade          

                                Major skills
     Climb                   Archery                   Dodging              

                                Minor skills
     Swim                    Long Blade                Pickpocket           
     BackStab                Critical Hit              Jump                 


                          Starting stats
     Base strength 40                  Base intelligence 40                   
         Base will 45                       Base agility 65                   
    Base endurance 50                   Base personality 45                   
        Base speed 65                          Base luck 50                   
                      Hit points/level 12

                           Affiliations
                 The Fighters Guild (Apprentice)
               The Dark Brotherhood (Journeyman)
                              Arkay (Acolyte)
                  The Thieves Guild (Apprentice)

                           Active Quests
       (3)         s0000999                  (1)         Q0C4XY04             
       (2)         s0000977           

                                 Bank balances
                    Dwynnen:   11657871      Wrothgarian Mountains:    2691419
                    Phrygia:   11672158                    Urvaius:    5924299
              Ilessen Hills:    5766305

   Difficulty dagger in use:     0.51
   Calculated difficulty dagger: 0.51
   Next level (10) after 8 skill increases.
-- Done.

You can, of course, use standard file redirection to send the report to your printer, or catch the output in a file to include or attach to an e-mail.


Donald Tipton
cucumatz@gte.net
November, 2000