# 🎲 welcome to the Flexi-RPG Master System!

This bot is not a fixed narrative story. It is a highly advanced, genre-agnostic, deterministic text-based TTRPG engine. The AI functions strictly as a neutral, precise Game Master (GM), executing dice rolls, managing a 20x20 tactical coordinate movement grid, and processing combat math with absolute consistency.

You provide the world, the genre, and the story. Whether you want to play a grimdark fantasy dungeon crawler, a cyberpunk tactical heist, a modern military survival operation, or a sci-fi space opera—this engine will adapt seamlessly and handle the rules flawlessly.

---

## 🛠️ THE 3-STEP INITIAL CALIBRATION GUIDE

When you click 'Start Chat', the bot will present an initial onboarding prompt. To configure your adventure, simply paste your answers to these four questions into your very first message:

1. The Setting & Theme: (e.g., "A gritty steampunk city ruled by a corrupt clockwork cult", "An ancient magical forest ruin", etc.)

2. The Tone: (e.g., Hardcore survival, comedic adventure, dark horror, high action).

3. The Difficulty Tier: Choose your challenge level (details below).

4. Party Setup Preference: Declare whether you want to proceed with a Customized Full Party (You + 3 Companions) or a Lone Wolf Run (You only).

---

## ⚖️ CHOOSE YOUR DIFFICUTLY TIER

Your chosen difficulty applies a rigid mathematical multiplier to all enemy core stat allocations and damage outputs, completely shifting the tactical pressure:

* Casual (0.6x Multiplier): Enemies are fragile and highly inaccurate. Perfect for narrative-focused players or learning the ropes.

* Standard (1.0x Multiplier): The intended, balanced tactical baseline experience. Threat levels are fair but demand attention.

* Hard (1.3x Multiplier): Enemies hit noticeably harder, move faster, and dodge well. Strategic positioning is mandatory.

* Deadly (1.6x Multiplier): Unforgiving and ruthless. A single mistake will lead to permanent injury or total party elimination.

---

## 🧠 VITAL MECHANICS EVERY PLAYER MUST KNOW

### 📑 1. Offload Your Character Sheets (Save Memory!)

To keep the AI lightning-fast and prevent it from "hallucinating" or changing your character's stats over time, the AI does not save your character sheets.

* The Rule: You must keep a separate text document open on your device to maintain your own stats, inventory, and abilities.

* In Combat: At the start of every battle, the GM will ask you to paste your party's current sheets into the chat. It will use those numbers strictly for that fight, ensuring 100% mathematical accuracy.

### 🔄 2. The Two-Step Combat Loop

Combat is split into two strict phases to completely stop the AI from rewriting history or deciding your actions for you:

* Phase 1 (The Math Phase): You declare your action. The GM calculates a d100 + Stat roll against the defender's DC, displays a 20x20 text-based map of active coordinates, and shows the exact damage. The AI will halt generation here and wait. You must check the math, tell the GM how you want to absorb the damage (using your Dodge or Defense pools), and confirm.

* Phase 2 (The Narrative Phase): Only after you confirm, the GM will unpause and write 1–2 paragraphs of vivid, gritty roleplay showing the physical results of that confirmed turn.

### 🛡️ 3. The Phalanx Effect (Clustering)

Positioning on the grid matters immensely. If 3 or more allies stand within a 10-foot radius (a 2-square radius) of each other at the start of a combat round, you form a Cluster.

* The Benefit: While clustered, any damage absorbed by your Dodge or Defense pools is reduced by 25%, and your turn-start pool regeneration is boosted by 25%.

* The Risk: Grouping up makes you a massive target for enemy Area of Effect (AoE) spells and explosions!

### 🩹 4. Out-of-Combat Survival & Resting

* HP does not magically return after a fight. Healing is intentionally slow.

* Short Rests (1 Hour): Recover 100% MP. Restores 25% HP for free, or 40% HP if you spend an inventory slot to consume a Ration. Securing/barricading a room grants an extra +10% HP bonus. Short rests have a strict 4-hour cooldown.

* Long Rests (8 Hours): Completely heals all HP/MP and cures minor lingering injuries. Requires a genuinely safe, fortified location (like a civilized inn or a heavily barred vault). Attempting to long rest in the exposed wilderness will trigger an immediate enemy ambush encounter!

Suggested Temperature Range - 0.5 - 0., purely for the numbers based mechanical crunch of the bot

Note from the Creator: Something different from what I've done so far, I wanted to take a swing at creating an all purpose RPG Bot, as customizable for every player as a pre-set mechanical system can be. If you have any comments, questions, critiques, please feel free to post, I will try to respond to everyone.