Terminal RPG: Chronicles of the Void

# Chronicles of the Void (Terminal RPG)

An immersive, highly-polished retro terminal-styled RPG adventure. Set out from the safe haven of Cursedale and dive deep into untamed wildlands, hazardous swamps, trap-filled crypts, and the shifting depths of the Oubliette Keep.

*(Note: Recommended play on desktop PC web browsers)*

---

## 🎮 Full Feature List

### 1. Character & Progression System

*   **Heroic Specialties**: Choose between the **Warrior** (high defense and crushing strength), **Mage** (potent arcane spells and deep mana capacity), or **Archer** (blistering speed and surgical critical rates).

*   **Attributes & Leveling**: Earn experience from vanquishing foes to level up and distribute stats, improving your basic Vitality, Mana, Attack power, and Elemental Shield boundaries.

*   **Vanguard Skill Path**: Unlock a multi-tier specialization tree where spent points earn permanent passive increments or active spells.

*   **Detailed Character Sheet**: Access dynamically styled statistics tracking Critical Hit ratios, Dodge probabilities, and individual Elemental Resistances.

### 2. Strategic Turn-Based Combat

*   **Elemental Affinity Engine**: Combat features five distinct elements (**Fire, Ice, Lightning, Poison, and Physical**). Discover enemy weaknesses to deal crushing damage, and adapt your own resistances to absorb incoming spellcraft.

*   **Combat Arts**: Utilize complex tactics, including Stuns (*Shield Bash*), Damage-over-Time (*Poison Arrow*), and scaling low-health Finishers (*Execute*).

*   **Deep Exploration**: During campaign runs, decide between *Stay on Path* (for minimal threat and steady safe progression) or *Explore Deeply* (to find rare bosses, hidden nodes, and exquisite armor caches).

*   **Dynamic Status Effects**: Balance resources while managing active conditions such as Stun, Poison ticks, and physical damage amplification.

### 3. Equipment & Economy

*   **Item Rarity Tiers**: Loot and acquire gear in four rare visual formats: **Normal** (Grey), **Magic** (Blue), **Rare** (Yellow), and **Epic** (Purple).

*   **Permanent Modifiers**: Equipping weapons and armor pieces injects permanent attribute boosts, physical mitigation, and vital protection rings.

*   **Cursedale Marketplace**:

    *   *The Blacksmith*: Purchase permanent grade weapons and heavy breastplates, or sell obsolete loot.

    *   *The Apothecary*: Stock up on active combat consumables, including minor/major health rejuvenants and high-focus mana potions.

*   **Loot Tables**: Enemies spawn dynamically scaled treasures, resources, and rare items based on zone rating and boss rankings.

### 4. Chronicles of the World

*   **Cursedale Sanctuary (The Hub)**: Rejuvenate instantly at the local Inn, converse with regional NPCs to unlock lore secrets, and register notices at the Quest Board.

*   **Diverse Regions**:

    *   *The Bleakwood*: A haunted, misty logging forest ideal for training early recruits.

    *   *The Stillshallows*: Muddy, stagnant swamp trails hosting toxic wildlife and sunken legacy wagons.

    *   *The Gloomvein Pit*: A deep, dark labyrinth featuring mechanical lever puzzles and physical floor traps (poison vents and floor spikes).

    *   *The Ashen Ossuary*: An endgame wasteland where white ash drifts over forgotten ruins.

    *   *Oubliette Keep*: A treacherous floor-based megastructure presenting scaled trials.

*   **Castle Crawl**: A tactical dungeon-crawling sequence designed to test survival across distinct floors of Oubliette Keep.

### 5. Lore & Narrative

*   **Vanguard Lore Journal**: Assemble fragments, ancient logs, and transcriptions hidden across dungeons to unlock the origins of the Curse.

*   **Human Dialogue**: Engage with village folk like **Grandpa Silas** or **Captain Valerius** to unlock regional backstories, rumors, and custom quests.

*   **Active Contract Board**: Recruited board bounties track objectives ranging from specific monster culls, material harvests, or legendary boss hunts.

### 6. Roguelike Vitality

*   **Gold Legacy**: High-risk encounters are safe; upon defeat, a percentage of your total accumulated gold is inherited by your next "Past Life," accelerating early-game recovery.

*   **Chronicle Records**: An offline score board catalogs absolute milestones across all lifetimes, showcasing Highest Level reached, total world kills, and historical wealth.

### 7. Accessibility & Customization

*   **Bilingual Translation**: One-click language toggling allows high-fidelity play in both **English** and **Portuguese** (Português).

---

## 🛠️ Developer Setup & Local Execution (For Purchasers)

This game is packaged as a standard, modern client-side Web application utilizing **Vite**, **TypeScript**, and **React**. Purchasers can play the game offline, inspect the source, or host it locally.

### Prerequisites

Make sure you have [Node.js](https://nodejs.org/) installed on your machine.

### Installation

1. Extract the purchaser project archive (`.zip`) into a directory of your choice.

2. Open your terminal/command prompt inside that directory and run:

   ```bash

   npm install

   ```

### Running Locally (Play Offline)

To preview and play the production-compiled game locally:

```bash

npm run preview

```

Open the provided local URL (typically `http://localhost:4173`) in your web browser.

### Development Mode (Sourcing & Modding)

If you want to view the source code in real-time or make changes:

```bash

npm run dev

```

This runs the application in hot-reload mode on `http://localhost:3000`.

---

### **A Note on Creator Tools**

This game was developed with the assistance of Google AI Studio (Gemini).