Add score table, improved description, hints, and more

diff --git a/Key-Hunt.md b/Key-Hunt.md
index 1a8c98ac1b1202d25fe1939c8fe1a8bf15ec5860..1630d0f29d8e2a7ad2ac78f69e253a77fa483aaa 100644 (file)
--- a/Key-Hunt.md
+++ b/Key-Hunt.md
@@ -7,25 +7,48 @@ Key Hunt (KH)
 Object of the Game
 ------------------
 
-In KH there are 3 teams (red; blue & yellow) and always one player of a team holds a key (Red key; blue key & yellow key). The goal is to collect the keys of the other teams and gather up to score. Get 1000 points to win a map (100 points for each capture).
-Tricky: Everyone that holds a key (Note: you can hold more than 1 of course) has a waypoint over his head (“Key carrier”), which shows his position.
+KeyHunt is a round-based game mode normally played with 3 teams, but 2 or 4 teams are also possible.
 
-How To:
+In each round, one player of each team gets a key. The goal of each round is to collect all the keys and gather up to score a lot of points. The first team to reach the score goal (default: 1000) wins the match.
 
-- Collect a key? Frag a player which holds a key and grab it (walk over it) after he died.
-- Score? Your team needs to collect all keys. If, for example, Player A, B and C of 1 team hold a team they have to meet a one place (can be anywhere) and be close enough together. That’s enough to score. Its possible that one player gets every key and he scores immediately then.
+Gameplay
+--------
+The game is played in seamless rounds. At the beginning of a round, one player per team gets a key in the color of the own team. The player who got the key (called “key carrier”) will see a message and the team mates will instantly see the position of the allied key carrier.
 
-Map Entities
-------------
+The message “Scanning frequency range” will appear. After a few seconds, the positions of all enemy key carriers will be revealed to everyone, too.
 
-_(Insert Map Entities here)_
+To win a round (and score), you have to grab all the keys and join them together. As soon as a team has all the keys, they must meet. If a single player collects all the keys, the team instantly wins the round.
+
+It is possible that a key is destroyed or lost during a round (e.g. by dropping it into the abyss or a deathtrap). The key carrier who lost or destroyed the key will lose the round for the team. The color of the key does not matter. This can happen for one of two reasons:
+
+1. The key carrier destroyed/lost the key due to own clumsiness: The team is “punished” by rewarding all other teams with a few points. This will appear as “destroyed” in the scoreboard
+2. An opponent pushed the key carrier violently into the abyss or a deadly liquid which destroyed the key. This awards the attacking team some points. This will be counted as a “push” in the scoreboard
+
+Finally, you can drop your keys by pressing the “Drop flag/key” control. It's [F] by default.
+
+Scoring
+-------
+
+In Key Hunt, the score depends on the number of teams in the game.
+
+| Action                                | 4 teams       | 3 teams | 2 teams | Notes                                              |
+|:-------------------------------------:|:-------------:|:-------:|:-------:|:--------------------------------------------------:|
+| Gather all keys                       | +300          | +200    | +100    |                                                    |
+| Make enemy team destroy key           | +60           | +60     | +60     | E.g. by pushing key carrier into abyss             |
+| Enemy team acidentally destroyed key  | +17 or +16*   | +25     | +50     | Awarded to each team that did *not* lose the round |
+| Collect enemy key                     | +3            | +3      | +3      | Awarded only once per key and round                |
+| Kill enemy key carrier                | +2            | +2      | +2      |                                                    |
+| Kill other enemy                      | +1            | +1      | +1      |                                                    |
+| Suicide/teamkill                      | -1            | -1      | -1      |                                                    |
+
+\* = This is a known bug. See [issue #2344](https://gitlab.com/xonotic/xonotic-data.pk3dir/issues/2344)
 
 Helpful Hints and Tips
 ----------------------
 
-- Some maps can contain powerups like “[Strength](Powerups#strength)” or “[Shield](Powerups#shield)” (which usually 
-spawn every 2 minutes). They can be useful tools to win a match!
-- [Binds](Binds) are very useful again to coordinate the team.
+- Some maps can contain powerups like “[Strength](Powerups#strength)” or “[Shield](Powerups#shield)”. They can be useful tools to win a match!
+- When you got a key but you're low on health, it can be useful to give the key to your team mates by dropping it
+- [Binds](Binds) are very useful to coordinate the team.
 
 List of Demos and Videos
 ------------------------