Differences between revisions 1 and 2
Revision 1 as of 2011-06-21 22:46:44
Size: 3145
Comment:
Revision 2 as of 2011-06-22 19:00:35
Size: 2944
Comment:
Deletions are marked like this. Additions are marked like this.
Line 1: Line 1:
Line 6: Line 5:
This page serves as the README.Debian of the mess programm DebianPkg:mess package. See MameDevel for how to build the package. This page serves as the README.Debian of the mess programm DebianPkg:mess package. See See MameDevel for how to build the package.
Line 11: Line 10:
This package supersedes the xmame-* packages, as the unix sdl port of Mame
has been integrated in official mame since 0.136.
See http://rbelmont.mameworld.info/?p=519 for info.
This package supersedes the xmess-* packages, as the unix sdl port of mess
has been integrated in official mess since 0.136.
Line 17: Line 15:
1. Create a folder "mame" and a subfolder "mame/roms" in your home directory. 1. Create a folder "mess" and a subfolder "mess/roms" in your home directory.
Line 19: Line 17:
2. Download the freely available rom World Rally from http://gaelco.com
and put the wrally.zip file in the "roms" folder.
2. For each emulated system, needs a bios/romset to be put in this directory,
plus some software to run ( an exception is the famicom/Nintendo
Entertainment System where eveything happens inside the cartridge )
Line 22: Line 21:
3. Check now the sanity of your roms. Mame is very picky about that. 3. Check the sanity of your roms. Mess is very picky about that.
Line 25: Line 24:
mame -verifyroms

wrally : tibpal20l8-25cnt.b23 (260 bytes) - NOT FOUND - NO GOOD DUMP KNOWN
wrally : gal16v8-25lnc.h21 (260 bytes) - NOT FOUND - NO GOOD DUMP KNOWN
wrally : tibpal20l8-25cnt.h15 (260 bytes) - NOT FOUND - NO GOOD DUMP KNOWN
romset wrally is best available
mac2bios: macs2os_l.bin (524288 bytes) - NOT FOUND - NO GOOD DUMP KNOWN
mac2bios: macs2os_h.bin (524288 bytes) - NOT FOUND - NO GOOD DUMP KNOWN
romset mac2bios is best available
2 romsets found, 2 were OK.
 mess -verifyroms | grep ^romset
romset famicom [nes] is best available
romset fami_key [nes] is best available
romset famitwin [nes] is best available
romset stbook [ste] is best available
romset ti99_224 is best available
romset ti99_232 [ti99_224] is best available
romset tmc1800 is best available
romset tmc2000e is best available
romset osc1000b [tmc1800] is best available
Line 37: Line 36:
You can safely ignore the mac2bios warning.
Line 39: Line 37:
4. Now start Mame with the command "mame" from the shell
or from your desktop applications menu.
4. Get a public domain rom of LJ65, a tetris clone, for your nes
{{{
wget http://www.pdroms.de/media/upload/files/20091126_lj65_v0.41.zip
}}}
{{{
unzip 20091126_lj65_v0.41.zip
}}}
Line 42: Line 45:
5. Basic keyboard commands include
  * 5 key to insert a coin
  * 1 key to start the game
  * Tab key to access the mame internal menu
5. Now start mess with
{{{
mess nes -cart lj65.nes
}}}
Line 47: Line 50:
6. If mame is way too slow on your computer and you have 3D hardware 6. Basic keyboard commands include
  * Tab key to access the mess internal menu
  * 5 to select, 1 to start

7
. If mess is way too slow on your computer and you have 3D hardware
Line 49: Line 56:
in the Mame configuration file. in the mess configuration file.
Line 53: Line 60:
  * MAME binary: {{{/usr/games/mame}}}
  * MAME tools directory: {{{/usr/bin}}} (chdman, ldresample, ...)

  * Configuration file: {{{$HOME/.mame/mame.ini}}} or {{{/etc/mame/mame.ini}}}
  * Output folders: {{{$HOME/.mame}}} (memory cards, snapshots, ...)
  * Core folders: {{{/usr/share/games/mame}}} (roms, cheats, ...)
  * mess binary: {{{/usr/games/mess}}}
  * Configuration file: {{{$HOME/.mess/mess.ini}}} or {{{/etc/mess/mess.ini}}}
  * Output folders: {{{$HOME/.mess}}} (memory cards, snapshots, ...)
  * Core folders: {{{/usr/share/games/mess}}} (roms, cheats, ...)
Line 62: Line 68:
in {{{/etc/mame/mame.ini}}} in {{{/etc/mess/mess.ini}}}
Line 66: Line 72:
  * make your own copy of {{{/etc/mame/mame.ini}}} in your home at {{{$HOME/.mame/mame.ini}}} and edit that file (recommended)
  * edit directly {{{/etc/mame/mame.ini}}}
  * make your own copy of {{{/etc/mess/mess.ini}}} in your home at {{{$HOME/.mess/mess.ini}}} and edit that file (recommended)
  * edit directly {{{/etc/mess/mess.ini}}}
Line 69: Line 75:
You can verify that MAME have read the correct options with "{{{mame -showconfig}}}"
and even create a fresh mame.ini file with "{{{mame -createconfig}}}".

If you upgraded from a previous version of mame, you might have to replace your
rom sets, see the [[http://ur1.ca/3a2w5|Mame FAQ on ROMs]].
You can verify that mess have read the correct options with "{{{mess -showconfig}}}"
and even create a fresh mess.ini file with "{{{mess -createconfig}}}".
Line 77: Line 80:
MAME utilities like chdman, jedutil, ldresample or ldverify are available in a mess utilities like chdman, jedutil, ldresample or ldverify are available in a


This page serves as the README.Debian of the mess programm mess package. See See MameDevel for how to build the package.


HISTORY

This package supersedes the xmess-* packages, as the unix sdl port of mess has been integrated in official mess since 0.136.

QUICK START

1. Create a folder "mess" and a subfolder "mess/roms" in your home directory.

2. For each emulated system, needs a bios/romset to be put in this directory, plus some software to run ( an exception is the famicom/Nintendo Entertainment System where eveything happens inside the cartridge )

3. Check the sanity of your roms. Mess is very picky about that.

 mess -verifyroms | grep ^romset
romset famicom [nes] is best available
romset fami_key [nes] is best available
romset famitwin [nes] is best available
romset stbook [ste] is best available
romset ti99_224 is best available
romset ti99_232 [ti99_224] is best available
romset tmc1800 is best available
romset tmc2000e is best available
romset osc1000b [tmc1800] is best available

4. Get a public domain rom of LJ65, a tetris clone, for your nes

wget http://www.pdroms.de/media/upload/files/20091126_lj65_v0.41.zip

unzip 20091126_lj65_v0.41.zip

5. Now start mess with

mess nes -cart lj65.nes

6. Basic keyboard commands include

  • Tab key to access the mess internal menu
  • 5 to select, 1 to start

7. If mess is way too slow on your computer and you have 3D hardware acceleration available, change the "video" parameter from "soft" to "opengl" in the mess configuration file.

DEFAULT FILES

  • mess binary: /usr/games/mess

  • Configuration file: $HOME/.mess/mess.ini or /etc/mess/mess.ini

  • Output folders: $HOME/.mess (memory cards, snapshots, ...)

  • Core folders: /usr/share/games/mess (roms, cheats, ...)

ROMS AND CONFIGURATION

A default configuration file is provided with the package and installed in /etc/mess/mess.ini

If you need to change the location of the roms folder or tweak something like video or cheats you can either:

  • make your own copy of /etc/mess/mess.ini in your home at $HOME/.mess/mess.ini and edit that file (recommended)

  • edit directly /etc/mess/mess.ini

You can verify that mess have read the correct options with "mess -showconfig" and even create a fresh mess.ini file with "mess -createconfig".

TOOLS

mess utilities like chdman, jedutil, ldresample or ldverify are available in a separate extra package called mame-tools.

PATCH

This package uses quilt to manage all modifications to the upstream source. Changes are stored in the source package as diffs in debian/patches and applied during the build. See /usr/share/doc/quilt/README.source for a detailed explanation.