# Timberbound Expeditions: Studio Setup & Tagging Guide

To bring the overarching logic to life, your physical objects in Roblox Studio need to be identified by the engine scripts. We use Roblox's **CollectionService (Tags)** and **Attributes** to do this securely and efficiently, avoiding thousands of `.Touched` connections on generic parts.

## How to Apply Tags & Attributes
- **Tags:** Use the built-in **Tag Editor** in Roblox Studio (View -> Tag Editor). Select your part/model, and tick the box for the specific tag name.
- **Attributes:** Select an object, scroll to the bottom of the **Properties** panel, and click "Add Attribute" (usually a String, Number, or Boolean type).

---

## 1. Core Mechanics: Trees & Dragging

### `TreeSegment` (Tag)
*   **What it goes on:** Any physical cylinder/block that represents a piece of a choppable tree or a cut log.
*   **Required Attributes:**
    *   `TreeType` (String): e.g., `"Oak"`, `"Pine"`. This maps exactly to the names in [ChoppingConfig.lua](file:///c:/Users/User/Desktop/VSCode2/RobloxStudio-MCP-GoogleAntigravity/src/ReplicatedStorage/Shared/ChoppingConfig.lua).
    *   `Health` (Number - *Optional*): The server will auto-assign MaxHealth from the config if you don't provide this.

### `Draggable` (Tag)
*   **What it goes on:** Furniture, tools, or boxes that the player can pick up and move around using the physics dragger.
*   *(Note: Anything tagged `TreeSegment` is automatically draggable, you do not need both tags).*

---

## 2. Economy & Processing

### `ProcessingMachine` (Tag)
*   **What it goes on:** The main `Model` grouping your sawmill or stripper.
*   **Required Parts Inside:**
    *   `ProcessTrigger` (Part): An invisible, non-colliding block inside the machine where the sawblade/stripper is. When a log touches this, it gets processed.
*   **Required Attributes (on the Model):**
    *   `MachineType` (String): `"Stripper"` or `"Sawmill"`.

### `MarketDropoff` (Tag)
*   **What it goes on:** A large, invisible, non-colliding `Part` at your market location. When processed wood touches it, the wood is sold and cash is given.

### `ShopCounter` (Tag)
*   **What it goes on:** An invisible `Part` resting just above the checkout counter in your shop.
*   **How it works:** Players drop boxed items onto this part. The script counts their prices when the player interacts with the NPC.

### `BoxedItem` (Tag)
*   **What it goes on:** The physical cardboard box mesh sitting on the shop shelves.
*   **Required Attributes:**
    *   `ItemId` (String): e.g., `"BasicAxe"`, `"Sawmill"`. Must match the IDs in [ShopConfig.lua](file:///c:/Users/User/Desktop/VSCode2/RobloxStudio-MCP-GoogleAntigravity/src/ReplicatedStorage/Shared/ShopConfig.lua).

---

## 3. Base Building & Plots

### `EmptyPlot` (Tag)
*   **What it goes on:** The massive, flat baseplate `Part` representing a claimable piece of land.
*   **How it works:** When a player without a plot touches this part, the server assigns it to them and loads their Datastore objects onto it.

---

## 4. Vehicle Logistics

### `Vehicle` (Tag)
*   **What it goes on:** The root `Model` of whatever vehicle chassis you are using (A-Chassis, Constraint Chassis, etc.).
*   **Required Parts Inside:**
    *   Either name the bed of the truck `"FlatbedPart"` OR tag that single part `"Flatbed"`. The script will apply massive friction to this specific part so logs don't slide off.

---

## 5. Wiring & Logic

### `LogicSource` (Tag)
*   **What it goes on:** The interactable object like a button or lever `Part`.
*   **Required Attributes:**
    *   `SourceType` (String): `"Button"` or `"Lever"`. A button pulses power for 1 second; a lever toggles it indefinitely.

---

## 6. Adventure & Hazards

### `HazardZone` (Tag)
*   **What it goes on:** A large invisible part representing an area affecting nearby flora.
*   **Required Attributes:**
    *   `HazardType` (String): `"Lava"` or `"Toxic"`. Mutates nearby trees into Fireproof or Glowing variants.

### `WeightSwitch` (Tag)
*   **What it goes on:** A `Model` representing an environmental puzzle switch.
*   **Required Parts Inside:**
    *   `Plate` (Part): The physical button that gets stepped on.
    *   `LinkedDoor` (Part): The wall/door that disappears when the puzzle is solved.

### `SwampZone` (Tag)
*   **What it goes on:** A large invisible part representing deep mud or swamp liquid. Heavy items sinking into it are physically forced downwards unless they possess the `SwampTires` tag.