rules

.cursor/rules/roblox/education/lesson-plans/roblox-developer/roblox-developer-4.md

@@ -0,0 +1,106 @@
+---
+title: Adventure game part 2
+description: The second part of a Roblox Developer education series. Teach students to create an adventure game in Roblox.
+next: /education/lesson-plans/roblox-developer/roblox-developer-5
+prev: /education/lesson-plans/roblox-developer/roblox-developer-3
+---
+
+**Lesson description**: Students continue developing the adventure game. They'll create scripts for using tools, selling items, and upgrading their spaces.
+
+<table>
+<tbody>
+   <tr>
+    <td><b>Lesson objectives</b></td>
+    <td>
+      <ul>
+        <li>Apply knowledge of if/then statements to create collectible items.</li>
+        <li>Demonstrate knowledge of functions to create functions that allow players to sell items and upgrade their spaces variable.</li>
+        </ul>
+      </td>
+   </tr>
+   <tr>
+    <td><b>Prep</b></td>
+    <td>
+    <ul>
+    <li>Download the <a href="../../../assets/education/adventure-game-series/starterTool.rbxm" target="_blank" rel="noopener">starter tool</a> and load it on every student's desktop.</li>
+    </ul>
+    </td>
+   </tr>
+
+</tbody>
+</table>
+
+### Overview
+
+<table>
+  <thead>
+    <tr>
+      <th>Duration</th>
+      <th>Activity</th>
+      <th>Description </th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>5 min</td>
+      <td>Introduction</td>
+      <td>Introduce the session.</td>
+    </tr>
+    <tr>
+      <td>50 min</td>
+      <td>Guided Tutorial: Scripting Game Mechanics</td>
+      <td>Have students create scripts for tools, selling items, and upgrading spaces.</td>
+    </tr>
+    <tr>
+      <td>5 min</td>
+      <td>Wrap-up</td>
+      <td>Reflect on project and recap concepts learned.</td>
+    </tr>
+  </tbody>
+</table>
+
+### Lesson plan
+
+#### Introduction
+
+1. Explain that students will be adding the core gameplay mechanics of the adventure game today: using a tool to collect items, selling items, and upgrading their spaces to collect more items.
+2. Point out that this session will be heavy on guided tutorials. The next session will be more free-form, so students can work on their own or catch up.
+
+#### Guided tutorial - Script game mechanics
+
+1. Make sure all students have access to the <a href="../../../assets/education/adventure-game-series/starterTool.rbxm" target="_blank" rel="noopener">starter tool</a>.
+2. Lead students through the following tutorials:
+   - <a href="../../../education/adventure-game-series/collect-items.md" target="_blank" rel="noopener">Collecting Items</a>
+   - <a href="../../../education/adventure-game-series/selling-items.md" target="_blank" rel="noopener">Selling Items</a>
+   - <a href="../../../education/adventure-game-series/buying-upgrades.md" target="_blank" rel="noopener">Buying Upgrades</a>
+
+#### Wrap-up
+
+1. Recap what students have created.
+2. Optional - Ask students what feature they're excited to work on or add tomorrow as they finish their games.
+
+### Appendix
+
+#### Troubleshooting and classroom tips
+
+**General troubleshooting**
+
+- While students code, leave up example scripts for students to reference. The Tool script is especially helpful as it has nested if statements.
+- Check that students are indenting their code to look like the code samples. This makes code more readable and reduces the possibility of errors.
+
+**Scripting tips**
+
+- Remind students to always add a comma between multiple parameters in a function, like in `sellItems(playerItems, playerGold)`.
+- In the Upgrade script, the order of functions matters. Make sure that the function `giveUpgrade()` is above `clickDetector.MouseClick`.
+
+**Facilitation tips**
+
+- To keep students on track, set a strict time limit for playtesting, like one minute.
+- Encourage students to remember a specific goal whenever playtesting, such as check if a tool harvests an item as intended. This helps them stay focused.
+
+#### Customize the lesson
+
+**Expand the lesson**
+
+- More than one item can be added to harvest, just remember that each item needs a BoolValue with `CanHarvest` set to true.
+- Surface GUI's, like the Upgrade Sign, can be customized. Encourage students to explore properties of TextLabels, like color and font in the properties of that TextLabel and SurfaceGui.