What a mess

This commit is contained in:
Joan
2025-11-07 15:27:13 +01:00
parent 0b79b3ae59
commit 33cc9586c2
130 changed files with 29819 additions and 1175 deletions

View File

@@ -1,11 +1,18 @@
# Echoes of the Ashes - Telegram RPG Bot
# Echoes of the Ashes
A post-apocalyptic survival RPG Telegram bot built with Python, featuring turn-based exploration, resource management, and a persistent world.
A post-apocalyptic survival RPG available on **Telegram** and **Web**, featuring turn-based exploration, resource management, and a persistent world.
![Python](https://img.shields.io/badge/python-3.11-blue)
![Telegram Bot API](https://img.shields.io/badge/telegram--bot--api-21.0.1-blue)
![PostgreSQL](https://img.shields.io/badge/postgresql-15-blue)
![Docker](https://img.shields.io/badge/docker-compose-blue)
![React](https://img.shields.io/badge/react-18-blue)
![FastAPI](https://img.shields.io/badge/fastapi-0.104-green)
## 🌐 Play Now
- **Telegram Bot**: [@your_bot_username](https://t.me/your_bot_username)
- **Web/Mobile**: [echoesoftheashgame.patacuack.net](https://echoesoftheashgame.patacuack.net)
## 🎮 Features
@@ -32,15 +39,51 @@ A post-apocalyptic survival RPG Telegram bot built with Python, featuring turn-b
## 🚀 Quick Start
### Telegram Bot
1. Get a Bot Token from [@BotFather](https://t.me/botfather)
2. Create `.env` file with your credentials
3. Run `docker-compose up -d --build`
4. Find your bot and send `/start`
See [Installation Guide](#installation) for detailed instructions.
### Progressive Web App (PWA)
1. Run `./setup_pwa.sh` to set up the web version
2. Open [echoesoftheashgame.patacuack.net](https://echoesoftheashgame.patacuack.net)
3. Register an account and play!
See [PWA_QUICKSTART.md](PWA_QUICKSTART.md) for detailed instructions.
## 📱 Platform Features
### Telegram Bot
- 🤖 Native Telegram integration
- 🔔 Instant push notifications
- 💬 Chat-based gameplay
- 👥 Easy sharing with friends
### Web/Mobile PWA
- 🌐 Play in any browser
- 📱 Install as mobile app
- 🎨 Modern responsive UI
- 🔐 Separate authentication
- ⚡ Offline support (coming soon)
- 🔔 Web push notifications (coming soon)
## 🛠️ Installation
### Prerequisites
- Docker and Docker Compose
- Telegram Bot Token (from [@BotFather](https://t.me/botfather))
- For Telegram: Bot Token from [@BotFather](https://t.me/botfather)
- For PWA: Node.js 20+ (for development)
### Installation
### Basic Setup
1. Clone the repository:
```bash
cd /opt/dockers/telegram-rpg
cd /opt/dockers/echoes_of_the_ashes
```
2. Create `.env` file:
@@ -50,16 +93,23 @@ DATABASE_URL=postgresql+psycopg://user:password@echoes_of_the_ashes_db:5432/tele
POSTGRES_USER=user
POSTGRES_PASSWORD=password
POSTGRES_DB=telegram_rpg
JWT_SECRET_KEY=generate-with-openssl-rand-hex-32
```
3. Start the bot:
3. Start services:
```bash
docker compose up -d --build
# Telegram bot only
docker-compose up -d --build
# With PWA (web version)
./setup_pwa.sh
```
4. Check logs:
```bash
docker logs echoes_of_the_ashes_bot -f
docker logs echoes_of_the_ashes_api -f
docker logs echoes_of_the_ashes_pwa -f
```
## 🎯 How to Play