---------------------------------------------------------------------------
CHAMPIONSHIP MANAGER 2 DATA EDITOR          Written by Svein Einar Kvernoey
version 3.20 for Windows 95                 19(c)97 by Svein Einar Kvernoey
---------------------------------------------------------------------------
                      released ??th May 1998

First of all I want to thank you for taking the time using this little utility.
The program is a data (pre-game) editor for Championship Manager 2, a brilliant
soccer management game. The editor is compatible with most leagues and
versions of cm2, including CM2 97-98 (enhanced).

I will strongly advice you to read this file, as it covers all aspects of
the editor. It is my belief that most problems are covered in this file.
However, if it don't help you, then mail me, and I'll do my best to help
you (please include a brief description of your problem along with any
error messages you got).

A good precaution is always to take backup copies of your db1 files, in
case anything should go wrong. All use of this program is entirely on your
own risk, although I hope it works like expected.



TABLE OF CONTENTS:
------------------

PART 1: For starters
        1.1 What is CM2 ?
        1.2 What this editor is & what you can do with it.

PART 2: General information
        2.1 Distribution license and warranties
        2.2 Copyrights
        2.3 Files in the package
        2.4 Requirements
        2.5 History
        2.6 What's new in this version

PART 3: The editor
        3.1 Quick start
        3.2 Editing
            3.2.1  Preferences
            3.2.2  Loading data files
            3.2.3  Applying changes
            3.2.4  Adding a record (or inserting a history)
            3.2.5  Deleting a record (or a history)
            3.2.6  Undelete a previously deleted record.
            3.2.7  Copy, Paste & Clear
            3.2.8  Searching
            3.2.9  Resetting and resorting
            3.2.10 The ChangeAll feature
            3.2.11 Saving your changes
            3.2.12 'Edit player's history' button
            3.2.13 Player-, team- and managerlist
        3.3 Values entered
        3.4 The attributes
            3.4.1 Player positions
            3.4.2 Player data set
            3.4.3 Team Developed
            3.4.4 Team Transfer System
            3.4.5 Team Cash
            3.4.6 Team X-Coord & Y-Coord
            3.4.7 Team Blend
        3.5 Data files

PART 4: Troubleshooting (errors)
        4.1 Not a valid integer value
        4.2 If files are ReadOnly
        4.3 Disabled attributes
        4.4 Appended players does not appear in the game
        4.5 The values are not exactly the same when starting CM2
        4.6 CM2 crashes ?
        4.7 Editor incompatibilities
        4.8 Known bugs

PART 5: Closings
        5.1 The author
        5.2 Credits



--------------------
PART 1: For starters
--------------------

 1.1 What is CM2 ?
     CM2 (abbreviation for Championship Manager 2) is an excellent
     soccer management game, focusing on the manager aspect of the
     game soccer (which we europeans call football). Not being
     overwhelmed with fancy graphics, real soccer fans (/fanatics)
     is rewarded with the best game engine, the most realism,
     the best statistical feedback, etc up to date.

 1.2 What this editor is & what you can do with it.
     This is a data editor for CM2, editing the *.db1 (database)
     files and the plhist.bin (player histories) file.

     WHAT YOU CAN DO WITH IT:
     You can edit
       - ALL attributes, skills and information of ANY player, team or manager.
       - Players' history

     WHAT YOU CANNOT DO:
     You cannot edit
       - season/year (current or start)
       - player contracts, values or the like
       - game rules, fixture lists, competition names or structure
       - /alter/patch/include the Bosman ruling into the game

     This info is NOT stored in the data files.

     This is NOT a savegagme editor. If you want a savegame editor, I
     recommend downloading Dan Nagle's brilliant savegame editor.

     Please note that this editor now includes all attributes, skills, etc
     possible to edit in the data files + history file.


---------------------------
PART 2: General information
---------------------------

 2.1 Distribution license and warranties
     You are hereby entitled to use and distribute this product freely
     as long as the following terms are met:
     - The author is NOT liable for ANY damage usage of this product
       may cause, expected, unexpected, directly or indirectly in any way.
     - The author does not make any warranty this product will work as
       supposed, or any other warranty at all, expressed or implied of any
       kind.
     - A free distribution license is granted on a non-commercial,
       non-profit basis, free of charge. The user shall not pay for this
       product in any way.
     - Distribution only allowed with the original package with all
       components intact and unchanged (file: cm2edw95.zip)

 2.2 Copyrights
     This editor is completely written by and copyrighted by
     Svein Einar Kvernoey, 1997. All rights reserved. You may not
     change any part of this package in any way.

 2.3 Files in the package
     - CM2ED.EXE : The program file. Run this to start the program.
     - CM2ED.DAT : Configuration file, list of directories where
                   *.db1 and plhist.bin file is to be found.
     - CM2ED.TXT : Uh.. that's me. Or what you're reading now, anyway :)

 2.4 Requirements
     - This editor is programmed in the Windows 95 environment, and requires
       Windows 95 (unkown if Win3.1x + Win32s works - if you do not know
       what I'm talking about do not ask me about it, I will not offer help
       on this subject).
     - Memory usage should not be a problem, CM2 demands more than
       this editor, but approx. 4-5Mb of free memory is used during
       usage.
     - One or more of the '*.db1' files and/or the 'plhist.bin' file
       in the directory you want to edit. You are allowed to choose
       which data files to load.
     - The 'pldata?.db1' (?: 1-3) files in a directory all need to be
       of the of the same version (you will be warned if not). Neither
       this editor or CM2 handles a mix of data files from various
       leagues/versions.

 2.5 History
     - 31.01.1996 : Version 1.00 released (DOS).
     - 17.12.1996 : Version 2.41 released (DOS).
          This is the last DOS version of this editor ever.
          Known to be incompatible with the following:
              - Team Editor: Norwegian League
              - Manager Editor: Dutch League
              - Manager Editor: Spanish League
              - Untested: Portugese & Italian 96-97 league and newer.
     - 06.06.1997 : Version 3.00 released (WIN95).
          Completely rewritten for Windows95 with a complete new user
          interface, load all data at startup, player history editor,
          bug fixes and other stuff (quite a few).
     - 06.09.1997 : Version 3.10 released (WIN95)
          Additions, bug fixes, etc, see next section (2.6) for details.
     - xx.01.1998 : Version 3.20 released (WIN95)
          A few addition, bug fixes, added compatibility with cm2e, ++.
          - Incompatible with
            - Spanish league, manager editor

 2.6 What's new in this version (v3.20)
     NOTE! Do NOT use the CM2ED.DAT file of CM2ED versions prior to 3.10
           with versions 3.10 or later, as the content of that file has
           changed.

      Added: Re-introduced some of the buttons from v3.00
      Added: Full compatibility with CM2 Enhanced (97-98)
      Fixed: Adding new teams with nation = any continent now works


------------------
PART 3: The editor
------------------

 3.1 Quick start
     Unzip 'cm2edw95.zip' to any directory (I assume you have already
     done this). Start the file 'cm2ed.exe' from your favourite file
     browser or add it to the 'Start Menu' in Windows 95.

     Choose a path from the list, if the one included is wrong, then
     choose 'Add' and browse until you find your directory, and press
     'Add path'. Now choose this directory from the list, and then
     press 'Open'.

     Off you go. Good luck.

 3.2 Editing
     The user interface should be pretty much self-explanatory and
     easy to use. I will focus on the main parts here. When viewing
     the data, choosing either of the types Players, Teams, Managers
     or Histories moves to that particular editor part. You may now
     browse all available attributes within that part, and edit them.

 3.2.1 Preferences
       This is the part where you 'set up' the editor. There are some
       things you can do here:

       Firstly you can type the correct names for each "continent"
       used in cm2. From version 3.10 of the editor, it features an
       extended club and national team recognition "system". This means
       that when you, at a national team, choose to get the list of
       teams, you will get a list of continents (soccer term continents).
       However, as there are many leagues of cm2 out there, each in
       their own language, these continents are written in several
       languages. There you must cm2ed the name of each continent in
       the correct language of cm2 you are currently editing.
       This means that if you have the Portugese version, English
       language, you don't have to change anything, but if you have the
       portugese version, portugese language, you must write the correct
       names for each continent in portugese.

       Second, you can alter the path list in the preferences. You can
       add, delete, set as default and clear the entire list.

       Adding is done by browsing yourself to the directory where one
       of the data files (*.db1) or the 'plhist.bin' file is found.
       You do not need all files in each directory, as from v3.10 you
       can choose which files to load as well as save.

       Deleting is done by simply choosing the item you want deleted,
       and then press 'Delete'.

       'Set as default' makes the chosen item the default path
       (automatically chosen) when you start the editor next time.

       'Clear list' uhm... does just that; clears the entire list.

       If you choose 'Cancel' any changes you have done are discarded,
       and the initial setup is used. Pressing 'Defaults' sets the
       continent namings to the default, which is english.

 3.2.2 Loading data files
       After adding paths, and you press 'Open', a new window will pop up,
       with details on the data files to load. You may enable or disable
       files as you wish, however note that at all (at least 2) of the
       pldata-files must be present to be able to load the player data.

 3.2.3 Applying changes
       When finished changing the data, click 'Apply' on the 'Edit'
       menu (or press Alt+Enter). The changes  you have done in the
       edit part is now actually applied to the data, so if you
       choose another player/team/manager before3 pressing 'Apply'
       you will loose your changes.

       When you press 'Apply', the editor will check if you have
       typed correct nation(s), club(s), favoured, etc. If not,
       you will be given an error message, and the changes will not
       be applied to the data.

       A note on this: When you change a national team's nation, you
       cannot choose a normal 'nation'. Instead, what defines a
       national team is the 'nation' attribute set to on of these:
         Europe, Asia, Africa, Oceania, South America or CONCACAF.

       Player's nation and club and manager's nation is required.
       Manager's club and favoured and team's nation is optional, and
       may be left blank. However, all of these can be left blank,
       and the editor will not protest. This is done for flexibility,
       also the "team" 'Free Transfer' has no nationality.

 3.2.4 Adding a record (or inserting a history)
       Click the 'Insert / Add' choice on the 'Edit' menu (or press
       Alt+Ins) to add a new player/team/manager to the database.
       You may now edit the new record, and press 'Apply' when you're
       done to apply changes to the data.

       'Add' adds new records to the bottom of the list. Use 'Reset'
       (see below, 3.2.6 Resetting and resorting) to sort the list.
       If you have deleted a record, 'Add' undeletes previously
       deleted record (see below, 3.2.4 Undeleting a previously
       deleted record).

       When in the Histories Editor, you can press either 'Insert
       before' or 'Insert after' in the list of the player's history
       to insert a new season. Seasons are interpreted like this: If
       the season says '95', then the season referred to is the 95-96
       season, likewise '89' refers to the 89-90 season.

       In the season history list, when you see an asterix (*) in front
       of a team name, it means the player was on loan to that club
       in that season.

       The seasons in the History Editor should be in ascending
       order, with first season first (90-91-92...etc).

       In the History Editor, to make new data correctly added/changed
       in the game, the name must be exactly like the player you edit
       (lastname,firstname - no space in between), and the nationality
       must be the same.

 3.2.5 Deleting a record (or a history)
       Clicking 'Delete' on the 'Edit' menu (or pressing Alt+Del)
       deletes the player/team/manager chosen in the
       player-/team-/managerlist on the right hand side of the screen.

       Likewise, pressing the Delete button in the season-list in the
       History Editor deletes the season which is focused on the list.
       There is no way of recovering the deleted data when a season is
       deleted.

 3.2.6 Undelete a previously deleted record.
       If you recently have pressed 'Delete' and deleted a record,
       then you may recover the lost data when pressing 'Add'.
       One restriction: the history (season, club, apps and goals) of
       a player which is deleted is not recovered (the other info is,
       however).

 3.2.7 Copy, Paste & Clear
       You can copy all attributes of a player, team or manager to the
       memory (Edit->Copy or Ctrl+C) and paste the data back into the
       editor (Edit->Paste or Ctrl+V). When you paste the data, a new
       player, team or manager will be created and the data will be
       pasted there. Now you have an exact copy of the player you
       copied. If the copy buffer is empty, the paste command will not
       do anything. Copying and pasting player histories works too, and
       you get an exact copy, including the player's yearly history.

       You may choose to clear (Edit->Copy or Ctr+X) the data on screen.
       This will clear all attributes for the player, manager or team
       you currently have chosen, however it does no real change to the
       data, just the edit window (cosmetic only, if you want).

 3.2.8 Searching
       There are two search functions in the editor.

       - Search in the player-/team-/manager-/historylist: Focus on
         the list, and start typing the last name of the player you
         want to look for. The editor will jump to the closest hit.
         Use backspace to delete previously entered character, and the
         search will jump one step back.

       - The 'Find' feature ('Edit' menu, or press Ctrl+F) will search
         for chosen any text within a player, team or manager, and
         it is not case sensitive.
         Numeric attributes are regarded as text, so searching for
         '20' gives you all players/teams/managers that has the value
         20 in *any* of their attributes. The search does not search
         for whole words, so any substring matching the search
         string is considered a hit. The search resets the
         player-/manager-/team-/historylist, and adds only hits found
         in the list. The player-/manager-/teamlist header will always
         show the number of records in the list, and therefor number
         of hits is shown there. If the list(s) is blank, no hits were
         found (obviously).

 3.2.9 Resetting and resorting
       Pressing the 'Reset' button resets the player/team/manager
       /history list, adds all records to it (if you have used
       'Find') and resorts it. This means that players newly added
       (at the bottom) now will move correctly into the alphabetically
       sorted list.

 3.2.10 The ChangeAll feature
        - This feature lets you choose an attribute for a
          player/team/manager/history and set a new value for it.
          ALL records listed in the appropriate list will be set this
          new value (you will be warned before proceeding though). Use
          with care.

        - To enable this feature, you simply have to press the mouse
          button while the mouse cursor is over one of the labels
          telling the name of the attribute you want to change.
          Pressing 'ChangeAll' button gives you the same (this)
          information.

        - For the History Editor, ChangeAll does not change the
          season-list.

        - After using ChangeAll successfully, it will call the
          appropriate search or reset/resort function to apply changes
          to list.

        - Changes done with ChangeAll CANNOT be recovered (except by
          reloading data without saving) !!

 3.2.11 Saving your changes
        Press 'Save' in the 'File' menu (or press Ctrl+S) and the data
        will be written to disk. Between 'Open' and 'Save' there is no
        access to the data files physically (memory only), so exiting
        ('Exit') or loading a new directory ('Open') will make you
        loose all your changes.
        When you press 'Open' you will be asked which files to save,
        and you may enable/disable files as you wish. The editor will
        only write the files you choose.

 3.2.12 'Edit player's history' button:
        When you press this, the editor will attempt to jump to the
        player's history in the History Editor. If two players have
        exactly the same name and nation, you may be brought to the
        wrong player. However, this should only happen very rarely.
        If the editor does not find the player in the history data,
        it will prompt you for permission to create a history record for
        that player.
        Also, if the History Data file is not loaded, you will be
        warned. If you proceed, a new history data file will be
        written when you press 'Write'. WARNING! Any existing history
        data file will be overwritten, WITHOUT warning.

 3.2.13 Player-, team- and managerlist
        Pressing the right mouse button (or Ctrl+L) over one of the
        lists lets you choose to list specific records of appropriate
        item, either nation, club or the like.

        Pressing Enter or doubleclicking the mouse on a player, team
        or manager moves focus to the edit part of the screen
        (first name / short name).


 3.3 Values entered
     Numeric values entered at range checked by the editor, and if it
     is outside the range, and error message will appear.

     Entering '0' as value in any skills makes CM2 randomize the value
     when generating a new game.

     Text is not range (length) checked. If a string (name, nation,
     etc) is too long, it is cut of at the max character length for the
     appropriate attribute


 3.4 The attributes
     The attributes and explanations are not included in this text
     file anymore, as the editor now includes brief description of all
     attributes when using the editor. Just move the mouse cursor over
     the edit box of the attribute you want brief help about, and
     shortly after information will be shown.

     Also refer to the 'edithelp.txt' file following CM2 Enhanced,
     where each attribute in CM2Enhanced is explained in further
     detail (some attributes are deleted or replaced in cm2e 
     compared to other versions).

 3.4.1 Player positions
       When using the editing part of the screen, you can choose from
       dropdown lists when choosing positions etc. But when using
       ChangeAll for positions, you need to refer to the actual number
       (0,1,2) used for the positions. So keep in mind that:
           0 = cannot play that position (worst performance)
           1 = "possibly" (can but bad performance)
           2 = preferred position(s) (best performance).

       For other appropriate attributes, where there is a choice
       between 'Yes' or 'No' (or 'Available and 'Unavailable),
                 0 = No (Available)
                 1 = Yes (Unavailable).

 3.4.2 Player data set (obsolete and removed in cm2 enhanced)
       The values of this is 0,1 or 2. However the meaning and
       influence on the gameplay is completely unkown.
       The name 'data set' indicates the player, in addition
       to his skills and attributes, uses some kind of preset
       data set, which may be a part of deciding his value,
       ratings, future development etc.
       It seems that players playing in England and Scotland has
       data set 0, while most other has 1, however this is not
       a strict rule, it can be avoided (some players with 1 does
       play in England).

 3.4.3 Team Transfer System (obsolete and removed in cm2enhanced)
       Only for national teams, this sets the country's transfer
       system. 0 means the country has no transfer deadline, 1 means
       the transfer deadline is end of March (england / scotland),
       2 sets the deadline to about end of February. The more you
       increase the earlier the deadline, 5 is the Italian deadline
       (Nov/Dec?), 255 setting the deadline to end of August.

       I'm not sure if this is all, but it's roughly how it works.


 3.4.4 Team Cash
       A team's cash is actually stored as number of thousands (1,000)
       in the file, and although you can type the 'real' number in the
       editor, the way of storing means you cannot vary the last 1,000
       part of the cash attribute; it will always be rounded to 1,000.
       E.g. entering '103405' will be '103000', and '3540' will be
       '3000'. Anything below 1000 is set to zero (0).

 3.4.5 Team X-Coord & Y-Coord
       Only used in the english & scottish leagues, I believe it is
       used to calculate the team's location in the country, and
       therefor also the away games travelling expenses. This is,
       however, nothing but a wild guess.

 3.4.6 Team Blend
       Ability to fit in new players as a whole to tactics, formations,
       other team mates. In basic, this is influences how long time new
       players use before they really settle in their new club and starts
       performing. NOTE: This is NOT to be confused with team's ability
       to attract (foreign / star) players, this mostly goes on the team's
       REPUTATION.


 3.5 Data files
     PLHIST.BIN  : All player history data
     TMDATA.DB1  : All team data
     MGDATA.DB1  : All manager data
     PLDATA1.DB1 : In the English/Scottish league, this is the domestic
                   players and their data.
                   In foreign leagues, this is a collection of the
                   best english and scottish players, and their data.
     PLDATA2.DB1 : A collection of the (best) european players and data.
     PLDATA3.DB1 : In the english/scottish league this file does not
                   exist.
                   In foreign leagues, this is the file containing
                   the domestic players and their data.

     CM2 Enhanced (97-98) has some of these files in one and has some of them
     renamed: Players.db1 is the player database, tmdata.db1 the teams,
     mgdata.db1 the managers and plhist97.bin the player history database.


--------------------------------
PART 4: Troubleshooting (errors)
--------------------------------

 4.1 Not a valid integer value
     This happens when you try to enter an ascii character into a
     numeric attribute. Note also that in the 'Season' of a Player
     History, you must type the last number on the season: e.g. you
     refer to season 94-95, type 'Season' as '95'. This may also occur
     if you enter an incredibly high number (> +/- 2,147,483,647)

 4.2 If files are ReadOnly
     If the editor finds that the files are marked ReadOnly (+r),
     Hidden (+h) or System (+s) these flags are removed and an
     Archive (+a) flag added (-r -h -s +a) automatically, to provide
     correct file access for editing. You are being notified about
     this.

 4.3 Disabled attributes
     If any attributes are disabled then your version of cm2 does not
     support the use of it.

 4.4 Appended players does not appear in the game
     CM2 has certain criteria it uses when picking which players to
     include in the game when generating it, like nationality, country,
     continent, age (?), how good he is, what team he plays on etc etc.
     I don't know the exact criteria, you'll have to keep on trying.

 4.5 The values are not exactly the same when starting CM2
     CM2 does randomize the values somewhat (not much), so your
     changes may not *exactly* be the way you typed them. It is NOT
     a bug in the editor.

 4.6 CM2 crashes ?
     If cm2 finds errors in the data or history files, it will try to
     fix/eliminate them. I guess this requires a lot of cpu time and/or
     intensive harddisk access, as I tried this running cm2 through
     Win95 and it crashed entire Win95. Then I tried in DOS mode (not
     dos shell), and it was 'ok' (cm2 used a bit longer than normal,
     but the game started, and changes where in the game).

     If you have problems, then ensure all data is correct, that there
     are no mis-spellings etc etc, and keep on trying.

 4.7 Editor incompatibilities
     The manager editor does not work with the Spanish League.
     The editor is untested in its entirety with the Italian 96-97 league.

 4.8 Known bugs
     Uhm... none as of yet. I am fully aware of the editor incompatibility
     with the spanish league (manager editor), so I don't count that as
     a bug ;)


----------------
PART 5: Closings
----------------

 5.1 The author

     Comments, bug reports, ideas or the like are appreciated.
     The author can be reached at the following e-mail address

      1.sve_kver@hig.no
      2.boah@giraff.hig.no

     The author, Svein Einar Kvernoey, is also editor of a CM2
     homepage containing lots of info on CM2, tips, tricks, hints,
     good players to buy, cheats (hmm.. but I didn't tell you that :),
     data updates, game utilities etc etc. Point your browser at:

      http://www.hig.no/~sve_kver/cm2/

     You will need a frame compliant browser, like Netscape Navigator
     2.0 or later or MS Internet Explorer 3.0 or later.

     You may also contact me on IRC (Internet Relay Chat) if you want.
     Do a /WHOIS BOAH and see if I'm online. My nick is, as you might
     have guessed, Boah. :) I am mostly on EfNet, often on IRCNet and
     sometimes on Undernet. Not at any other nets (well.. very rarely
     anyway).

 5.2 Credits
     Special thanks goes to William Chi-Chung Lam and Tapani Olkku for
     taking the time to beta test and come with pre-release ideas and
     bug reports. Appreciated.



Good luck in your editing!

Cheers,
Svein (Boah@IRC)



- REAL programmers think structured programming is a communist plot.
