Ascii Patrol is an ASCII game project. It was mainly inspired by "Moon Patrol", my favourite arcade game at the times I was a child.
Currently game can be built using C++ compilers such as Clang, GCC, or Intel oneAPI including operating systems:
- Windows (Visual Studio, Cygwin, MinGW, MSYS2, Windows Subsystem for Linux)
- Linux, MacOS
- DOS (Watcom)
- HTML5 browsers (Emscripten)
- Added $ASCII_PATROL_CONFIG_DIR and $ASCII_PATROL_RECORD_DIR environment variables (Linux only)
- Thanks to XM player patch provided by @hexwab music sounds even better https://ascii-patrol.com/area54/ascii-patrol-html5.html
- Mobile browsers can use touch input More on how to navigate & play using touch input is here: https://ascii-patrol.com/forum/index.php?topic=71.0
- It is possible to install game as PWA from: https://ascii-patrol.com/area53/ascii-patrol-html5.html
- You may also notice some vibrations bzzzz....
To use / modify / add graphics asserts located in 'asset' directory you need to use REXPaint Copy 'assets' directory to REXPaint's 'images' subdirectory. To apply modifications to the game, in next step you should use temp_xp program which converts all .xp files located in some directory to assets.cpp and assets.h files being compiled with game.
Ascii Patrol Home Page (ascii-patrol.com)
Accordingly to raspberrypi.org AP can be easily built and runs great on Raspberry PI!
Find me on Twitter: @MrGumix
https://ascii-patrol.com/area53/ascii-patrol-html5.html
sudo snap install ascii-patrol
Arch Linux:
- https://aur.archlinux.org/packages/ascii-patrol-git/ by @SlavMetal
- https://aur.archlinux.org/packages/ascii-patrol/ by Towtow10 (only x64)
These instructions assume the system has Git and a C++ compiler.
# clone sources repo
git clone https://github.com/msokalski/ascii-patrol.git
# enter sources directory
cd ascii-patrol
The needed libraries are installed like:
# install required packages, (no apt-get -> use pacman)
sudo apt-get install libx11-dev libpulse-dev
# OR
sudo dnf install libX11-devel pulseaudio-libs-devel
# to fix problems with no keyboard input in few gnome terminals we require XI2
sudo apt-get install libxi-dev
# OR
sudo dnf install libXi-devel
Build with CMake:
cmake -Bbuild
cmake --build build
If the system doesn't have CMake:
# enable execution of build.sh and run.sh scripts
chmod +x *.sh
# invoke compilation
./build.sh
Homebrew install libraries (works with Clang or GCC):
brew install libx11 libxi pulseaudio
Build:
cmake -Bbuild
cmake --build build
No extra libraries are needed on Windows. Works with Visual Studio, MinGW / MSYS2, Cygwin, or WSL.
cmake -Bbuild
cmake --build build
On a system with emscripten installed, build for HTML5 web browsers, producing "build/asciipat.[js,wasm]"
emcmake cmake -B build -Dweb=on
cmake --build build
Ascii Patrol uses curl to communicate with hi-score server (ascii-patrol.com)
So optionally let's install it if needed.
sudo apt-get install curl
Finally let's piu-piu !
./asciipat
or
./run.sh
More on asciipat arguments can be found here: http://ascii-patrol.com/forum/index.php?topic=63
Ascii Patrol creates two files: asciipat.cfg and asciipat.rec.
asciipat.cfg is created when you change your player name, avatar, or key bindings. asciipat.rec is created when you start playing the game, and get a score.
On Linux, by default, the game saves these files in $HOME. If $HOME is not set, then the game saves the files in the current directory.
However, if $ASCII_PATROL_CONFIG_DIR or $ASCII_PATROL_RECORD_DIR are set, then the game will save the files in those directories respectively. The directories should already exist; Ascii Patrol will not create them.
- no sound? -> install / start pulseaudio ( ie:
pulseaudio -v -C
) - weird colors? -> try another terminal emulator or run from raw console (ctrl-alt-F1 or so)
- poor font look? -> try changing font in your terminal or in case of raw console use setfont
- keyboard doesn't work? -> try another terminal emulator or run from raw console
- no hi-scores table? -> install curl