# Narraboros - Infinity Interactive Fiction

## Overview
Narraboros is a web-based, Infinity Interactive Fiction designed for dynamic storytelling and infinite procedural narratives. It combines deterministic logic (Laravel/MySQL) with a single-shot AI narrator (Gemini 2.5 Flash Lite) to create a highly consistent, causally-driven interactive literature experience.

## Architecture
- **Hard Logic (Backend):** Built with Laravel and MySQL. The database acts as the absolute truth, ensuring object permanence, absolute memory, and preventing AI memory drift. All logic and RNG happen server-side.
- **AI Narrator:** Uses Gemini 2.5 Flash Lite via API. Prompts are constructed dynamically (`prompt_dynamic`) and combined with static lore/rules (`lore_static` via `->withSystemInstruction()`).
- **Single-Shot Execution:** The system sends structured snapshots (Lore/State) to the LLM without chat history, avoiding hallucination over time.

## Key Features
- **Natural Language Actions:** Users interact using natural language (e.g., shorthand like `[key=thrust][mod=agility|perception][weapon=dagger] Stich`). The AI interprets intention; Laravel validates it against the database.
- **Absolute Object Permanence:** Items and states are saved in SQL, ensuring a true "infinite level memory".
- **Director System:** An overarching instance controls pacing and dramaturgy.
- **Perception Filter & Unreliable Narrator:** Information is filtered based on the character's state.
- **Consequences:** Decisions are irreversible (no save-scumming), focusing on endless mystery rather than traditional "winning".

## Contact & Links
- Discord: https://discord.gg/AVSTCrH8WX
- Reddit: https://www.reddit.com/r/narraboros/
- Contact: info@narraboros.de