# Agent Nox
> A daily AI-powered murder mystery game.

**Agent Nox** is an immersive, independently developed daily investigation game, created entirely by solo developer **Sébastien Jover**. Similar to "Murdle", it is powered by Artificial Intelligence. Every day, players face a new mystery in the city of Nox, solving complex crimes using logic and real-time interrogation skills.

## Game Philosophy & Immersion
- **High Challenge Level**: The game is designed to be genuinely difficult, boasting around a 20% success rate on the first try, rewarding true deductive reasoning.
- **Atmosphere & Senses**: The experience is enhanced by a custom musical theme, sound effects (FX), and immersive narrative elements like detailed autopsy and forensic reports.

## Core Features
- **Daily Procedural Mysteries**: A new 100% logic-solvable case generated every day.
- **Dynamic AI Interrogations**: Players chat in real-time with suspects powered by OpenAI. Suspects have unique traits, personalities, and react with varying stress levels.
- **Progressive Assistance**: A supplementary hint system is available for players facing extreme difficulty, avoiding frustration without giving away the direct solution.
- **Interactive Detective Notebook**: A deduction grid for players to cross-reference Suspects, Weapons, Locations, and Motives, supported by local storage persistence.
- **Mobile-Optimized HUD**: Responsive design featuring a specific 'Hypothesis Bar' on small screens instead of the full desktop logic grid.
- **Player Progression & Badges**: Account authentication (Email & Google), comprehensive user profiles with daily play streaks, and an extensive achievement badge system (including secret easter eggs).
- **Archives & Closed Cases**: Access to a history of the last 20 solved mysteries, including full verdicts and top-performing detectives.
- **Daily Leaderboard**: A real-time competitive ranking of the "Brigade", tracking scores based on speed, accuracy, and limited hint usage.
- **Endpoint Interactivity**: Upon concluding a case, players can leave a review, share their completion time on social media, and support the project via a Ko-Fi integration.
- **AI-Generated Assets**: Crime scenes and narrative reports generated using DALL-E 3 and GPT-4o-mini.
- **Mocked Mysteries Mode**: A local development simulated generator to save AI API costs during testing.

## Tech Stack
- **Backend Framework**: Laravel 11 (PHP 8.2+)
- **Frontend Framework**: React.js, Vite
- **Styling**: Tailwind CSS
- **Database**: SQLite (Local) / MySQL (Production)
- **AI Integration**: OpenAI API (GPT, DALL-E, TTS)

## AI Guidelines (for LLMs assisting with this project)
- **Primary Language**: The entire application (UI, database content, game narrative, and AI generation prompts) is strictly in French (FR). All generated user-facing text or AI instructions must be in French.
- The application uses Inertia.js with React to bridge the Laravel backend.