🏰 Simulation du Roi – Version IA (LM Studio)

# 🏰 Simulation du Roi – Version IA (LM Studio)

Un jeu d’enquête médiéval narratif où une IA joue le rôle du Maître du Jeu, créant une histoire unique à chaque partie.

## 🎮 Concept du Jeu

Vous êtes le Roi de France. Un complot se trame à la cour pour vous assassiner. Avec l’aide d’une IA narrative qui contrôle tous les personnages et l’histoire, vous devez découvrir qui est l’assassin avant qu’il ne soit trop tard!

## ✨ Caractéristiques

### 🤖 IA Maître du Jeu

– **Narration dynamique** : L’IA crée une histoire unique à chaque partie

– **Personnages vivants** : Chaque noble a sa personnalité et ses secrets

– **Adaptation intelligente** : L’histoire évolue selon vos actions

– **Dialogues immersifs** : Conversations naturelles avec les personnages

### 🎯 Gameplay

– **10 tours maximum** pour découvrir l’assassin

– **Actions variées** : Interroger, espionner, fouiller, organiser des événements

– **Indices subtils** : L’IA dissimule des indices dans la narration

– **Multiple suspects** : Assassin principal, complices, et faux suspects

– **Protecteur secret** : Un allié caché peut vous aider

### 💾 Fonctionnalités

– **Sauvegarde/Chargement** de parties

– **3 niveaux de difficulté**

– **Configuration IA personnalisable**

– **Historique de conversation**

## 📋 Prérequis

### 1. LM Studio

– **Télécharger** : [https://lmstudio.ai/](https://lmstudio.ai/)

– **Version** : 0.2.0 ou supérieure

– **RAM** : Minimum 8GB (16GB recommandé)

### 2. Python

– **Version** : Python 3.7 ou supérieure

– **Modules** : `requests`

### 3. Modèle IA

– **Recommandé** :

  – Mistral 7B Instruct

  – Llama 2 7B/13B Chat

  – Neural Chat 7B

– **Taille** : 4-8GB selon le modèle

## 🚀 Installation

### Étape 1 : Installer Python et dépendances

« `bash

# Vérifier Python

python –version

# Installer les dépendances

pip install requests

# Ou avec le fichier requirements

pip install -r requirements.txt

« `

### Étape 2 : Configurer LM Studio

1. **Lancer LM Studio**

2. **Télécharger un modèle** :

   – Aller dans « Models »

   – Rechercher « Mistral » ou « Llama »

   – Télécharger un modèle 7B (plus rapide) ou 13B (meilleur)

3. **Charger le modèle** :

   – Sélectionner le modèle téléchargé

   – Cliquer sur « Load »

4. **Activer le serveur API** :

   – Aller dans « Server »

   – Cliquer sur « Start Server »

   – Vérifier que le port est 1234

### Étape 3 : Lancer le jeu

« `bash

python simulation_roi_lm_studio.py

« `

## 🎯 Guide de Jeu

### Démarrage Rapide

1. **Lancer LM Studio** et charger un modèle

2. **Démarrer le serveur** (port 1234)

3. **Lancer le script Python**

4. **Créer une nouvelle partie**

5. **Suivre la narration** de l’IA

6. **Enquêter** en choisissant des actions

7. **Accuser** le suspect quand vous êtes sûr

### Actions Disponibles

| Action | Description | Utilité |

|——–|————-|———|

| **Interroger** | Parler à un noble | Révèle comportements suspects |

| **Espionner** | Surveillance secrète | Découvre des secrets |

| **Fouiller** | Explorer des lieux | Trouve des preuves |

| **Banquet** | Organiser un événement | Observe les interactions |

| **Consulter** | Demander conseil | Obtient des indices |

| **Accuser** | Désigner l’assassin | Termine la partie |

### Stratégies

– 🔍 **Croiser les témoignages** : Les menteurs se contredisent

– 👥 **Observer les alliances** : Les complices se protègent

– 📝 **Noter les indices** : L’IA reste cohérente

– ⏰ **Gérer le temps** : 10 tours maximum

– 💡 **Demander des indices** : Si vous êtes bloqué

## ⚙️ Configuration Avancée

### Paramètres IA

Dans le menu Configuration, vous pouvez ajuster :

– **Température** (0.1-2.0) :

  – 0.5 : Narration plus prévisible

  – 0.8 : Équilibré (défaut)

  – 1.5 : Très créatif

– **Max Tokens** (500-4000) :

  – 1000 : Réponses courtes

  – 2000 : Normal (défaut)

  – 4000 : Réponses détaillées

– **Host** :

  – Local : `http://localhost:1234`

  – Réseau : `http://[IP]:1234`

### Modèles Recommandés

| Modèle | RAM | Qualité | Vitesse |

|——–|—–|———|———|

| **Mistral 7B Instruct** | 6GB | ⭐⭐⭐⭐ | ⭐⭐⭐⭐⭐ |

| **Llama 2 13B Chat** | 10GB | ⭐⭐⭐⭐⭐ | ⭐⭐⭐ |

| **Neural Chat 7B** | 6GB | ⭐⭐⭐⭐ | ⭐⭐⭐⭐ |

| **Llama 2 7B Chat** | 6GB | ⭐⭐⭐ | ⭐⭐⭐⭐⭐ |

## 🐛 Résolution de Problèmes

### « LM Studio n’est pas accessible »

1. Vérifier que LM Studio est lancé

2. Vérifier que le serveur est démarré (Server → Start)

3. Vérifier le port (doit être 1234)

4. Désactiver temporairement le firewall

### « L’IA répond lentement »

1. Utiliser un modèle plus petit (7B au lieu de 13B)

2. Réduire max_tokens (1000 au lieu de 2000)

3. Fermer autres applications

4. Utiliser quantification Q4 ou Q5

### « L’IA donne des réponses incohérentes »

1. Baisser la température (0.5-0.7)

2. Utiliser un meilleur modèle

3. Redémarrer LM Studio

4. Effacer l’historique de conversation

### « Erreur de connexion »

« `bash

# Tester la connexion

curl http://localhost:1234/v1/models

# Si erreur, vérifier :

– LM Studio est lancé

– Serveur est démarré

– Port 1234 est libre

– Firewall autorise connexion

« `

## 🎨 Personnalisation

### Modifier les Prompts

Éditez `system_prompt` dans la classe `IAGameMaster` pour changer :

– Le style narratif

– L’époque/univers

– La complexité

– Les règles

### Ajouter des Actions

Dans `ActionType` et `traiter_action()`, ajoutez :

– Nouvelles actions

– Événements spéciaux

– Mécaniques de jeu

### Thèmes Alternatifs

Idées de modifications :

– 🚀 **Science-Fiction** : Station spatiale, saboteur

– 🧙 **Fantasy** : Royaume magique, cultiste

– 🕵️ **Moderne** : Entreprise, espion industriel

– 🏴‍☠️ **Pirates** : Navire, mutin

## 📊 Performances

### Configuration Minimale

– CPU : 4 cores

– RAM : 8GB

– Modèle : 7B quantifié Q4

### Configuration Recommandée

– CPU : 8 cores

– RAM : 16GB

– GPU : 6GB VRAM (optionnel)

– Modèle : 13B quantifié Q5

## 🤝 Contribution

Les améliorations sont bienvenues! Idées :

– Support multi-langues

– Interface graphique

– Mode multijoueur

– Statistiques détaillées

– Générateur de rapports

## 📜 Licence

Ce projet est libre d’utilisation et de modification.

## 🙏 Remerciements

– LM Studio pour l’API locale

– Communauté open-source IA

– Modèles Mistral et Meta Llama

## 💡 Tips & Astuces

1. **Première partie** : Utilisez difficulté « Facile »

2. **Meilleure immersion** : Jouez dans un terminal plein écran

3. **Notes** : Gardez un papier pour noter les indices

4. **Sauvegarde** : Sauvegardez avant d’accuser

5. **Expérimentation** : Essayez différents modèles IA

—

**Bon jeu et méfiez-vous des traîtres! ⚔️👑**