@weppy/roblox-mcp 1.2.2 → 1.3.0

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Roblox MCP server and tools for AI-powered game development",
-    "version": "1.2.2"
+    "version": "1.3.0"
   },
   "plugins": [
     {
       "name": "weppy-roblox-mcp",
       "source": "./plugins/weppy-roblox-mcp",
       "description": "MCP server for Roblox Studio integration - AI-powered game development with specialized agents and skills",
-      "version": "1.2.2",
+      "version": "1.3.0",
       "author": {
         "name": "hope1026"
       },

package/CHANGELOG.md

@@ -4,11 +4,39 @@ All notable changes to this project will be documented in this file.
 
 
 
+## [1.3.0] - 2026-03-06
 
+### Breaking Changes
 
+- Sync file format now uses nested directory structure for all objects — each instance is represented as its own directory (e.g., `Part/Part.props.json` instead of flat files)
+- Duplicate sibling instances are now distinguished using `~N` suffix encoding (Odd-Count Tilde Rule) — e.g., `Part~1/`, `Part~2/`, `Part~3/`
+- Existing sync data will be regenerated automatically (no migration from v1)
 
+### Improvements
 
+- Enhance sync stability and performance for bidirectional file synchronization
+- Improve sync child indexing and collision handling
+- Refine analytics tracking for tool usage
 
+### Bug Fixes
+
+- Improve error handling and resilience during MCP tool execution
+- Fix license token cache and Pro auth flow issues
+- Resolve sync errors on concurrent file changes
+- Fix duplicated instance name handling in sync index
+- Fix various edge cases in sync change processing
+
+### Plugin
+
+- Improve plugin icons and UI refinements
+- Clean up unused files and modules
+- General plugin stability improvements
+
+
+## [1.2.3] - 2026-03-02
+
+Other Changes
+-	improved UI, security, and overall stability
 
 
 ## [1.2.2] - 2026-03-01

package/docs/en/sync/overview.md

@@ -110,6 +110,30 @@ When changes are detected on both Studio and local sides during bidirectional sy
 - Inspect target file with `read_file`
 - Restore content with `write_file`, then verify Studio state
 
+## File format (v2 nested directory)
+
+Each Roblox instance is stored as its own directory containing meta files:
+
+```
+explorer/
+├── Workspace/
+│   ├── _tree.json
+│   ├── Part/
+│   │   └── Part.props.json
+│   ├── MyScript/
+│   │   └── MyScript.server.luau
+│   └── Coins/
+│       └── Coins.value.json
+```
+
+Naming conventions:
+- Props: `{Name}/{Name}.props.json`
+- Scripts: `{Name}/{Name}.server.luau` / `.client.luau` / `.module.luau`
+- Values: `{Name}/{Name}.value.json`
+
+Duplicate instance names use `~N` suffix on the directory (e.g. `Part~2/Part.props.json`).
+Names containing `~` are escaped to `~~` (e.g. `Part~2` becomes `Part~~2/`). The Odd-Count Tilde Rule applies: a trailing `~+N` is a collision suffix only when the tilde count is odd.
+
 ## Related docs
 
 - [Tools Overview](../tools/overview.md)

package/docs/es/sync/overview.md

@@ -110,6 +110,30 @@ Cuando se detectan cambios tanto en Studio como en local durante la sincronizaci
 - Inspecciona archivo objetivo con `read_file`
 - Restaura contenido con `write_file` y verifica en Studio
 
+## Formato de archivos (v2 nested directory)
+
+Cada instancia de Roblox se almacena como su propio directorio con archivos meta dentro:
+
+```
+explorer/
+├── Workspace/
+│   ├── _tree.json
+│   ├── Part/
+│   │   └── Part.props.json
+│   ├── MyScript/
+│   │   └── MyScript.server.luau
+│   └── Coins/
+│       └── Coins.value.json
+```
+
+Convenciones de nombres:
+- Propiedades: `{Name}/{Name}.props.json`
+- Scripts: `{Name}/{Name}.server.luau` / `.client.luau` / `.module.luau`
+- Valores: `{Name}/{Name}.value.json`
+
+Las instancias con nombre duplicado usan el sufijo `~N` en el directorio (ej. `Part~2/Part.props.json`).
+Los nombres que contienen `~` se escapan como `~~` (ej. `Part~2` → `Part~~2/`). Regla Odd-Count Tilde: un `~+N` final se interpreta como sufijo de colisión solo cuando la cantidad de tildes es impar.
+
 ## Documentos relacionados
 
 - [Cobertura de herramientas (Tools Overview)](../tools/overview.md)

package/docs/id/sync/overview.md

@@ -110,6 +110,30 @@ Ketika perubahan terdeteksi di sisi Studio maupun lokal selama sinkronisasi dua
 - Periksa file target dengan `read_file`
 - Pulihkan konten dengan `write_file`, lalu verifikasi status di Studio
 
+## Format file (v2 nested directory)
+
+Setiap instance Roblox disimpan sebagai direktori sendiri dengan file meta di dalamnya:
+
+```
+explorer/
+├── Workspace/
+│   ├── _tree.json
+│   ├── Part/
+│   │   └── Part.props.json
+│   ├── MyScript/
+│   │   └── MyScript.server.luau
+│   └── Coins/
+│       └── Coins.value.json
+```
+
+Konvensi penamaan:
+- Properti: `{Name}/{Name}.props.json`
+- Script: `{Name}/{Name}.server.luau` / `.client.luau` / `.module.luau`
+- Nilai: `{Name}/{Name}.value.json`
+
+Instance dengan nama duplikat menggunakan sufiks `~N` pada direktori (contoh: `Part~2/Part.props.json`).
+Nama yang mengandung `~` di-escape menjadi `~~` (contoh: `Part~2` → `Part~~2/`). Aturan Odd-Count Tilde: `~+N` di akhir ditafsirkan sebagai sufiks collision hanya jika jumlah tilde ganjil.
+
 ## Dokumen terkait
 
 - [Cakupan tool (Tools Overview)](../tools/overview.md)

package/docs/ja/sync/overview.md

@@ -110,6 +110,30 @@ ProではタイプごとにDirection/Apply Modeを細かく制御できます。
 - `read_file` で対象ファイルを確認
 - `write_file` で内容を復元してStudio状態を再確認
 
+## ファイルフォーマット (v2 nested directory)
+
+各Robloxインスタンスは独自のディレクトリとして保存され、ディレクトリ内にメタファイルが配置されます:
+
+```
+explorer/
+├── Workspace/
+│   ├── _tree.json
+│   ├── Part/
+│   │   └── Part.props.json
+│   ├── MyScript/
+│   │   └── MyScript.server.luau
+│   └── Coins/
+│       └── Coins.value.json
+```
+
+命名規則:
+- プロパティ: `{Name}/{Name}.props.json`
+- スクリプト: `{Name}/{Name}.server.luau` / `.client.luau` / `.module.luau`
+- 値: `{Name}/{Name}.value.json`
+
+同名インスタンスはディレクトリ名に `~N` サフィックスを付けて区別します（例: `Part~2/Part.props.json`）。
+名前に `~` が含まれる場合は `~~` にエスケープされます（例: `Part~2` → `Part~~2/`）。Odd-Count Tilde ルール: 末尾の `~+N` でチルダの数が奇数の場合のみ collision suffix として解釈されます。
+
 ## 関連ドキュメント
 
 - [Tool対応範囲 (Tools Overview)](../tools/overview.md)

package/docs/ko/sync/overview.md

@@ -110,6 +110,30 @@ Pro에서는 타입별로 Direction/Apply Mode를 다르게 설정해 워크플
 - 필요한 파일을 `read_file`로 확인
 - 복구할 내용을 `write_file`로 반영 후 Studio 상태 재확인
 
+## 파일 포맷 (v2 nested directory)
+
+각 Roblox 인스턴스는 자체 디렉토리로 저장되며, 해당 디렉토리 안에 메타 파일이 위치합니다:
+
+```
+explorer/
+├── Workspace/
+│   ├── _tree.json
+│   ├── Part/
+│   │   └── Part.props.json
+│   ├── MyScript/
+│   │   └── MyScript.server.luau
+│   └── Coins/
+│       └── Coins.value.json
+```
+
+파일 명명 규칙:
+- 속성: `{Name}/{Name}.props.json`
+- 스크립트: `{Name}/{Name}.server.luau` / `.client.luau` / `.module.luau`
+- 값: `{Name}/{Name}.value.json`
+
+동일 이름 인스턴스는 디렉토리에 `~N` 접미사를 붙여 구분합니다 (예: `Part~2/Part.props.json`).
+이름에 `~`가 포함되면 `~~`로 이스케이프됩니다 (예: `Part~2` → `Part~~2/`). Odd-Count Tilde 규칙: 끝의 `~+N`에서 tilde 개수가 홀수일 때만 collision suffix로 해석됩니다.
+
 ## 함께 보면 좋은 문서
 
 - [Tool 지원 범위 (Tools Overview)](../tools/overview.md)

package/docs/pt-br/sync/overview.md

@@ -110,6 +110,30 @@ Quando mudancas sao detectadas tanto no Studio quanto no local durante a sincron
 - Inspecione o arquivo alvo com `read_file`
 - Restaure conteudo com `write_file` e valide no Studio
 
+## Formato de arquivos (v2 nested directory)
+
+Cada instancia Roblox e armazenada como seu proprio diretorio com arquivos meta dentro:
+
+```
+explorer/
+├── Workspace/
+│   ├── _tree.json
+│   ├── Part/
+│   │   └── Part.props.json
+│   ├── MyScript/
+│   │   └── MyScript.server.luau
+│   └── Coins/
+│       └── Coins.value.json
+```
+
+Convencoes de nomes:
+- Propriedades: `{Name}/{Name}.props.json`
+- Scripts: `{Name}/{Name}.server.luau` / `.client.luau` / `.module.luau`
+- Valores: `{Name}/{Name}.value.json`
+
+Instancias com nome duplicado usam o sufixo `~N` no diretorio (ex: `Part~2/Part.props.json`).
+Nomes que contem `~` sao escapados como `~~` (ex: `Part~2` → `Part~~2/`). Regra Odd-Count Tilde: um `~+N` final e interpretado como sufixo de colisao somente quando a quantidade de tildes e impar.
+
 ## Documentos relacionados
 
 - [Cobertura de ferramentas (Tools Overview)](../tools/overview.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "description": "MCP (Model Context Protocol) server for Roblox Studio integration - enables AI coding agents to interact with Roblox Studio in real-time",
   "main": "plugins/weppy-roblox-mcp/dist/index.js",
   "type": "module",

package/plugins/weppy-roblox-mcp/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "weppy-roblox-mcp",
   "description": "MCP server for Roblox Studio integration - AI-powered game development with specialized agents and skills",
-  "version": "1.2.2",
+  "version": "1.3.0",
   "author": {
     "name": "hope1026"
   },