Update README.md

README.md

@@ -10,4 +10,49 @@ pinned: false
 license: mit
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# Cascadia Ruleset 🌲
+
+## Setup 📦
+- **Game Components** 🎲
+  - Habitat tiles 🟩
+  - Wildlife tokens 🐻🦅🐟🦌🐿️
+  - Scorecards ✍️
+  - Nature tokens 🍃
+- **Preparation** 📐
+  - Shuffle habitat tiles and place in stacks 🔄
+  - Sort wildlife tokens by type 🐾
+  - Give each player a scorecard and a starting habitat tile 🤲
+
+## Gameplay 🎮
+- **Turn Sequence** ↩️
+  - **Drafting** 🤔
+    - Draw one habitat tile and one wildlife token 🟩🐻
+    - Place them in your play area 🌄
+  - **Tile Placement** 🏗️
+    - Place the habitat tile next to a tile in your area, matching at least one edge ⬛️➡️🟩
+  - **Wildlife Placement** 🐾
+    - Place the wildlife token on a corresponding habitat on any tile 🦅🟩
+- **Nature Tokens** 🍃
+  - Spend nature tokens to swap wildlife tokens or save them for endgame scoring 💱
+
+## Scoring 📊
+- **Wildlife Scoring** 🐻
+  - Score based on patterns and sets of wildlife tokens as indicated on the scorecard 📝
+- **Habitat Scoring** 🌲
+  - Score for the largest connected areas of each habitat type 🏞️
+- **Nature Tokens Scoring** 🍃
+  - Remaining nature tokens can score additional points 💰
+
+## End of Game 🏁
+- **Final Scoring** 📈
+  - Add up scores from wildlife, habitats, and nature tokens 🧮
+  - The player with the most points wins 🏆
+
+## Variants and Expansions 🔄
+- **Family Variant** 👨‍👩‍👧‍👦
+  - Simplified scoring for younger players ✂️
+- **Solo Play** 🧍
+  - Adjusted rules for single-player mode 👤
+- **Expansions** 📦
+  - Additional wildlife tokens and habitat tiles for expanded play 🆕