roblox-core 是一个针对 Roblox 体验开发基础结构的技能,主要解决运行时职责划分、脚本放置与常见玩法脚本模式问题。
用途:当任务核心是决定逻辑应放在客户端、服务端还是两端共享,或需要判断 Script、LocalScript、ModuleScript 应位于哪个容器时使用。也适用于组织 ServerScriptService、ServerStorage、ReplicatedStorage、ReplicatedFirst、StarterPlayer、StarterGui 和 Workspace 中的代码,以及使用服务、模块复用、属性、BindableEvent 等日常脚本结构。
主要能力:
- 运行时侧划分:服务端负责权威世界状态、生成、规则执行与共享模拟;客户端负责玩家本地输入、相机、即时表现与本地反馈;共享模块仅在两端需要相同代码或常量时使用。
- 容器与脚本类型选择:ServerScriptService 放仅服务端脚本与模块;ServerStorage 放无需复制的服务端资产或模块;ReplicatedStorage 放共享模块与可复制资产;ReplicatedFirst 仅用于最早客户端启动;StarterPlayerScripts、StarterCharacterScripts、StarterGui、StarterPack 放复制到每个玩家的客户端行为。客户端代码可用 LocalScript 或 RunContext = Client 的 Script,服务端用 RunContext = Server 的 Script 或常规服务端位置。
- 代码组织:用 game:GetService() 在脚本顶部获取服务;客户端访问复制对象时使用 WaitForChild();ModuleScript 返回值在 Luau 环境中按缓存处理,每个脚本 require 一次并复用;避免循环 require;共享模块保持侧无关。
- 实例状态与本地通信:属性用于轻量的每实例状态与配置;BindableEvent 仅用于客户端-服务端边界同一侧的通信。
- 输入与相机:输入与相机代码保持在客户端,并根据玩家当前输入模式适配,而非假设仅桌面端。
- 工作区脚本:通过清晰引用读写对象状态;使用射线检测进行空间查询;使用碰撞组或部件属性控制碰撞;在需要朝向与相对变换时使用 CFrame 操作。
使用方式:技能提供 references 目录下的参考文档,包括 scripting-overview.md(Studio 基础脚本工作流与服务-模块-函数-事件脚本形态)、client-server-runtime.md(权威、复制、编辑与运行时数据模型)、script-locations-and-script-types.md(脚本类型与容器放置)、services.md(GetService 模式)、modulescripts-and-reuse-patterns.md(模块缓存与封装)、attributes.md(每实例状态与复制顺序注意)、bindable-events.md(同侧通信)、input-overview.md(客户端输入处理)、workspace-basics-camera-raycasting-collisions-and-cframes.md(常见世界面运行时模式)。技能还提供检查清单与常见错误提示,帮助避免如把仅服务端逻辑放入 ReplicatedStorage、假设复制对象已存在而跳过 WaitForChild()、把 BindableEvent 当作跨网络通信工具等。
适用场景:基础 Roblox 运行时结构、日常玩法脚本、容器放置、模块复用、属性与 BindableEvent 使用、客户端输入与相机、射线检测、碰撞和 CFrame 等。
限制:不适用于详尽的引擎 API 查询或逐类参考浏览;不适用于跨边界遥控设计、高级遥控安全或服务端权威架构(应转 roblox-networking);不适用于持久化、内存存储、消息、Open Cloud、OAuth 或外部自动化(应转 roblox-data、roblox-cloud 或 roblox-oauth);也不适用于大规模 API 成员查询(应转 roblox-api)。若任务混合核心结构与范围外系统,技能只回答基础 Roblox 部分并明确排除其余内容。