roblox-input

使用方法

复制安装命令，在自己的智能体环境安装前先检查源码包。
从原始文档核对所需工具、凭据和支持的宿主。
说明输入材料与期望交付物，并对照来源检查输出。

npx skills add https://github.com/tabooharmony/roblox-brain --skill roblox-input

开始前需了解

安装不包含模型订阅、API 额度或访问文件的权限。
仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。

仓库原始内容

按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Roblox Input

When to Load

Touch, gamepad, keyboard, mouse or motion input, on-screen action buttons, cross-platform binding. Client-only; Server Authority simulation input uses the Input Action System.

Quick Reference

Events: InputBegan/Changed/Ended give (input, gameProcessedEvent); filter it for gameplay. Wheel fires only InputChanged.
Bindings: prefer ContextActionService:BindAction(name, handler, touchButton, ...keys); gate on state (touch is KeyCode.Unknown); stack order, so BindActionAtPriority. Server Authority: InputAction/InputContext + RunService:BindToSimulation() (needs Workspace.UseFixedSimulation).
Mobile first, hybrid aware: show controls from UserInputService.PreferredInput (Enum.PreferredInput), observed with GetPropertyChangedSignal, not from TouchEnabled cached once.
Touch action buttons: fire only for touches that began on the button; camera drags across it never fire. Place from the measured jump button under PlayerGui.TouchGui; clear the thumbstick zone.
Gate gameplay: block attacks while a game window is open, a TextBox is focused, GuiService.MenuIsOpen, or GuiService.SelectedObject is set.
Cancel is not release: holds cancel on window open, Cancel, unequip, focus loss, input switch or pad disconnect.
Gamepad tools: default controls bind ButtonR2 through BindActivate; Tool.ManualActivationOnly = true disables it. Aim from the screen center on gamepad, not GetMouseLocation().
Hints: GetStringForKeyCode(key, Enum.KeyCodeStringFormat.Abbreviated), GetImageForKeyCode, or InputActionLabel; never hardcode Xbox names.
Test: Device Simulator + Controller Emulator; menu focus is in roblox-gui.