Summary

XianTu (Immortal Path) is an AI-driven text adventure game simulating a cultivation world, targeting players seeking immersive, dynamic narrative experiences. It leverages multiple large language models (Gemini, Claude, OpenAI, DeepSeek) to generate personalized storylines and game events, offering an evolving gameplay loop beyond static narratives.

How It Works

The game features a Vue 3/TypeScript frontend and a Python/FastAPI backend. Core gameplay is driven by LLMs for dynamic narratives and NPC interactions. A comprehensive game engine manages a full cultivation system, including realm progression, skill mastery, equipment crafting, and an intelligent judgment system based on character attributes and game state.

Quick Start & Requirements

Docker deployment is recommended: docker run -d -p 8080:80 qianye60/xiantu:latest. Local development requires Node.js for the frontend (npm install, npm run serve) and Python 3 with FastAPI for the optional backend (pip install -r server/requirements.txt). Users must provide their own API keys for supported LLMs (Gemini, Claude, OpenAI, DeepSeek) for full AI functionality. Setup is quick via Docker; local setup requires standard web development environments.

Highlighted Details

• AI-powered dynamic narrative generation supporting multiple LLMs.
• Comprehensive cultivation system with deep mechanics (realms, skills, crafting).
• Cross-platform compatibility (desktop/mobile) with light/dark themes.
• SillyTavern integration for enhanced AI interaction.

Maintenance & Community

The project includes CI/CD pipelines for automated builds and deployments. Community support is available via a QQ group (1079437686). Contribution guidelines are detailed in CONTRIBUTING.md.

Licensing & Compatibility

The license permits personal learning and research use. Commercial use requires explicit prior contact with the author, indicating a restrictive license for business applications.

Limitations & Caveats

Full AI functionality is contingent on users supplying their own LLM API keys. Commercial deployment is restricted without author consent. The primary community channel is QQ, which may not be universally accessible.