Upload 88 files

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 callmerem
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

STRUCTURE.md

@@ -0,0 +1,101 @@
+## Project Structure
+
+```text
+TimberWoods/
+├── references/
+├── src/
+│   ├── ReplicatedStorage/
+│   │   ├── Events/
+│   │   │   ├── ChopEvent.model.json
+│   │   │   ├── ClaimPlot.model.json
+│   │   │   ├── CraftEvent.model.json
+│   │   │   ├── DialogueEvent.model.json
+│   │   │   ├── DragEvent.model.json
+│   │   │   ├── DropEvent.model.json
+│   │   │   ├── EquipToolEvent.model.json
+│   │   │   ├── FillBlueprintEvent.model.json
+│   │   │   ├── MarketUpdateEvent.model.json
+│   │   │   ├── NotificationEvent.model.json
+│   │   │   ├── PlaceBlueprintEvent.model.json
+│   │   │   ├── PurchaseEvent.model.json
+│   │   │   ├── QuestUpdateEvent.model.json
+│   │   │   ├── SettingsEvent.model.json
+│   │   │   ├── ShopEvent.model.json
+│   │   │   ├── SoundEvent.model.json
+│   │   │   └── WireConnectEvent.model.json
+│   │   └── Shared/
+│   │       ├── AutomationConfig.lua
+│   │       ├── BiomeConfig.lua
+│   │       ├── BuildingConfig.lua
+│   │       ├── ChoppingConfig.lua
+│   │       ├── Constants.lua
+│   │       ├── CraftingConfig.lua
+│   │       ├── DraggingConfig.lua
+│   │       ├── EconomyConfig.lua
+│   │       ├── ExplorationConfig.lua
+│   │       ├── GameConfig.lua
+│   │       ├── MutationConfig.lua
+│   │       ├── NPCConfig.lua
+│   │       ├── PlotConfig.lua
+│   │       ├── QuestConfig.lua
+│   │       ├── ShopConfig.lua
+│   │       ├── SoundConfig.lua
+│   │       ├── TreeModelConfig.lua
+│   │       ├── Utility.lua
+│   │       ├── VehicleConfig.lua
+│   │       ├── WeatherConfig.lua
+│   │       └── WireLogicConfig.lua
+│   ├── ServerScriptService/
+│   │   ├── AchievementManager.server.lua
+│   │   ├── AntiCheatManager.server.lua
+│   │   ├── BiomeGeneratorManager.server.lua
+│   │   ├── ConstructionManager.server.lua
+│   │   ├── CraftingManager.server.lua
+│   │   ├── DatastoreManager.server.lua
+│   │   ├── DayNightManager.server.lua
+│   │   ├── DragManager.server.lua
+│   │   ├── DroneAutomationManager.server.lua
+│   │   ├── EnvironmentalPuzzleManager.server.lua
+│   │   ├── InventoryManager.server.lua
+│   │   ├── LeaderboardManager.server.lua
+│   │   ├── MapManager.server.lua
+│   │   ├── MarketManager.server.lua
+│   │   ├── MutationManager.server.lua
+│   │   ├── NPCManager.server.lua
+│   │   ├── PlayerSetupManager.server.lua
+│   │   ├── PlotManager.server.lua
+│   │   ├── QuestManager.server.lua
+│   │   ├── RespawnManager.server.lua
+│   │   ├── SawmillManager.server.lua
+│   │   ├── ShopManager.server.lua
+│   │   ├── SoundscapeManager.server.lua
+│   │   ├── TreeManager.server.lua
+│   │   ├── TreeSpawnerManager.server.lua
+│   │   ├── VehicleLogisticsManager.server.lua
+│   │   ├── WeatherManager.server.lua
+│   │   └── WireLogicManager.server.lua
+│   ├── StarterGui/
+│   │   ├── CraftingGUI.client.lua
+│   │   ├── DialogueGUI.client.lua
+│   │   ├── InventoryGUI.client.lua
+│   │   ├── MainHUD.client.lua
+│   │   ├── MarketGUI.client.lua
+│   │   ├── QuestGUI.client.lua
+│   │   ├── SettingsGUI.client.lua
+│   │   └── ShopGUI.client.lua
+│   └── StarterPlayer/
+│       └── StarterCharacterScripts/
+│           ├── AxeController.client.lua
+│           ├── BuildController.client.lua
+│           ├── DragController.client.lua
+│           └── SoundController.client.lua
+├── aftman.toml
+├── default.project.json
+├── LICENSE
+├── mcp.json
+├── roblox-studio-antigravity-mcp-guide.md
+├── robloxstudio-mcp-system-mechanics.md
+├── studio-rust-mcp-server-system-mechanics.md
+├── studio_setup_guide.md
+└── TECHSTACK.md
+```

TECHSTACK.md

@@ -0,0 +1,12 @@
+## Techstack
+
+Audit of **TimberWoods** project files (excluding environment and cache):
+
+| File Type | Count | Size (KB) |
+| :--- | :--- | :--- |
+| Lua (.lua) | 61 | 212.2 |
+| JSON (.json) | 19 | 1.8 |
+| Markdown (.md) | 4 | 17.8 |
+| (no extension) | 1 | 1.1 |
+| TOML (.toml) | 1 | 0.3 |
+| **Total** | **86** | **233.1** |

aftman.toml

@@ -0,0 +1,7 @@
+# This file lists tools managed by Aftman, a cross-platform toolchain manager.
+# For more information, see https://github.com/LPGhatguy/aftman
+
+# To add a new tool, add an entry to this table.
+[tools]
+rojo = "rojo-rbx/rojo@7.7.0-rc.1"
+# rojo = "rojo-rbx/rojo@6.2.0"

default.project.json

@@ -0,0 +1,36 @@
+{
+  "name": "TimberboundExpeditions",
+  "tree": {
+    "$className": "DataModel",
+    "ReplicatedStorage": {
+      "$className": "ReplicatedStorage",
+      "Shared": {
+        "$path": "src/ReplicatedStorage/Shared"
+      },
+      "Events": {
+        "$path": "src/ReplicatedStorage/Events"
+      }
+    },
+    "ServerScriptService": {
+      "$className": "ServerScriptService",
+      "TimberboundServer": {
+        "$path": "src/ServerScriptService"
+      }
+    },
+    "StarterPlayer": {
+      "$className": "StarterPlayer",
+      "StarterCharacterScripts": {
+        "$className": "StarterCharacterScripts",
+        "TimberboundClient": {
+          "$path": "src/StarterPlayer/StarterCharacterScripts"
+        }
+      }
+    },
+    "StarterGui": {
+      "$className": "StarterGui",
+      "TimberboundGUI": {
+        "$path": "src/StarterGui"
+      }
+    }
+  }
+}

mcp.json

@@ -0,0 +1,10 @@
+{
+    "mcpServers": {
+        "Roblox Studio": {
+            "command": "C:\\Users\\User\\Desktop\\VSCode2\\RobloxStudio-MCP-GoogleAntigravity\\references\\studio-rust-mcp-server-main\\target\\release\\rbx-studio-mcp.exe",
+            "args": [
+                "--stdio"
+            ]
+        }
+    }
+}

roblox-studio-antigravity-mcp-guide.md

@@ -0,0 +1,74 @@
+# Integrating Google Antigravity with Roblox Studio via Rust MCP
+
+This guide outlines exactly how to connect the Google Antigravity system (running within VS Code) natively to your Roblox Studio instance utilizing the high-performance **Rust Model Context Protocol (MCP)** implementation.
+
+---
+
+## Step 1: Prepare the Rust Environment
+
+The `studio-rust-mcp-server-main` reference must first be built into a local binary.
+
+1. Open your terminal inside the `studio-rust-mcp-server-main` repository directory.
+2. Ensure you have Rust and Cargo installed via rustup.
+3. Build the server for release:
+   ```bash
+   cargo build --release
+   ```
+4. This will output a binary executable located at `target\release\rbx-studio-mcp.exe`.
+
+## Step 2: Configure Google Antigravity (VS Code)
+
+Google Antigravity leverages a configuration file named `mcp.json` inside your VS Code user data directory to identify connected AI bridging servers.
+
+1. Navigate to your VS Code data folder. On Windows, this is typically located at:
+   `C:\Users\User\AppData\Roaming\Code\User\mcp.json`
+   *(If the file does not exist, create it).*
+2. Add the `Roblox Studio` entry to the `mcpServers` object, directing it to your compiled executable and passing the required `--stdio` flag. The file should look like this:
+
+   ```json
+   {
+     "mcpServers": {
+       "Roblox Studio": {
+         "command": "C:\\Users\\User\\Desktop\\VSCode2\\RobloxStudio-MCP-GoogleAntigravity\\references\\studio-rust-mcp-server-main\\target\\release\\rbx-studio-mcp.exe",
+         "args": [
+           "--stdio"
+         ]
+       }
+     }
+   }
+   ```
+
+## Step 3: Install the Studio Component Plugin
+
+The Rust MCP server utilizes a native Roblox Studio plugin (`MCPStudioPlugin.rbxm`) to communicate over local ports via long polling. The compiled server binary can install this plugin automatically.
+
+1. Run the `.exe` directly **without any arguments** from your command line:
+   ```bash
+   .\target\release\rbx-studio-mcp.exe
+   ```
+2. The installer will automatically extract and inject the plugin directly into your local Roblox plugins directory (`%LOCALAPPDATA%\Roblox\Plugins`).
+
+## Step 4: Finalizing the Integration
+
+You must make both systems aware of the new bridging connections.
+
+1. **Reload VS Code**: Because you just created/modified `mcp.json`, the Antigravity system hasn't loaded it yet. Run the VS Code command `Developer: Reload Window` (Ctrl+Shift+P) or simply restart VS Code entirely.
+2. **Restart Roblox Studio**: Open any local place or project file to load your plugins.
+3. **Activate the Plugin**: In the Studio `Plugins` toolbar, click the MCP icon to toggle it ON. Look at your Studio `Output` window—you should see the message: 
+   > `"The MCP Studio plugin is ready for prompts."`
+
+---
+
+## Step 5: Test the Workspace Link!
+
+The setup is complete! Since Google Antigravity relies on an internal network of autonomous tools (and doesn't require jumping through an external Claude/Cursor GUI), you can simply begin prompting directly in the Antigravity chat:
+
+- *"List the child elements of my Workspace."*
+- *"Create a red part at the world spawn."*
+- *"Find and report any LocalScripts currently running in ReplicatedStorage."*
+
+Antigravity will instantly pipe instructions sequentially through `rbx-studio-mcp.exe`, execute natively inside Roblox Studio's DataModel, and retrieve responses securely back into your agent interface.
+
+# others
+
+cat C:\Users\User\AppData\Roaming\Code\User\mcp.json

robloxstudio-mcp-system-mechanics.md

@@ -0,0 +1,78 @@
+# NOTE: This is from 'C:\Users\User\Desktop\VSCode2\RobloxStudio-MCP-GoogleAntigravity\references\robloxstudio-mcp-main'.
+
+# Roblox Studio MCP Server (Node.js/TypeScript) System Mechanics
+
+This document provides a detailed breakdown of the system architecture and mechanics for the `robloxstudio-mcp` project, which facilitates communication between an LLM Client (like Claude or Cursor) and Roblox Studio.
+
+## Architecture Diagram
+
+Below is a detailed Mermaid sequence diagram illustrating the lifecycle of a tool request in this environment.
+
+```mermaid
+sequenceDiagram
+    participant LLM as LLM Client (Claude/Cursor)
+    participant MCP as Node.js MCP Server (stdio)
+    participant Bridge as BridgeService (Memory)
+    participant HTTP as Express HTTP Server (:port)
+    participant Plugin as Roblox Studio Plugin (Luau)
+
+    note over LLM,Plugin: 1. Setup Phase
+    HTTP-->>Plugin: Setup Endpoints (/health, /poll, /response)
+    Plugin->>HTTP: POST /ready (Initialize Connection)
+    HTTP->>Bridge: bridge.clearAllPendingRequests()
+
+    note over LLM,Plugin: 2. Long Polling Loop
+    loop Every few seconds or immediately after a response
+        Plugin->>HTTP: GET /poll
+        HTTP->>Bridge: getPendingRequest()
+        alt No pending request
+            HTTP-->>Plugin: empty response (after delay/timeout)
+        else Has pending request
+            HTTP-->>Plugin: JSON { request, requestId }
+        end
+    end
+
+    note over LLM,Plugin: 3. Tool Execution Lifecycle
+    LLM->>MCP: CallTool (e.g., get_file_tree)
+    MCP->>Bridge: sendRequest(endpoint, data)
+    Bridge->>Bridge: generate UUID & store in pendingRequests Map
+    
+    note right of HTTP: The next long poll from Plugin hits...
+    Plugin->>HTTP: GET /poll
+    HTTP->>Bridge: getPendingRequest()
+    Bridge-->>HTTP: oldest pending request
+    HTTP-->>Plugin: Return Request Payload (requestId, tool data)
+    
+    note over Plugin: Evaluates request & interacts with Roblox DataModel
+
+    Plugin->>HTTP: POST /response { requestId, response, error }
+    HTTP->>Bridge: resolveRequest(requestId, response)
+    Bridge->>Bridge: Match UUID, trigger promise resolve
+    Bridge-->>MCP: Return result
+    MCP-->>LLM: Return CallToolResult
+```
+
+## Detailed Discussion
+
+### Components Overview
+
+1. **MCP Server over stdio (`src/index.ts`)**:
+   The core entry point utilizes the `@modelcontextprotocol/sdk` to expose Roblox Studio capabilities to AI assistants via Standard AI standard input/output streams (`stdio`). It initializes various available tools (like `get_file_tree`, `search_files`, `edit_script_lines`, etc.) and maps them to functions in `RobloxStudioTools`.
+
+2. **BridgeService (`src/bridge-service.ts`)**:
+   Since standard LLMs cannot execute HTTP requests directly into the Roblox Studio execution context, a "Bridge" is required. The `BridgeService` stores requests originating from the LLM in memory utilizing a `Map<string, PendingRequest>`. It assigns a `uuidv4` identifier to each request, resolving or rejecting Javascript Promises when Roblox Studio responds or naturally timing out after 30 seconds.
+
+3. **Express HTTP Server (`src/http-server.ts`)**:
+   Exposed locally, this server creates standard REST API endpoints mapping to the bridge context:
+   - `/ready` and `/disconnect`: Manage lifecycle awareness for the connected plugin.
+   - `/poll`: The crucial endpoint for the long-polling architecture. The Roblox Studio plugin continuously sends GET requests here. If a request exists, it returns immediately; otherwise, it waits/cycles to keep the network open without overwhelming the LLM client.
+   - `/response`: Where the plugin submits the results of executed queries natively run inside Studio.
+   - Various `/mcp/*` endpoints exist natively simulating the tools routing.
+
+4. **Roblox Studio Plugin (`studio-plugin/src/...`)**:
+   Written in Luau. Because Roblox restricts incoming connections for security, the plugin utilizes `HttpService` to make outgoing requests to the local Express server. It intercepts the HTTP Polling results, runs internal Studio SDK functions (e.g., getting hierarchical Place structures, updating script source code), and uses `/response` to fire the feedback back up the chain.
+
+### Core Mechanics
+
+- **Asynchronous Execution Gap Check**: The Node.js application is cleanly divided between the immediate `stdio` processing required by AI environments and the delayed networking constraints of `HttpService` in Roblox. The Promise architecture in the `BridgeService` forces the LLM to patiently await a complete trip through the local REST API and back.
+- **Robust Toolset**: Uniquely among implementations, the TS-based server opts to fully define over 30 distinct granular tools (e.g., `insert_script_lines`, `mass_create_objects`) rather than primarily depending on evaluating raw Luau injected as strings. This gives the AI safer, strictly structured constraints to work within instead of writing custom engine scripts consistently over REST.

src/ReplicatedStorage/Events/ChopEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/ClaimPlot.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/CraftEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/DialogueEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/DragEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/DropEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/EquipToolEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/FillBlueprintEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/MarketUpdateEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/NotificationEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/PlaceBlueprintEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/PurchaseEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/QuestUpdateEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/SettingsEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/ShopEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/SoundEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Events/WireConnectEvent.model.json

@@ -0,0 +1,3 @@
+{
+    "ClassName": "RemoteEvent"
+}

src/ReplicatedStorage/Shared/AutomationConfig.lua

@@ -0,0 +1,20 @@
+-- src/ReplicatedStorage/Shared/AutomationConfig.lua
+
+local AutomationConfig = {
+    Drones = {
+        BasicDrone = {
+            Speed = 20,
+            MaxCarryWeight = 50, -- Volume limit
+            EnergyCapacity = 100,
+            EnergyDrainPerStud = 0.1
+        },
+        AdvancedDrone = {
+            Speed = 40,
+            MaxCarryWeight = 150,
+            EnergyCapacity = 300,
+            EnergyDrainPerStud = 0.05
+        }
+    }
+}
+
+return AutomationConfig

src/ReplicatedStorage/Shared/BiomeConfig.lua

@@ -0,0 +1,105 @@
+-- src/ReplicatedStorage/Shared/BiomeConfig.lua
+
+local BiomeConfig = {
+	Biomes = {
+		Forest = {
+			TerrainMaterial = Enum.Material.Grass,
+			GroundColor = Color3.fromRGB(85, 120, 60),
+			TreeTypes = {"Oak", "Birch", "Elm"},
+			TreeDensity = 0.08, -- trees per stud^2 (in spawn region)
+			ElevationRange = {0, 5},
+			HazardType = nil,
+			FogEnd = 1500,
+			FogColor = Color3.fromRGB(180, 200, 180),
+			Region = {MinX = -500, MaxX = -1, MinZ = 1, MaxZ = 500},
+		},
+		PineWoods = {
+			TerrainMaterial = Enum.Material.Grass,
+			GroundColor = Color3.fromRGB(60, 95, 45),
+			TreeTypes = {"Pine", "Birch"},
+			TreeDensity = 0.10,
+			ElevationRange = {5, 20},
+			HazardType = nil,
+			FogEnd = 1200,
+			FogColor = Color3.fromRGB(160, 180, 160),
+			Region = {MinX = 1, MaxX = 500, MinZ = 1, MaxZ = 500},
+		},
+		Swamp = {
+			TerrainMaterial = Enum.Material.Mud,
+			GroundColor = Color3.fromRGB(70, 80, 50),
+			TreeTypes = {"Oak", "Elm"},
+			TreeDensity = 0.04,
+			ElevationRange = {-3, 0},
+			HazardType = "SwampZone",
+			FogEnd = 600,
+			FogColor = Color3.fromRGB(120, 140, 100),
+			Region = {MinX = -500, MaxX = -1, MinZ = -500, MaxZ = -1},
+		},
+		Desert = {
+			TerrainMaterial = Enum.Material.Sand,
+			GroundColor = Color3.fromRGB(210, 190, 140),
+			TreeTypes = {"Elm"},
+			TreeDensity = 0.01,
+			ElevationRange = {0, 10},
+			HazardType = nil,
+			FogEnd = 2000,
+			FogColor = Color3.fromRGB(230, 220, 180),
+			Region = {MinX = 501, MaxX = 1000, MinZ = -500, MaxZ = -1},
+		},
+		Volcanic = {
+			TerrainMaterial = Enum.Material.Basalt,
+			GroundColor = Color3.fromRGB(60, 40, 35),
+			TreeTypes = {"LavaWood"},
+			TreeDensity = 0.02,
+			ElevationRange = {10, 40},
+			HazardType = "HazardZone",
+			HazardAttribute = "Lava",
+			FogEnd = 800,
+			FogColor = Color3.fromRGB(180, 100, 60),
+			Region = {MinX = 501, MaxX = 1000, MinZ = 1, MaxZ = 500},
+		},
+		IcePeak = {
+			TerrainMaterial = Enum.Material.Glacier,
+			GroundColor = Color3.fromRGB(200, 220, 240),
+			TreeTypes = {"Pine", "Birch"},
+			TreeDensity = 0.03,
+			ElevationRange = {20, 60},
+			HazardType = nil,
+			FogEnd = 900,
+			FogColor = Color3.fromRGB(210, 220, 240),
+			Region = {MinX = -1000, MaxX = -501, MinZ = -500, MaxZ = -1},
+		},
+		TropicalRainforest = {
+			TerrainMaterial = Enum.Material.LeafyGrass,
+			GroundColor = Color3.fromRGB(40, 100, 35),
+			TreeTypes = {"Mahogany", "Walnut", "GlowWood"},
+			TreeDensity = 0.12,
+			ElevationRange = {0, 8},
+			HazardType = nil,
+			FogEnd = 500,
+			FogColor = Color3.fromRGB(100, 150, 100),
+			Region = {MinX = -1000, MaxX = -501, MinZ = 1, MaxZ = 500},
+		},
+		Meadow = {
+			TerrainMaterial = Enum.Material.Grass,
+			GroundColor = Color3.fromRGB(130, 170, 80),
+			TreeTypes = {"Oak", "Birch"},
+			TreeDensity = 0.02,
+			ElevationRange = {0, 3},
+			HazardType = nil,
+			FogEnd = 2000,
+			FogColor = Color3.fromRGB(200, 210, 200),
+			Region = {MinX = 1, MaxX = 500, MinZ = -500, MaxZ = -1},
+		},
+	},
+
+	-- Terrain generation
+	TerrainChunkSize = 64, -- studs per terrain block
+	TerrainResolution = 4,  -- voxel resolution
+	WaterLevel = -2,
+
+	-- Tree spacing
+	MinTreeSpacing = 12, -- minimum studs between trees
+}
+
+return BiomeConfig

src/ReplicatedStorage/Shared/BuildingConfig.lua

@@ -0,0 +1,98 @@
+-- src/ReplicatedStorage/Shared/BuildingConfig.lua
+
+local BuildingConfig = {
+	GridSnap = 2,
+	MaxPlacementDistance = 30,
+
+	Structures = {
+		WoodWall = {
+			Name = "Wooden Wall",
+			Size = Vector3.new(10, 10, 1),
+			Cost = {
+				WoodVolume = 20,
+				SpecificMaterial = "Plank",
+			},
+		},
+		WoodFloor = {
+			Name = "Wooden Floor",
+			Size = Vector3.new(10, 1, 10),
+			Cost = {
+				WoodVolume = 25,
+				SpecificMaterial = "Plank",
+			},
+		},
+		WoodRoof = {
+			Name = "Wooden Roof",
+			Size = Vector3.new(12, 1, 12),
+			Cost = {
+				WoodVolume = 15,
+				SpecificMaterial = "Plank",
+			},
+		},
+		WoodDoor = {
+			Name = "Wooden Door",
+			Size = Vector3.new(4, 8, 1),
+			Cost = {
+				WoodVolume = 10,
+				SpecificMaterial = "Plank",
+			},
+		},
+		WoodStairs = {
+			Name = "Wooden Stairs",
+			Size = Vector3.new(4, 10, 10),
+			Cost = {
+				WoodVolume = 30,
+				SpecificMaterial = "Plank",
+			},
+		},
+		WoodWindow = {
+			Name = "Wooden Window Frame",
+			Size = Vector3.new(6, 6, 1),
+			Cost = {
+				WoodVolume = 12,
+				SpecificMaterial = "Plank",
+			},
+		},
+		WoodFence = {
+			Name = "Wooden Fence",
+			Size = Vector3.new(10, 4, 1),
+			Cost = {
+				WoodVolume = 8,
+				SpecificMaterial = "Stripped",
+			},
+		},
+		WoodBridge = {
+			Name = "Wooden Bridge",
+			Size = Vector3.new(6, 1, 16),
+			Cost = {
+				WoodVolume = 40,
+				SpecificMaterial = "Plank",
+			},
+		},
+		StonePillar = {
+			Name = "Stone Pillar",
+			Size = Vector3.new(3, 12, 3),
+			Cost = {
+				WoodVolume = 5, -- Mortar binding
+				SpecificMaterial = "Raw",
+			},
+		},
+		WoodShelter = {
+			Name = "Rain Shelter",
+			Size = Vector3.new(14, 8, 14),
+			Cost = {
+				WoodVolume = 50,
+				SpecificMaterial = "Plank",
+			},
+		},
+	},
+
+	-- Structure type cycle order for BuildController
+	StructureOrder = {
+		"WoodWall", "WoodFloor", "WoodRoof", "WoodDoor",
+		"WoodStairs", "WoodWindow", "WoodFence", "WoodBridge",
+		"StonePillar", "WoodShelter",
+	},
+}
+
+return BuildingConfig

src/ReplicatedStorage/Shared/ChoppingConfig.lua

@@ -0,0 +1,115 @@
+-- src/ReplicatedStorage/Shared/ChoppingConfig.lua
+local ChoppingConfig = {
+	-- Tree configuration
+	TreeTypes = {
+		Oak = {
+			HealthPerSegment = 100,
+			LogColor = Color3.fromRGB(133, 94, 66),
+			Density = 0.7,
+			ValueMult = 1.0,
+		},
+		Pine = {
+			HealthPerSegment = 80,
+			LogColor = Color3.fromRGB(158, 127, 98),
+			Density = 0.5,
+			ValueMult = 0.8,
+		},
+		Birch = {
+			HealthPerSegment = 60,
+			LogColor = Color3.fromRGB(220, 215, 200),
+			Density = 0.4,
+			ValueMult = 1.2,
+		},
+		Walnut = {
+			HealthPerSegment = 120,
+			LogColor = Color3.fromRGB(80, 50, 30),
+			Density = 0.8,
+			ValueMult = 1.8,
+		},
+		Mahogany = {
+			HealthPerSegment = 150,
+			LogColor = Color3.fromRGB(100, 40, 20),
+			Density = 0.9,
+			ValueMult = 2.5,
+		},
+		Elm = {
+			HealthPerSegment = 90,
+			LogColor = Color3.fromRGB(110, 80, 55),
+			Density = 0.6,
+			ValueMult = 1.0,
+		},
+		Redwood = {
+			HealthPerSegment = 200,
+			LogColor = Color3.fromRGB(120, 50, 30),
+			Density = 1.0,
+			ValueMult = 3.0,
+		},
+		GlowWood = {
+			HealthPerSegment = 70,
+			LogColor = Color3.fromRGB(60, 180, 80),
+			Density = 0.3,
+			ValueMult = 4.0,
+		},
+		LavaWood = {
+			HealthPerSegment = 130,
+			LogColor = Color3.fromRGB(50, 30, 20),
+			Density = 1.2,
+			ValueMult = 5.0,
+		},
+		-- Mutation types
+		Fireproof = {
+			HealthPerSegment = 180,
+			LogColor = Color3.fromRGB(255, 100, 0),
+			Density = 1.1,
+			ValueMult = 6.0,
+		},
+		Glowing = {
+			HealthPerSegment = 90,
+			LogColor = Color3.fromRGB(0, 255, 100),
+			Density = 0.5,
+			ValueMult = 7.0,
+		},
+		Frozen = {
+			HealthPerSegment = 50,
+			LogColor = Color3.fromRGB(150, 200, 255),
+			Density = 0.9,
+			ValueMult = 4.5,
+		},
+		Crystalline = {
+			HealthPerSegment = 250,
+			LogColor = Color3.fromRGB(200, 160, 255),
+			Density = 1.5,
+			ValueMult = 10.0,
+		},
+	},
+
+	-- Axe configuration
+	AxeTypes = {
+		BasicAxe = {
+			Damage = 25,
+			SwingCooldown = 0.8,
+			Range = 6,
+		},
+		SteelAxe = {
+			Damage = 50,
+			SwingCooldown = 0.6,
+			Range = 7,
+		},
+		GoldAxe = {
+			Damage = 80,
+			SwingCooldown = 0.5,
+			Range = 8,
+		},
+		DiamondAxe = {
+			Damage = 120,
+			SwingCooldown = 0.4,
+			Range = 9,
+		},
+	},
+
+	-- General Physics logic limits
+	MinSegmentSizeY = 1.5,
+	MaxSegmentSizeY = 8,
+}
+
+return ChoppingConfig

src/ReplicatedStorage/Shared/Constants.lua

@@ -0,0 +1,63 @@
+-- src/ReplicatedStorage/Shared/Constants.lua
+
+local Constants = {}
+
+-- CollectionService Tags
+Constants.Tags = {
+	TreeSegment = "TreeSegment",
+	TreeModel = "TreeModel",
+	Draggable = "Draggable",
+	Blueprint = "Blueprint",
+	ConstructedPart = "ConstructedPart",
+	EmptyPlot = "EmptyPlot",
+	ClaimedPlot = "ClaimedPlot",
+	MarketDropoff = "MarketDropoff",
+	ShopCounter = "ShopCounter",
+	BoxedItem = "BoxedItem",
+	ProcessingMachine = "ProcessingMachine",
+	Vehicle = "Vehicle",
+	DronePad = "DronePad",
+	HazardZone = "HazardZone",
+	SwampZone = "SwampZone",
+	WeightSwitch = "WeightSwitch",
+	LogicSource = "LogicSource",
+	SwampTires = "SwampTires",
+	NPC = "NPC",
+	BiomeZone = "BiomeZone",
+	WorldBoundary = "WorldBoundary",
+	SpawnPlatform = "SpawnPlatform",
+}
+
+-- Attributes
+Constants.Attributes = {
+	TreeType = "TreeType",
+	Health = "Health",
+	ProcessState = "ProcessState",
+	OwnerId = "OwnerId",
+	ItemId = "ItemId",
+	FillLevel = "FillLevel",
+	WoodFilled = "WoodFilled",
+	WoodRequired = "WoodRequired",
+	StructureType = "StructureType",
+	MaterialRequired = "MaterialRequired",
+	MachineType = "MachineType",
+	DegradedMult = "DegradedMult",
+	Mutated = "Mutated",
+	HazardType = "HazardType",
+	ComponentType = "ComponentType",
+	SourceType = "SourceType",
+	TargetFunction = "TargetFunction",
+	ConveyorSpeed = "ConveyorSpeed",
+	Purchased = "Purchased",
+	EquippedAxe = "EquippedAxe",
+	BiomeName = "BiomeName",
+}
+
+-- Process States
+Constants.ProcessStates = {
+	Raw = "Raw",
+	Stripped = "Stripped",
+	Plank = "Plank",
+}
+
+return Constants

src/ReplicatedStorage/Shared/CraftingConfig.lua

@@ -0,0 +1,74 @@
+-- src/ReplicatedStorage/Shared/CraftingConfig.lua
+
+local CraftingConfig = {
+	-- Punch (fist) stats
+	Fist = {
+		Damage = 5,
+		SwingCooldown = 1.2,
+		Range = 5,
+	},
+
+	-- Resources dropped per chop hit
+	WoodDropChance = 0.6,  -- 60% chance to drop resource per hit
+	WoodDropAmount = {1, 3}, -- random amount per drop
+
+	-- Crafting recipes
+	Recipes = {
+		BasicAxe = {
+			Name = "Basic Axe",
+			Materials = {
+				Wood = 10,
+			},
+			CraftTime = 2,
+		},
+		SteelAxe = {
+			Name = "Steel Axe",
+			Materials = {
+				Wood = 30,
+				Stone = 5,
+			},
+			CraftTime = 4,
+		},
+		GoldAxe = {
+			Name = "Gold Axe",
+			Materials = {
+				Wood = 50,
+				Stone = 15,
+				GoldOre = 10,
+			},
+			CraftTime = 6,
+		},
+		DiamondAxe = {
+			Name = "Diamond Axe",
+			Materials = {
+				Wood = 80,
+				Stone = 30,
+				GoldOre = 20,
+				Diamond = 5,
+			},
+			CraftTime = 10,
+		},
+	},
+
+	-- Resource types and how they are gathered
+	Resources = {
+		Wood = {
+			Source = "TreeSegment",
+			Color = Color3.fromRGB(160, 120, 80),
+		},
+		Stone = {
+			Source = "Rock",
+			Color = Color3.fromRGB(140, 140, 140),
+		},
+		GoldOre = {
+			Source = "GoldVein",
+			Color = Color3.fromRGB(255, 200, 50),
+		},
+		Diamond = {
+			Source = "DiamondVein",
+			Color = Color3.fromRGB(100, 200, 255),
+		},
+	},
+}
+
+return CraftingConfig

src/ReplicatedStorage/Shared/DraggingConfig.lua

@@ -0,0 +1,15 @@
+-- src/ReplicatedStorage/Shared/DraggingConfig.lua
+local DraggingConfig = {
+    MaxGrabDistance = 15,       -- How far away the player can grab an object
+    HoldDistance = 6,           -- The distance at which the object is held in front of the player
+    
+    -- AlignPosition Properties
+    AlignPositionMaxForce = 20000,
+    AlignPositionResponsiveness = 15,
+    
+    -- AlignOrientation Properties
+    AlignOrientationMaxTorque = 20000,
+    AlignOrientationResponsiveness = 20,
+}
+
+return DraggingConfig

src/ReplicatedStorage/Shared/EconomyConfig.lua

@@ -0,0 +1,40 @@
+-- src/ReplicatedStorage/Shared/EconomyConfig.lua
+
+local EconomyConfig = {
+	-- Base values per unit (Stud^3 roughly) of raw wood
+	WoodBaseValues = {
+		Oak = 15,
+		Pine = 10,
+		Birch = 18,
+		Walnut = 25,
+		Mahogany = 35,
+		Elm = 12,
+		Redwood = 45,
+		GlowWood = 60,
+		LavaWood = 80,
+		Fireproof = 100,
+		Glowing = 120,
+		Frozen = 70,
+		Crystalline = 200,
+	},
+
+	-- Processing multipliers
+	ProcessingMultipliers = {
+		Raw = 1.0,
+		Stripped = 1.5,
+		Plank = 2.5,
+	},
+
+	-- Market fluctuation settings
+	MarketFluctuations = {
+		Enabled = true,
+		UpdateInterval = 300,
+		MaxIncrease = 1.3,
+		MaxDecrease = 0.7,
+	},
+
+	-- Starter cash amount
+	StarterCash = 500,
+}
+
+return EconomyConfig

src/ReplicatedStorage/Shared/ExplorationConfig.lua

@@ -0,0 +1,42 @@
+-- src/ReplicatedStorage/Shared/ExplorationConfig.lua
+
+local ExplorationConfig = {
+	Puzzles = {
+		WeightSwitch = {
+			RequiredWeight = 500,
+			ActiveTime = 0,
+		},
+		LightReceptor = {
+			RequiredIntensity = 0.8,
+		},
+	},
+
+	Biomes = {
+		Swamp = {
+			SinkingSpeed = 2,
+			DamagePerSecond = 5,
+		},
+		IcePeak = {
+			SlipFriction = 0.05,
+			FreezeDamage = 2,
+		},
+		Desert = {
+			HeatDamagePerSecond = 1,
+			StaminaDrainMult = 1.5,
+		},
+		Volcanic = {
+			LavaDamagePerSecond = 20,
+			SafeDistance = 10,
+		},
+		TropicalRainforest = {
+			VisibilityRange = 100,
+			PoisonChance = 0.1,
+		},
+		Tundra = {
+			FreezeDamage = 3,
+			SlowMult = 0.7,
+		},
+	},
+}
+
+return ExplorationConfig

src/ReplicatedStorage/Shared/GameConfig.lua

@@ -0,0 +1,57 @@
+-- src/ReplicatedStorage/Shared/GameConfig.lua
+
+local GameConfig = {
+	-- Starting values
+	StarterCash = 500,
+	StarterAxe = "BasicAxe",
+
+	-- Leaderstats
+	Stats = {
+		Cash = "Cash",
+		WoodChopped = "WoodChopped",
+	},
+
+	-- World boundaries
+	WorldBounds = {
+		MinX = -1500,
+		MaxX = 1500,
+		MinZ = -1500,
+		MaxZ = 1500,
+	},
+
+	-- Spawn area
+	SpawnPosition = Vector3.new(0, 5, 0),
+	SpawnPlatformSize = Vector3.new(60, 1, 60),
+
+	-- Auto-save
+	AutoSaveInterval = 120, -- seconds
+
+	-- Max players per server
+	MaxPlayers = 12,
+
+	-- Plot spawn positions (evenly spaced)
+	PlotPositions = {
+		Vector3.new(120, 0.5, 0),
+		Vector3.new(240, 0.5, 0),
+		Vector3.new(120, 0.5, 220),
+		Vector3.new(240, 0.5, 220),
+		Vector3.new(-120, 0.5, 0),
+		Vector3.new(-240, 0.5, 0),
+		Vector3.new(-120, 0.5, 220),
+		Vector3.new(-240, 0.5, 220),
+		Vector3.new(120, 0.5, -220),
+		Vector3.new(240, 0.5, -220),
+		Vector3.new(-120, 0.5, -220),
+		Vector3.new(-240, 0.5, -220),
+	},
+
+	-- Market area
+	MarketPosition = Vector3.new(0, 0.5, -100),
+	MarketSize = Vector3.new(40, 10, 40),
+
+	-- Shop area
+	ShopPosition = Vector3.new(60, 0.5, -100),
+	ShopSize = Vector3.new(30, 12, 30),
+}
+
+return GameConfig

src/ReplicatedStorage/Shared/MutationConfig.lua

@@ -0,0 +1,40 @@
+-- src/ReplicatedStorage/Shared/MutationConfig.lua
+
+local MutationConfig = {
+	Hazards = {
+		Lava = {
+			Radius = 50,
+			MutationChance = 0.5,
+			ModifiedType = "Fireproof",
+			ValueMult = 2.5,
+			Material = Enum.Material.Neon,
+			Color = Color3.fromRGB(255, 100, 0),
+		},
+		Toxic = {
+			Radius = 60,
+			MutationChance = 0.3,
+			ModifiedType = "Glowing",
+			ValueMult = 3.0,
+			Material = Enum.Material.Neon,
+			Color = Color3.fromRGB(0, 255, 100),
+		},
+		Frozen = {
+			Radius = 45,
+			MutationChance = 0.4,
+			ModifiedType = "Frozen",
+			ValueMult = 2.0,
+			Material = Enum.Material.Ice,
+			Color = Color3.fromRGB(150, 200, 255),
+		},
+		Crystalline = {
+			Radius = 30,
+			MutationChance = 0.15,
+			ModifiedType = "Crystalline",
+			ValueMult = 5.0,
+			Material = Enum.Material.Glass,
+			Color = Color3.fromRGB(200, 160, 255),
+		},
+	},
+}
+
+return MutationConfig

src/ReplicatedStorage/Shared/NPCConfig.lua

@@ -0,0 +1,86 @@
+-- src/ReplicatedStorage/Shared/NPCConfig.lua
+
+local NPCConfig = {
+	NPCs = {
+		Lumberjack_Larry = {
+			DisplayName = "Larry the Lumberjack",
+			Position = Vector3.new(10, 3, -80),
+			BodyColors = {
+				HeadColor = Color3.fromRGB(234, 184, 146),
+				TorsoColor = Color3.fromRGB(180, 40, 40),
+				LeftArmColor = Color3.fromRGB(234, 184, 146),
+				RightArmColor = Color3.fromRGB(234, 184, 146),
+				LeftLegColor = Color3.fromRGB(50, 50, 130),
+				RightLegColor = Color3.fromRGB(50, 50, 130),
+			},
+			Dialogue = {
+				"Welcome to Timberbound Expeditions, partner!",
+				"Grab your axe and start choppin' trees!",
+				"Process logs at the sawmill for better prices.",
+				"Watch out for the rain -- it ruins unprotected wood!",
+			},
+			QuestIds = {"ChopFirstTree", "Chop10Trees"},
+			Role = "Guide",
+		},
+		Shopkeeper_Sue = {
+			DisplayName = "Sue's Supply Shop",
+			Position = Vector3.new(60, 3, -90),
+			BodyColors = {
+				HeadColor = Color3.fromRGB(234, 184, 146),
+				TorsoColor = Color3.fromRGB(50, 150, 50),
+				LeftArmColor = Color3.fromRGB(234, 184, 146),
+				RightArmColor = Color3.fromRGB(234, 184, 146),
+				LeftLegColor = Color3.fromRGB(90, 70, 50),
+				RightLegColor = Color3.fromRGB(90, 70, 50),
+			},
+			Dialogue = {
+				"Welcome to my shop! Take a look around.",
+				"I've got axes, sawmills, and more!",
+				"Drag items to the counter and talk to me to buy.",
+			},
+			QuestIds = {"BuyFirstItem"},
+			Role = "Shopkeeper",
+		},
+		Market_Mike = {
+			DisplayName = "Market Mike",
+			Position = Vector3.new(0, 3, -110),
+			BodyColors = {
+				HeadColor = Color3.fromRGB(180, 140, 100),
+				TorsoColor = Color3.fromRGB(200, 180, 50),
+				LeftArmColor = Color3.fromRGB(180, 140, 100),
+				RightArmColor = Color3.fromRGB(180, 140, 100),
+				LeftLegColor = Color3.fromRGB(40, 40, 40),
+				RightLegColor = Color3.fromRGB(40, 40, 40),
+			},
+			Dialogue = {
+				"Bring your wood here and I'll buy it!",
+				"Planks are worth more than raw logs.",
+				"Market prices shift every few minutes. Sell smart!",
+			},
+			QuestIds = {"SellFirstWood", "Earn5000"},
+			Role = "Buyer",
+		},
+		Explorer_Eva = {
+			DisplayName = "Explorer Eva",
+			Position = Vector3.new(-30, 3, -80),
+			BodyColors = {
+				HeadColor = Color3.fromRGB(210, 170, 130),
+				TorsoColor = Color3.fromRGB(100, 70, 40),
+				LeftArmColor = Color3.fromRGB(210, 170, 130),
+				RightArmColor = Color3.fromRGB(210, 170, 130),
+				LeftLegColor = Color3.fromRGB(60, 80, 50),
+				RightLegColor = Color3.fromRGB(60, 80, 50),
+			},
+			Dialogue = {
+				"This world is full of secrets!",
+				"Different biomes have different tree types.",
+				"Some rare woods glow in the dark... and they're worth a fortune!",
+				"Have you found the volcanic region yet?",
+			},
+			QuestIds = {"ExploreAllBiomes"},
+			Role = "Explorer",
+		},
+	},
+}
+
+return NPCConfig

src/ReplicatedStorage/Shared/PlotConfig.lua

@@ -0,0 +1,10 @@
+-- src/ReplicatedStorage/Shared/PlotConfig.lua
+local PlotConfig = {
+    GridSize = 2, -- Grid snapping increment in studs
+    MaxItemsPerPlot = 1000, -- Limit for performance
+    
+    -- Dimensions of the claimable land
+    PlotDimensions = Vector3.new(200, 1, 200),
+}
+
+return PlotConfig

src/ReplicatedStorage/Shared/QuestConfig.lua

@@ -0,0 +1,107 @@
+-- src/ReplicatedStorage/Shared/QuestConfig.lua
+
+local QuestConfig = {
+	Quests = {
+		ChopFirstTree = {
+			Title = "First Timber",
+			Description = "Chop down your first tree segment.",
+			Type = "Chop",
+			Target = 1,
+			Reward = {Cash = 100},
+			Icon = "rbxassetid://0", -- placeholder
+		},
+		Chop10Trees = {
+			Title = "Getting Started",
+			Description = "Chop 10 tree segments.",
+			Type = "Chop",
+			Target = 10,
+			Reward = {Cash = 500},
+			Icon = "rbxassetid://0",
+		},
+		Chop50Trees = {
+			Title = "Lumberjack",
+			Description = "Chop 50 tree segments.",
+			Type = "Chop",
+			Target = 50,
+			Reward = {Cash = 2500},
+			Icon = "rbxassetid://0",
+		},
+		Chop200Trees = {
+			Title = "Master Forester",
+			Description = "Chop 200 tree segments.",
+			Type = "Chop",
+			Target = 200,
+			Reward = {Cash = 10000},
+			Icon = "rbxassetid://0",
+		},
+		SellFirstWood = {
+			Title = "First Sale",
+			Description = "Sell wood at the market for the first time.",
+			Type = "Sell",
+			Target = 1,
+			Reward = {Cash = 200},
+			Icon = "rbxassetid://0",
+		},
+		Earn5000 = {
+			Title = "Money Maker",
+			Description = "Earn a total of $5,000 from selling wood.",
+			Type = "EarnCash",
+			Target = 5000,
+			Reward = {Cash = 1000},
+			Icon = "rbxassetid://0",
+		},
+		Earn50000 = {
+			Title = "Timber Tycoon",
+			Description = "Earn a total of $50,000.",
+			Type = "EarnCash",
+			Target = 50000,
+			Reward = {Cash = 10000},
+			Icon = "rbxassetid://0",
+		},
+		BuildFirstStructure = {
+			Title = "Builder",
+			Description = "Construct your first building.",
+			Type = "Build",
+			Target = 1,
+			Reward = {Cash = 300},
+			Icon = "rbxassetid://0",
+		},
+		Build10Structures = {
+			Title = "Architect",
+			Description = "Construct 10 buildings.",
+			Type = "Build",
+			Target = 10,
+			Reward = {Cash = 3000},
+			Icon = "rbxassetid://0",
+		},
+		ExploreAllBiomes = {
+			Title = "Explorer",
+			Description = "Visit every biome in the world.",
+			Type = "Explore",
+			Target = 8, -- number of biomes
+			Reward = {Cash = 5000},
+			Icon = "rbxassetid://0",
+		},
+		ProcessFirstPlank = {
+			Title = "Mill Worker",
+			Description = "Process a log into a plank at the sawmill.",
+			Type = "Process",
+			Target = 1,
+			Reward = {Cash = 150},
+			Icon = "rbxassetid://0",
+		},
+		BuyFirstItem = {
+			Title = "First Purchase",
+			Description = "Buy an item from the shop.",
+			Type = "Purchase",
+			Target = 1,
+			Reward = {Cash = 100},
+			Icon = "rbxassetid://0",
+		},
+	},
+
+	-- Quest ordering (which quests unlock first)
+	StarterQuests = {"ChopFirstTree", "SellFirstWood", "BuildFirstStructure", "BuyFirstItem"},
+}
+
+return QuestConfig

src/ReplicatedStorage/Shared/ShopConfig.lua

@@ -0,0 +1,112 @@
+-- src/ReplicatedStorage/Shared/ShopConfig.lua
+
+local ShopConfig = {
+	Items = {
+		BasicAxe = {
+			Price = 0, -- Free starter tool
+			Name = "Basic Axe",
+			Type = "Tool",
+			Description = "A simple axe for chopping trees.",
+		},
+		SteelAxe = {
+			Price = 1200,
+			Name = "Steel Axe",
+			Type = "Tool",
+			Description = "Stronger than basic. Faster swings.",
+		},
+		GoldAxe = {
+			Price = 5000,
+			Name = "Gold Axe",
+			Type = "Tool",
+			Description = "High damage with quick recovery.",
+		},
+		DiamondAxe = {
+			Price = 25000,
+			Name = "Diamond Axe",
+			Type = "Tool",
+			Description = "The ultimate axe. Cuts anything fast.",
+		},
+		BarkStripper = {
+			Price = 800,
+			Name = "Bark Stripper Machine",
+			Type = "Machine",
+			Description = "Strips bark from raw logs.",
+		},
+		Sawmill = {
+			Price = 3500,
+			Name = "Basic Sawmill",
+			Type = "Machine",
+			Description = "Converts logs into valuable planks.",
+		},
+		AdvancedSawmill = {
+			Price = 15000,
+			Name = "Advanced Sawmill",
+			Type = "Machine",
+			Description = "Processes logs faster and cleaner.",
+		},
+		Conveyor = {
+			Price = 500,
+			Name = "Conveyor Belt",
+			Type = "Machine",
+			Description = "Moves items automatically.",
+		},
+		Flatbed = {
+			Price = 8000,
+			Name = "Flatbed Truck",
+			Type = "Vehicle",
+			Description = "Transport large loads of lumber.",
+		},
+		BasicDrone = {
+			Price = 12000,
+			Name = "Basic Delivery Drone",
+			Type = "Automation",
+			Description = "Automatically carries small loads.",
+		},
+		AdvancedDrone = {
+			Price = 35000,
+			Name = "Advanced Delivery Drone",
+			Type = "Automation",
+			Description = "Carries heavy loads at high speed.",
+		},
+		WoodShelter = {
+			Price = 2000,
+			Name = "Rain Shelter Kit",
+			Type = "Structure",
+			Description = "Protects wood from rain degradation.",
+		},
+		WireKit = {
+			Price = 300,
+			Name = "Wire Kit",
+			Type = "Utility",
+			Description = "Connect components with wires.",
+		},
+		Button = {
+			Price = 200,
+			Name = "Logic Button",
+			Type = "Component",
+			Description = "Wire source: sends pulse signal.",
+		},
+		Lever = {
+			Price = 250,
+			Name = "Logic Lever",
+			Type = "Component",
+			Description = "Wire source: toggles on/off.",
+		},
+	},
+
+	-- Category ordering for ship GUI
+	Categories = {"Tool", "Machine", "Vehicle", "Automation", "Structure", "Utility", "Component"},
+
+	-- Items per category (for display ordering)
+	CategoryItems = {
+		Tool = {"BasicAxe", "SteelAxe", "GoldAxe", "DiamondAxe"},
+		Machine = {"BarkStripper", "Sawmill", "AdvancedSawmill", "Conveyor"},
+		Vehicle = {"Flatbed"},
+		Automation = {"BasicDrone", "AdvancedDrone"},
+		Structure = {"WoodShelter"},
+		Utility = {"WireKit"},
+		Component = {"Button", "Lever"},
+	},
+}
+
+return ShopConfig

src/ReplicatedStorage/Shared/SoundConfig.lua

@@ -0,0 +1,39 @@
+-- src/ReplicatedStorage/Shared/SoundConfig.lua
+-- Sound asset IDs (using Roblox default content where available)
+
+local SoundConfig = {
+	-- Tool Sounds
+	AxeSwing = "rbxasset://sounds/snap.mp3",
+	AxeHitWood = "rbxasset://sounds/impact_wood.mp3",
+	TreeFall = "rbxasset://sounds/bass.mp3",
+
+	-- Economy
+	CashRegister = "rbxasset://sounds/electronicpingshort.wav",
+	PurchaseSuccess = "rbxasset://sounds/electronicpingshort.wav",
+	PurchaseFail = "rbxasset://sounds/bass.mp3",
+
+	-- Building
+	PlaceBlueprint = "rbxasset://sounds/snap.mp3",
+	ConstructComplete = "rbxasset://sounds/electronicpingshort.wav",
+
+	-- UI
+	ButtonClick = "rbxasset://sounds/snap.mp3",
+	QuestComplete = "rbxasset://sounds/electronicpingshort.wav",
+	Notification = "rbxasset://sounds/electronicpingshort.wav",
+
+	-- Weather ambient
+	RainLoop = "rbxasset://sounds/bass.mp3",
+	WindLoop = "rbxasset://sounds/snap.mp3",
+
+	-- General ambient
+	ForestAmbient = "rbxasset://sounds/snap.mp3",
+	SwampAmbient = "rbxasset://sounds/bass.mp3",
+
+	-- Volume levels
+	MasterVolume = 0.8,
+	SFXVolume = 1.0,
+	MusicVolume = 0.5,
+	AmbientVolume = 0.3,
+}
+
+return SoundConfig

src/ReplicatedStorage/Shared/TreeModelConfig.lua

@@ -0,0 +1,119 @@
+-- src/ReplicatedStorage/Shared/TreeModelConfig.lua
+
+local TreeModelConfig = {
+	Templates = {
+		Oak = {
+			TrunkDiameter = {2.5, 3.5},   -- min, max
+			TrunkHeight = {12, 20},
+			SegmentCount = {3, 5},
+			CanopyRadius = {6, 10},
+			CanopySegments = 5,
+			LeafColor = Color3.fromRGB(50, 120, 40),
+			LeafMaterial = Enum.Material.LeafyGrass,
+			BarkColor = Color3.fromRGB(133, 94, 66),
+			BarkMaterial = Enum.Material.Wood,
+			HasLeaves = true,
+		},
+		Pine = {
+			TrunkDiameter = {1.5, 2.5},
+			TrunkHeight = {15, 25},
+			SegmentCount = {4, 6},
+			CanopyRadius = {3, 5},
+			CanopySegments = 6,
+			LeafColor = Color3.fromRGB(30, 80, 30),
+			LeafMaterial = Enum.Material.LeafyGrass,
+			BarkColor = Color3.fromRGB(158, 127, 98),
+			BarkMaterial = Enum.Material.Wood,
+			HasLeaves = true,
+			ConicalCanopy = true,
+		},
+		Birch = {
+			TrunkDiameter = {1.5, 2.0},
+			TrunkHeight = {14, 22},
+			SegmentCount = {4, 6},
+			CanopyRadius = {4, 7},
+			CanopySegments = 4,
+			LeafColor = Color3.fromRGB(100, 170, 60),
+			LeafMaterial = Enum.Material.LeafyGrass,
+			BarkColor = Color3.fromRGB(220, 215, 200),
+			BarkMaterial = Enum.Material.Marble,
+			HasLeaves = true,
+		},
+		Walnut = {
+			TrunkDiameter = {2.0, 3.0},
+			TrunkHeight = {10, 16},
+			SegmentCount = {3, 4},
+			CanopyRadius = {5, 8},
+			CanopySegments = 5,
+			LeafColor = Color3.fromRGB(60, 100, 30),
+			LeafMaterial = Enum.Material.LeafyGrass,
+			BarkColor = Color3.fromRGB(80, 50, 30),
+			BarkMaterial = Enum.Material.Wood,
+			HasLeaves = true,
+		},
+		Mahogany = {
+			TrunkDiameter = {3.0, 4.5},
+			TrunkHeight = {18, 28},
+			SegmentCount = {5, 7},
+			CanopyRadius = {8, 12},
+			CanopySegments = 6,
+			LeafColor = Color3.fromRGB(40, 90, 25),
+			LeafMaterial = Enum.Material.LeafyGrass,
+			BarkColor = Color3.fromRGB(100, 40, 20),
+			BarkMaterial = Enum.Material.Wood,
+			HasLeaves = true,
+		},
+		Elm = {
+			TrunkDiameter = {2.0, 3.0},
+			TrunkHeight = {12, 18},
+			SegmentCount = {3, 5},
+			CanopyRadius = {5, 9},
+			CanopySegments = 5,
+			LeafColor = Color3.fromRGB(80, 140, 50),
+			LeafMaterial = Enum.Material.LeafyGrass,
+			BarkColor = Color3.fromRGB(110, 80, 55),
+			BarkMaterial = Enum.Material.Wood,
+			HasLeaves = true,
+		},
+		Redwood = {
+			TrunkDiameter = {4.0, 6.0},
+			TrunkHeight = {30, 50},
+			SegmentCount = {6, 10},
+			CanopyRadius = {6, 10},
+			CanopySegments = 4,
+			LeafColor = Color3.fromRGB(35, 70, 30),
+			LeafMaterial = Enum.Material.LeafyGrass,
+			BarkColor = Color3.fromRGB(120, 50, 30),
+			BarkMaterial = Enum.Material.Wood,
+			HasLeaves = true,
+		},
+		GlowWood = {
+			TrunkDiameter = {1.5, 2.5},
+			TrunkHeight = {8, 14},
+			SegmentCount = {3, 4},
+			CanopyRadius = {4, 6},
+			CanopySegments = 4,
+			LeafColor = Color3.fromRGB(0, 255, 100),
+			LeafMaterial = Enum.Material.Neon,
+			BarkColor = Color3.fromRGB(60, 180, 80),
+			BarkMaterial = Enum.Material.SmoothPlastic,
+			HasLeaves = true,
+			GlowTrunk = true,
+		},
+		LavaWood = {
+			TrunkDiameter = {2.0, 3.5},
+			TrunkHeight = {8, 14},
+			SegmentCount = {3, 4},
+			CanopyRadius = {3, 5},
+			CanopySegments = 3,
+			LeafColor = Color3.fromRGB(255, 120, 0),
+			LeafMaterial = Enum.Material.Neon,
+			BarkColor = Color3.fromRGB(50, 30, 20),
+			BarkMaterial = Enum.Material.CrackedLava,
+			HasLeaves = true,
+			GlowTrunk = true,
+		},
+	},
+}
+
+return TreeModelConfig

src/ReplicatedStorage/Shared/Utility.lua

@@ -0,0 +1,85 @@
+-- src/ReplicatedStorage/Shared/Utility.lua
+
+local Utility = {}
+
+function Utility.formatCash(amount)
+	if amount >= 1000000 then
+		return string.format("$%.1fM", amount / 1000000)
+	elseif amount >= 1000 then
+		return string.format("$%.1fK", amount / 1000)
+	else
+		return "$" .. tostring(math.floor(amount))
+	end
+end
+
+function Utility.formatTime(seconds)
+	local min = math.floor(seconds / 60)
+	local sec = math.floor(seconds % 60)
+	return string.format("%d:%02d", min, sec)
+end
+
+function Utility.lerp(a, b, t)
+	return a + (b - a) * t
+end
+
+function Utility.getPartVolume(part)
+	if not part or not part:IsA("BasePart") then return 0 end
+	return part.Size.X * part.Size.Y * part.Size.Z
+end
+
+function Utility.randomInRange(min, max)
+	return min + math.random() * (max - min)
+end
+
+function Utility.randomIntInRange(min, max)
+	return math.random(min, max)
+end
+
+function Utility.clampVector3(vec, minBounds, maxBounds)
+	return Vector3.new(
+		math.clamp(vec.X, minBounds.X, maxBounds.X),
+		math.clamp(vec.Y, minBounds.Y, maxBounds.Y),
+		math.clamp(vec.Z, minBounds.Z, maxBounds.Z)
+	)
+end
+
+function Utility.shuffleTable(tbl)
+	local shuffled = {}
+	for _, v in ipairs(tbl) do
+		table.insert(shuffled, v)
+	end
+	for i = #shuffled, 2, -1 do
+		local j = math.random(1, i)
+		shuffled[i], shuffled[j] = shuffled[j], shuffled[i]
+	end
+	return shuffled
+end
+
+function Utility.tableContains(tbl, value)
+	for _, v in ipairs(tbl) do
+		if v == value then return true end
+	end
+	return false
+end
+
+function Utility.tableKeys(tbl)
+	local keys = {}
+	for k, _ in pairs(tbl) do
+		table.insert(keys, k)
+	end
+	return keys
+end
+
+function Utility.deepCopy(original)
+	local copy = {}
+	for k, v in pairs(original) do
+		if type(v) == "table" then
+			copy[k] = Utility.deepCopy(v)
+		else
+			copy[k] = v
+		end
+	end
+	return copy
+end
+
+return Utility

src/ReplicatedStorage/Shared/VehicleConfig.lua

@@ -0,0 +1,14 @@
+-- src/ReplicatedStorage/Shared/VehicleConfig.lua
+local VehicleConfig = {
+    -- Physical properties for the truck bed to prevent logs from sliding off easily while driving
+    -- Density, Friction, Elasticity, FrictionWeight, ElasticityWeight
+    -- Extremely high Friction and FrictionWeight to lock the logs to the bed
+    FlatbedPhysicalProperties = PhysicalProperties.new(1.0, 2.0, 0, 100, 100),
+    
+    CollisionGroups = {
+        Logs = "Logs",
+        Vehicles = "Vehicles",
+    }
+}
+
+return VehicleConfig

src/ReplicatedStorage/Shared/WeatherConfig.lua

@@ -0,0 +1,17 @@
+-- src/ReplicatedStorage/Shared/WeatherConfig.lua
+
+local WeatherConfig = {
+    CycleDurationMin = 300, -- 5 mins of clear weather
+    CycleDurationMax = 600, -- 10 mins
+    
+    RainDurationMin = 60, -- 1 minute of rain
+    RainDurationMax = 180, -- 3 minutes of rain
+    
+    DegradationConfig = {
+        WoodValueLossPerTick = 0.05, -- 5% loss per tick
+        TickInterval = 3, -- Every 3 seconds in rain
+        MaxValueLoss = 0.5, -- Logs won't lose more than 50% of value
+    }
+}
+
+return WeatherConfig

src/ReplicatedStorage/Shared/WireLogicConfig.lua

@@ -0,0 +1,14 @@
+-- src/ReplicatedStorage/Shared/WireLogicConfig.lua
+
+local WireLogicConfig = {
+    MaxWireLength = 50, -- Maximum distance between two connected nodes
+    
+    -- Defining the kinds of components available
+    ComponentTypes = {
+        Source = {"Button", "Lever", "PressurePlate"},
+        Logic = {"AND", "OR", "NOT", "Delay", "Timer"},
+        Target = {"Door", "Sawmill", "Conveyor", "Light"}
+    }
+}
+
+return WireLogicConfig

src/ServerScriptService/AchievementManager.server.lua

@@ -0,0 +1,82 @@
+-- src/ServerScriptService/AchievementManager.server.lua
+
+local Players = game:GetService("Players")
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+
+local NotificationEvent = ReplicatedStorage:WaitForChild("Events"):WaitForChild("NotificationEvent")
+
+-- Achievement definitions
+local Achievements = {
+	{id = "first_chop", title = "First Swing", description = "Chop your first tree segment", stat = "WoodChopped", target = 1},
+	{id = "chop_100", title = "Century Cutter", description = "Chop 100 tree segments", stat = "WoodChopped", target = 100},
+	{id = "chop_500", title = "Lumber Legend", description = "Chop 500 tree segments", stat = "WoodChopped", target = 500},
+	{id = "chop_1000", title = "Timber Titan", description = "Chop 1000 tree segments", stat = "WoodChopped", target = 1000},
+	{id = "earn_1000", title = "First Thousand", description = "Earn $1,000 total", stat = "TotalEarned", target = 1000},
+	{id = "earn_10000", title = "Money Bags", description = "Earn $10,000 total", stat = "TotalEarned", target = 10000},
+	{id = "earn_100000", title = "Timber Mogul", description = "Earn $100,000 total", stat = "TotalEarned", target = 100000},
+	{id = "build_1", title = "First Foundation", description = "Build your first structure", stat = "TotalBuilt", target = 1},
+	{id = "build_25", title = "Master Builder", description = "Build 25 structures", stat = "TotalBuilt", target = 25},
+}
+
+-- Track awarded achievements per player
+local playerAchievements = {} -- [userId] = {achievementId = true, ...}
+
+local function checkAchievements(player)
+	local data = _G.GetPlayerData(player)
+	if not data then return end
+
+	if not playerAchievements[player.UserId] then
+		playerAchievements[player.UserId] = {}
+	end
+
+	local leaderstats = player:FindFirstChild("leaderstats")
+
+	for _, achievement in ipairs(Achievements) do
+		if playerAchievements[player.UserId][achievement.id] then continue end
+
+		local currentValue = 0
+
+		-- Check leaderstats
+		if leaderstats then
+			local stat = leaderstats:FindFirstChild(achievement.stat)
+			if stat then
+				currentValue = stat.Value
+			end
+		end
+
+		-- Check player data
+		if data[achievement.stat] then
+			currentValue = data[achievement.stat]
+		end
+
+		if currentValue >= achievement.target then
+			playerAchievements[player.UserId][achievement.id] = true
+			NotificationEvent:FireClient(player, "Achievement", achievement.title .. " - " .. achievement.description)
+		end
+	end
+end
+
+-- Expose for other managers
+_G.CheckAchievements = function(player)
+	checkAchievements(player)
+end
+
+_G.GetPlayerAchievements = function(player)
+	return playerAchievements[player.UserId] or {}
+end
+
+-- Periodic check
+task.spawn(function()
+	while true do
+		task.wait(10)
+		for _, player in ipairs(Players:GetPlayers()) do
+			pcall(function()
+				checkAchievements(player)
+			end)
+		end
+	end
+end)
+
+Players.PlayerRemoving:Connect(function(player)
+	playerAchievements[player.UserId] = nil
+end)

src/ServerScriptService/AntiCheatManager.server.lua

@@ -0,0 +1,73 @@
+-- src/ServerScriptService/AntiCheatManager.server.lua
+
+local Players = game:GetService("Players")
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+
+-- Rate limiting tracker
+local rateLimits = {} -- [userId] = { [eventName] = { count, lastReset } }
+
+local MAX_EVENTS_PER_SECOND = 10
+local RATE_WINDOW = 1 -- seconds
+
+local function getRateData(player, eventName)
+	if not rateLimits[player.UserId] then
+		rateLimits[player.UserId] = {}
+	end
+	if not rateLimits[player.UserId][eventName] then
+		rateLimits[player.UserId][eventName] = {
+			count = 0,
+			lastReset = tick(),
+		}
+	end
+	return rateLimits[player.UserId][eventName]
+end
+
+-- Check if a player is rate limited
+_G.IsRateLimited = function(player, eventName)
+	local data = getRateData(player, eventName)
+	local now = tick()
+
+	if now - data.lastReset > RATE_WINDOW then
+		data.count = 0
+		data.lastReset = now
+	end
+
+	data.count = data.count + 1
+
+	if data.count > MAX_EVENTS_PER_SECOND then
+		warn("Rate limit exceeded for " .. player.Name .. " on event " .. eventName)
+		return true
+	end
+
+	return false
+end
+
+-- Validate distance between player and target
+_G.ValidateDistance = function(player, targetPosition, maxDistance)
+	local character = player.Character
+	if not character then return false end
+
+	local rootPart = character:FindFirstChild("HumanoidRootPart")
+	if not rootPart then return false end
+
+	local distance = (rootPart.Position - targetPosition).Magnitude
+	return distance <= maxDistance
+end
+
+-- Validate player has enough cash
+_G.ValidateCash = function(player, amount)
+	local leaderstats = player:FindFirstChild("leaderstats")
+	if not leaderstats then return false end
+
+	local cash = leaderstats:FindFirstChild("Cash")
+	if not cash then return false end
+
+	return cash.Value >= amount
+end
+
+-- Cleanup on player leave
+Players.PlayerRemoving:Connect(function(player)
+	rateLimits[player.UserId] = nil
+end)
+
+print("Anti-Cheat Manager initialized")

src/ServerScriptService/BiomeGeneratorManager.server.lua

@@ -0,0 +1,195 @@
+-- src/ServerScriptService/BiomeGeneratorManager.server.lua
+-- Simple flat baseplate-style world with colored biome regions
+
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+local CollectionService = game:GetService("CollectionService")
+
+local BiomeConfig = require(ReplicatedStorage:WaitForChild("Shared"):WaitForChild("BiomeConfig"))
+local GameConfig = require(ReplicatedStorage:WaitForChild("Shared"):WaitForChild("GameConfig"))
+
+-- Create folders
+local biomeZonesFolder = Instance.new("Folder")
+biomeZonesFolder.Name = "BiomeZones"
+biomeZonesFolder.Parent = workspace
+
+local worldFolder = Instance.new("Folder")
+worldFolder.Name = "WorldStructures"
+worldFolder.Parent = workspace
+
+-- Biome color map (distinct flat colors, no grass)
+local BiomeColors = {
+	Forest = Color3.fromRGB(80, 130, 60),
+	PineWoods = Color3.fromRGB(50, 100, 45),
+	Swamp = Color3.fromRGB(65, 85, 50),
+	Desert = Color3.fromRGB(210, 190, 130),
+	Volcanic = Color3.fromRGB(70, 40, 35),
+	IcePeak = Color3.fromRGB(190, 210, 230),
+	TropicalRainforest = Color3.fromRGB(35, 110, 40),
+	Meadow = Color3.fromRGB(140, 180, 80),
+}
+
+local function createBiomePlate(biomeName, biomeData)
+	local region = biomeData.Region
+	local regionWidth = region.MaxX - region.MinX
+	local regionDepth = region.MaxZ - region.MinZ
+	local centerX = (region.MinX + region.MaxX) / 2
+	local centerZ = (region.MinZ + region.MaxZ) / 2
+
+	-- Flat baseplate for this biome
+	local plate = Instance.new("Part")
+	plate.Name = biomeName .. "_Plate"
+	plate.Size = Vector3.new(regionWidth, 1, regionDepth)
+	plate.Position = Vector3.new(centerX, -0.5, centerZ) -- Top surface at Y=0
+	plate.Anchored = true
+	plate.Material = Enum.Material.SmoothPlastic
+	plate.Color = BiomeColors[biomeName] or Color3.fromRGB(100, 100, 100)
+	plate.TopSurface = Enum.SurfaceType.Smooth
+	plate.BottomSurface = Enum.SurfaceType.Smooth
+	plate.Parent = biomeZonesFolder
+
+	-- Invisible detection zone (taller, for biome detection)
+	local zonePart = Instance.new("Part")
+	zonePart.Name = biomeName .. "_Zone"
+	zonePart.Size = Vector3.new(regionWidth, 50, regionDepth)
+	zonePart.Position = Vector3.new(centerX, 25, centerZ)
+	zonePart.Anchored = true
+	zonePart.CanCollide = false
+	zonePart.Transparency = 1
+	zonePart:SetAttribute("BiomeName", biomeName)
+	CollectionService:AddTag(zonePart, "BiomeZone")
+	zonePart.Parent = biomeZonesFolder
+
+	-- Hazard zone if applicable
+	if biomeData.HazardType then
+		local hazardZone = Instance.new("Part")
+		hazardZone.Name = biomeName .. "_Hazard"
+		hazardZone.Size = Vector3.new(regionWidth * 0.8, 20, regionDepth * 0.8)
+		hazardZone.Position = Vector3.new(centerX, 10, centerZ)
+		hazardZone.Anchored = true
+		hazardZone.CanCollide = false
+		hazardZone.Transparency = 0.95
+		hazardZone.BrickColor = BrickColor.new("Bright red")
+
+		if biomeData.HazardAttribute then
+			hazardZone:SetAttribute("HazardType", biomeData.HazardAttribute)
+		end
+
+		CollectionService:AddTag(hazardZone, biomeData.HazardType)
+		hazardZone.Parent = biomeZonesFolder
+	end
+
+	-- Biome label sign at center
+	local signPart = Instance.new("Part")
+	signPart.Name = biomeName .. "_Sign"
+	signPart.Size = Vector3.new(8, 4, 0.5)
+	signPart.Position = Vector3.new(centerX, 4, centerZ)
+	signPart.Anchored = true
+	signPart.Material = Enum.Material.Wood
+	signPart.BrickColor = BrickColor.new("Reddish brown")
+	signPart.Parent = biomeZonesFolder
+
+	local signGui = Instance.new("SurfaceGui")
+	signGui.Face = Enum.NormalId.Front
+	signGui.Parent = signPart
+
+	local signLabel = Instance.new("TextLabel")
+	signLabel.Size = UDim2.new(1, 0, 1, 0)
+	signLabel.BackgroundTransparency = 1
+	signLabel.Text = biomeName
+	signLabel.TextColor3 = Color3.new(1, 1, 1)
+	signLabel.TextScaled = true
+	signLabel.Font = Enum.Font.GothamBold
+	signLabel.Parent = signGui
+
+	print("Biome plate created:", biomeName)
+end
+
+-- Create spawn platform (elevated slightly so it is distinct)
+local function createSpawnPlatform()
+	local platform = Instance.new("Part")
+	platform.Name = "SpawnPlatform"
+	platform.Size = Vector3.new(GameConfig.SpawnPlatformSize.X, 0.2, GameConfig.SpawnPlatformSize.Z)
+	platform.Position = Vector3.new(GameConfig.SpawnPosition.X, 0.1, GameConfig.SpawnPosition.Z) -- rests slightly above biome plate
+	platform.Anchored = true
+	platform.Material = Enum.Material.SmoothPlastic
+	platform.Color = Color3.fromRGB(160, 160, 165)
+	platform.TopSurface = Enum.SurfaceType.Smooth
+	platform.BottomSurface = Enum.SurfaceType.Smooth
+	CollectionService:AddTag(platform, "SpawnPlatform")
+	platform.Parent = worldFolder
+
+	local spawn = Instance.new("SpawnLocation")
+	spawn.Size = Vector3.new(6, 1, 6)
+	spawn.Position = Vector3.new(GameConfig.SpawnPosition.X, 0.5, GameConfig.SpawnPosition.Z)
+	spawn.Anchored = true
+	spawn.CanCollide = false
+	spawn.Transparency = 1
+	spawn.Parent = worldFolder
+end
+
+-- World boundaries
+local function createWorldBoundaries()
+	local bounds = GameConfig.WorldBounds
+	local height = 200
+	local thickness = 5
+
+	local walls = {
+		{pos = Vector3.new(0, height/2, bounds.MinZ), size = Vector3.new(bounds.MaxX - bounds.MinX, height, thickness)},
+		{pos = Vector3.new(0, height/2, bounds.MaxZ), size = Vector3.new(bounds.MaxX - bounds.MinX, height, thickness)},
+		{pos = Vector3.new(bounds.MinX, height/2, 0), size = Vector3.new(thickness, height, bounds.MaxZ - bounds.MinZ)},
+		{pos = Vector3.new(bounds.MaxX, height/2, 0), size = Vector3.new(thickness, height, bounds.MaxZ - bounds.MinZ)},
+	}
+
+	for i, wallData in ipairs(walls) do
+		local wall = Instance.new("Part")
+		wall.Name = "WorldBoundary_" .. i
+		wall.Size = wallData.size
+		wall.Position = wallData.pos
+		wall.Anchored = true
+		wall.Transparency = 1
+		wall.CanCollide = true
+		CollectionService:AddTag(wall, "WorldBoundary")
+		wall.Parent = worldFolder
+	end
+end
+
+-- Plot areas
+local function createPlots()
+	local plotsFolder = Instance.new("Folder")
+	plotsFolder.Name = "Plots"
+	plotsFolder.Parent = worldFolder
+
+	for i, pos in ipairs(GameConfig.PlotPositions) do
+		local plot = Instance.new("Part")
+		plot.Name = "Plot_" .. i
+		plot.Size = Vector3.new(200, 0.2, 200)
+		plot.Position = Vector3.new(pos.X, 0.1, pos.Z) -- elevate slightly to prevent z-fighting
+		plot.Anchored = true
+		plot.Material = Enum.Material.SmoothPlastic
+		plot.Color = Color3.fromRGB(90, 90, 95)
+		plot.TopSurface = Enum.SurfaceType.Smooth
+		plot.BottomSurface = Enum.SurfaceType.Smooth
+		plot.Transparency = 1 -- fully invisible as requested
+		CollectionService:AddTag(plot, "EmptyPlot")
+		plot.Parent = plotsFolder
+
+
+	end
+end
+
+-- Execute world generation
+task.spawn(function()
+	print("=== Timberbound Expeditions: World Generation Starting ===")
+
+	createSpawnPlatform()
+	createWorldBoundaries()
+	createPlots()
+
+	-- Create flat biome plates (no terrain, no elevation)
+	for biomeName, biomeData in pairs(BiomeConfig.Biomes) do
+		createBiomePlate(biomeName, biomeData)
+	end
+
+	print("=== World Generation Complete ===")
+	_G.BiomeGenerationComplete = true
+end)

src/ServerScriptService/ConstructionManager.server.lua

@@ -0,0 +1,88 @@
+-- src/ServerScriptService/ConstructionManager.server.lua
+
+local CollectionService = game:GetService("CollectionService")
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+local Players = game:GetService("Players")
+
+local BuildingConfig = require(ReplicatedStorage:WaitForChild("Shared"):WaitForChild("BuildingConfig"))
+local PlaceBlueprintEvent = ReplicatedStorage:WaitForChild("Events"):WaitForChild("PlaceBlueprintEvent")
+local FillBlueprintEvent = ReplicatedStorage:WaitForChild("Events"):WaitForChild("FillBlueprintEvent")
+
+local function getPartVolume(part)
+    return part.Size.X * part.Size.Y * part.Size.Z
+end
+
+-- Validate and place a blueprint
+local function onPlaceBlueprint(player, structureType, cframe)
+    local config = BuildingConfig.Structures[structureType]
+    if not config then return end
+    
+    -- In a real game, you would verify if `cframe` is inside the player's Claimed Plot
+    -- Verification skipped here for brevity
+    
+    local blueprintModel = Instance.new("Part")
+    blueprintModel.Size = Vector3.new(10, 10, 1) -- Example dimensions
+    blueprintModel.CFrame = cframe
+    
+    -- Visual Blueprint state
+    blueprintModel.Transparency = 0.5
+    blueprintModel.BrickColor = BrickColor.new("Neon blue")
+    blueprintModel.Material = Enum.Material.ForceField
+    blueprintModel.Anchored = true
+    
+    -- Attributes for tracking
+    blueprintModel:SetAttribute("StructureType", structureType)
+    blueprintModel:SetAttribute("WoodFilled", 0)
+    blueprintModel:SetAttribute("WoodRequired", config.Cost.WoodVolume)
+    blueprintModel:SetAttribute("MaterialRequired", config.Cost.SpecificMaterial)
+    blueprintModel:SetAttribute("OwnerId", player.UserId)
+    
+    CollectionService:AddTag(blueprintModel, "Blueprint")
+    
+    blueprintModel.Parent = workspace.Terrain
+    
+    -- Bind touched event so players can "throw" wood into the blueprint to fill it
+    local debounce = {}
+    blueprintModel.Touched:Connect(function(hit)
+        -- Make sure it's fully processed wood touching it
+        if CollectionService:HasTag(hit, "TreeSegment") and not debounce[hit] then
+            debounce[hit] = true
+            
+            local requiredMaterial = blueprintModel:GetAttribute("MaterialRequired")
+            local hitMaterial = hit:GetAttribute("ProcessState") or "Raw"
+            
+            if hitMaterial == requiredMaterial then
+                local volume = getPartVolume(hit)
+                
+                local currentFill = blueprintModel:GetAttribute("WoodFilled")
+                local required = blueprintModel:GetAttribute("WoodRequired")
+                
+                local newFill = currentFill + volume
+                blueprintModel:SetAttribute("WoodFilled", newFill)
+                
+                -- Visual feedback: change transparency based on fill %
+                local fillPercent = math.clamp(newFill / required, 0, 1)
+                blueprintModel.Transparency = 0.5 - (0.5 * fillPercent)
+                
+                hit:Destroy()
+                
+                if newFill >= required then
+                    -- Construct!
+                    blueprintModel.Transparency = 0
+                    blueprintModel.BrickColor = BrickColor.new("Burlap")
+                    blueprintModel.Material = Enum.Material.WoodPlanks
+                    blueprintModel.CanCollide = true
+                    
+                    CollectionService:RemoveTag(blueprintModel, "Blueprint")
+                    CollectionService:AddTag(blueprintModel, "ConstructedPart")
+                end
+            end
+            
+            task.delay(0.5, function()
+                debounce[hit] = nil
+            end)
+        end
+    end)
+end
+
+PlaceBlueprintEvent.OnServerEvent:Connect(onPlaceBlueprint)