# Player GDB Manager BETA - Created by Lplover2k2

This is a program to allow users to easily manage kitserver's (a superb Pro Evolution Soccer addon created by Juce) face,hair and boots files and map.txt files for players.The program is still in beta version. So there are still quite some bugs. There are still a lot of features to be implemented in the future.

I would like to give a special thanks to Robbie who contributed significantly in this program by developping the tools necessary to directly access pes6 option file.

## Table of contents

- #### Requirements

- #### Installation

- #### Version Changes

- #### How to import a pack with map.txt

- #### How to import a pack without map.txt

- #### How to import/choose a Stadium

- #### Troubleshooting

- #### Credits

##

## Requirements

- Pro Evolution Soccer 6 obviously :)
- Kitserver obviously too :P
- .NET framework[www.microsoft.com/downloads/thankyou.aspx?familyId=0856EACB-4362-4B0D-8EDD-AAB15C5E04F5&displayLang=en]

## Installation

- Just extract the .zip file in any directory (e.g. "C:\Player GDB manager\")

HOPE everything goes well, post any bugs found at www.soccergaming.tv or
http://www.wevolution.org/forum/showthread.php?tid=3316&pid=65117&#pid65117

## Key Features

The key features of this program are

- easily manage (add,delete) your face/hair/boots files without having to manually modify map.txt
- select a player from the program's players listbox and manage his face/hair/boots files
- the program automatically gets the player's id for you
- use search facilities to search for files or players
- create backups of your files and map.txt databases

See version changes for additional features added in future releases.

## Shortcut Keys

Shorcut keys are there to allow you to perform common operations quickly

- Ctrl+S - Save current tab
- Ctrl+A - Save all tabs changes
- CTRL+X - Exit
- ENTER - Search

## Version Changes

#### v.0.1 BETA [3 JAN 07]

#### v.0.2 BETA [4 JAN 07]

* pes6 directory automatically located
* improved navigation.
* Now you can set default face/hair/boots folders.
* .str support added for face and hair
* tooltip and tip menu added
* unassign buttons added
* revised search mechanism
* some bugs fixed
- nomore crashes when map.txt is missing
- check that kitserver is installed
- GDB/faces/hair/boots folders automatically created if missing
- map.txt files automatically created if missing
- check if valid pes6 directory is entered when changed

####
v.0.3 BETA [5 JAN 07]

* face/hair/boots manager added
* import new faces using the face/hair/boots manager now in any subfolders you want
* delete files from face/hair/boots manager
* create/delete folder,subfolders in the face/boots/hair manager
* the associations with deleted files are automatically removed from map.txt
* recovery option added under "file" top menu
* database backup/restore option moved under recovery
* files backup/restore option added under recovery
* PNG boots preview in boots manager
* get notified to save when a player's settings were modified and not saved.(still incomplete)
* bugs reported fixed
- now ids with leading zeros are managed in proper way

#### v.0.4 BETA [6 JAN 07]

* revised interface
* playersID.txt must now be in the program's directory
* program now locate Pro Evolution Soccer 6 directory whereever it is
* search facility added in face/hair/boots manager
* top menu restructured with new options
* now modify more than 1 player and save all changes in 1 go
* bugs reported fixed
- program's process now terminates properly

#### v.0.5 BETA [7 JAN 07]

* revised interface (more compact and neat :) )
* top menu view option (toggle visibility of option control(save,save and exit,exit)
* player's names are now correct with no weird characters(accents replaced with standard characters to facilitate search)
* unregistered players no more displayed in players list
* bugs reported fixed
- type mismatch problem solution added in troubleshooting and error is ignored in program(no more crash)
- kitserver not being detected problem fixed
- boots not being saved fixed
* SHORTCUT KEYS ADDED
- ctrl+R - Reload Database
- Ctrl+S - Save
- Ctrl+E - Save And Exit
- CTRL+X - Exit
- ENTER - Search

#### v.0.6 BETA [8 JAN 07]

* direct access to option file meaning NO NEED FOR playersID.txt now [ thanks to Robbie ]
* players are now classified by teams (National teams,club teams,classic teams,Other teams)
* revised interface obviously to accomodate new classfication scheme
* nice new search mechanism. (popup like search results.. double on a result to view player)
* kitserver detection which was causing bugs... definately removed now
* you are prompted to enter your pes6 directory if something goes wrong in detecting the pes6 folder (hopefully this will solve the path not found problem).

#### v.0.7 BETA [10 JAN 07]

* option file detection fixed.
* "Quick Import" added for club teams players.
- directly import face/hair without using face/hair manager
- file automatically renamed to player's name and imported in the player's team folder.
- e.g.
importing a face for Gerrard[Liverpool].. the face will be saved as
"C:\pro evo 6\kitserver\GDB\faces\Liverpool\Gerrard.bin"
* recovery options bugs fixed.
* save disabled when there's nothing to save
* before any critical file manipulation(file delete,map.txt backup)..user prompted to save changes. (to prevent any obsolete entried in map.txt)
* added "tools" menu on topbar
* "recovery" placed under "tools" now
* "clean up" added under "recovery"
- "clean up" option analyses all your face/hair files and delete all unassigned files.
* added "rename" in face/hair/boot manager (all entried in map.txt updated upon file rename)
* .RAR files support!!!
- You nomore need to unrar your files now.
- select the file needed from the .rar file in the RAR listbox (with png preview for boots).
* right-click popup menu(insert,delete,rename,select) in face/hair/boots manager, RAR listbox and search listbox
* progress message added (when cleaning up,backing up or reading .rar files)

#### v.0.8 BETA [11 JAN 07]

* "quick import" added for all teams
- player's with a club will have their face/hair files imported as "<player club team name>/<playername.bin>"
- player's without a club will have their face/hair files imported as "<player national team name>/<playername.bin>"
* if pes6 path or option not detected, you are prompted to specify them manually and directories specified are saved so that you don't have to re-enter manually next time
* automatically registers UnRarOCX.ocx needed to import .rar files
* revised recovery
- map.txt are now saved in GDB root folder as map.faces.backup.txt,map.hair.backup.txt and map.boots.backup.txt
- "Files backup/restore" replaced by "Database and Files backup/restore"
- date of last backup made is displayed when restoring database and files or database only
* cleanup revised (should be faster) I recommend you to do a "Database and Files backup" before performing this operation
- whenever the cleanup fails... restore your old database and files
* minor bugs fixed
* added some pics to fill in empty space lol...

#### v.0.9 BETA [13 JAN 07]

* reoganise map.txt
- reorganise your map.txt entries by teams
* Non-affiliated players can now be viewed under "Non-affiliated players" team
- player's face/hair are saved as Non-affiliated/playername.bin upon "quick import"
* "Preferences" under "settings" added. (now customise some few options of program)
- define your view options
- Automatically save changes before "clean up","backups" and some files manager operations(delete,rename,etc..)
- Automatically "clean up" or "reoganise map.txt" upon "save changes"
* revised directory/file handling procedures in Files manager..Hopefully this will resolve "path not found" error
- there are still issues with folder or files with unicode characters (may not be saved properly in map.txt entries)
* "map.txt viewer" under "Tools" added
- this is a simple map.txt viewer to see how your map.txt files look
- there's also a search facility there to search for anything you want. (e.g. see what files are with what players)
- "refresh" used to reload updated map.txt files

####

#### v.1.0 BETA [17 JAN 07]

- complettely reworked from scratch (done in .NET framework)
- GDB folder found outside kitserver folder is notw supported (by reading the Kload.cfg config file)
- refined GUI
- refined File manager
- refined saving. (all paths are managed internally..hoping that this will solve the "Path not found" error)
- refined cleanup.
  - recovery functions added so as to attempt to restore lost files if cleanup fails.
  - should be faster and less buggy with revised algorithm
- Files reorganisation
  - this function analyses the entries in map.txt
  - it renames and moves the corresponding player's face/hair files to correct format ( i.e. GDB/Faces/<teamname>/<playername.bin>)
- refined recovery
  - multiple backups can be made now
  - select one of your backups and restore it when needed
- changes saved whenever necessary (cleanup,reorganise files,delete file,rename file)

####

#### v.1.1 BETA [19 JAN 07]

- Search fixed (player selected correctly now).
- Clean up results shown. (number of files deleted).
- "Clean up" and "Reorganise files" added for boots
- Added "Import Pack with map.txt" feature. (use backup before using it!!!) .
  - only packs of the format of kitserver GDB faces/hair/boots folder is accepted for now. (i.e. map.txt must be included).
  - refer "How to import pack" in this readme to understand how to use it.
- metallic buttons :)
- in map.txt, now textbox automatically scrolls when searching for a keyword.
- in file manager, search box added.
- transparency attribute for hair in map.txt now supported.

####

#### v.1.2 BETA [19 JAN 07]

- Search fixed once again (player selected correctly now).
- can now add transparency value to hair file .
- FACE/HAIR texture Preview .
- Player List arranged in alphabetical order and search box similar to the one in file manager added .
- Splash screen with progress bar when loading application.
- Much shorter Loading Time for application to start up now.
- "Clean up map.txt only" added .
- Confirmation message appears before doing a "Cleanup" or "File reorganistion".
- cached "All Players" list ..should load up a bit faster now.

#### v.1.3 BETA [20 JAN 07]

- Stadium manager added.
  - it is still very beta and i recommend that you manually do a backup of your existing "Stadiums" folder before using it .
  - read "Read me" for a tutorial of how to use it.... it's very primitive at the moment.
- New saving mechanism....
  - saving changes take only a few seconds now . (probably saving stadiums will slow it down a bit though)
  - will seperate save player's changes and stadium changes in future releases
- Some bugs fixed hopefully. ("pes.exe couldn't be opened" ,"key already entered",....)
- Search fixed once and for all this time i hope :)
- some new visuals again :)

####

#### v.1.4 BETA [23 JAN 07]

- "Import pack without map.txt" added.
  - Automatically matches filename with playername for easy importing of faces/hair packs.
- New saving mechanism
  - Each tab can be saved seperately. (ctrl+S to save current selected tab)
  - unsaved tabs are labelled with "*"
  - ctrl+a to save all tabs changes
- Folder management/file management buttons added in file manager
  - right-click menu mechanism revised.(cannot select a folder/file with rightclick now as it was causing some problems)
  - buttons added as in v.0.9 and earlier
- In UNRAR file window,
  - it now detects whether file selected is a valid file.
  - face/hair/boots preview
- File default import folder settings added.
  - you can choose where your faces/hair/boots files are so that when you import a face/hair/boots file, you are directly directed to these folders.
- Stadium info displayed in "map.txt viewer"
  - Number of entries in stadium map.txt displayed.
  - number of stadium folders in "GDB\stadiums".
- Some stadium bugs fixed
  - "adboards_tex " nomore required .
  - preview.bmp support .
- reorganise files bug fixed
  - transparency bug fixed .
- main search optimized
  - search is quicker now .
- players with no club but in a national team, are imported in national team folder instead of "Non-affiliated" folder.

##### v.1.4.1 BETA [23 JAN 07]

- "Make all hair opaque" option added.
- save mechanism fixed.

####

#### v.1.5 BETA [24 JAN 07]

- slightly modified loading mechanism. (hopefully will solve the "can't open .exe" problem)
- "," in stadium folder name is now supported
- stadium manager similar to face/hair/boots manager added.
- "import pack without map.txt" for boots removed as not very useful
- "import pack without map.txt", face/hair preview for players in players list added with name of file in map.txt displayed.
- faces/hair/boots/stadiums map.txt or folders automatically created if missing

##

#### v.1.6 BETA [27 JAN 07]

- now select pes6.exe instead of the pes6 folder if pes6 is not automatically detected. (Hopefully, this will finally solve the "can't open .exe" problem)
- Ball manager added.
  - not tested a lot..so don't forget, as always, do a backup before using it. (do a manual backup, backup in the PGM is only for faces/hair/boots)
  - add/delete ball entries of balls map.txt.
  - change name,texture, model of the balls.
  - manage your ball texture files similar to faces/hair/boots manager.
  - only texture preview. :(
  - the ball map.txt entries are arranged in the map.txt according to the path of their texture files

  > e.g.

  > ####_ADIDAS_#### # Adidas Teamgeists "Adidas Teamgeist White","modified_gwidon_mdl.bin","ADIDAS\teamgeist\textureplain.bmp" #Adidas Finale "Adidas Finale","ariel_mdl.bin","ADIDAS\Finale\textureblue.bmp"
  > "Adidas Finale Paris06 Final","teamgeistmdl_newtex.bin","ADIDAS\FinaleParis06\texturefinalnew.bmp"

- Stadium manager bugs fixed. (entries without quotes are now handled properly and info.txt bugs also solved)
- "Import pack without map.txt" interface slightly changed with search facility added for pack files.
- "Teams" dropdown menu has a bigger height now to facilitate better navigation

#### v.1.6.1 BETA [27 JAN 07]

- Invalid ball entries in map.txt are ignored and you are indicated which entries are invalid.

#### v.1.6.2 BETA [29 JAN 07]

- There are 2 types of balls save now.
  - first one is like before (i.e. Organise map.txt on save)
  - second one is saving of map.txt entries in alphabetical order. (more stable and much faster).
  - Choose the type you want in "Settings".
- Automatic faces/hair/boots/stadiums/balls map.txt backups on program's first use
  - In "Recovery" tab, choose "Restore Original map.txt" to restore original map.txt files.
- Recovery supports "Stadiums" and "Balls" now.

####

#### v.1.6.2.1 BETA [29 JAN 07]

- small visual fix
- search player list fix

####

#### v.1.6.3 BETA [10 FEB 07]

- Search support for Edited players
- Fixed bug for hair
- bigger window
- Fixed bug with import pack where import changes were not saved

####

#### v.1.6.4 BETA [10 JUL 07]

- kitserver name conflict problem solved
- Stadium info correctly written
- Slightly Revised GUI for import pack menu

#### v.1.6.5 BETA [14 JUL 07]

- WE2007 now supported (national teams name and nationality still not supported but nothing serious). [thx to maxpayne12 for testing the program with WE2007]
- Fixed the "Object reference not set to an instance of an object" problem
- Home ball support
- "Stadiums" tab changed to "Teams " tab. (stadium and home ball support for teams found here).

BETA testing almost over... please POST your bugs here :)

## How to Import "Pack with map.txt"

- "File" --- > "Import Packs"
- choose pack folder

There are 2 lists... the left one is your map.txt while the right one is the map.txt of the pack to be imported.

Now, I will explain the Import pack menus... the regions labelled with numbers are explained below

1. When you choose an entry in "Your map.txt" ... the entry corresponding to the player's id selected in "your map.txt" is automatically selected in "pack's map.txt" list.... this works vice-versa. (this allows you to see what entries are going to be replaced.. etc...)
2. The ids of the player with entry selected in the lists
3. "Overwrite Files" if checked, will automatically allow files imported to replace existing files without any prompt.
   - if unchecked, you will be prompted whether you want to replace duplicate files or not.
   - "overwrite entries" is the same as "overwrite files" except that this concerns the entried in map.txt
4. the first button will import the selected entry of list "pack's map.txt" while the second button will import all the entries in "pack's map.txt"
5. this indicates whether file of selected entry is present or not.

##

## How to import a pack without map.txt

Click on "Load Pack" and browse for your pack's folder.

You have 3 options when importing the files from your pack. Although most invalid files are filtered(e.g. when you are importing faces, all hair files are filtered oout allowing only faces files), there are some files which can't be determined whether it is a face or hair in the program, so these options allow you manage these files.

- "Ignore Possible Invalid Files"

- When selected, files which are suspected to be invalid, are not added to "Pack's FIles List "

- "Import Everything"
  - When selected,even files which are suspected to be invalid, are added to the "Pack's FIles List "
- "Prompt when possible Invalid Files"
  - When selected, each a suspected invalid file is encountered,you are prompted whether you want to add it in "Pack's Files List" or not.

You can use "-" to remove any file from the "Pack' s Files List"

When you choose a file from "Pack' s Files List", you have a preview of the file(face or hair) but note that for some files, there's no preview. It's up to you to judge whether this is a face file or a hair file (e.g. by looking at the filename... "C. Schulz Face by Alegor.bin" being a face and C. Schulz Hair by Alegor.bin" being a hair file for example)

You can switch between "Faces" import or "Hair" import.

Whenever you select a file from "Pack' s Files List" , a search is made to match the player whose name is closest to the filename and the player found is selected in the "Players List".

e.g.

"hairr040_Emanuelson_mystiq.bin" ----- > "Emanuelson"
"facew180_Van Nistelrooy_mystiq.bin" -----> "Van Nistelrooy"
"drogba\facek005.bin" -----> "Drogba"
etc...

These are options when you are importing file(s) from the "Pack's Files List" and assigning it to player(s) in the "players list" .

- "Auto Assign"
  - when selected, it directly imports and assign face/hair file to the player without a prompt
- "Overwrite map.txt entries"
  - when selected, when importing and assigning a face/hair file to a player,who already has an entry in map.txt", the existing map.txt entry is replaced by the new one without a prompt.
- "Overwrite File"
  - Overwrite existing files without a prompt.

There are 2 ways to import the file(s).... "single file import" or "all files import"

> > import file selected in "Pack's Files List" and assign it to the player selected in "players List". Once you have imported the file, it is removed from the list

> > import all files in "Pack's Files List" and automatically assign them to players.

> > - for filenames which have more than 1 player matched to it, are not imported and will remain in the list.

> >   e.g.

> >   "facer022_De Jong_mystiq.bin" ----> there are about 4 "De Jong"

> > - A report is generated at the end of "Import all files" showing which files have been imported and which have not.

## How to Import/Choose a Stadium

- Choose the team, for which you want to assing a stadium, from the teamlist .
- Click on ".." and a folder browser dialog will open up
- To choose an existing stadium that is inside "GDB\Stadiums\" folder as labelled 1 in the picture above
- To import a new stadium that is not in "GDB\Stadiums\" as labelled 2 in the picture above

##

## Troubleshooting

* If you get an error
"Component 'Comdlg32.ocx' or one of its dependencies not correctly registered: a file is missing or invalid"

Check
http://ozmorrowind.planetelderscrolls.gamespy.com/help/ieka2/critical_error_messages.htm
for a solution

### Credits

Thanks to
- "Juce" for his wonderful addon(Kitserver).
- KONAMI for this great game.
- All the people on the www.wevolution.org and www.soccergaming.tv testing my program and giving suggestions and ideas. [thx to maxpayne12 for testing the program with WE2007]

SPECIAL THANKS TO "Robbie" who contributed significantly in this program by developping the tools necessary to directly access pes6 option file.

------------------------------------------------------------
Lplover2k2