User Manual
===========

Introduction
============

First Python RPG is a retro-style role-playing game featuring procedural generation,
dynamic weather systems, and an engaging quest system. Explore dungeons, battle enemies,
and become a legendary hero!

Getting Started
===============

Launching the Game
------------------

Launch the game using ``python main.py`` or ``rivers-of-reckoning`` if installed via pip.

Controls
========

Desktop
-------

.. list-table::
   :widths: 30 70
   :header-rows: 1

   * - Key
     - Action
   * - Arrow Keys
     - Move your character
   * - Enter
     - Start game / Confirm selection
   * - Space
     - Toggle features / Interact
   * - Escape
     - Pause game / Return to menu
   * - Q
     - Toggle Quest Log
   * - W
     - Toggle Weather Info

Game Features
=============

Feature Selection
-----------------

When you launch the game, you'll be greeted with the **Feature Select** screen.
Here you can toggle various game features on or off before starting your adventure:

- **Random Events** - Encounter random events while exploring
- **Difficulty Levels** - Enable harder difficulty settings
- **Enemy Encounters** - Toggle random enemy battles
- **Procedural Dungeons** - Generate unique dungeon layouts
- **Dynamic Quests** - Enable the quest system
- **Weather System** - Dynamic weather affects gameplay

Procedural Dungeons
-------------------

When enabled, each playthrough generates a unique dungeon layout with:

- Randomly placed walls and obstacles
- Various terrain types (grass, water, rocks)
- Strategic placement of enemies and items

Dynamic Weather System
----------------------

The weather system adds atmosphere and can affect gameplay:

- **Clear** - Normal visibility and movement
- **Rain** - Reduced visibility
- **Storm** - Dangerous conditions

Combat
======

Enemy Encounters
----------------

When enemy encounters are enabled, you may randomly encounter enemies while moving.
Each enemy has:

- A name and type (Goblin, Orc, Slime, Wraith)
- Damage modifiers based on their type
- Health scaled to the current difficulty

Tips and Strategies
===================

1. **Toggle features wisely** - Start with fewer features enabled while learning
2. **Watch your health** - Keep track of damage from encounters
3. **Complete quests** - Quests provide gold rewards
4. **Explore carefully** - Procedural dungeons may contain surprises
5. **Check the weather** - Weather can affect your adventure

Credits
=======

First Python RPG was created as a demonstration of Python game development
using the Pygame-ce game engine.

Enjoy your adventure!