Ads keep us online. Without them, we wouldn't exist. We don't have paywalls or sell mods - we never will. But every month we have large bills and running ads is our only way to cover them. Please consider unblocking us. Thank you from GameBanana <3

[PS2] MYMC - A Modding Tool for GameBanana


By Ross Ridge
Pubic Domain

@(#) mymc README.txt 1.6 12/10/04 19:18:08

This file describes mymc, a utility for manipulating PlayStation 2

memory card images as used by the emulator PCSX2.  Its main purpose is

to allow save games to be imported and exported to and from these

images.  Both MAX Drive and EMS (.psu) save files are fully supported,

however save files in the SharkPort/X-Port and Code Breaker formats

can only be imported and not exported.  In addition to these basic

functions, mymc can also perform a number of other operations, like

creating new memory card images, viewing their contents, and adding

and extracting individual files.

A simple, hopefully easy to use, graphicial user interface (GUI) is

provided, but it's limitted to only basic operations.  More advanced

opterations require the use of a command line tool.  To install mymc,

unpack the downloaded ZIP archive to a new directory on your machine.

You can then run the GUI version of mymc by openning that newn

directory with Windows Explorer and double clicking on the "mymc-gui"

icon.  To make it easier to access, you can drag the "mymc-gui" icon

to either your Desktop, Start Menu or Quick Launch toolbar.  Make sure

if you do so, that you create a shortcut to "mymc-gui.exe".  If you

copy the file instead, the program won't work.

The command line utility can be invoked from the Windows Command

Prompt by using the "mymc" command.  The executable "mymc.exe" and

number of support files and these file must kept together in the same

directory.  To run the command you need to either add the directory

where you unpacked the distribution to your PATH or type the full

pathname of the executable.  For example if you unpacked mymc to a

directory named "c:\mymc" you need to enter "c:\mymc\mymc.exe" to run

the program.

The second important thing to note is that mymc is only "alpha"

quality software.  This means that has is been released without

extensive testing and may be unreliable.  While it works fine for me,

the author, it might not work as well for you.  For that reason you

should be careful how you use it, and prepared for the eventuality of

it corrupting your save game images or producing garbage save files.

If you're worried about this, one make things safer is to use two

memory card images.  Use the first image to load and save your games

with under PCSX2, and the second image to import and export saves

games using mysc.  Then use the PS2 browser to copy files between two

card images.



The GUI for mymc is should be easy to use.  After starting mymc, you

can select the PS2 memory card image you want to work with by

selecting the "Open" command by pressing the first button on the

toolbar.  You can then import a save file clicking on the Import

toolbar button.  To export a save files, first select it and then

press the Export button.  You can delete a save file permanently from

your memory card, by selecting the "Delete" command from the File


Do not try to use mymc to modify a memory card image while PCSX2 is

running.  Doing so will corrupt your memory card.



The basic usage template for mysc is "mymc memcard.ps2 command".  The

first argument, "memcard.ps2" is the filename of the memory card image

while "command" is the name of the command you wish to use on the

image.  So for example, assuming you've installed mymc in "c:\mymc"

and you've installed PCSX2 in "c:\pcsx2" you could enter the following

command to see the contents of the memory card in the emulator's slot


    c:\mymc\mymc c:\pcsx2\memcards\Mcd001.ps2 dir

You would see output something like this:

    BASLUS-20678USAGAS00             UNLIMITED SAGA

     154KB Not Protected             SYSTEMDATA

    BADATA-SYSTEM                    Your System

       5KB Not Protected             Configuration

    BASLUS-20488-0000D               SOTET<13>060:08

     173KB Not Protected             Arias

    7,800 KB Free

This is the simple "user friendly" way to view the contents of a

memory card.  It displays the same information you can see using the

PlayStation 2 memory card browser.  On the right is name of each save,

and on the left is the size and protection status of the save.  Also

on the left is one bit of information you won't see in the browser,

the directory name of the save file.  PlayStation 2 saves are actually

a collection of different files all stored in a single directory on

the memory card.  This is important information, because you need to

know it to export save files.

As mentioned above, if you know the directory name of a save, you can

export it.  Exporting a save creates a save file in either the EMS

(.psu) or MAX Drive (.max) format.  You can then transfer the save to

real PS2 memory using the appropriate tools.  You can also send the

saves to someone else to use or just keep them on your hard drive as a

backup.  The following command demonstrates how to export a save in

the EMS format using mymc:

    c:\mymc\mymc c:\pcsx2\memcards\Mcd001.ps2 export BASLUS-20448-0000D

This will create a file called "BASLUS-20448-0000D.psu" in the current

directory.  To create a file in the MAX format instead, use the export

command's -m option:

    c:\mymc\mymc c:\pcsx2\memcards\Mcd001.ps2 export -m BASLUS-20448-0000D

This creates a file named "BASLUS-20448-0000D.max".  Note the "-m"

option that appears after the "export" command.

Importing save files is similar.  The save file type is auto-detected,

so you don't need use an "-m" option with MAX Drive saves.  Here's a

couple of examples using each format:

    c:\mymc\mymc c:\pcsx2\memcards\Mcd001.ps2 import BASLUS-20035.psu

    c:\mymc\mymc c:\pcsx2\memcards\Mcd001.ps2 import 20062_3583_GTA3.max



    - To get general help with the command line utility use the "-h"

      global option (eg. "mymc -h").  To get help with a specific

      command use the "-h" option with that command (eg. "mymc x

      import -h").  In this later case, you need to specify a memory

      card image file, but it's ignored and so doesn't need to exist.

    - Both executables in the Windows version, "mymc.exe" and

      "mymc-gui.exe" do the same thing and support the same options.

      The difference is that "mymc" is console application, while

      "mymc-gui" is a Windows appliction.  Currently, using "mymc"

      to start the GUI will result in a fair amount debug messages

      being printed that are normally not seen "mymc-gui" is used.

    - It's possible to use mymc create images that are bigger (or

      smaller) than standard PS2 memory cards.  Be very careful if you

      do this, not all games may be compatible with such images.

    - The bad block list on images is ignored.  Since memory card

      images created with either PCSX2 or mymc won't have any bad

      blocks, this shouldn't be a problem unless you've somehow

      extracted a complete image from a real memory card and expect to

      copy it back.

    - The PS2 only uses at most 8,000 KB of a memory card, but there

      is actually 8,135 KB of allocatable space on a standard

      error-free memory card.  The extra 135 KB is reserved so that

      memory card with bad blocks don't appear to have less space than

      memory cards with fewer or no bad blocks.  Since there are no

      bad blocks on memory card images, mymc uses the full capacity

      provided by standard memory cards.



The "source code" distribution of mymc is provided for users of Linux

and other non-Windows operating systems.  It uses the same Python code

that the Windows distribution is built with (using py2exe) and

supports all the same functionality.  One big difference is that the

Windows DLL "mymcsup.dll" is not included and as a result compressing

and decompressing MAX Drive saves will be as much as 100 times slower.

The GUI mode is hasn't been extensively tested on non-Windows systems,

and the 3D display of save file icons requires the DLL.  The Python

source version should support big-endian machines, but this hasn't

been tested.

No comments yet