updated README

- added guide for installation, initial setup
- added rules and how to manage games

README.md

@@ -1,38 +1,130 @@
-# Gwen't
+# Gwen't - The Dice Game <!-- omit in toc -->
 Gwen't is a simplyfied version of the Witcher card game "Gwent" but with dices, created by u/Dr_Manuka. (Source: https://www.reddit.com/r/WitcherTRPG/comments/ep0cc0/gwent_the_dice_version_of_gwent/)
 
-Even though it's coming from the Witcher franchise, it is **system agnostic**.
+# IMPORTANT <!-- omit in toc -->
+**This document is a complete guide on how to install, configure and play "Gwen't - The Dice Game". So you should read it completely to avoid confusion.**
+Even though it's originating from the Witcher franchise, it is **system agnostic**.
 
-# Installation
-It is not released yet. It is still in progress.
+- [1. How to Play](#1-how-to-play)
+  - [1.1. Rules](#11-rules)
+  - [1.2. Start a Game](#12-start-a-game)
+- [2. Installation](#2-installation)
+  - [2.1. Method 1](#21-method-1)
+- [3. Initial setup](#3-initial-setup)
+  - [3.1. Create Game Board](#31-create-game-board)
+    - [3.1.1. Create Board Actor](#311-create-board-actor)
+    - [3.1.2. Configure Board Settings](#312-configure-board-settings)
+    - [3.1.3. Configure Ownership](#313-configure-ownership)
+  - [3.2. Creating Decks](#32-creating-decks)
+    - [3.2.1. Create Deck Item](#321-create-deck-item)
+- [4. Support](#4-support)
 
+<br>
+
+# 1. How to Play
+## 1.1. Rules
+<!-- TODO: Show image of board, where to players are playing -->
+Please read the [reddit post](https://www.reddit.com/r/WitcherTRPG/comments/ep0cc0/gwent_the_dice_version_of_gwent/) from [Dr_Manuka](https://www.reddit.com/u/Dr_Manuka), since it already explains the rules. But there are some changes or restriction, which I will mention here:
+
+* **In the event of a draw, the player who passed first wins. If a player places his last die, it automatically counts as "pass".** I think this is a fair solution that ensures that all games are finished within 3 rounds.
+* If a deck contains more than 10 dice, it will **take the best 10 dice (d12 > d10 > d8 > ...)**. I don't know if some other logic would be nicer/better. Let me know what you think, by creating an issue [here](https://github.com/ortegamarcel/fvtt-gwent/issues).
+* **There are no "Easy", "Normal" or "Hard" options available**. Instead I recommend to create some predefined decks with different difficulties and use them the same as players would. A feature is planned, where you can easily configure these predefined decks to easily add them to games. So basically you can then configure as many difficulties as you want.
+* **There are no faction bonuses/deck types yet**. You can select it, but it has no effect for now. But that will be added in future. I might adapt these bonuses slightly for balancing purposes.
+* For now, **player2 always begins**. Due to time issues, I could't make it randomly, but I will change that asap.
+
+## 1.2. Start a Game
+Here I will explain how two players can play against each other or against the GM. Also, additional features like resetting the board and playing multiple matches in a row.
+
+**Play a Game:**
+
+Once, you finished the initial setup, (at least one of) your players should have a deck in their inventory. They should be able to open it from there (see previous screenshot). When they **click on "Play"**, the deck and player will be added to the board, which will automatically show up to the player. Now another person (or the GM) can do the same (click "Play" on one of their decks).
+
+**The game will automatically start, once two players joined the game board.**
+
+<!-- Show image of board -->
+
+**Play again:**
+
+As long as there are two player's joined, **only the GM can click on "Play Again"** to start the game from the beginning.
+
+**Reset the Game Board:**
+
+**Only the GM** can see and **click on "Reset Game"**, to remove all joined player's and deck's from the game board, so that other player's can join.
+
+# 2. Installation
 <!-- ## Method 1
 1. On Foundry VTT's **Configuration and Setup** screen, go to **Add-on Modules**
 2. Click **Install Module**
 3. Search for **Token Action HUD TheWitcherTRPG** 
 4. Click **Install** next to the module listing -->
 
-<!-- ## Method 1
+## 2.1. Method 1
 1. On Foundry VTT's **Configuration and Setup** screen, go to **Add-on Modules**
 2. Click **Install Module**
 3. In the Manifest URL field, paste: `https://github.com/ortegamarcel/fvtt-gwent/releases/latest/download/module.json`
-4. Click **Install** next to the pasted Manifest URL -->
+4. Click **Install** next to the pasted Manifest URL
+
+# 3. Initial setup
+Once installed, you need to make some configurations to make it compatible with the system you are using.
+
+## 3.1. Create Game Board
+Before you can play *Gwen't - The Dice Game*, you need to create a game board. Since game boards are not dynamically generated when someone wants to play a game, you need to prepare a game board on which two parties can compete. 
+
+<!-- TODO: Remove once multiple boards are implemented -->
+> In the future, it will be possible to prepare multiple game boards so that more players can play simultaneously.
+
+### 3.1.1. Create Board Actor
+Create an actor as usual. The type doesn't matter. But I recomment to give it a meaningful name, like "Gwen't Gaming Table".
+
+<!-- Show image of witcher actor -->
+
+Now click on "Sheet" to open the *Sheet Configuration*-dialog. Select "gwent.BoardSheet" for "This Sheet" and click on "Save Sheet Configuration". Now it should look like this:
+
+<!-- Show image of game board -->
+
+Click on the top left icon behind the actor name to copy its ID to the clipboard. This is important for the next step.
+
+### 3.1.2. Configure Board Settings
+Go to "Game Settings" -> "Configure Settings" -> "Gwen't". 
+
+<!-- Add settings screenshots with numbers -->
+
+1. **Paste the ID of the game board under "Board ID"**
+
+2. **Check if the weight attribute is correct.** It is used to calculate the weight of the deck. If this setting is wrong, the deck will not automatically update it's weight depending on the number of dice it contains, but besides that the module will still work.
+
+3. **(Optional) Change the games name**. If you want you can change the name of the game, so it fits your setting/system. Currently it is not shown anywhere, but that might change in future.
+
+### 3.1.3. Configure Ownership
+Now, to make players able to join this game board, you must give all players the "Owner" Permission for this actor.
+
+> For now this is needed, because when a players joins the game board, he will create and add a deck item to that actor. And for that "Owner"-permissions are required.
+
+**HINT:** Tell your players when they join your foundry world for the first time, to select their correct character instead of the Game Board, since it will also appear in the character selection window.
+
+> I will try to find a better solution in future.
+
+## 3.2. Creating Decks
+With "deck" I mean a collection of dice, representing a usual deck like used in card games like *Gwent*. At least two are needed to play a match of *Gwen't - The Dice Game*. You can also simply give these decks to your players, through which they can start a game. Since they are regular items, they will also appear in their inventory.
+
+### 3.2.1. Create Deck Item
+I am using the Witcher TRPG system, but it will work similar for any system as well.
+
+**First** you **create an item for your players, like you do as usual.** Select a item type so that the deck will be shown in a meaningful place in the players inventory. For me it will be under *Equipment* -> *General*.
+
+<!-- Show Image of create item box, where to select the type -->
 
-# Initial setup
-Once installed you need to make some configurations to make it compatible with the system you are using.
+I recommend to give it a meaningful name, i.e. "John's Gwen't Deck" and select a nice image.
 
-# Create Gwen't Decks
-Guide on how to create items, that represent a gwent deck.
+<!-- Show the item, before the sheet type is changed -->
 
-# Start a game
-Once, there are at least two decks, they can play against each other.
+**Click on "Sheet"** to open the *Sheet Configuration*-Dialog. **Select "gwent.GwentItemSheet" for "This Sheet"**.
 
-# Play a game
-Here are the rules.
+<!-- Show deck item sheet -->
 
-# Support
-Not yet, since it is still in progress. But if you have ideas (i.e. about UI/UX), feel free to let me know, by creating an issue [here](https://github.com/ortegamarcel/fvtt-gwent/issues).
+Now you have successfully created a gwent deck, that will behave like all your other items, but can be used to play a game. You can enter which and how many dice will be inside the deck. You need at least 10 dice to be able to play with it.
 
-<!-- For questions, feature requests or bug reports, please open an issue [here](https://github.com/ortegamarcel/fvtt-gwent/issues). -->
+# 4. Support
+For questions, feature requests or bug reports, please open an issue [here](https://github.com/ortegamarcel/fvtt-gwent/issues).
 
-<!-- Pull requests are welcome. Please include a reason for the request or create an issue before starting one. -->
+Pull requests are welcome. Please include a reason for the request or create an issue before starting one.