summaryrefslogtreecommitdiff
path: root/README
blob: b74b7ecc31daa8c40daa98e5998e93652c6b5de7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
 *
 * Copyright 2012 Florian Jung <florian.a.jung@web.de>
 * 
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License Version 3
 * as published by the Free Software Foundation.
 * 
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 * 
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston,
 * MA 02110-1301, USA.
 *


This bot shall be able to play Mario Kart using the Mupen64Plus emulator.
It works both on Linux and on FreeBSD, but there are some differences:
	- under Linux, we can uinput to emulate a joystick. This works
	  with an existing mupen64plus installation, you just need to
	  create a suitable button mapping. currently, you can only create
	  it by uncommenting the code block with "press enter to steer left"
	  in mariokart.cpp.
	- under FreeBSD, you have to (and under Linux, you probably can)
	  use a patched version of the Mupen64Plus-SDL-Input-plugin.
	  Under FreeBSD, build mupen64plus from ports as usual, but then:
	  - cd into /usr/ports/emulators/mupen64plus-input-sdl/
	  - run 'make patch'
	  - cd work, and apply mupen64plus-input-sdl.patch from this repo
	  - cd .. and make install as usual
	  The input plugin will now create a FIFO/named pipe at 
	  /var/tmp/mupen64plus_ctl, which the bot writes to.
	  This does not affect normal gaming experience, the "external
	  control" only kicks in once the FIFO is written. Then, you cannot
	  use your "actual" controls any more.
	  
The program currently expects ~/MarioKart64.rom to be a valid
Mario Kart 64 ROM file which is playable by Mupen64Plus.
(Please note that it might be illegal to download the file from the
internet, and it definitely is illegal if you don't own the game AND
a N64. Don't do that.)

When you start ./mariokart, a Mupen64Plus instance is launched.
You have to navigate to a Time Trial with a suitable course (only
tested with Flower Cup -> Mario Raceway so far), start the game, and
wait for the small ghost to disappear. (You probably want to save the
state using F5 now; in future, you can get here quickly with F7).

Then press "ENTER" in the mariokart bot command window and enjoy :)