AFS Explorer v3.4 --- README

Editing tools for the Next Generation of Winning Eleven games!

by the WE-NG Team

http://dte-ng.issextreme.net

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:

Pro Evolution Soccer 4
Winning Eleven 8
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 ;)

AFS EXPLORER v3.4

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

From version 3.3 to version 3.4	- Fixed: Noticeable increase of speed when listing directories and files.
	- "Modify reserved space" and "Create AFP patch" windows can now be resized.
	- Fixed: Patch size calculation now detached in a separated thread to improve browsing speed in "Create AFP patch" window.

From version 3.2 to version 3.3	- Added support to Winning Eleven 8 graphic files.
	- Added BF encryption to ZLIBManager.
	- Improved plug-in support. Added STR handling functions.
	- AFSExplorer now allows auto-loading of regenerated AFS files.
	- Graphic sub-system now uses ZLIB compression level set on ZLIBManager.
	- Images are now resized when target dimension differ.
	- Improved corrupted AFS handling.Now AFS files with invalid or absent descriptors can be loaded.
	- Added function to export and import all file names in an AFS.
	- Added file name edition.
	- Fixed: Tree window no longer randomly hides directories. Plug-ins are now notified later than before when an AFS file is loaded to asure they do not interfere with AFSExplorer.
	- Added message box notifying the user when AFSExplorer cannot communicate with plug-ins. This way users with misconfigured firewalls will be aware of this fact.
	- Added internal configuration settings for plug-ins via a new DLL exported function, which allows them not to receive notifications from AFSExplorer unless it is explicitaly told. This decreases communication load thus increasing performance. Old plug-ins not supporting this feature are still safely supported ;).
	- Fixed: Correct AFP patch length is now correctly displayed in patch creation window.
	- Fixed: Less warning message boxes when loading AFS files.
	- Some minor improvements and fixes.

From version 3.0 to version 3.2	- Added support to WE7Int graphic files.
	- Added support to WE7Int CES files.
	- Rewrote "Import AFP patch" function. It now acts like a normal folder importing.
	- Improved plug-in support. Added crypt functions.
	- Fixed memory leaks.
	- Fixed error window not appearing on regeneration window. Now an error window appears when the reserved space for an AFS file is not enough to room its sub-files.

From version 2.0 to version 3.0	- Added plug-in support.
	- Fixed "Import folder" function.
	- Fixed "Import AFP patch" function.
	- Added "Update" function.
	- Added status bar.
	- Configuration options increased. New option to enable/disable sub-AFS processing.
	- Updated graphic support. Reflects improvements and fixes done on WEPictureDecoder engine.
	- Added BMP importing/exporting menu options to graphic preview window, allowing the reduction of file size to adjust to reserved space if file results bigger when BMP is imported.
	- Added combo boxes to graphic preview window. Allows selecting between picture, palette, alpha palette and alpha picture views.
	- Added separators to main and graphic preview windows.
	- Fixed graphic and sound player windows reposition.Windows weren't showed when main window was maximized.
	- Improved file list updating speed.
	- Changed font type of main window to system default font.
	- Added toolbar with most important options.
	- Added "ZLIB manager" window.

From version 1.20 to version 2.0	- Finished compatibility with WE7/PES3 AFS v2 files.
	- Configuration options increased. Now you can set paths for external CES and hexadecimal (default) editors; plus options for enabling/disabling coherency check, and allow ignoring descriptor's length.
	- Updated graphic support. WE7/PES 3 kits are now previewed.
	- Added file time support. Due to lazyness I delayed the displaying of the date of files, now it's done ;)
	- Removed the "Min. size" entry in the file list.
	- Graphic preview window now resizeable.
	- Sound player window is now independent.
	- Improved "Modify reserved space" and "Create patch" windows. Now they use a treeview control to easier the management of files. Note updating a treeview is slower than updating a listview, so it may take some time specially with pre-WE7 AFS files.
	- ALL functions now fully support direct management of sub-AFS files. Now there's no need to perform multiple AFS regenerations; this means you can import folders and use AFP patches over sub-afs files.
	- And dozens and dozens of additional small fixes! In example, double-clicking over a .AFS file opens it with another instance of AFSExplorer, etc...

From version 1.15 to version 1.20	- Fixed bug on "Export file" menu option.
	- Fixed bug: double-click had no effect on certain cases.
	- Added "Play sound" to contextual menu.
	- Improved picture hashing. Now images are located faster; this improves image processing speed in graphic preview window, noticeable on files with many images such as font files.
	- Colorized file list to make it more intuitive.

From version 1.0 to version 1.15	- Added compatibility to new AFS format introduced in Winning Eleven 7.
	- AFS files contained in the main AFS file are showed as dirs. They will be marked as "AFS Content" in the file list.
	- Improved search function to work on sub-AFSs.
	- Improved folder extraction function to extract files on sub-AFSs, too.
	- Added playing support to .CES and .SPF files.
	- Updated graphic preview to support new WE7 graphic files.
	- Colorized list in rebuild AFS window to make it more intuitive.
	- User can now tab between tree view and file list windows. '+' and '-' keypad keys now increase/decrease reserved space in rebuild AFS window.

From version 0.40 to version 1.0	- Added search function.
	- Added snoop patch function in Create Patch window. This allows an easier handling of multiple AFP patches.
	- Added graphical preview of pictures (Winning Eleven/PES only).
	- Added keyboard accelerators.
	- Added progress information windows for different operations.
	- Integrated with WEPictureDecoder.
	- Added AFS rebuilding.
	- Added ADX files playing.
	- Added folder importing.
	- Added contextual menu for files.

IMPORTANT NOTES

Plug-ins communicate with AFSExplorer using sockets (network resources) for optimal performance. Be sure you don't have any external software (such as firewalls or antivirus) blocking AFSExplorer attempts of using the network.
Recommended settings at the configuration window: check Configuration Settings at ADDENDUM section. Be specially careful with "Ignore descriptor's length" option.
When loading a WE7, PES3, WE7Int or WE8 original AFS files, be sure you use "Update" function on them before working with them. Check How to correctly load v2 AFS files at ADDENDUM section.
When loading AFS files that miss descriptors, you'll need to regenerate them. Check How to correctly load corrupted AFS files at ADDENDUM section.
If you want to use AFP patches together with another PPF patches, apply first PPF patches then apply AFP patches.
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 managing 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).
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 tools 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 necessary.
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 patched data or even game's code data.
When burning, try to use low speeds. The faster the burning is, the more probable data writing errors occur.
x1 or x2 speeds are recommended with non-branded media, x8 with good quality media.
*TIP* In the main window:
Reserved spaces displayed in green mean the reserved space has been marked with a new value for rebuilding.
Double-clicking a file opens the file with the appropriate program or plays a sound, depending on the file type.
Dragging a file from other app to the file list imports it.
Slowly double-clicking over a file name allows editing its name.
*TIP* In the graphic preview window:
Press left mouse button while you move the mouse to scroll the picture.
Pressing right mouse button over an image opens a pop-up menu allowing to import/export BMP files.
*TIP* In the AFS rebuilding window:
Press '+' and '-' keypad buttons to increase/decrease reserved space for a file.
*TIP* In the AFP patch creation window:
Pressing right mouse button toggles the selection/deselection of all children, in function of parent selection status.
*TIP* In the ZLIB Manager window:
Double-clicking a section opens it with configured hexadecimal editor.
Probably, many things are forgotten... in case you have any doubt you can find help at http://www.issextreme.net/forums

MENU DESCRIPTION

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? ;)
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 "files" list).
  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 "files" list).
3. Import folder...
  Replaces the files of the seleted directory (in "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 "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.
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" plug-in).
  Please, note, filesize.afs/data_X.afs are not AFS files despite of their extension, so they cannot be loaded with AFSExplorer.
2. Import file name list...
  Updates name of files from a file list file.
  Don't forget to use "Update" function to physicaly update AFS file.
3. Create file name list...
  Creates a file that contains all the file names in an AFS file.
  Note the exported file will only be applicable on AFS files having the same directory structure as the AFS the file was created from.
4. 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.
5. 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.
6. Play sound
  Plays the currently selected ADX, CES or SPF sound file.
Advanced
1. Graphic preview
  Toggles 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
  Toggles visibility of sound player window.
3. ZLib manager
  Toggles visibility of zlib manager window.
Help
Info about this software.
Plug-ins
Allows showing/hidding plug-in windows.

ACKNOWLEDGEMENTS

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

* Alex:
Thanks to his tests with AFP patches they are now applied 100% correct.

* 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 plug-in ;)

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

* d4lton:
Another excellent tester, and a graphic design master too! ;) Maker of the great Liga Argentina patches.
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. One of best testers out there and a great guy too!
http://www.wefantasy.com

* Evilgab:
Thanks to him and all Wendetta members many of the latest improvements have been added, thanks to his suggestions 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.net

* 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 plug-in development and bug testing. Thanks!

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

* RCE & WARPJAVIER:
They found WE7/WE8 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 ;)

* Unreal:
Great help all over the time!

* 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

IMPORTANT:
*** You must own an original copy of the game to use these utils ***
*** Use of copies is only allowed to those who own the original ***

ADDENDUM

How to correctly load v2 AFS files

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

[AFS MAIN HEADER]
[HEADER FILE 0] ... [HEADER FILE N]	HEADERS
[FILE 0] ... [FILE N]	FILE DATA
[DESCRIPTOR FILE 0] ... [DESCRIPTOR FILE N]	DESCRIPTORS

The length given at headers was used by the game but had a serious limitation: games hang if the length is lower than the reserved space minus 2048, whilst the field at descriptors seems 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/WE7Int 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/WE7Int AFS v2 files to behave as older AFS v1 files.
Just follow these 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 configuration settings:

"Coherency check" --------------- ACTIVATED
"Sub-AFS processing" ---------- ACTIVATED
"Ignore descriptor's length" ---- DEACTIVATED (*)

(*) The option "Ignore descriptor's length" should NOT be activated unless you are loading an original, non-updated AFS v2 file.
Check How to correctly load v2 AFS files section above for more details.
Having "Ignore descriptor's length" activated will probably cause unexpected results (such as corrupted AFSs) when rebuilding an AFS file, or when importing folders or AFP patches.

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

How to correctly load corrupted AFS files

Here are the recommended configuration settings:

"Coherency check" --------------- ACTIVATED
"Sub-AFS processing" ---------- ACTIVATED
"Ignore descriptor's length" ---- ACTIVATED (*)

AFS files can be corrupted because it helds some incorrect data about the files it contains (e.g. it tells a file is greater than the maximum allocatable space), or because it simply misses some data.
If those corruptions are not serious enough, AFSExplorer can load the AFS file guessing the correct values.

In case the AFS refuses to be loaded, and it contains other AFS files, you can try disabling "Sub-AFS processing" option.

Remember you should rebuild the corrupted AFS file before working with it.

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

Temporal storage issues

AFSExplorer makes use of temporal files for a wide variety of operations, such as graphic displaying, sound previewing or patch importing.

Those temporal files are created on default Window's temporal folder, which varies depending on the operating system.
To correctly operate, AFSExplorer needs the H.D. partition where that temp folder is located to have enough free space.

This feature must be specially considered when importing a patch: as patch files are temporally extracted, it's very important you check there's at least a free space at the OS partition equal or greater than the patch size.
That's it: if a patch is 200MB long, at least 200MB of free space is needed so AFSExplorer can apply the patch.