nonlooped/roblox-suite

roblox

Route Roblox Luau tasks to specialist skills.

ソースを見る

使い方

  1. インストールコマンドをコピーし、自分の環境へ導入する前にソースを確認します。
  2. 必要なツール、認証情報、対応環境を原文で確認します。
  3. 入力と成果物を指定し、出力を資料と照合します。
npx skills add https://github.com/nonlooped/roblox-suite --skill roblox

開始前の確認

  • 導入にはモデル契約、API枠、ファイルへのアクセス許可は含まれません。
  • スター数や導入数は活動の指標であり、独立した品質・安全性試験ではありません。
リポジトリの原文

見出し、例、コード、表、リンク、参照画像を含む原文を表示しています。

roblox

Engine API Reference (always the source of truth for classes/properties): https://create.roblox.com/docs/reference/engine

Full documentation indexes for agents:

  • https://create.roblox.com/docs/llms.txt (start here, then route to Engine vs Open Cloud sub-indexes)
  • Engine-specific: https://create.roblox.com/docs/reference/engine/llms.txt

This hub skill gives the big picture and routes to specialist SKILL.md entry points. Each specialist owns its deep references/ index so agents load only the material needed.

Specialist skills

Choose the skill matching the task. Each specialist links to its own detailed references.

<!-- catalog:specialists:start -->

  • roblox-core: Choose services, types, serialization, and script locations
  • roblox-networking: Design remotes, validate client requests, and control replication
  • roblox-datastores: Save player data, handle concurrent writes, and recover versions
  • roblox-user-interfaces: Build responsive GUIs, handle input, and add UI effects
  • roblox-animation: Animate rigs, configure IK, tween properties, and time marker events
  • roblox-vfx: Build particles, flipbooks, beams, trails, and highlights
  • roblox-audio: Build audio graphs, mix effects, and migrate legacy Sound code
  • roblox-gamepasses: Handle passes, products, subscriptions, transfers, and purchase policy
  • roblox-open-cloud: Automate Roblox resources through REST APIs or supported HttpService calls
  • roblox-teleport: Move players between places, coordinate matchmaking, and hand off data
  • roblox-rojo: Set up filesystem projects, sync with Studio, build, and export places
  • roblox-mcp: Connect agents to Studio, inspect instances, edit scripts, and playtest
  • roblox-physics: Build mechanisms, choose constraints, and assign physics ownership
  • roblox-npcs: Navigate NPCs, handle blocked paths, and build patrol or chase behavior
  • roblox-testing: Reproduce bugs, write tests, and profile performance

<!-- catalog:specialists:end -->

Shared constraints

  1. Server authority first. Validate or simulate on the server. Client is for input, prediction, and cosmetics.
  2. Everything that talks to the cloud is fallible. Wrap DataStore, Marketplace, Http, etc. calls in pcall. Have a plan for transient vs permanent errors.
  3. Preload assets. ContentProvider:PreloadAsync for animations, images, sounds, models.
  4. Use modern APIs. Animator + LoadAnimation, task.* scheduler, TweenService, IKControl, CollectionService tags, Attributes, etc. Avoid deprecated BodyMovers, wait/spawn/delay, Humanoid:LoadAnimation, etc.
  5. Respect limits. DataStore budgets scale with concurrent users but are still finite. Particles and transparent UI are fill-rate expensive. Profile early.
  6. Structure for maintainability. ServerScriptService for authority, ReplicatedStorage for shared modules, StarterGui for client UI roots, clear module boundaries, consistent naming.
  7. Test the hard parts. Studio with API access only on test places. Multiple device classes. Low graphics quality for effects/UI. Concurrency (multiple servers touching the same keys).

Modern API notes

  • Deferred events: Set Workspace.SignalBehavior = Enum.SignalBehavior.Deferred (or use the corresponding project setting) so events queue and flush, avoiding re-entrancy issues.
  • Chat: Use TextChatService for modern chat; the legacy Chat service still exists but is the older API.
  • MemoryStore: Use MemoryStoreService for cross-server, short-lived, or high-throughput data, not regular DataStores.
  • Parallel Luau: Use Actor instances and task.synchronize() / task.desynchronize() for compute-heavy work, with careful shared-state rules.
  • buffer type: Use the buffer Luau type for compact binary data, serialization, and bit/byte manipulation.
  • UI safe zones: Use ScreenGui.ScreenInsets and related properties to respect device notches and safe areas.
  • ConfigService: Use a centralized configuration system (commonly a custom ConfigService module or Configuration instances) for live configuration and feature flags.

Workflow

  1. Load the specialist that owns the task. For broad architecture work, also read architecture-principles.md.
  2. Follow that specialist's reference links for the feature or failure you are handling. For systems that interact, read cross-skill-integration.md.
  3. Adapt script examples to the project and check their maturity labels. Validate changes in a dedicated test experience.
  4. Before handing off, report which checks passed, which need Roblox integration, and any unresolved API or policy questions. Check uncertain behavior against the official sources above.

<!-- catalog:references:start -->

Reference index

<!-- catalog:references:end -->

同じリポジトリから

関連する Skills

すべての Skills