weppy-roblox-sync-guide

Use when working with WEPPY Roblox MCP Studio-local sync, effective policy, bidirectional file mirrors, multi-place project folders, conflicts, reverse apply and delete safety, sourcemaps, detector recovery, or Roblox Explorer context.

Jump to install

Repository: hope1026/weppy-roblox-mcp
Last source activity: August 25, 2026 at 02:50
Detected SKILL.md language: English
Stars: 60
Forks: 9

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/hope1026/weppy-roblox-mcp --skill weppy-roblox-sync-guide

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

File Explorer

7 files

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

WEPPY Roblox Sync Guide

Overview

Use this skill when local files and Roblox Studio state must stay aligned through WEPPY sync. Load only the reference that matches the sync problem.

Workflow

Inspect the current place with manage_sync.status_current_place and read the effective policy with manage_sync.policy before changing files.

If Sync is Off or the effective policy does not allow the intended direction, explain the current state and ask the user to change it in the Studio plugin; policy editing stays in the Studio plugin.

Confirm the relevant semantic scope and effective direction: forward, reverse, or bidirectional.

Use the v2 nested directory format when reading or editing mirrored files.

Treat play mode as a sync suppression window; reconcile after play exits.

Resolve conflicts according to the effective policy, not by silently overwriting both sides.

Confirm destructive local deletes before applying them to Studio unless delete auto-apply was explicitly enabled.

Verify by checking sync status, changed files, sourcemaps, and Roblox Explorer when relevant.

References

references/sync-workflow.md: status, effective policy, workflow scopes, apply modes, and runtime lifecycle.

references/sync-format.md: v2 nested directory and file naming rules.

references/conflicts.md: direction enforcement and conflict resolution.

references/sourcemap.md: Place sourcemaps and luau-lsp integration.

references/roblox-explorer.md: VSCode Explorer view over the sync mirror.

Guardrails

Do not start sync while Studio is in play mode.

Do not claim that MCP or the Dashboard can edit Sync policy.

Do not migrate or delete old sync roots automatically.

Do not assume one active sync root per place; the project has one active weppy-project-sync root with isolated place_* children.

Do not treat __MCP_* temporary test instances as synced game content.