简体中文 · 繁體中文 · English · Tiếng Việt · 日本語 · Français

— ✦ —

# Cultivation World Simulator ![GitHub stars](https://img.shields.io/github/stars/4thfever/cultivation-world-simulator?style=social) [![LINUX DO](https://img.shields.io/badge/LINUX.DO-Communauté-2EA44F)](https://linux.do/t/topic/2439437) [![Bilibili](https://img.shields.io/badge/Bilibili-Voir_la_vidéo-FB7299?logo=bilibili)](https://space.bilibili.com/527346837) ![QQ Group](https://img.shields.io/badge/Groupe%20QQ-1071821688-deepskyblue?logo=tencent-qq&logoColor=white) [![Discord](https://img.shields.io/badge/Discord-Rejoindre-7289da?logo=discord&logoColor=white)](https://discord.gg/3Wnjvc7K) [![Epic Games Store](https://img.shields.io/badge/Epic%20Games%20Store-Gratuit-313131?logo=epicgames&logoColor=white)](https://store.epicgames.com/p/ai-cultivation-world-simulator-adebb8) ![Python](https://img.shields.io/badge/Python-3.10%2B-blue?style=flat&logo=python&logoColor=white) ![FastAPI](https://img.shields.io/badge/FastAPI-005571?style=flat&logo=fastapi&logoColor=white) ![Vue](https://img.shields.io/badge/Vue.js-3.x-4FC08D?style=flat&logo=vuedotjs&logoColor=white) ![TypeScript](https://img.shields.io/badge/typescript-%23007ACC.svg?style=flat&logo=typescript&logoColor=white) ![Vite](https://img.shields.io/badge/vite-%23646CFF.svg?style=flat&logo=vite&logoColor=white) ![PixiJS](https://img.shields.io/badge/PixiJS-E72264?style=flat&logo=pixijs&logoColor=white)

Démo du jeu

> **Incarnez le "Dao Céleste" et observez un monde de cultivation autonome, porté à la fois par un système de règles et par l'IA.** > **Tous les personnages sont pilotés par LLM, les récits émergent collectivement, la version desktop est gratuite sur Epic Games Store, et le projet prend aussi en charge Docker, le développement depuis les sources et les créations dérivées.**

4thfever%2Fcultivation-world-simulator | Trendshift

## 📖 Présentation **Cultivation World Simulator** est un simulateur de monde xianxia piloté par l'IA. Chaque cultivateur y est un Agent indépendant, capable d'observer son environnement et de prendre ses propres décisions. Pour éviter les hallucinations et les dérives excessives, le monde est encadré par des règles de cultivation riches et cohérentes. Dans cet univers tissé par les règles et l'IA, les cultivateurs, les sectes et les volontés d'organisation rivalisent, coopèrent et produisent sans cesse de nouvelles histoires. Vous pouvez rester un observateur lointain, voir les sectes s'élever ou s'effondrer, assister à l'ascension de génies ou à leur chute, ou encore intervenir subtilement en déclenchant une tribulation céleste, en modifiant un esprit ou en influençant le cours du monde. ### ✨ Points forts - 👁️ **Jouer le "Dao Céleste"** : vous n'êtes pas un cultivateur, mais la volonté qui observe et infléchit les règles du monde. - 🤖 **Tous les PNJ sont pilotés par IA** : chaque personnage possède sa personnalité, sa mémoire, ses relations et sa logique d'action. Ils aiment, haïssent, complotent, s'allient et peuvent même défier leur destin. - 🌏 **Des règles comme fondation** : racines spirituelles, royaumes, techniques, personnalités, sectes, élixirs, armes, tournois, enchères et espérance de vie structurent un monde crédible. - 🦋 **Des récits émergents** : il n'y a pas de scénario figé. Les guerres de sectes, les conflits entre voie droite et voie démoniaque, les révélations de destin et les accidents du monde naissent des causalités internes.

Système de sectes

Région urbaine

Historique des événements

Panneau du personnage

Traits et équipement

Pensée autonome

Surnoms

Exploration de domaine secret

Informations du personnage

Élixirs / trésors / armes

## 🚀 Démarrage rapide ### Méthode recommandée - **Pour modifier le code ou déboguer** : utilisez le déploiement depuis les sources avec Python `3.10+`, Node.js `18+` et un service de modèle disponible. - **Pour jouer directement** : récupérez gratuitement la version desktop sur [Epic Games Store](https://store.epicgames.com/p/ai-cultivation-world-simulator-adebb8), ou lancez le projet avec Docker. - Pour consulter rapidement les informations du monde, les actions, les sectes et d'autres données, vous pouvez générer un wiki local dans `tools/wiki`. ### Première utilisation - Avec la version desktop Epic, lancez le jeu puis confirmez la configuration du modèle depuis la page des paramètres avant de commencer une nouvelle partie. - Avec les sources ou Docker, configurez d'abord un préréglage de modèle disponible, par exemple DeepSeek, MiniMax ou Ollama. - En mode développement, la page frontend s'ouvre normalement automatiquement. Sinon, utilisez l'adresse affichée dans les logs de démarrage. ### Méthode 0 : version desktop Epic Games Store Adaptée aux joueurs qui veulent simplement essayer le jeu sans environnement de développement. 1. Installez gratuitement le jeu depuis [Epic Games Store](https://store.epicgames.com/p/ai-cultivation-world-simulator-adebb8). 2. Au premier lancement, vérifiez la configuration du modèle dans les paramètres. 3. Si vous souhaitez utiliser votre propre service de modèle, sélectionnez un préréglage comme DeepSeek, MiniMax ou Ollama. ### Méthode 1 : lancement depuis les sources (mode développement, recommandé) Adaptée aux développeurs et aux personnes qui veulent modifier ou inspecter le projet. 1. **Installer les dépendances et démarrer** ```bash # 1. Installer les dépendances backend pip install -r requirements.txt # 2. Installer les dépendances frontend (Node.js requis) cd web && npm install && cd .. # 3. Démarrer le service (backend + frontend) python src/server/main.py --dev ``` 2. **Configurer le modèle** Dans la page des paramètres du frontend, choisissez un préréglage de modèle. La configuration est enregistrée dans le répertoire de données utilisateur. 3. **Accéder au frontend** En mode développement, le serveur frontend est lancé automatiquement. L'adresse habituelle est `http://localhost:5173`. ### Méthode 2 : déploiement Docker en une commande (non testé) ```bash git clone https://github.com/4thfever/cultivation-world-simulator.git cd cultivation-world-simulator docker-compose up -d --build ``` Frontend : `http://localhost:8123` Le conteneur backend persiste les données utilisateur avec `CWS_DATA_DIR=/data` : paramètres, secrets, sauvegardes et logs. Par défaut, ces données sont montées dans `./docker-data` sur l'hôte et survivent à un `docker compose down` suivi d'un nouveau `up`.

Accès réseau local / mobile (cliquer pour ouvrir)

> ⚠️ L'interface mobile n'est pas encore entièrement adaptée. À utiliser comme aperçu. 1. **Backend** : il est recommandé de lancer le backend avec une variable d'environnement, par exemple dans PowerShell : `$env:SERVER_HOST='0.0.0.0'; python src/server/main.py --dev`. Pour changer la valeur par défaut, modifiez `system.host` dans la configuration en lecture seule `static/config.yml`. 2. **Frontend** : dans `web/vite.config.ts`, ajoutez `host: '0.0.0.0'` dans le bloc `server`. 3. **Accès** : assurez-vous que le téléphone et l'ordinateur sont sur le même Wi-Fi, puis ouvrez `http://:5173`.

API externe / intégration Agent ou Claw (cliquer pour ouvrir)

Cette partie sert aux agents externes, aux scripts d'automatisation ou à une boucle de jeu du type "observer -> décider -> intervenir -> observer à nouveau". Points d'entrée recommandés : - Requêtes en lecture seule : `/api/v1/query/*` - Écritures contrôlées : `/api/v1/command/*` Endpoints utiles pour démarrer : - `GET /api/v1/query/runtime/status` - `GET /api/v1/query/world/state` - `GET /api/v1/query/events` - `GET /api/v1/query/detail?type=avatar|region|sect&id=` - `POST /api/v1/command/game/start` - `POST /api/v1/command/avatar/*` - `POST /api/v1/command/world/*` Flux minimal : 1. Appeler `GET /api/v1/query/runtime/status` pour vérifier l'état courant. 2. Si aucune partie n'est lancée, appeler `POST /api/v1/command/game/start`. 3. Utiliser `world/state`, `events` et `detail` pour lire l'état du monde et la cible. 4. Exécuter une intervention via un endpoint `command`. 5. Relire l'état via `query`, sans supposer que le cache local reflète le résultat. Réponse réussie typique : ```json { "ok": true, "data": {} } ``` En cas d'échec, l'API renvoie une erreur structurée. Lisez `detail.code` et `detail.message` pour gérer les cas côté programme. Notes : - Les paramètres de l'application restent gérés par `/api/settings*` et `/api/settings/llm*`. - Pour la liste complète des interfaces et les conventions d'extension, consultez `docs/specs/external-control-api.md`.

### 💭 Pourquoi créer ce projet ? Les romans de cultivation décrivent des mondes immenses, mais le lecteur n'en voit qu'un fragment. Les jeux de cultivation existants reposent souvent soit sur un scénario prédéfini, soit sur des machines à états très simples. Cela crée facilement des comportements artificiels ou incohérents. Avec les grands modèles de langage, l'idée que "chaque personnage puisse sembler vivant" devient beaucoup plus accessible. Le but est de créer un monde de cultivation vivant, direct et immersif : ni simple vitrine promotionnelle, ni pure démonstration de recherche, mais un monde jouable qui donne une vraie sensation de présence. ## 📞 Contact Pour toute question ou suggestion, ouvrez une Issue. - **Bilibili** : [Suivre](https://space.bilibili.com/527346837) - **Groupe QQ** : `1071821688` (réponse pour rejoindre : 肥桥今天吃什么) - **Discord** : [Rejoindre la communauté](https://discord.gg/3Wnjvc7K) --- ## ⭐ Star History Si ce projet vous intéresse, laissez une Star ⭐. Cela nous aide à continuer à l'améliorer.

# Partages Merci aux contributeurs et à la communauté pour les projets et publications liés à ce dépôt. - [cultivation-world-simulator-api-skill](https://github.com/RealityError/cultivation-world-simulator-api-skill) - [cultivation-world-simulator-android](https://github.com/RealityError/cultivation-world-simulator-android) - [Publication LINUX DO](https://linux.do/t/topic/2439437) ## 👥 Contributeurs

_4thfever	_xzhseh	_teps3105	_Meanliss	_octo-patch	_cooleryu	_LuckVd
_MarkYangKp	_Robinwhliu	_Seafoodsz	_Tianrant	_cw1990	_RealityError	_{mitsuko33000-ops}

Pour les détails de contribution, consultez [CONTRIBUTORS.md](../../CONTRIBUTORS.md). ## 📋 Avancement du développement ### 🏗️ Système de base - ✅ Carte du monde, temps et système d'événements - ✅ Terrains variés : plaines, montagnes, forêts, déserts, eaux, etc. - ✅ Interface web - ✅ Cadre de simulation - ✅ Fichiers de configuration - ✅ Build desktop en une commande - ✅ Barre de menu, sauvegarde et chargement - ✅ Interface LLM personnalisable - ✅ Support macOS - ✅ Localisation multilingue - ✅ Page de démarrage - ✅ Musique et effets sonores - ✅ Édition par le joueur - ✅ Mode roleplay ### 🗺️ Système du monde - ✅ Système de tuiles - ✅ Régions normales, régions de cultivation, villes et régions de secte - ✅ Interactions entre PNJ sur la même tuile - ✅ Distribution et production de l'énergie spirituelle - ✅ Événements du monde - ✅ Classements Ciel, Terre et Humain - ✅ Cartes plus grandes, plus belles et cartes aléatoires ### 👤 Système de personnages - ✅ Attributs de base - ✅ Royaumes de cultivation - ✅ Racines spirituelles - ✅ Actions de déplacement - ✅ Traits, personnalités et relations - ✅ Percée de royaume - ✅ Portée d'interaction - ✅ Effets, buffs et debuffs - ✅ Techniques de cultivation - ✅ Armes et équipements auxiliaires - ✅ Système de "doigt d'or" - ✅ Élixirs - ✅ Mémoire à court et long terme - ✅ Objectifs à court et long terme, modifiables par le joueur - ✅ Surnoms - ✅ Compétences de vie : cueillette, chasse, minage, plantation, forge et alchimie - ✅ Mortels ### 🏛️ Organisations - ✅ Sectes : paramètres, techniques, soins, base, style de conduite et tâches - ✅ Actions spéciales de secte : Secte Hehuan, Secte Baishou, etc. - ✅ Niveaux de secte - ✅ Orthodoxie - ✅ Cour impériale - ✅ Volonté d'organisation pilotée par IA - ✅ Tâches, ressources et fonctions d'organisation - ✅ Réseau de relations entre organisations ### ⚡ Système d'actions - ✅ Actions de déplacement - ✅ Cadre d'exécution des actions - ✅ Actions définies avec règles claires - ✅ Actions longues multi-mois et règlement automatique - ✅ Actions multijoueurs : initiation et réponse - ✅ Actions LLM influençant les relations - ✅ Enregistrement systématique des actions ### 🎭 Système d'événements - ✅ Changements d'énergie spirituelle entre ciel et terre - ✅ Grands événements multijoueurs : - ✅ Enchères - ✅ Exploration de domaine secret - ✅ Tournoi martial mondial - ✅ Assemblée de prêche de secte - [ ] Événements soudains : - ✅ Apparition de trésors - [ ] Catastrophes naturelles / tribulations célestes ### ⚔️ Combat - ✅ Avantages et contres - ✅ Calcul des chances de victoire ### 🎒 Objets - ✅ Objets de base et pierres spirituelles - ✅ Commerce d'objets ### 🌿 Écosystème - ✅ Animaux et plantes - ✅ Chasse, cueillette et matériaux - ✅ Races yao ### 🤖 Renforcement IA - ✅ Intégration LLM - ✅ IA de personnages : règles + LLM - ✅ Décision asynchrone et accélération multi-thread - ✅ Planification longue durée et comportement orienté objectif - ✅ Réponse immédiate aux stimuli externes - ✅ Dialogue, pensée et interaction générés par LLM - ✅ Fragments narratifs générés par LLM - ✅ Séparation des modèles max/flash selon le type de tâche - ✅ Micro-théâtres : combat, dialogue et styles textuels variés - ✅ Choix ponctuels, par exemple remplacer ou non une technique ### 🏛️ Lore du monde - ✅ Injection de connaissances de base du monde - ✅ Génération dynamique de techniques, équipements, sectes et régions à partir de l'historique utilisateur ### ✨ Spécial - ✅ Rencontres fortuites - ✅ Tribulation céleste et démon du cœur - ✅ Révélation de destin - ✅ Formations - ✅ Gu - ✅ Opportunités fortuites - ✅ Secrets du monde - ✅ POI - ✅ PNJ d'arrière-plan ### 🔭 Perspectives à long terme - [ ] Ascension vers le royaume supérieur - [ ] Fonder une secte / devenir empereur - [ ] Romanisation, illustration et vidéo de l'histoire et des événements - [ ] Agentification des compétences : les cultivateurs planifient, analysent, appellent des outils et décident seuls - [ ] Intégrer votre propre Claw dans le monde de cultivation