boxing after dark - Emacs ascii art game engine
-----------------------------------------------
 ______      _      _____                v2.0.0
|  __  \    / \    |  __ \       ___   _
| |__| /   / _ \   | |  | |     | __| | |
| |__| \  / ___ \  | |__| |  _  | _|  | |_
|______/ /_/   \_\ |_____/  |_| |___| |___|

-----------------------------------------------

git clone https://dataswamp.org/~incal/bad.git

URL src: https://dataswamp.org/~incal/bad

URL web: https://dataswamp.org/~incal/bad-www

byte-compile: ./co

native-compile: ./no # recommended

run: ./so # or either of 'to', 'po', or 'eo'
          # (also 'min', 'he'; or 'all')

Tested on: Emacs 29, 30, and 31
Does not work on: Emacs 28
Freedback: incal@dataswamp.org
----------------------------------------------

bad.el is an Emacs Lisp package that consists
of many files. Its purpose is to draw, to
animate, to create fun and pretty things
with Emacs.

"Bad" or BAD is for 'Boxing After Dark'
because it all started as an idea how to
automate the drawing of ascii boxes and
banners. But from this modest origin it grew
into an ascii art framework with its own
studio, an ascii art game engine. Several
demos and games are included even in this very
first official release v1.0.0. [6 at v2.0.0]

bad.el is a collection of code for Emacs that
can be used to create programs with
interactive graphics - demos, games, utilities
for education, you name it - using - so far! -
ascii art to draw.

[ I write "so far" because bad.el has
  a super-modular design made possible by the
  one library it relies on, EIEIO or eieio.el ]

v1.0.0 includes two games, one interactive
demo, and one application, the studio. The
studio is at an embryotic level at the
moment but has a couple of advanced features
even so.

The games are fun and pretty!

To get an instant handle on what it is about,
check out the below four screenshots, one from
each of the programs. You will see there is
variety even/especially among simple things.

  https://dataswamp.org/~incal/bad/meta/screenshot/toronto.png
  https://dataswamp.org/~incal/bad/meta/screenshot/cat.png
  https://dataswamp.org/~incal/bad/meta/screenshot/egypt.png
  https://dataswamp.org/~incal/bad/meta/screenshot/studio.png

bad.el does not use any Elisp packages to
draw, nor to do any of the associated
computation: collision, transparency,
rotation, and many other things are all done
in-house.

bad.el is 34 Elisp files and exactly 2000
lines of code. Work started 2024-08-24 and
v1.0.0 is released today, 2024-09-17, a veeery
long one month, one day later.

[v2.0.0 2024-10-06. 36 files, 2231 chars. ]

----------------------------------------------

You can try bad.el yourself by using the
scripts located in the same directory as this
file. They will use your local Emacs binary
with the options -D and -Q so as to not affect
or be affected by local configuration.

That means, no installation whatsoever is
needed. You just need the files, and you can
get them anyway you'd like. But git is the
best way :)

  ./run-snake       play snake      [./po]
  ./run-toronto     play Toronto    [./to]
  ./run-studio      the studio      [./so]
  ./run-egypt       Egypt demo      [./eo]

  ./compile         byte-compile    [./co]
  ./compile-native  native-compile  [./no]

----------------------------------------------

Contact:

  mail: <incal@dataswamp.org>
  phone: +46 72 946 20 26
  visit me in Uppsala, Sweden

----------------------------------------------
   https://dataswamp.org/~incal/bad/README
----------------------------------------------