SuperAPI AI 工具集

roblox-luau

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:在 Roblox 中编写 Luau 脚本,包括获取服务、创建与挂载实例、连接事件、判断代码运行在服务端还是客户端,以及搭建跨端通信。适用于存在 Script/LocalScript/ModuleScript、.rbxl(x) 场景或 Rojo *.project.json,且代码调用 game:GetService(...) 的项目。不适用:跨会话数据持久化(用 roblox-datastores);远程协议架构、防作弊、限流、高频复制与多客户端滥用测试(用 roblox-networking);与 Roblox API 无关的通用 Lua 问题;引擎无关的输入/存档架构。

主要能力:用 game:GetService("Name") 获取服务,常用 Players、Workspace、ReplicatedStorage、ServerScriptService、ServerStorage、RunService、UserInputService;Script 在服务端运行,LocalScript 在客户端(StarterPlayerScripts、StarterGui 或角色内)运行,ModuleScript 为可 require 的共享代码;用 Instance.new 创建实例,先设属性最后设 Parent;用 :Connect 响应 Players.PlayerAdded、part.Touched、RunService.Heartbeat 等信号,及时 :Disconnect 避免泄漏;用 RemoteEvent 做客户端请求、服务端校验并应用,服务端对所有游戏状态权威。

使用方式:在 Studio 用 Play / Play Here / 服务端+客户端 Start 测试,借助 Output 窗口与视图切换确认代码运行位置;在客户端刚加入时用 WaitForChild 取对象;用 task.wait/task.spawn/task.delay 替代已弃用的 wait/spawn/delay。

限制:不可信任客户端,RemoteEvent/RemoteFunction 的每个参数都需在服务端校验类型与范围;LocalScript 不会在 Workspace 或 ServerScriptService 运行;属性应先设、Parent 最后设;长期 :Connect 会泄漏;RemoteFunction 会阻塞等待返回,优先用单向 RemoteEvent。Luau 新类型求解器于 2025 年 11 月正式发布,仅在编辑时运行,严格模式需通过 UseNewLuauTypeSolver 开启。其余细节暂未提供。