Skip to content

A simple CLI text adventure game, created for learning purposes, feel free to contribute.

License

Notifications You must be signed in to change notification settings

thecoffeemeister/ascii-combat

 
 

Repository files navigation

Run on Repl.it

ASCII Combat

A simple CLI text adventure game, created for learning purposes.

Project objectives

  • Fully functional dungeon system for exploration.
  • Creating an inventory system with the ability to pickup, eat and get info about items found throughout the dungeon
  • Enemies distributed over dungeon entrances, explore further by beating them in a role-based combat system.

Usage instructions

Note: This game uses Python 3 ONLY. Using Python 2 will not work!

  • Get sources either by downloading .zip file and extracting it
  • Or by cloning the master branch git clone https://github.com/aelmosalamy/ascii-combat
  • To setup: run pip3 install colorama or pipenv install
  • To play: run python3 main.py

Game Modules

  • The game mainly uses two modules: Cmd (to run the a generic command-line interface with several useful features) and colorama (an amazing ANSI sequence text colorizer).

Pull Requests

  • I really welcome pull requests, specially if it is your first time, checkout the current issues and any little correction, bugfix, new feature will be reviewed and added if possible.
  • Feel free to send PRs (Check open issues first).
  • Clean, well-documented code is pretty appreciated.
  • THIS IS VERY IMPORTANT: If you are using Unix-based system for writing code, make sure to convert your code's newlines to CRLF (The default terminator used by Windows) since this causes tons of merge conflicts!

Future Plans

  • We all agree its fun to play text-based games as this genre got its very own fans, however we further agree on the beauty of graphics, so I am planning to make a pygame version of this, exactly same concept with simplistic, yet beautiful 8-bit pixel art graphics, I intend to create a roguelike exploration system + a role-based combat system which acts like an obstacle to the advance of exploration in the dungeons of ASCII Combat, mmm... shall we say 'Pixel Combat'? :)

About

A simple CLI text adventure game, created for learning purposes, feel free to contribute.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 99.9%
  • Batchfile 0.1%