Metadata-Version: 2.4
Name: arlq
Version: 4.3.1
Summary: ARLQ, another rogue-like quest game.
Project-URL: Homepage, https://github.com/tos-kamiya/arlq
Project-URL: Repository, https://github.com/tos-kamiya/arlq
Project-URL: Issues, https://github.com/tos-kamiya/arlq/issues
Author-email: Toshihiro Kamiya <kamiya@mbj.nifty.com>
License: BSD 2-Clause License
License-File: LICENSE.txt
Keywords: blessed,game,pyglet,roguelike,terminal
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: BSD License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Games/Entertainment
Requires-Python: >=3.10
Requires-Dist: appdirs>=1.4
Requires-Dist: blessed>=1.28
Requires-Dist: pyglet>=2
Provides-Extra: dev
Requires-Dist: mypy>=1.0; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.6; extra == 'dev'
Description-Content-Type: text/markdown

# ARLQ, another rogue-like quest game

ARLQ (Another Rogue-Like Quest) is a compact rogue-like game created as an
experiment in developing code and manuals with humans and ChatGPT.

<p align="center">
  <a href="https://pypi.org/project/arlq/">
    <img alt="PyPI version" src="https://img.shields.io/pypi/v/arlq" />
  </a>
  <a href="https://www.python.org/">
    <img alt="Python 3.10-3.14" src="https://img.shields.io/badge/Python-3.10--3.14-3776AB?logo=python&logoColor=white" />
  </a>
</p>

![](https://github.com/tos-kamiya/arlq/blob/main/screenshot.png?raw=True)

Explore a procedurally generated dungeon, manage your LP (Life Points), learn
the identities of monsters, and find the treasure guarded by the dragon. The
game includes three stages:

- Stage 1: Find the Dragon's treasure chest.
- Stage 2: Find the Fire Drake's treasure chest.
- Stage 3: Defeat the Dread Wyrm and claim its treasure chest with help from the elves.

Features include:

- Turn-based combat, level progression, food, and special monster abilities.
- Fog of war and an automap that preserves explored areas.
- Companions with unique abilities.
- A Pyglet graphical interface and a Blessed terminal interface.

## Installation

ARLQ requires Python 3.10 or later. Install it from PyPI with:

```bash
pip install arlq
```

The required Pyglet and Blessed dependencies are installed automatically.

Start the graphical version with:

```bash
arlq
```

The terminal version is available through `arlq-cli`:

```bash
arlq-cli
```

You can also select the Blessed terminal interface explicitly:

```bash
arlq --terminal
```

Run `arlq --help` for the complete list of options. The old `--curses` option
is retained as a deprecated alias for `--terminal`. The terminal interface
requires a terminal at least 80 columns wide and 24 lines high; the game
pauses while the terminal is smaller and resumes after it is enlarged.

## License

ARLQ is released under the BSD-2-Clause License.
