DonPachi (arcade, US version) for Windows and Linux - version 0.7.0
=======================================================================

A native Windows and Linux version of Cave's 1995 arcade shooter DonPachi,
rebuilt from the arcade program. It does not come with the game's graphics, sound
or data: you need your own copy of the arcade ROM set.


GETTING STARTED
---------------
On Windows (DonPachi-0.7.0-win64.zip):
1. Unzip this folder somewhere you can write to (your Documents or Desktop, for
   example; not inside "Program Files").
2. Double-click donpachi.exe.
   Windows may say "Windows protected your PC" the first time, because the program
   is not signed. Click "More info", then "Run anyway".

On Linux (DonPachi-0.7.0-linux-x64.tar.gz; a 64-bit Linux):
1. Unpack it somewhere in your home folder:
       tar xzf DonPachi-0.7.0-linux-x64.tar.gz
2. Run ./donpachi in that folder (or double-click it in your file manager).
   It uses your system's SDL2. If it says libSDL2-2.0.so.0 is missing, install it:
       Debian / Ubuntu / Mint:  sudo apt install libsdl2-2.0-0
       Ubuntu 25.10 and later:  sudo apt install libsdl2-compat
       Fedora:                  sudo dnf install SDL2
       Arch:                    sudo pacman -S sdl2

Then, on both:
3. A window asks for the ROM set. Drag MAME's donpachi.zip (the US version) onto
   it. The game takes what it needs from it once and saves it as donpachi_usa.dat
   beside the program; after that the .zip isn't needed. Merged and non-merged MAME
   sets both work. If your set is incomplete, the window lists the files it is
   missing.


CONTROLS (change them in SETTINGS > CONTROLS)
---------------------------------------------
                  Player 1        Player 2        Gamepad
  Move            Arrow keys      R D F G         D-pad / left stick
  Shot (hold:     Z               A               X
   laser)
  Bomb            X               S               A
  Auto fire       C               Q               B
  Start           1               2               Start
  Coin            5               6               -

  Esc / gamepad Back     the menu (pause, settings, save states, training)
  F3                     reset the game
  F4                     reset into the arcade's test (service) menu
  F5 / F8                save state / load state (for this session)
  F6 / F7                the save state slot before / after (5 slots)
  Tab / LB (held)        fast forward
  F11 or Alt+Enter       full screen

Free play is on by default: Start drops in a credit.


FEATURES
--------
  - The arcade's slowdown: when the screen is busy the game slows down at the
    same moments as the real board, as it counts the 68000's time instruction by
    instruction (checked against MAME). GAME OPTIONS > SLOWDOWN turns it off
  - Main menu: START GAME, TRAINING (start at any area, any point part way
    through it, its mid-boss or boss, with your choice of ship, power, bombs
    and difficulty), SETTINGS
  - Side panels on wide screens: chain gauge, rank, run statistics, bees
    collected, score graph against the top score, stage progress and boss and
    mid-boss health
  - A CRT look (SETTINGS > GRAPHICS > CRT): a curved arcade screen with its
    scanlines, phosphor stripes and glow
  - Save states, fast forward, hitbox display, scanlines, borderless or exclusive
    full screen, difficulty and the arcade's hidden big HIT display in GAME OPTIONS
  - High scores kept between sessions (not while cheats or save states were used)
  - 26 achievements (main menu > ACHIEVEMENTS): area clears, no-miss and no-bomb
    clears, all 13 bees, long chains, scores and more. Earned in the arcade game
    only: not in training, or in a game with a cheat or a loaded save state
  - Replays (main menu > REPLAYS): every arcade game is recorded; when it ends
    you're asked whether to save it (in the replays folder). In training,
    SAVE REPLAY in the pause menu keeps the attempt. Watch, rename or delete
    them from the menu, or share the .dpreplay files. While watching: Space
    (gamepad A) pauses, Right (d-pad right) steps one frame
  - Menu tooltips: with the side panels on, the right one explains the
    highlighted option while a menu is open
  - Lifetime statistics (main menu > STATISTICS): games, play time, clears,
    bosses, deaths, bombs, bees, best chain and scores, per ship and per area
    (arcade games only, as the achievements)


CHEATS
------
The cheats page (SETTINGS > GAME OPTIONS > CHEATS) has the game's own: AI PLAYER
2 (the computer flies player 2 beside you, joining by itself), and infinite
lives, infinite bombs, invincibility, MAX power and an endless chain, for each
player. GAME OPTIONS > DEBUG TOOLS brings back the developers' debug mode and
RAM editor, left in the arcade program (the page lists their controls). For
more cheats, add MAME's cheat file for DonPachi (not included here); its
cheats are listed after the game's own:
  1. Download MAME's cheat collection, cheat.7z (from Pugsy's Cheats,
     https://www.mamecheat.co.uk).
  2. Open it with 7-Zip and take out donpachi.xml.
  3. Make a folder called "cheats" beside the program (donpachi.exe on Windows,
     donpachi on Linux) and put donpachi.xml in it, so you have
     cheats/donpachi.xml in the same folder as the program. (Or set the full path
     as "cheats =" under [files] in donpachi.ini.)
High scores aren't saved while a cheat is on.


FILES THE GAME KEEPS BESIDE THE PROGRAM
---------------------------------------
  donpachi_usa.dat   the game data taken from your ROM set
  donpachi.ini       your settings (delete it to go back to the defaults)
  donpachi.eeprom    the arcade board's own settings (the test menu's)
  donpachi.hiscore   the high score table
  donpachi.achievements   the achievements you've earned, and when
  donpachi.stats     your lifetime statistics
  replays\           your replays (.dpreplay files: share them, or delete the
                     ones you don't want)

Keep these if you move the game to another folder or computer. Don't share
donpachi_usa.dat: it is the contents of the ROM set.

donpachi.eeprom is in MAME's format: to bring your settings over from MAME,
copy MAME's nvram\donpachi\eeprom beside the program as donpachi.eeprom (and
the other way round).

If the game's folder can't be written to (installed somewhere read-only), it
keeps them in your own folder instead: ~/.local/share/DonPachi/ on Linux,
%APPDATA%\DonPachi\ on Windows.


LICENSES
--------
See the licenses folder: this program's notices, and SDL2's license.
DonPachi is (c) 1995 Cave / Atlus. This is an unofficial fan project, not
connected with or endorsed by them.
