Editing tools for the Next Generation of Winning Eleven games!

by the WE-NG Team

http://dte-ng.issextreme.com

1. ABOUT
2. DESCRIPTION
3. CHANGES
4. IMPORTANT NOTES
5. MENU DESCRIPTION
6. ACKNOWLEDGEMENTS
7. ADDENDUM

ABOUT

"DTE!/NG" is a set of tools that allows the edition of the soccer games created for the console Playstation-2 and PC by Konami.
These tools work under Win32.

To the date, the games that have been tested on are:

• Winning Eleven 7 International
• Pro Evolution Soccer 3
• Winning Eleven 7
• Winning Eleven 6 International
• Winning Eleven 6 FE
• Winning Eleven 6 Junior League
• Winning Eleven 6
• Winning Eleven 5 FE
• Pro Evolution Soccer 2
• Pro Evolution Soccer
• it's also been reported the tools work on other non-Konami games ;)

To the date, the toolkit is comprised of four applications:

• AFSExplorer v3.0
• WEPictureDecoder v1.60
• CATExplorer v0.43
• CESExplorer v0.62

AFS EXPLORER v3

DESCRIPTION

This software allows managing the AFS files found on many console games (such as Konami's Winning Eleven and Pro Evolution Soccer games for the PSX-2 and PC).
Those files contains most graphics and sounds of the game, as well as files containing another data.
This tool also allows the creation and use of AFP patches.
Appart from these basic functions for handling AFS files, the application includes some specific options to be used with the previous games).

This application is designed to work under Win32 platforms, and has been tested to work under all avalaible 32-bit Windows OSs.

CHANGES

IMPORTANT NOTES

• Recommended settings at the configuration window: check Configuration Settings at ADDENDUM section.
  
  
• You can replace/export any file in/from the AFS file.
  But you can't replace using files greater than the reserved space the replaced file has.
  
  
• In the case you want to insert greater files, you must use the "Modify reserved space" (regeneration), which allows to manage the reserved spaces.
  You can also use the "Import folder" option.
  
  
• Regeneration of AFS files is not a trivial operation, so it can take long on some computers, specially on those with low-performance hard disks.
  
  
• Be careful when modifying the reserved spaces trying to avoid creating an AFS file greater than the original. Otherwise you'll have to rebuild CD image's ISO structure to be able to insert the new AFS file into the image.
  
  
• When applying a patch, it can happen the size of new AFS file is bigger than the original.
  To minimize the possibility it happens, you should try not to increase the reserved slot for the files; on the contrary, when possible, try to reduce the original reserved spaces, so the marked AFS file length is as short as possible.
  
  
• Tricks to reduce files length:
  • In the case of images, you can decrease the number of palette colors they use to gain space (can be done with WEPictureDecoder).
  • In the case of sounds, shorten their lengths or reduce their frequency (can cause games to hang in some cases).
    
    
• If you want to use AFP patches together with another PPF patches, apply first the PPF patches then apply the AFP patches.
  
  
• Don't forget that a NEW AFS file is created when you apply a patch that modifies the reserved spaces of the patched AFS file.
  
  
• There are some utils out there to extract/replace the AFS file from a CD image. The recommended one is CDMage. Make sure your version is, at least, 1.02.1 BETA 5.
  
  
• After replacing the AFS file in the CD image, and before burning it, you should update the image's CRC fields so the machine does not take the modified data as erroneous. If your CD-burner supports automatic ECC correction this step is not neccessary.
  You can use ECCReGen or CDMage.
  
  
• If you use CDMage to replace the AFS file, you should only use the "Scan for Corruption" and "Rebuild Sector Fields" options. Do not use "Repair corrupted sectors" as the app will try to recover the original information leading to a more than probable corruption of the the patched data or even game's code data.
  
  
• When burning, try to use low speeds. The faster the burning is, the more probable data writting errors occur.
  x1 or x2 speeds are recommended with non-branded media, x8 is recommended with good quality media.
  
  
• *TIP* In the main window:
  Reserved spaces displayed in green mean the reserved spaced has been marked with a new value for rebuilding.
  Double-clicking opens the file with the appropiate program or plays a sound, depending on the file type.
  
  
• *TIP* In the graphic preview windows:
  Press left mouse button while you move the mouse to scroll the picture.
  
  
• *TIP* In the AFS rebuilding window:
  Press '+' and '-' keypad buttons to increase/decrease reserved space for a file.
  
  
• *TIP* In the patch creation window:
  Pressing right mouse button toggles the selection/deselection of all children, in function of parent selection status.
  
  
• Probably, many things are forgotten... in case you have any doubt you can find help at http://www.issextreme.com/forums

MENU DESCRIPTION

1. File
   
   
   1. Open File...
      Imports an AFS file.
      
      
   2. Update...
      Updates AFS control data (headers and descriptors).
      Useful for fixing AFS v2 to behave as AFS v1 files.
      
      
   3. Configure...
      Options to configure the application.
      
      
   4. Exit
      Uhmm... what's this for? ;)
      
      
2. Action
   The options of this menu provide a way of modifying the files contained in the AFS file.
   
   
   1. Import file...
      Replaces the file selected in the ("files" section).
      The imported file can't be greater than the currently selected file. In case the file is greater file won't be imported, but you'll be asked if you want to pre-adjust its reserved space, very useful to easier the regeneration of AFS files.
      
      
   2. Export file...
      Saves the file selected (in the "files" section).
      
      
   3. Import folder...
      Replaces the files of the seleted directory (in the "folders" section) and its subdirectories.
      The files you import, and the subdirectories, must have the same name than the original ones.
      You'll only be notified when trying to import a file that is bigger than the original reserved space, or
      when you could save AFS space on case the file is smaller enough.
      It's NOT necessary to import all files, it will only import those matching the previous two requeriments.
      
      NOTE: It will NOT import files into sub-AFS directories (they are AFS files...).
      
      
   4. Export folder...
      Saves the files of the seleted directory (in the "folders" section) and its subdirectories.
      
      
   5. Search...
      Opens a dialog box that allows to search for next file whose name contains the introduced string.
      Only single words can be searched. There's no need to use character * as wildcard: a search for "general" is equivalent to "*general*".
      
      
   6. Find next
      Same than search, looking for last searched string.
      
      
   7. Open with...
      Opens the currently selected file with the choosen tool. You can set those tools at the configuration window.
      
      
3. Advanced
   Rooms some options that allow modifying the AFS structure.
   
   
   1. Modify reserved space...
      Opens a window that allows changing the reserved slot for each file.
      NOTE: WE7, WE7International and PES3 games for Playstation2 use an external file (filesize.afs or size_X.af, depending on the game) to get the reserved spaces. You'll need to recreate that file too when the AFS is regenerated (use "Filesize creator" plugin).
      Please, note, filesize.afs/data_X.afs are not AFS files despite of their extension, so they cannot be loaded with AFSExplorer.
      
      
   2. Import patch...
      Loads an AFS patch.
      Don't forget that a NEW AFS file is created when you apply a patch and it modifies the reserved spaces of the patched AFS file.
      
      
   3. Create patch...
      Opens a window that allows selecting which files you want to include in the patch, and creates it.
      If you select a file being an AFS you should not select any of it sub-files, as those sub-files are already contained by that AFS file.
      
      
   4. Play sound
      Plays the currently selected ADX, CES or SPF sound file.
      
      
4. Advanced
   
   
   1. Graphic preview
      Togles visibility of graphic preview window. If not visible, software won't try to load file selected in the file list, so it'll be faster.
      
      
   2. Sound player
      Togles visibility of sound player window.
      
      
   3. ZLib manager
      Togles visibility of zlib manager window.
      
      
5. Help
   Info about this software.
   
   
6. Plugins
   Allows showing/hidding plugin windows.
   

ACKNOWLEDGEMENTS

This software uses code from zlib v1.1.4 Copyright (c) 1995-2002 Jean-loup Gailly and Mark Adler

This software uses AdxToWav() code Copyright (c) 2001 BERO

The author would like to thank the following people (in alph. order):

* Antiz:
For testing the AFS rebuilding and patch generation with his great chants patch. Thanks mate!

* Ataru-CrespoGol:
For testing latest beta versions! Lots of great ideas!!

* Billy:
Many thanks for testing the ADX/SPF plugin ;)

* Burgy:
Has helped a lot testing the software! Don't miss his site: http://issrealgame.fr.st
Maker of the fabulous WE6FE L1/L2 French League patch!

* d4lton:
Another excellent tester, and a graphic design master too! ;) Maker of the great WE6FE Liga Argentina patch.
Has done a great, great job testing newer versions! He has also been the animated logo designer.
http://www.023.com.ar/we

* Eriol:
Has helped a lot testing the programs.

* Evilgab:
Thanks to him many of the latest improvements have been added, thanks to his suggestion and bug tracking.
http://www.weitalia.da.ru

* El_Hacker:
Designer of the GREAT!! original logo.

* Goku:
Has helped testing the software and giving all support I've needed! He is the one who has designed the DTE-NG website!
The best WE/PES site ever!: http://www.issextreme.com

* Honome:
He was who convinced me to start this stuff. With his unvaluable help in the research and test, this project could not be performed! He lost lots of CDs burning them to test that things worked... until he knew he could have used CD-RWs xDDD
He is one of the makers of the impressive WE6FE WE-Classic and Campeonato Brasileiro patches!
http://www.w11.com.br
http://www.weclassico.hpg.ig.com.br

* K0H:
For spending some of his short spare time testing the util. He is the "Graphic Master" ;) as you can see on the great WE6FE WEHispano patch.
http://www.wehispano.tk

* KOC2000:
Has tested .FNT files and ID edition features. Thanks ;)

* Mauras:
Has tested the utils with his portuguese league patch. Has always offered his help when I've needed it. Obrigado!
http://www.lusowedit.html

* Mephisto:
He has provided invaluable help due to his tests with plugin development.

* MikeOM:
Thanks for being such a great guy! Babe's power!! xD

* RCE & WARPJAVIER:
They found WE7 encryption algorithm! Great job they've done!!

* Rh4psody:
A "Class A" tester this one ;) Hope it helps on his fabulous, state-of-the-art patches!
http://www.wedoit.da.ru

* ShinjiOno:
Thanks for the bug reports mate!

* Solidus J2k:
Great help since he tested the new patching format with his chants patch. His great chants patch has been the first released using AFP patch format!
http://w11extremo.da.ru

* TCrew:
Thanks to his posts and his home page I've been able to have a reference point from where to start this project!
http://www.total-amiga.com/we6

* Txema7:
Thanks to his testing on AFSExplorer, the bug on window title displaying could be fixed ;)

* All the other people I've forgotten:
If I've done so, sorry for it!

* (All people at the ISSExtreme forums):
Thanks for the feedback and suggestions!

------------ Tato

ADDENDUM

How to correct a WE7/PES3 AFS file

In previous AFS files, the length of the file was located in two places: headers and descriptors.

The length given at headers was used by the game but had a serious limitation: the game hanged if the length was lower than the reserved space - 2048, whilst the field at descriptors seemed not to affect the games when modified.

Therefore the length given at descriptors in AFSExplorer was used to know the real length of files;
this way you can freely insert files without the limitation of the header and therefore insert small files without having to modify the reserved space for that file.

But, with the arrival of WE7/PES3 games, Konami has slightly modified the structure of AFS files.
The descriptor's field has been filled with some unknown data and this causes AFSExplorer to show the length of files incorrectly (you'll probably get a coherency error message when loading the file).

Fortunately, you can fix WE7/PES3 AFS v2 files to behave as older AFS v1 files.
Just follow this instructions:

• Open "Configuration" window [shortcut = F1]
  • Under "AFS loading options", activate "Ignore descriptor's length" option
  • (Press "OK" button) ;)
    
    
• Import original AFS file
  
  
• Use "Update" menu option to fix the AFS file. The file to be fixed cannot be write-protected.
  
  
• Open "Configuration" window again
  • Deactivate "Ignore descriptor's length" option
  
  
• Import the regenerated AFS file

With the new AFS file you'll be able to fully insert/extract files much smaller than the reserved space again.

====================================================

Configuration settings

Here are the recommended settings depending on the AFS file you want to load.

• FOR OLD AFS v1 FILES (WE6FE, WE6I and previous games), and the RECOMMENDED DEFAULT

+ "Coherency check" --------------- ACTIVATED
+ "Sub-AFS processing" ---------- ACTIVATED
+ "Ignore descriptor's length ----- DEACTIVATED

• FOR NEW AFS v2 FILES (WE7 & PES3)

+ "Coherency check" --------------- ACTIVATED
+ "Sub-AFS processing" ---------- ACTIVATED
+ "Ignore descriptor's length" ---- ACTIVATED

* If you use an AFS v2 file fixed by the method described in How to correct a WE7/PES3 AFS file, use the recommended settings for OLD files.