From dfad38ff3a0a9e6658c198ec8fa8ec2a9dd3216c Mon Sep 17 00:00:00 2001
From: alterwain <alterwain@protonmail.com>
Date: Mon, 14 Apr 2025 01:13:19 +0300
Subject: [PATCH] Changed action cards logic. x15

---
 README.md | 56 +++++++++++++++++++++++++++++++++++++++++++++++--------
 1 file changed, 48 insertions(+), 8 deletions(-)

diff --git a/README.md b/README.md
index 2a6011a..e09fdb4 100644
--- a/README.md
+++ b/README.md
@@ -1,18 +1,58 @@
-# Bunker
+# 🛡️ BUNKER – A Post-Apocalyptic Telegram Bot Game
 
 ![GitHub last commit](https://img.shields.io/github/last-commit/alterdekim/JBunker)
 [![Jenkins Build](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fjenkins.awain.net%2Fjob%2FJBunker%2F)](https://jenkins.awain.net/job/JBunker/)
 ![GitHub License](https://img.shields.io/github/license/alterdekim/JBunker)
 ![GitHub code size in bytes](https://img.shields.io/github/languages/code-size/alterdekim/JBunker)
 
-Bunker - telegram bot, that provides ability to play a post-apocalypse survival game.
+**Bunker** is a multiplayer text-based survival game hosted on Telegram. Players take on the roles of randomly assigned survivors trapped in a bunker after a global catastrophe. Each game challenges the group to vote on who should be expelled from the bunker while managing limited resources, random events, and hidden player traits.
 
-## Description
+## 🎮 How to Play
 
-This bot acts as a "game master", providing unique game experience for you and your friends.
+1. **Start a Game**  
+   Set up a telegram bot and invite it to your telegram group, then you can bind bot to group using `/setgroup`. To start a game use `/startgame`.
 
-## Features
+2. **Receive a Profile**  
+   Each player is given a unique profile with:
+    - Age
+    - Gender
+    - Profession
+    - Health status
+    - Luggage contents
+    - Hobby
 
- - Control panel for admins
- - Seamless integration with telegram
- - Customization
\ No newline at end of file
+3. **Reveal Traits**  
+   Each round, players must reveal one new trait to the group.
+
+4. **Voting Rounds**  
+   At the end of each round, players vote on who should be removed from the bunker.
+
+5. **Events & Environment**  
+   Each game includes:
+    - **Bunker conditions** (e.g. broken air filter, food supply, structural issues)
+    - **Player-driven actions** (e.g. steal luggage)
+    - **Randomized voting rules** per round (e.g. tie = no expel, reversed voting)
+
+6. **Win or Lose**  
+   At the end of the game, the bot evaluates remaining player profiles against the environment to calculate a **survival win rate**. If it's high enough, the group wins. If not—well, better luck next apocalypse.
+
+---
+
+## ⚙️ Features
+
+- 🧠 Dynamic trait-based strategy
+- 🎲 Procedural environmental hazards
+- 🧍 Player actions and deception
+- 🔄 Randomized voting mechanics
+- 📊 Automatic win/loss evaluation
+- 🤖 Smooth Telegram integration
+- ☕ Built with Java + Spring Boot
+
+---
+
+## 🚀 Getting Started (For Developers)
+
+### Requirements
+- Java 17+
+- Maven
+- Telegram Bot Token (via BotFather)