update rules

.cursor/rules/roblox/en-us/includes/engine-comparisons/fishing-pole-code-sample.md

@@ -0,0 +1,34 @@
+---
+title: include
+---
+
+The following Luau code sample demonstrates how to, after a player equips a fishing pole, listen for user input (in this case, the <kbd>E</kbd> key) and call additional functions:
+
+```lua
+local ContextActionService = game:GetService("ContextActionService")
+local ReplicatedStorage = game:GetService("ReplicatedStorage")
+
+-- Get a module script from ReplicatedStorage that returns a single function
+local performSomeAction = require(ReplicatedStorage.performSomeAction)
+
+-- Assumes that this script is a child of the fishing pole
+local fishingPole = script.Parent
+local ACTION_CAST = "Cast"
+
+-- Check that the key is down, then call another function
+local function castLine(_actionName, inputState, _inputObject)
+	if inputState == Enum.UserInputState.Begin then
+		performSomeAction()
+	end
+end
+
+-- Only enable the action when the player equips the fishing pole
+fishingPole.Equipped:Connect(function()
+	ContextActionService:BindAction(ACTION_CAST, castLine, true, Enum.KeyCode.E)
+end)
+
+-- Disable the action when the player unequips the fishing pole
+fishingPole.Unequipped:Connect(function()
+	ContextActionService:UnbindAction(ACTION_CAST)
+end)
+```

.cursor/rules/roblox/en-us/includes/engine-comparisons/script-locations.md

@@ -0,0 +1,15 @@
+---
+title: include
+---
+
+Location | Description
+:--- | :---
+`Class.Workspace` | Represents the experience's 3D world. This location works well for server scripts that attach directly to objects and control their behavior.
+`Class.ReplicatedFirst` | Contains objects that replicate to the client before anything else. This location is ideal for the absolute minimum set of objects and client scripts necessary to display a loading screen.
+`Class.ReplicatedStorage` | Contains objects that are replicated to both the client and the server. This location is ideal for `Class.ModuleScript\|ModuleScripts` that you want to use on both the server and the client. `Class.LocalScript\|LocalScripts` do not run from this location, but `Class.Script\|Scripts` with a `Class.BaseScript.RunContext\|RunContext` of `Enum.RunContext\|Client` do.
+`Class.ServerScriptService` | Contains server scripts. This location is ideal for scripts that need to access server-side functionality or objects, such as game logic and cloud storage.
+`Class.ServerStorage` | Contains server-side objects. This location is ideal for large objects that don't need to be immediately replicated to clients when they join an experience. Scripts do not run from this location, but you can store server-side `Class.ModuleScript\|ModuleScripts` here.
+`Class.StarterPlayer` ⟩ `Class.StarterCharacterScripts` | Contains `Class.LocalScript\|LocalScripts` that run when the character spawns.
+`Class.StarterPlayer` ⟩ `Class.StarterPlayerScripts` | Contains general-purpose `Class.LocalScript\|LocalScripts` that run when the player joins the experience.
+`Class.StarterGui` | Contains GUI elements that the client displays when it loads the experience. `Class.LocalScript\|LocalScripts` can run from this location. This location is ideal for scripts that modify the experience's user interface, such as adding buttons, menus, and pop-ups.
+`Class.StarterPack` | Generally only contains `Class.Tool\|Tools`, but can also include `Class.LocalScript\|LocalScripts` for setting up player backpacks.

.cursor/rules/roblox/en-us/includes/engine-comparisons/script-types.md

@@ -0,0 +1,17 @@
+---
+title: include
+---
+
+Roblox experiences support three different types of Luau scripts:
+
+- **Client scripts**
+
+  These scripts run on the client, and the server has no visibility into their behavior. For legacy reasons, these scripts can take the form of `Class.LocalScript|LocalScripts` or `Class.Script|Scripts` with a `Class.BaseScript.RunContext|RunContext` value of `Enum.RunContext|Client`. Client scripts typically live in `Class.ReplicatedStorage`, `Class.StarterPlayerScripts`, or `Class.StarterCharacterScripts`.
+
+- **Server scripts**
+
+  These scripts run on the server, and the client has no visibility into their behavior. Server scripts have a `Class.BaseScript.RunContext|RunContext` value of `Enum.RunContext|Server` and typically live in `Class.ServerScriptService`, the contents of which are not replicated to the client.
+
+- **Module scripts**
+
+  These scripts are reusable pieces of code that return exactly one value, typically a function or table (or a table of functions). Rather than duplicating code in client and server scripts, use module scripts to share code and data between the two. Module scripts often live in `Class.ReplicatedStorage`, but can live elsewhere if you want to share code between scripts on the same side of the client-server boundary.

.cursor/rules/roblox/en-us/includes/engine-comparisons/transforms.md

@@ -0,0 +1,8 @@
+---
+title: include
+---
+
+{props.engine}'s transforms and Roblox's `Datatype.CFrame|CFrames` serve similar purposes in representing 3D transformations of objects:
+
+- Both transforms and `Datatype.CFrame|CFrames` represent the position and rotation of an object in 3D space. Transforms include scale, whereas Roblox uses a `Class.BasePart.Size` property that isn't part of the `Datatype.CFrame`.
+- Both support multiplication for complex transformations and have built-in methods for other manipulations.