ASCII Arms is a modular CLI based damage simulation system, built with Python. It simulates interactions between game entities, items, and spells using customizable data from JSON configuration files. This tool is useful for prototyping game mechanics, balancing combat systems, or serving as a backend module in larger game engines.
- Python 3.13 or higher
- Git (optional, if cloning the repo)
-
Clone repository
git clone <repository-url>
cd ASCII_Arms
-
Create virtual environment (recommended)
python -m venv .venv
Windows
.\.venv\Scripts\Activate.bat
Mac OS / Linux
source .venv/bin/activate
-
Install dependencies
python -m pip install .
-
Run game
RUN GAME AS MODULE: -m
Windows
Use run.bat
Terminal
python -m src.ascii_arms.main