@weppy/roblox-mcp 1.3.0 → 1.3.1

package/docs/id/README.md

@@ -1,16 +1,44 @@
 # Roblox MCP
 
-[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | **Bahasa Indonesia**
+> Server MCP dan plugin untuk Roblox Studio — kendalikan script, terrain, asset, dan lighting dengan Claude Code, Cursor, Codex, dan Gemini.
 
-> Bicara ke AI, langsung dijalankan di Roblox Studio.
+[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | **Bahasa Indonesia**
 
 [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
+## Instalasi Cepat (5 menit)
+
+**Langkah 1** — Install plugin Roblox Studio (jembatan antara Studio dan AI):
+[Panduan instalasi plugin](../en/installation/roblox-plugin.md)
+
+**Langkah 2** — Daftarkan MCP server di aplikasi AI:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+| Aplikasi AI | Panduan |
+|-------------|---------|
+| Claude Code | [Setup](../en/installation/ai-apps/claude-code.md) |
+| Claude Desktop | [Setup](../en/installation/ai-apps/claude-app.md) |
+| Codex CLI | [Setup](../en/installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [Setup](../en/installation/ai-apps/codex-app.md) |
+| Gemini CLI | [Setup](../en/installation/ai-apps/gemini-cli.md) |
+
+> Bekerja dengan semua klien MCP yang kompatibel. Perintah server: `npx -y @weppy/roblox-mcp`
+
+## Kompatibilitas
+
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+**Persyaratan:** Node.js 18+, Roblox Studio, Windows 10+ atau macOS 12+
+
 ## Fitur utama
 
 ### 1) MCP Tool: eksekusi langsung di Studio dari bahasa alami
 
-Pilar pertama Roblox MCP adalah **eksekusi MCP Tool**.
 AI bisa langsung menangani script, instance, properti, terrain, lighting, asset, audio, dan animasi di dalam Studio.
 
 - "Tambahkan partikel + suara + cooldown saat player melompat."
@@ -21,7 +49,6 @@ Ini bukan sekadar generate kode. Ini adalah **aksi yang benar-benar bisa dieksek
 
 ### 2) Sync: menjaga konteks penuh proyek untuk AI
 
-Pilar kedua adalah **Project Sync**.
 AI bekerja dari mirror lokal yang tersinkron, jadi perubahan lintas banyak file tetap konsisten.
 
 ![Alur Sync — Studio dan file lokal tersinkron secara real time](../assets/screenshots/sync.png)
@@ -29,8 +56,6 @@ AI bekerja dari mirror lokal yang tersinkron, jadi perubahan lintas banyak file
 - Basic: sinkronisasi satu arah (Studio -> Local)
 - Pro: sinkronisasi dua arah + Direction/Apply Mode per tipe + riwayat + multiplace
 
-Dengan begitu sumber kebenaran tetap jelas dan konteks perubahan tidak hilang.
-
 ## Nilai yang langsung terasa
 
 - Ringkas pekerjaan berulang: banyak edit manual jadi satu perintah
@@ -40,25 +65,18 @@ Dengan begitu sumber kebenaran tetap jelas dan konteks perubahan tidak hilang.
 
 ## Dokumen detail
 
-- [Cakupan tool (Tools Overview)](tools/overview.md)
-- [Panduan detail Sync](sync/overview.md)
-
-## Mulai
-
-Instalasi cuma dua langkah:
-
-1. **Install plugin Roblox Studio** — Jembatan antara Studio dan AI
-2. **Daftarkan MCP server di aplikasi AI** — Biar AI-mu mengenali Roblox MCP
-
-5 menit kelar. 👉 [Lihat panduan instalasi](installation/README.md)
+- [Panduan instalasi](../en/installation/README.md)
+- [Cakupan tool](../en/tools/overview.md)
+- [Panduan detail Sync](../en/sync/overview.md)
+- [Kompatibilitas](../compatibility.md)
+- [Panduan pemecahan masalah](../troubleshooting.md)
 
 ## Upgrade Pro
 
 Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.
 
-👉 [Panduan Upgrade Pro](pro-upgrade.md)
+[Panduan Upgrade Pro](../en/pro-upgrade.md)
 
-## Link
+---
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [Laporkan Masalah](https://github.com/hope1026/roblox-mcp/issues)
+[GitHub Issues](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/ja/README.md

@@ -1,16 +1,44 @@
 # Roblox MCP
 
-[English](../../README.md) | [한국어](../ko/README.md) | **日本語** | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
+> Roblox Studio用MCPサーバー＆プラグイン — Claude Code、Cursor、Codex、GeminiでスクリプトやTerrain、アセット、ライティングをAI制御。
 
-> AIに話しかけるだけで、Roblox Studioで実行されます。
+[English](../../README.md) | [한국어](../ko/README.md) | **日本語** | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
 [![デモ](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
+## クイックインストール（5分）
+
+**Step 1** — Roblox Studioプラグインのインストール（StudioとAIを接続する橋渡し）:
+[プラグインインストールガイド](../en/installation/roblox-plugin.md)
+
+**Step 2** — AIアプリにMCPサーバーを登録:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+| AIアプリ | ガイド |
+|---------|--------|
+| Claude Code | [セットアップ](../en/installation/ai-apps/claude-code.md) |
+| Claude Desktop | [セットアップ](../en/installation/ai-apps/claude-app.md) |
+| Codex CLI | [セットアップ](../en/installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [セットアップ](../en/installation/ai-apps/codex-app.md) |
+| Gemini CLI | [セットアップ](../en/installation/ai-apps/gemini-cli.md) |
+
+> MCP対応のAIアプリであれば利用できます。サーバーコマンド: `npx -y @weppy/roblox-mcp`
+
+## 互換性
+
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+**要件:** Node.js 18+、Roblox Studio、Windows 10+ または macOS 12+
+
 ## 主要機能
 
 ### 1) MCP Tool: 自然言語の指示をStudioで直接実行
 
-Roblox MCPの第一の柱は**MCP Tool実行**です。
 AIがStudio内で、スクリプト、インスタンス、プロパティ、地形、ライティング、アセット、オーディオ、アニメーションを直接処理します。
 
 - 「プレイヤーのジャンプ時に、パーティクル + サウンド + クールタイムを追加して。」
@@ -21,44 +49,34 @@ AIがStudio内で、スクリプト、インスタンス、プロパティ、地
 
 ### 2) Sync: AIがプロジェクト全体の文脈を維持
 
-第二の柱は**Project Sync**です。
 同期されたローカルミラーを基準にAIが作業するため、複数ファイルにまたがる変更も一貫して適用できます。
 
 ![Syncワークフロー — Studioとローカルファイルがリアルタイムで同期される様子](../assets/screenshots/sync.png)
 
-- Basic: 片方向同期 (Studio -> Local)
+- Basic: 片方向同期（Studio -> Local）
 - Pro: 双方向同期 + タイプ別Direction/Apply Mode + 変更履歴 + マルチPlace
 
-どちらを正とするかを明確に保ち、変更文脈の取りこぼしを防げます。
-
 ## すぐに実感できる価値
 
 - 反復作業を圧縮: 多数の手作業を1つの指示に集約
 - 関連ファイルを同時に変更: 単一ファイル修正で終わらない
 - リスク低減: 同期状態と履歴を見ながら安全に変更
-- トークン効率向上 (Pro): バルク処理で往復回数を削減
+- トークン効率向上（Pro）: バルク処理で往復回数を削減
 
 ## 詳細ドキュメント
 
-- [Tool対応範囲 (Tools Overview)](tools/overview.md)
-- [Sync機能詳細ガイド](sync/overview.md)
-
-## はじめに
-
-インストールは2つのステップで完了します:
-
-1. **Roblox Studioプラグインのインストール** — StudioとAIを接続する橋渡し
-2. **AIアプリにMCPサーバーを登録** — 使用するAIアプリでRoblox MCPを認識
-
-5分で終わります。👉 [インストールガイド](installation/README.md)
+- [インストールガイド](../en/installation/README.md)
+- [Tool対応範囲](../en/tools/overview.md)
+- [Sync機能詳細ガイド](../en/sync/overview.md)
+- [互換性](../compatibility.md)
+- [トラブルシューティング](../troubleshooting.md)
 
 ## Proアップグレード
 
 双方向Sync、高度な制作機能、AIトークン効率 — 一度のアップグレードで全てを手に入れる。
 
-👉 [Proアップグレードガイド](pro-upgrade.md)
+[Proアップグレードガイド](../en/pro-upgrade.md)
 
-## リンク
+---
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [Issue報告](https://github.com/hope1026/roblox-mcp/issues)
+[GitHubイシュー](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/ko/README.md

@@ -1,16 +1,44 @@
 # Roblox MCP
 
+> Roblox Studio용 MCP 서버 및 플러그인 — Claude Code, Cursor, Codex, Gemini로 스크립트, 지형, 에셋, 조명을 AI로 제어합니다.
+
 [English](../../README.md) | **한국어** | [日本語](../ja/README.md) | [Español](../es/README.md) | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
-> AI에게 말하면, Roblox Studio에서 바로 실행됩니다.
+[![데모](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+
+## 빠른 설치 (5분)
+
+**1단계** — Roblox Studio 플러그인 설치 (Studio와 AI를 연결하는 다리):
+[플러그인 설치 가이드](../en/installation/roblox-plugin.md)
+
+**2단계** — AI 앱에 MCP 서버 등록:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+| AI 앱 | 가이드 |
+|-------|--------|
+| Claude Code | [설정](../en/installation/ai-apps/claude-code.md) |
+| Claude Desktop | [설정](../en/installation/ai-apps/claude-app.md) |
+| Codex CLI | [설정](../en/installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [설정](../en/installation/ai-apps/codex-app.md) |
+| Gemini CLI | [설정](../en/installation/ai-apps/gemini-cli.md) |
+
+> MCP를 지원하는 모든 AI 앱에서 사용 가능합니다. 서버 명령어: `npx -y @weppy/roblox-mcp`
 
-[![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
+## 호환성
+
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+**요구 사항:** Node.js 18+, Roblox Studio, Windows 10+ 또는 macOS 12+
 
 ## 핵심 기능
 
 ### 1) MCP Tool: 말로 지시하면 Studio에서 바로 실행
 
-Roblox MCP의 첫 번째 축은 **MCP Tool 실행 능력**입니다.  
 스크립트, 인스턴스, 속성, 지형, 조명, 에셋, 오디오, 애니메이션까지 AI가 Studio에서 직접 처리합니다.
 
 - "플레이어 점프 시 파티클 + 사운드 + 쿨타임까지 한 번에 넣어줘."
@@ -21,7 +49,6 @@ Roblox MCP의 첫 번째 축은 **MCP Tool 실행 능력**입니다.
 
 ### 2) Sync: AI가 프로젝트 전체 문맥을 읽고 유지
 
-두 번째 축은 **Project Sync**입니다.
 AI가 로컬 동기화된 프로젝트를 기준으로 전체 구조를 이해해, 여러 파일에 걸친 변경을 일관되게 수행합니다.
 
 ![Sync 워크플로우 — Studio와 로컬 파일이 실시간으로 동기화되는 모습](../assets/screenshots/sync.png)
@@ -29,8 +56,6 @@ AI가 로컬 동기화된 프로젝트를 기준으로 전체 구조를 이해
 - Basic: Studio -> Local 단방향 동기화
 - Pro: 양방향 동기화 + 타입별 Direction/Apply Mode + 변경 기록 + 멀티 Place
 
-즉, "지금 어떤 파일이 실제 기준인지", "무엇이 언제 바뀌었는지"를 놓치지 않고 협업할 수 있습니다.
-
 ## 유저가 바로 체감하는 장점
 
 - 반복 작업 압축: 수십 번 클릭/수정을 자연어 한 번으로 처리
@@ -40,25 +65,18 @@ AI가 로컬 동기화된 프로젝트를 기준으로 전체 구조를 이해
 
 ## 세부 문서
 
-- [Tool 지원 범위 (Tools Overview)](tools/overview.md)
-- [Sync 기능 상세 가이드](sync/overview.md)
-
-## 시작하기
-
-설치는 두 단계로 완료됩니다:
-
-1. **Roblox Studio 플러그인 설치** — Studio와 AI를 연결하는 다리 역할을 합니다
-2. **AI 앱에 MCP 서버 등록** — 사용하는 AI 앱에서 Roblox MCP를 인식하도록 설정합니다
-
-5분이면 끝나요. 👉 [설치 가이드 보기](installation/README.md)
+- [설치 가이드](../en/installation/README.md)
+- [Tool 지원 범위](../en/tools/overview.md)
+- [Sync 기능 상세 가이드](../en/sync/overview.md)
+- [호환성](../compatibility.md)
+- [문제 해결 가이드](../troubleshooting.md)
 
 ## Pro로 업그레이드
 
 양방향 Sync, 고급 제작 기능, AI 토큰 효율 — 한 번의 업그레이드로 모두 누리세요.
 
-👉 [Pro 업그레이드 가이드](pro-upgrade.md)
+[Pro 업그레이드 가이드](../en/pro-upgrade.md)
 
-## 링크
+---
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [이슈 리포트](https://github.com/hope1026/roblox-mcp/issues)
+[GitHub 이슈](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/pt-br/README.md

@@ -1,16 +1,44 @@
 # Roblox MCP
 
-[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | **Português** | [Bahasa Indonesia](../id/README.md)
+> Servidor MCP e plugin para Roblox Studio — controle scripts, terrain, assets e iluminacao com Claude Code, Cursor, Codex e Gemini.
 
-> Fale com a IA e ela executa direto no Roblox Studio.
+[English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | [Español](../es/README.md) | **Português** | [Bahasa Indonesia](../id/README.md)
 
 [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
+## Instalacao rapida (5 minutos)
+
+**Passo 1** — Instale o plugin do Roblox Studio (ponte entre Studio e IA):
+[Guia de instalacao do plugin](../en/installation/roblox-plugin.md)
+
+**Passo 2** — Registre o servidor MCP no seu app de IA:
+
+```bash
+npx -y @weppy/roblox-mcp
+```
+
+| App de IA | Guia |
+|-----------|------|
+| Claude Code | [Configuracao](../en/installation/ai-apps/claude-code.md) |
+| Claude Desktop | [Configuracao](../en/installation/ai-apps/claude-app.md) |
+| Codex CLI | [Configuracao](../en/installation/ai-apps/codex-cli.md) |
+| Codex Desktop | [Configuracao](../en/installation/ai-apps/codex-app.md) |
+| Gemini CLI | [Configuracao](../en/installation/ai-apps/gemini-cli.md) |
+
+> Funciona com qualquer cliente MCP compativel. O comando do servidor e `npx -y @weppy/roblox-mcp`.
+
+## Compatibilidade
+
+| Claude Code | Claude Desktop | Cursor | Codex CLI | Gemini CLI |
+|:-----------:|:--------------:|:------:|:---------:|:----------:|
+| ✅ | ✅ | ✅ | ✅ | ✅ |
+
+**Requisitos:** Node.js 18+, Roblox Studio, Windows 10+ ou macOS 12+
+
 ## Funcionalidades principais
 
 ### 1) MCP Tool: execucao direta no Studio via linguagem natural
 
-O primeiro eixo do Roblox MCP e a **execucao de MCP Tool**.
 A IA consegue operar diretamente scripts, instancias, propriedades, terreno, iluminacao, assets, audio e animacao dentro do Studio.
 
 - "Adiciona particulas + som + cooldown quando o jogador pular."
@@ -21,7 +49,6 @@ Nao e apenas geracao de codigo. Sao **acoes executaveis para fluxo real de desen
 
 ### 2) Sync: mantem contexto completo do projeto para a IA
 
-O segundo eixo e o **Project Sync**.
 A IA trabalha com um espelho local sincronizado, entao alteracoes em varios arquivos continuam consistentes.
 
 ![Fluxo de Sync — Studio e arquivos locais sincronizados em tempo real](../assets/screenshots/sync.png)
@@ -29,8 +56,6 @@ A IA trabalha com um espelho local sincronizado, entao alteracoes em varios arqu
 - Basic: sincronizacao unidirecional (Studio -> Local)
 - Pro: sincronizacao bidirecional + Direction/Apply Mode por tipo + historico + multiplace
 
-Assim voce mantem clara a fonte de verdade e evita perder contexto de mudancas.
-
 ## Valor imediato para o usuario
 
 - Comprimir trabalho repetitivo: transformar muitas edicoes manuais em um pedido
@@ -40,25 +65,18 @@ Assim voce mantem clara a fonte de verdade e evita perder contexto de mudancas.
 
 ## Documentacao detalhada
 
-- [Cobertura de ferramentas (Tools Overview)](tools/overview.md)
-- [Guia detalhado de Sync](sync/overview.md)
-
-## Comecar
-
-A instalacao tem dois passos:
-
-1. **Instalar plugin do Roblox Studio** — Faz a ponte entre Studio e IA
-2. **Registrar servidor MCP no app de IA** — Configura seu app de IA para reconhecer o Roblox MCP
-
-Leva 5 minutos. 👉 [Ver guia de instalacao](installation/README.md)
+- [Guia de instalacao](../en/installation/README.md)
+- [Cobertura de ferramentas](../en/tools/overview.md)
+- [Guia detalhado de Sync](../en/sync/overview.md)
+- [Compatibilidade](../compatibility.md)
+- [Solucao de problemas](../troubleshooting.md)
 
 ## Upgrade Pro
 
 Sync bidirecional, recursos avancados de criacao e eficiencia de tokens de IA — tudo em uma unica atualizacao.
 
-👉 [Guia de upgrade Pro](pro-upgrade.md)
+[Guia de upgrade Pro](../en/pro-upgrade.md)
 
-## Links
+---
 
-- [GitHub](https://github.com/hope1026/roblox-mcp)
-- [Reportar Problema](https://github.com/hope1026/roblox-mcp/issues)
+[GitHub Issues](https://github.com/hope1026/roblox-mcp/issues) · [Discussions](https://github.com/hope1026/roblox-mcp/discussions) · [npm](https://www.npmjs.com/package/@weppy/roblox-mcp)

package/docs/troubleshooting.md

@@ -0,0 +1,47 @@
+# Troubleshooting
+
+## Plugin not connecting
+
+**Symptom:** "Connection failed" or plugin shows disconnected in Roblox Studio.
+
+1. Make sure the MCP server is running: `npx -y @weppy/roblox-mcp`
+2. In Roblox Studio: Plugins tab → W-MCP → Connect
+3. Confirm nothing is blocking `localhost:3002` (firewall, antivirus, VPN)
+4. Try restarting both Roblox Studio and the MCP server
+
+## MCP server not found by AI client
+
+1. Verify your AI client config uses the correct command: `npx -y @weppy/roblox-mcp`
+2. Ensure Node.js >= 18 is installed: `node --version`
+3. On Windows, try running your terminal as Administrator if permission errors appear
+4. Check the client-specific setup guide in [Installation](en/installation/README.md)
+
+## "Pro feature required" error
+
+The action you're requesting requires the Pro tier.
+See [Pro Upgrade Guide](en/pro-upgrade.md) for details.
+
+## Sync not working
+
+1. Check sync status: ask AI `manage_sync status`
+2. Ensure the plugin is connected before starting sync
+3. For reverse sync (file → Studio), confirm Pro tier is active
+4. Check that the local sync folder exists and has write permissions
+
+## Common error messages
+
+| Error | Cause | Fix |
+|-------|-------|-----|
+| `ECONNREFUSED localhost:3002` | MCP server not running | Run `npx -y @weppy/roblox-mcp` |
+| `Timeout waiting for plugin` | Studio plugin not connected | Click Connect in plugin panel |
+| `Rate limit exceeded` | Over 450 requests/min | Reduce or batch requests |
+| `Forbidden path` | Accessing CoreGui/CorePackages | Use valid instance paths only |
+| `Place ID mismatch` | Wrong place connected | Reconnect from correct Studio session |
+
+## Still stuck?
+
+[Open a Discussion](https://github.com/hope1026/roblox-mcp/discussions) and include:
+- OS and Node.js version
+- AI client and version
+- Error message or logs
+- Steps you already tried

package/llms.txt

@@ -0,0 +1,45 @@
+# Roblox MCP
+
+> MCP server and Roblox Studio plugin that lets AI coding agents (Claude Code,
+> Cursor, Codex, Gemini) directly control Roblox Studio via natural language.
+
+## What it does
+
+- Execute MCP tools: create/edit scripts, instances, properties, terrain,
+  lighting, assets, audio, animation inside Roblox Studio
+- Bidirectional project sync between Roblox Studio and local files
+- 21 consolidated MCP tools covering the full Roblox Studio API surface
+
+## Installation
+
+Install in 2 steps:
+1. Install Roblox Studio plugin (bridge between Studio and AI)
+2. Register MCP server: `npx -y @weppy/roblox-mcp`
+
+Supports: Claude Code, Claude Desktop, Cursor, Codex CLI, Gemini CLI
+
+## Tiers
+
+- Basic (Free): MCP tool execution + one-way Studio -> Local sync
+- Pro: Bidirectional sync, bulk actions, multi-place support, advanced tools
+
+## Key docs
+
+- Installation: https://github.com/hope1026/roblox-mcp/blob/main/docs/en/installation/README.md
+- Tools reference: https://github.com/hope1026/roblox-mcp/blob/main/docs/en/tools/overview.md
+- Sync guide: https://github.com/hope1026/roblox-mcp/blob/main/docs/en/sync/overview.md
+- Troubleshooting: https://github.com/hope1026/roblox-mcp/blob/main/docs/en/troubleshooting.md
+- Compatibility: https://github.com/hope1026/roblox-mcp/blob/main/docs/en/compatibility.md
+
+## Requirements
+
+- Node.js >= 18
+- Roblox Studio (Windows 10+ or macOS 12+)
+- Any MCP-compatible AI client
+
+## Links
+
+- GitHub: https://github.com/hope1026/roblox-mcp
+- npm: https://www.npmjs.com/package/@weppy/roblox-mcp
+- Issues: https://github.com/hope1026/roblox-mcp/issues
+- Discussions: https://github.com/hope1026/roblox-mcp/discussions

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weppy/roblox-mcp",
-  "version": "1.3.0",
+  "version": "1.3.1",
   "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.3.0",
+  "version": "1.3.1",
   "author": {
     "name": "hope1026"
   },