@weppy/roblox-mcp 2.5.1 → 2.6.1

package/docs/ko/dashboard/changelog.md

@@ -1,114 +0,0 @@
-# Changelog
-
-> AI가 Roblox Studio에서 수행한 모든 변경 사항을 세션 단위로 기록하고, 변경 요약/타임라인/Before & After를 제공합니다.
-
-![Changelog — 세션별 변경 카드 목록](../../assets/screenshots/dashboard/dashboard_changelog1.png)
-
-## 개요
-
-Changelog는 AI 에이전트가 Studio에서 수행한 게임 변경 이력을 추적하는 페이지입니다. 변경 사항은 세션 단위로 그룹화되며, 각 세션에서 어떤 종류의 변경이 몇 건 발생했는지 한눈에 파악할 수 있습니다.
-
-## 세션 카드 목록
-
-Changelog의 첫 화면은 세션별 카드 목록을 보여줍니다.
-
-### 세션 상태
-
-각 세션 카드에는 상태가 표시됩니다:
-
-| 상태 | 의미 |
-|------|------|
-| **Active** | 현재 진행 중인 세션 (실시간 업데이트) |
-| **Completed** | 완료된 세션 |
-| **Bootstrap** | 초기 동기화 세션 |
-
-### 세션 요약
-
-각 카드에는 해당 세션의 변경 건수가 카테고리별로 요약됩니다:
-
-- Script — 스크립트 생성/수정 건수
-- Instance — 인스턴스 생성/삭제/이동 건수
-- Property — 속성 변경 건수
-- Lighting — 조명/환경 설정 건수
-- Terrain — 지형 변경 건수
-- Asset — 에셋 삽입 건수
-
-### 필터 탭
-
-상단 탭으로 세션을 필터링할 수 있습니다:
-- **All** — 모든 세션
-- **Active** — 진행 중인 세션만
-- **Completed** — 완료된 세션만
-
-## 세션 상세 뷰
-
-세션 카드를 클릭하면 상세 뷰로 진입합니다.
-
-![Changelog 상세 뷰 — 변경 요약, 타임라인, Before & After](../../assets/screenshots/dashboard/dashboard_changelog2.png)
-
-### Change Summary
-
-세션의 변경 사항을 6개 카테고리 카드로 시각화합니다:
-
-| 카테고리 | 아이콘 | 설명 |
-|---------|--------|------|
-| Scripts | 스크립트 | 스크립트 생성/수정 건수 |
-| Instances | 인스턴스 | 인스턴스 생성/삭제/이동 건수 |
-| Properties | 속성 | 속성 변경 건수 |
-| Lighting | 조명 | 조명/환경 변경 건수 |
-| Terrain | 지형 | 지형 변경 건수 |
-| Assets | 에셋 | 에셋 삽입 건수 |
-
-### Change Timeline
-
-세션 내 모든 변경을 시간순으로 나열합니다.
-
-- 각 항목에 타임스탬프, 변경 카테고리 태그, 대상 경로가 표시됩니다
-- **Category** 드롭다운으로 특정 카테고리만 필터링할 수 있습니다
-- 항목을 클릭하면 Before & After 비교 뷰가 펼쳐집니다
-
-### Before & After
-
-변경 전후의 데이터를 비교합니다. 변경 유형에 따라 다른 수준의 정보를 제공합니다:
-
-| 신뢰도 | 의미 | 예시 |
-|--------|------|------|
-| **exact** | 변경 전후 값이 정확히 기록됨 | 속성 변경, 스크립트 수정 |
-| **partial** | 일부 정보만 기록됨 | 복합 변경 |
-| **after-only** | 변경 후 값만 존재 | 새 인스턴스 생성 |
-| **intent-only** | 의도만 기록됨 | 삭제 등 |
-
-## 활용 사례
-
-### 작업 검증
-
-```
-"방금 AI가 수정한 스크립트가 무엇인지 확인하고 싶다"
-```
-
-Changelog에서 Active 세션의 Script 카테고리를 필터링하면, 수정된 스크립트 목록과 변경 전후 코드를 비교할 수 있습니다.
-
-### 변경 추적
-
-```
-"어제 세션에서 Lighting을 어떻게 설정했는지 다시 보고 싶다"
-```
-
-Completed 탭에서 해당 세션을 찾아 Lighting 카테고리로 필터링하면, 변경 이력과 설정 값을 확인할 수 있습니다.
-
-### 문제 디버깅
-
-```
-"어떤 시점에서 특정 인스턴스가 삭제되었는지 찾아야 한다"
-```
-
-타임라인에서 Instance 카테고리를 필터링하고, delete 타입의 변경을 시간순으로 추적할 수 있습니다.
-
-## 관련 문서
-
-- [대시보드 Overview](overview.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)
-- [Settings](settings.md)

package/docs/ko/dashboard/connection.md

@@ -1,77 +0,0 @@
-# Connection
-
-> 서버, AI 에이전트, 플러그인의 연결 상태를 한 곳에서 모니터링합니다.
-
-![Connection — 서버 상태, AI 에이전트, 플러그인 연결 정보](../../assets/screenshots/dashboard/dashboard_connection.png)
-
-## 개요
-
-Connection 페이지는 MCP 시스템의 모든 연결 상태를 한 곳에서 모니터링합니다. 대시보드가 **서버 연결됨** 또는 **Studio 연결됨** 상태이면 항상 접근할 수 있습니다.
-
-## Server Status
-
-서버의 핵심 정보를 표시합니다:
-
-| 항목 | 설명 |
-|------|------|
-| Status | 연결 상태 배지 (Online/Offline) |
-| Version | MCP 서버 버전 |
-| PID | 서버 프로세스 ID |
-| Uptime | 서버 가동 시간 |
-| Session ID | 현재 세션 식별자 |
-| Exec Path | 서버 실행 경로 |
-
-## AI Agents
-
-현재 연결된 AI 에이전트 목록을 테이블로 표시합니다:
-
-| 열 | 설명 |
-|----|------|
-| Name | 에이전트 이름 (예: Claude Code) |
-| PID | 에이전트 프로세스 ID |
-| Working Dir | 에이전트 작업 디렉토리 |
-| Connected | 연결 경과 시간 |
-
-여러 에이전트가 동시에 연결된 경우 모두 표시됩니다.
-
-## Plugins
-
-연결된 Roblox Studio 플러그인 목록을 표시합니다:
-
-| 열 | 설명 |
-|----|------|
-| Place | Place 이름 |
-| Client ID | 플러그인 클라이언트 식별자 |
-| Last Seen | 마지막 통신 시간 |
-| Version | 플러그인 버전 |
-
-## Connection Log
-
-연결 관련 이벤트를 실시간으로 표시합니다. SSE를 통해 에이전트/플러그인의 연결/해제 이벤트가 자동으로 추가됩니다.
-
-## 활용 사례
-
-### 연결 문제 진단
-
-```
-"AI가 Studio와 연결되지 않는 것 같다"
-```
-
-Server Status가 Online인지, Plugins 테이블에 플러그인이 표시되는지 확인합니다. Connection Log에서 연결/해제 이벤트를 추적할 수 있습니다.
-
-### 에이전트 확인
-
-```
-"지금 어떤 AI가 연결되어 있는지 확인하고 싶다"
-```
-
-AI Agents 테이블에서 현재 연결된 에이전트의 이름, PID, 작업 디렉토리를 확인합니다.
-
-## 관련 문서
-
-- [대시보드 Overview](overview.md)
-- [Changelog](changelog.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)
-- [Settings](settings.md)

package/docs/ko/dashboard/overview.md

@@ -1,95 +0,0 @@
-# 대시보드
-
-> MCP 서버의 상태, 연결, 동기화, 도구 실행 기록, 게임 변경 이력을 웹 브라우저에서 실시간으로 확인하고 관리합니다.
-
-![대시보드 Overview — 서버 상태, 최근 변경 사항, 세션 요약을 한눈에 확인](../../assets/screenshots/dashboard/dashboard_overview.png)
-
-## 대시보드란?
-
-대시보드는 MCP 서버가 제공하는 웹 기반 모니터링 인터페이스입니다. MCP 서버가 실행되면 자동으로 브라우저에서 열리며, AI 에이전트가 Roblox Studio에서 수행하는 모든 작업을 실시간으로 추적할 수 있습니다.
-
-- 터미널 로그를 뒤질 필요 없이 시각적으로 상태를 파악
-- AI가 Studio에서 무엇을 변경했는지 변경 이력으로 추적
-- 동기화 상태, 연결 상태, 도구 실행 통계를 한 곳에서 확인
-
-## 페이지 구성
-
-| 페이지 | 설명 | 상세 가이드 |
-|--------|------|------------|
-| [Overview](#overview) | 서버/플러그인/에이전트/Sync 상태 카드, 최근 변경 피드 | 이 문서 |
-| [Changelog](changelog.md) | 게임 변경 이력 — 세션별 카드, 변경 요약, 타임라인, Before & After | [상세 가이드](changelog.md) |
-| [Connection](connection.md) | 서버 상태, AI 에이전트 목록, 플러그인 연결 정보 | [상세 가이드](connection.md) |
-| [Sync](sync.md) | 동기화 상태, 방향 설정, 로그 | [상세 가이드](sync.md) |
-| [Playtest](playtest.md) | 플레이테스트 상태, 테스트 기록 | [상세 가이드](playtest.md) |
-| [Tools](tools.md) | 도구 실행 기록, 통계, 티어 분포 | [상세 가이드](tools.md) |
-| [Settings](settings.md) | 라이선스, 로그 레벨, 언어 | [상세 가이드](settings.md) |
-
-## 접속 방법
-
-MCP 서버가 실행되면 대시보드가 자동으로 브라우저에서 열립니다. 수동으로 접속하려면:
-
-```
-http://localhost:3002
-```
-
-> `DASHBOARD_AUTO_OPEN=false`로 설정하면 자동 열림을 비활성화할 수 있습니다 ([Settings](settings.md) 페이지에서 확인).
-
-## 연결 상태
-
-대시보드는 연결 상태에 따라 사용 가능한 기능이 달라집니다:
-
-| 상태 | 조건 | 사용 가능한 페이지 |
-|------|------|-------------------|
-| **서버 연결 끊김** | 서버 미연결 | 재연결 대기 화면만 표시 |
-| **서버 연결됨** | 서버 연결, 플러그인 미연결 | Connection, Tools, Settings |
-| **Studio 연결됨** | 서버 + 플러그인 모두 연결 | 모든 페이지 |
-
-대시보드가 **서버 연결됨** 상태일 때는 Overview, Changelog, Sync, Playtest 페이지에 접근할 수 없습니다.
-
-## Overview
-
-Overview 페이지는 대시보드의 첫 화면으로, 시스템 전체 상태를 한눈에 보여줍니다.
-
-### 상태 카드
-
-| 카드 | 표시 정보 |
-|------|----------|
-| **Server** | 서버 연결 상태 (Online/Offline) |
-| **Plugin** | 플러그인 연결 상태, Place 정보 |
-| **Agent** | 현재 연결된 AI 에이전트 이름 |
-| **Sync** | 동기화 상태 (Idle/Syncing/Error) |
-
-### 최근 게임 변경 (Recent Game Changes)
-
-AI가 Studio에서 수행한 최근 변경 사항을 실시간으로 표시합니다 (최대 20개). 각 항목은 변경 카테고리 아이콘과 함께 표시되며, 클릭하면 [Changelog](changelog.md)의 상세 뷰로 이동합니다.
-
-카테고리 아이콘:
-- Script — 스크립트 생성/수정
-- Instance — 인스턴스 생성/삭제/이동
-- Property — 속성 변경
-- Lighting — 조명/환경 설정
-- Terrain — 지형 변경
-- Asset — 에셋 삽입
-
-### 세션 변경 요약 (Session Change Summary)
-
-현재 세션의 변경 통계를 카테고리별로 집계하여 보여줍니다 (예: "4 scripts · 3 properties").
-
-## 실시간 업데이트
-
-대시보드는 SSE(Server-Sent Events)를 사용하여 실시간으로 데이터를 업데이트합니다:
-
-- 서버 상태: 5초 간격 폴링
-- 변경 피드, 연결 이벤트: SSE 실시간 스트리밍
-- SSE 연결 끊김 시: 3초 후 자동 재연결
-
-## 관련 문서
-
-- [Changelog](changelog.md) — 게임 변경 이력 추적
-- [Connection](connection.md) — 서버/에이전트/플러그인 연결 상태
-- [Sync](sync.md) — 동기화 상태 모니터링
-- [Playtest](playtest.md) — 플레이테스트 기록
-- [Tools](tools.md) — 도구 실행 기록/통계
-- [Settings](settings.md) — 라이선스, 서버 설정, 언어
-- [Tool 전체 목록](../tools/overview.md)
-- [Sync 기능 상세 가이드](../sync/overview.md)

package/docs/ko/dashboard/playtest.md

@@ -1,61 +0,0 @@
-# Playtest
-
-> AI가 실행한 플레이테스트의 상태와 테스트 결과를 확인합니다.
-
-![Playtest — 플레이테스트 상태와 테스트 기록](../../assets/screenshots/dashboard/dashboard_playtest.png)
-
-## 개요
-
-Playtest 페이지는 AI가 실행한 플레이테스트의 상태와 테스트 결과를 보여줍니다. 대시보드가 **Studio 연결됨** 상태일 때만 접근할 수 있습니다.
-
-## Playtest Status
-
-현재 플레이테스트 상태를 표시합니다:
-
-| 상태 | 의미 |
-|------|------|
-| **NotRunning** | 플레이테스트 미실행 |
-| **Running** | 플레이테스트 실행 중 |
-| **Paused** | 플레이테스트 일시정지 (Run 모드) |
-
-## Test History
-
-AI가 `run_test` 액션으로 실행한 테스트 결과를 시간순으로 나열합니다:
-
-| 항목 | 설명 |
-|------|------|
-| 타임스탬프 | 테스트 실행 시간 |
-| Test Report | 테스트 리포트 링크 |
-| Mode | 실행 모드 (play/run) |
-| Duration | 테스트 소요 시간 |
-| Status | 결과 (Passed/Failed) |
-
-테스트 리포트를 클릭하면 마크다운 형식의 상세 리포트와 로그를 확인할 수 있습니다.
-
-## 활용 사례
-
-### 테스트 실패 분석
-
-```
-"방금 실행한 자동 테스트가 실패한 원인을 찾고 싶다"
-```
-
-Test History에서 Failed 상태의 테스트를 찾아 Test Report를 클릭하면, 상세 로그와 실패 원인을 확인할 수 있습니다.
-
-### 테스트 이력 확인
-
-```
-"오늘 실행한 테스트들의 성공/실패 현황을 보고 싶다"
-```
-
-Test History에서 타임스탬프와 Status를 확인하여 테스트 결과 추이를 파악합니다.
-
-## 관련 문서
-
-- [대시보드 Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Tools](tools.md)
-- [Settings](settings.md)
-- [플레이테스트 & 자동 테스트 (도구)](../tools/playtest.md)

package/docs/ko/dashboard/settings.md

@@ -1,60 +0,0 @@
-# Settings
-
-> 라이선스 정보, 서버 설정, 언어를 확인하고 관리합니다.
-
-## 개요
-
-Settings 페이지에서는 라이선스 정보와 서버 설정을 확인하고 일부를 변경할 수 있습니다. 대시보드가 **서버 연결됨** 또는 **Studio 연결됨** 상태이면 항상 접근할 수 있습니다.
-
-## License (읽기 전용)
-
-현재 라이선스 상태를 표시합니다:
-
-| 항목 | 설명 |
-|------|------|
-| Status | 상태 배지 (Active/Inactive) |
-| Tier | 현재 티어 (Basic/Pro) |
-| License Key | 마스킹된 라이선스 키 |
-| Provider | 라이선스 제공자 정보 |
-
-## General
-
-| 설정 | 설명 |
-|------|------|
-| Log Level | 로그 출력 수준 |
-| History Recording | 도구 실행 기록 저장 여부 |
-| Stats Collection | 도구 통계 수집 여부 |
-| Request Timeout | 요청 타임아웃 (초) |
-
-## Server Environment (읽기 전용)
-
-환경 변수로 설정된 서버 설정을 표시합니다:
-
-| 환경 변수 | 설명 | 기본값 |
-|----------|------|--------|
-| `HTTP_PORT` | HTTP 포트 | 3002 |
-| `HTTP_HOST` | HTTP 호스트 | 127.0.0.1 |
-| `DASHBOARD_AUTO_OPEN` | 대시보드 자동 열림 | true |
-
-## Language
-
-대시보드 UI 언어를 변경합니다. 6개 언어 + Auto(브라우저 언어 자동 감지)를 지원합니다.
-
-| 옵션 | 언어 |
-|------|------|
-| Auto | 브라우저 언어 자동 감지 |
-| English | 영어 |
-| 한국어 | 한국어 |
-| 日本語 | 일본어 |
-| Español | 스페인어 |
-| Português | 포르투갈어 |
-| Bahasa Indonesia | 인도네시아어 |
-
-## 관련 문서
-
-- [대시보드 Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)

package/docs/ko/dashboard/sync.md

@@ -1,68 +0,0 @@
-# Sync
-
-> Studio ↔ 로컬 파일 동기화의 현재 상태, 방향 설정, 로그를 모니터링합니다.
-
-![Sync — 동기화 상태, 방향 설정, 로그](../../assets/screenshots/dashboard/dashboard_sync.png)
-
-> Sync 기능 자체의 상세 가이드는 [Sync 기능 상세 가이드](../sync/overview.md)를 참고하세요.
-
-## 개요
-
-Sync 페이지는 Studio ↔ 로컬 파일 동기화의 현재 상태와 설정을 시각적으로 보여줍니다. 대시보드가 **Studio 연결됨** 상태일 때만 접근할 수 있습니다.
-
-## Sync Status
-
-현재 동기화 상태를 표시합니다:
-
-| 상태 | 의미 |
-|------|------|
-| **Idle** | 동기화 대기 중 |
-| **Initializing** | 초기 동기화 진행 중 |
-| **Syncing** | 증분 동기화 진행 중 |
-| **Error** | 동기화 오류 발생 |
-
-상태 카드에는 동기화 경로, 동기화된 인스턴스 수, 현재 적용 모드(Auto/Manual)가 함께 표시됩니다.
-
-## Sync Directions
-
-타입별 동기화 방향을 테이블로 보여줍니다:
-
-| 열 | 설명 |
-|----|------|
-| Type | 동기화 대상 타입 (Scripts, Values, Instances, Data, Services) |
-| Direction | 동기화 방향 (Local → Studio, Studio → Local) |
-| Apply Mode | 적용 모드 (Auto/Manual) |
-
-각 타입의 동기화 방향을 확인하여 어떤 변경이 어느 방향으로 반영되는지 파악할 수 있습니다.
-
-## Sync Log
-
-동기화 이벤트를 시간순으로 표시합니다. 각 로그 항목에는 변경 유형 태그(create, update, delete 등)와 대상 경로가 포함됩니다.
-
-## 활용 사례
-
-### 동기화 상태 확인
-
-```
-"Sync가 제대로 동작하는지 확인하고 싶다"
-```
-
-Sync Status가 Idle인지 확인하고, Sync Log에서 최근 변경이 정상적으로 기록되었는지 확인합니다.
-
-### 동기화 방향 파악
-
-```
-"스크립트 변경이 어느 방향으로 동기화되는지 알고 싶다"
-```
-
-Sync Directions 테이블에서 Scripts 타입의 Direction을 확인합니다.
-
-## 관련 문서
-
-- [대시보드 Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Playtest](playtest.md)
-- [Tools](tools.md)
-- [Settings](settings.md)
-- [Sync 기능 상세 가이드](../sync/overview.md)

package/docs/ko/dashboard/tools.md

@@ -1,69 +0,0 @@
-# Tools
-
-> AI가 실행한 MCP 도구의 기록과 통계를 확인합니다.
-
-![Tools — 도구 실행 기록과 통계](../../assets/screenshots/dashboard/dashboard_tools.png)
-
-## 개요
-
-Tools 페이지는 AI가 실행한 MCP 도구의 기록과 통계를 제공합니다. **History**와 **Statistics** 두 개의 서브탭으로 구성됩니다. 대시보드가 **서버 연결됨** 또는 **Studio 연결됨** 상태이면 항상 접근할 수 있습니다.
-
-## History 탭
-
-도구 실행 기록을 시간순 테이블로 보여줍니다:
-
-| 열 | 설명 |
-|----|------|
-| Time | 실행 시간 |
-| Tool.Action | 실행된 도구와 액션 (예: `query_instances.get_instance`) |
-| Duration | 실행 소요 시간 |
-| Status | 결과 상태 (OK/Error) |
-| Tier | 사용된 티어 (Basic/Pro) |
-
-기능:
-- **Tool 필터** 드롭다운으로 특정 도구만 필터링
-- 페이지네이션으로 대량의 기록 탐색
-- 실시간으로 새 실행 기록 추가
-
-## Statistics 탭
-
-도구 사용 통계를 시각적으로 분석합니다:
-
-- **티어 분포** — Basic/Pro 도구 사용 비율
-- **도구별 통계** — 각 도구의 호출 횟수, 평균 응답 시간
-- **액션별 분석** — 도구 내 액션별 세부 통계
-
-## Basic 티어 전용 기능
-
-Basic 티어 사용자에게는 추가 UI가 표시됩니다:
-
-- **Tier Usage Progress** — 사용량 진행 바
-- **Basic vs Pro 비교 모달** — Pro 티어의 추가 기능을 안내
-
-## 활용 사례
-
-### 도구 성능 분석
-
-```
-"어떤 도구가 가장 오래 걸리는지 알고 싶다"
-```
-
-Statistics 탭에서 도구별 평균 응답 시간을 확인합니다.
-
-### 오류 추적
-
-```
-"방금 실행한 도구가 실패한 이유를 알고 싶다"
-```
-
-History 탭에서 Status가 Error인 항목을 찾아 상세 정보를 확인합니다.
-
-## 관련 문서
-
-- [대시보드 Overview](overview.md)
-- [Changelog](changelog.md)
-- [Connection](connection.md)
-- [Sync](sync.md)
-- [Playtest](playtest.md)
-- [Settings](settings.md)
-- [Tool 전체 목록](../tools/overview.md)

package/docs/ko/explorer/overview.md

@@ -1,104 +0,0 @@
-# WEPPY Roblox Explorer 상세 가이드
-
-**WEPPY Roblox Explorer**는 Roblox Studio의 Explorer 트리를 VSCode·Antigravity 같은 에디터 안에서 동일한 형태로 보여주는 companion 확장입니다. Studio와 로컬을 오가지 않고도 동기화된 인스턴스 계층을 탐색하고, 스크립트를 열고, 속성을 편집할 수 있습니다.
-
-> **선택 사항** — Explorer는 필수가 아닙니다. MCP 서버와 Roblox Studio 플러그인만으로도 모든 핵심 기능을 사용할 수 있습니다. 에디터 안에서 프로젝트 구조를 탐색하거나 속성을 빠르게 확인·편집하고 싶을 때 설치하세요.
-
-![WEPPY Roblox Explorer — VSCode 사이드바에 표시되는 Studio 인스턴스 트리](../../assets/screenshots/roblox-explorer/roblox-explorer-screen.png)
-
-## 왜 Explorer를 쓰는가
-
-Sync가 생성한 파일만으로도 AI는 프로젝트 전체 문맥을 이해할 수 있지만, 사람이 직접 탐색할 때는 파일 경로만으로는 구조가 잘 드러나지 않습니다. Explorer는 같은 sync 데이터를 **Roblox Studio와 동일한 계층 구조**로 다시 보여주기 때문에 다음이 편해집니다.
-
-- 스크립트가 어느 서비스/인스턴스 아래에 있는지 한눈에 파악
-- 여러 서비스에 걸친 인스턴스를 이름·경로 기준으로 빠르게 찾기
-- 동기화 상태(modified / studio / conflict)를 파일별로 확인
-- Studio로 전환하지 않고 속성값을 편집
-
-## 요구 사항
-
-- VSCode 1.85+ 또는 Antigravity
-- [Roblox MCP](../installation/README.md) 설치 및 Sync 활성화 (Basic 또는 Pro)
-- 프로젝트 루트 아래에 Sync가 생성한 `weppy-project-sync/place_*/.sync-meta.json` 존재
-
-Explorer는 기본적으로 디스크의 sync 파일만 읽어도 동작하며, 로컬 MCP 서버가 실행 중이면 실시간 sync 상태와 direction 정보를 추가로 반영합니다.
-
-## 설치 방법
-
-VSCode 또는 Antigravity의 Extensions 사이드바(`Ctrl+Shift+X` / `Cmd+Shift+X`)에서 **WEPPY Roblox Explorer**를 검색하고 **Install**을 클릭합니다.
-
-마켓플레이스 직접 링크:
-
-- [VS Code Marketplace](https://marketplace.visualstudio.com/items?itemName=weppy.weppy-roblox-explorer)
-- [Open VSX](https://open-vsx.org/extension/weppy/weppy-roblox-explorer)
-
-## 인스턴스 트리 탐색
-
-설치 후 VSCode Activity Bar에 **WEPPY Explorer** 뷰가 생성되며, 프로젝트 루트에서 sync 디렉토리를 자동 탐색합니다.
-
-- **서비스 루트**: `Workspace`, `ReplicatedStorage`, `ServerScriptService` 등 동기화 대상 서비스가 최상위에 표시됩니다.
-- **Roblox 클래스 아이콘**: 200개 이상의 Studio 아이콘이 다크/라이트 테마에 맞춰 자동으로 전환됩니다.
-- **멀티 Place**: 동기화된 Place가 여러 개일 때 각 Place별로 트리 루트가 분리되어 표시됩니다.
-- **자동 새로고침**: Sync 파일이 변경되면 500ms 디바운스로 트리가 자동 갱신됩니다.
-- **Sync 상태 배지**: `modified`, `studio`, `conflict` 상태가 아이콘 옆에 표시되어 변경/충돌을 즉시 확인할 수 있습니다.
-
-트리에서 항목을 클릭하면 해당 인스턴스를 뒷받침하는 파일(`.server.luau`, `.client.luau`, `.module.luau`, `.props.json` 등)이 바로 열립니다. 우클릭 메뉴로 인스턴스 경로를 `game.Workspace.Part` 형식으로 복사하거나, 기본 VSCode 탐색기에서 해당 파일 위치를 보여줄 수 있습니다.
-
-## Property Panel
-
-Explorer 트리에서 인스턴스를 선택하고 **Open Properties** 명령을 실행하면, Studio의 Properties 창과 같은 형태의 패널이 열립니다. `.props.json` 파일을 직접 편집하지 않고도 속성을 그룹별로 확인하고 수정할 수 있습니다.
-
-![Property Panel — Roblox Studio와 동일한 속성 편집 화면을 VSCode에서 사용](../../assets/screenshots/roblox-explorer/roblox-explorer-property-window.png)
-
-- **그룹별 표시**: Appearance, Behavior, Data, Part, Transform 등 Studio와 같은 분류로 속성을 정리합니다.
-- **타입 기반 에디터**: 숫자, 문자열, Boolean, Color, Vector3, Enum 등 속성 타입에 맞는 입력 위젯이 제공됩니다.
-- **파일 기반 편집**: 변경 내용은 해당 인스턴스의 `*.props.json` 파일에 저장되며, Sync의 reverse 경로를 통해 Studio로 반영됩니다(Pro, bidirectional 설정 시).
-- **커스텀 에디터 등록**: `.props.json` 파일을 직접 열면 기본 편집기 대신 Property Panel이 자동으로 연결됩니다.
-
-자동으로 Property Panel을 열고 싶다면 설정에서 `robloxExplorer.propertyPanel.autoOpen` 을 `true` 로 바꾸면 됩니다.
-
-## 인스턴스 검색
-
-`WEPPY Explorer: Search Instances` 명령(뷰 상단 아이콘 또는 Command Palette)을 사용하면 모든 서비스에 걸쳐 QuickPick 기반 검색을 할 수 있습니다.
-
-- 인스턴스 이름의 부분 일치로 빠르게 탐색
-- 결과 선택 시 트리에서 해당 항목으로 포커스 이동
-- 여러 Place가 동기화된 경우 Place별 네임스페이스에서 검색
-
-## 설정
-
-| 설정 | 기본값 | 설명 |
-|------|--------|------|
-| `robloxExplorer.mcpBaseUrl` | `""` | 로컬 MCP HTTP 베이스 URL. 비워두면 `http://127.0.0.1:3002`, `http://127.0.0.1:3003` 순으로 시도합니다. |
-| `robloxExplorer.syncRoot` | `""` | `weppy-project-sync` 루트 절대 경로. 비워두면 워크스페이스 폴더에서 자동 탐색합니다. |
-| `robloxExplorer.hidePropsFiles` | `false` | 기본 VSCode 탐색기에서 sync 파일(`.props.json`, `_tree.json`, `.value.json`)을 숨깁니다. |
-| `robloxExplorer.autoRefresh` | `true` | Sync 파일 변경 시 트리를 자동 새로고침합니다. |
-| `robloxExplorer.showSyncStatus` | `true` | 트리 항목에 Sync 상태 배지를 표시합니다. |
-| `robloxExplorer.followFocusCue` | `false` | 외부 focus cue 파일에 따라 트리를 자동으로 열고 관련 파일을 엽니다. |
-| `robloxExplorer.propertyPanel.autoOpen` | `false` | 트리에서 인스턴스 선택 시 Property Panel을 자동으로 엽니다. |
-
-## 명령어
-
-| 명령어 | 설명 |
-|--------|------|
-| `WEPPY Explorer: Refresh` | 인스턴스 트리 수동 새로고침 |
-| `WEPPY Explorer: Search Instances` | 모든 서비스에서 인스턴스 검색 |
-| `WEPPY Explorer: Open Backing File` | 선택한 인스턴스의 backing 파일 열기 |
-| `WEPPY Explorer: Open Properties` | 선택한 인스턴스의 Property Panel 열기 |
-| `WEPPY Explorer: Copy Instance Path` | 전체 인스턴스 경로 복사 (예: `game.Workspace.Part`) |
-| `WEPPY Explorer: Reveal in Explorer` | 기본 VSCode 탐색기에서 파일 위치 표시 |
-| `WEPPY Explorer: Collapse All` | 트리의 모든 노드 접기 |
-| `WEPPY Explorer: Open Settings` | Explorer 설정 페이지 열기 |
-
-## 문제 해결
-
-- **트리가 비어 있음**: `weppy-project-sync/place_*` 디렉토리가 존재하는지, Sync가 최소 한 번 Full Sync를 마쳤는지 확인하세요. 필요하다면 `robloxExplorer.syncRoot`를 수동 지정합니다.
-- **Sync 상태가 표시되지 않음**: 로컬 MCP 서버가 실행 중인지 확인하고, `robloxExplorer.mcpBaseUrl`을 명시적으로 설정해 보세요.
-- **Property Panel이 열리지 않음**: `.props.json` 파일이 기본 편집기로 열릴 경우, 파일 우클릭 메뉴에서 **Reopen Editor With... → WEPPY Property Panel**을 선택합니다.
-- **아이콘이 깨짐**: VSCode 테마를 다시 선택하거나 창을 재시작해 아이콘 캐시를 갱신합니다.
-
-## 함께 보면 좋은 문서
-
-- [Roblox MCP 설치 가이드](../installation/README.md)
-- [Sync 기능 상세 가이드](../sync/overview.md)
-- [Tool 지원 범위 (Tools Overview)](../tools/overview.md)