Claudo

 ██████╗██╗      █████╗ ██╗   ██╗██████╗  ██████╗
██╔════╝██║     ██╔══██╗██║   ██║██╔══██╗██╔═══██╗
██║     ██║     ███████║██║   ██║██║  ██║██║   ██║
██║     ██║     ██╔══██║██║   ██║██║  ██║██║   ██║
╚██████╗███████╗██║  ██║╚██████╔╝██████╔╝╚██████╔╝
 ╚═════╝╚══════╝╚═╝  ╚═╝ ╚═════╝ ╚═════╝  ╚═════╝

Claudo

Claudo is a 2D top-down murder mystery game built with Godot 4.6.

Someone was murdered in the mansion. Your job is to figure out **who did it**, **with what weapon**, and **in which room**.

See part of the game play here:

https://github.com/user-attachments/assets/a169ab6d-a14f-4c5a-a29c-f24dc193cb07

How to Play

1. Walk around the mansion and meet the suspects.
2. Talk to nearby NPCs and compare their stories.
3. Track clues and contradictions in your notebook.
4. Build your theory about the killer, weapon, and room.

Each run generates a fresh mystery, so no two games are exactly the same.

Controls

• Move: Arrow keys
• Talk to nearest NPC: C
• Close chat window: Esc
• Toggle notebook: N

How It Works

• A local Game Master service generates a new murder scenario at startup.
• Six suspect NPCs are created with generated archetypes and backstories.
• Godot runs the game client while a local Node.js/TypeScript server handles AI + state over WebSocket.

Project Status

The project is in active phased development:

• Phase 0: graphical draft (done)
• Phase 1: core infrastructure (done)
• Phase 2+: NPC intelligence, GM pressure systems, and accusation flow (in progress)

Tech Stack

• Godot 4.6 (GDScript)
• Node.js >= 18 + TypeScript
• @google/genai (NPC chat responses)
• ws (Godot <-> server transport)

Requirements

• Godot 4.6 installed
• Node.js 18+ installed
• pnpm installed (npm install -g pnpm)
• GOOGLE_API_KEY in server/.env

Copy `server/.env.example` to `server/.env`, then add your key.

Running the Game

1. Open the project in Godot 4.6.
2. Press F5.

`scenes/main/main.gd` automatically sta