@weppy/roblox-mcp 1.0.0 → 1.0.2

package/.claude-plugin/marketplace.json

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

package/CHANGELOG.md

@@ -5,6 +5,34 @@ All notable changes to this project will be documented in this file.
 
 
 
+
+
+## [1.0.2] - 2026-02-23
+
+### Bug Fixes
+
+- handle blocked devices and improve graceful fallback for Pro license checks
+
+### Documentation
+
+- add script-based installation instructions to setup guides
+
+### Chores
+
+- update `.mcp.json` to use relative path for `mcp-server` startup script
+
+### Other Changes
+
+- update
+
+
+## [1.0.1] - 2026-02-23
+
+### Other Changes
+
+- refactor: standardize data directory path logic across modules
+
+
 ## [1.0.0] - 2026-02-23
 
 ### Sync

package/README.md

@@ -8,41 +8,65 @@
 
 ## What You Can Do
 
-### Create Complete Games
+### From One Idea to a Playable Game
 
-Just ask "Make a Minecraft-style survival game" or "Create an escape room puzzle game", and AI will design the game structure, build the map, create objects, and write scripts for you. Turn a simple idea into a playable game.
+"Make a Minecraft-style survival game with day/night, crafting, and wave defense." — One sentence and AI designs the game structure, builds the map, creates objects, and writes every script.
 
 > **Tip**: Ask "Make a plan first", review it, then say "Execute it" for better results.
 
-### Create and Place Objects
+### An AI That Has Read Your Entire Project
 
-Say "Make a red brick house" or "Plant 10 trees in a row" and AI creates them directly in Roblox Studio. Create one object or hundreds at once.
+AI syncs your Roblox project to local files, learning every script, object, and structure. Dozens of files understood at once, changed consistently.
 
-### Write and Modify Scripts
+- "Find every place that uses RemoteEvents and map out the call flow."
+- "Refactor all enemy AI scripts to use a unified state machine."
+- "Summarize only the risky changes made since yesterday."
 
-Ask "Make particles appear when players jump" or "Find the bug in this script" and AI writes and fixes code for you. It analyzes existing scripts and understands dependencies too.
+Manage multiple Places simultaneously. Track the full history of changes.
 
-### Set Scene Atmosphere
+### Scripts: Write, Refactor, Debug — Across Related Files
 
-Just say "Change to sunset vibes" or "Make it dark like a rainy day" and AI automatically adjusts lighting, sky, and fog.
+Not just the file you point at. AI handles the whole dependency chain.
 
-### Generate Terrain
+- "When the player jumps, add particles, a sound, and a cooldown."
+- "Find all event connections that could leak memory and fix them safely."
+- "Change this module's interface and update every script that references it."
 
-Create natural landscapes like mountains, rivers, plains, and caves through conversation. Customize materials, colors, and sizes freely.
+### Build and Place Objects — Hundreds at Once
 
-### Search and Insert Assets
+"Line up 50 street lights along this road", "Place 20 brick houses across the district with random rotations" — AI creates them directly in Studio. Batch-update properties across any number of objects with a single command.
 
-Search the Creator Store for free models and assets, then add them to your game instantly. Just say "Find a medieval castle model and insert it".
+### Lighting, Weather, and Atmosphere in One Sentence
 
-### Spatial Analysis and Placement
+"Change to a dusty desert at sunset", "Make it a stormy night where lightning briefly illuminates the area" — one sentence and lighting, sky, atmosphere, and fog all update at once.
 
-AI handles spatial tasks like "Find empty space in this area" or "Analyze where monsters can walk".
+### Sculpt Terrain Through Conversation
 
-### Debugging and Analysis
+"Mountains in the north, a river through the center, open plains in the south" — generate any landscape through conversation. Control material, color, height, and smoothing. Build entire maps without touching the terrain editor.
 
-Check game error logs, find problems, and fix them together with AI.
+### Search Creator Store and Place Instantly
 
-> [View all features](docs/en/tools/overview.md)
+"Find a medieval castle model, place it at the map center, and scale it up 1.5x" — search free assets and insert them directly into your project.
+
+### Spatial Intelligence for Level Design
+
+"Find open space for a new boss arena", "Show only the areas where monsters can actually patrol" — AI handles complex spatial reasoning and placement logic.
+
+### Animations, Physics, and Audio as Connected Systems
+
+- "While the dash animation plays, change the player-enemy collision rules."
+- "Fade in the boss BGM when the ultimate activates, and smoothly return when it ends."
+
+Characters, collision, and sound working together as a game system, not separate tools.
+
+### Run Any Roblox Code Directly
+
+When built-in tools aren't enough, AI executes arbitrary Luau in Studio.
+
+- "Find every Part in the Workspace with Anchored=false and list them."
+- "Batch-update matching objects and log every change."
+
+> [View all tools](docs/en/tools/overview.md)
 
 ## Getting Started
 
@@ -53,9 +77,9 @@ Installation is complete in two steps:
 
 Takes just 5 minutes. 👉 [View Installation Guide](docs/en/installation/README.md)
 
-## Go Pro
+## Pro Upgrade
 
-Build without limits. Bidirectional Sync, advanced build capabilities, and AI token efficiency — all in one upgrade.
+Bidirectional Sync, advanced build capabilities, and AI token efficiency — all in one upgrade.
 
 👉 [Pro Upgrade Guide](docs/en/pro-upgrade.md)
 

package/docs/es/README.md

@@ -1,52 +1,89 @@
 # Roblox MCP
 
-> Habla con la IA y se ejecuta directamente en Roblox Studio.
-
 [English](../../README.md) | [한국어](../ko/README.md) | [日本語](../ja/README.md) | **Español** | [Português](../pt-br/README.md) | [Bahasa Indonesia](../id/README.md)
 
+> Habla con la IA y se ejecuta directamente en Roblox Studio.
+
 [![Demo](https://img.youtube.com/vi/3jrUpBbZPaw/maxresdefault.jpg)](https://youtu.be/3jrUpBbZPaw)
 
 ## Qué puedes hacer
 
-### Crear juegos completos de una vez
-Puedes pedir cosas como "Crea un juego de supervivencia estilo Minecraft" o "Crea un juego de escape room", y la IA diseñará la estructura del juego, creará mapas, objetos y scripts por ti. Con una simple idea, puedes tener un juego jugable.
+### De una idea a un juego jugable
+
+"Crea un juego de supervivencia estilo Minecraft con ciclo día/noche, recolección, crafteo y defensa de oleadas." — Una frase y la IA diseña la estructura, construye el mapa, crea los objetos y escribe todos los scripts.
+
 > **Tip**: Pide primero "Haz un plan", revísalo y luego di "Ejecútalo" para obtener mejores resultados.
 
-### Crear y colocar objetos
-"Crea una casa de ladrillos rojos", "Planta 10 árboles en línea"
+### Una IA que ha leído todo tu proyecto
+
+La IA sincroniza tu proyecto de Roblox en archivos locales y aprende cada script, objeto y estructura. Docenas de archivos entendidos a la vez, modificados de forma consistente.
+
+- "Encuentra todos los lugares que usan RemoteEvents y mapea el flujo de llamadas."
+- "Refactoriza todos los scripts de IA enemiga para usar una máquina de estados unificada."
+- "Resume solo los cambios peligrosos realizados desde ayer."
+
+Gestiona múltiples Places simultáneamente. Rastrea el historial completo de cambios.
+
+### Scripts: escribir, refactorizar, depurar — en archivos relacionados a la vez
+
+No solo el archivo que señalas. La IA maneja toda la cadena de dependencias.
+
+- "Cuando el jugador salte, agrega partículas, sonido y cooldown."
+- "Encuentra todas las conexiones de eventos que podrían tener memory leaks y corrígelas de forma segura."
+- "Cambia la interfaz de este módulo y actualiza todos los scripts que lo referencian."
+
+### Crear y colocar objetos — cientos con un solo comando
 
-### Escribir y modificar scripts
-"Haz que salgan partículas cuando el jugador salte", "Encuentra el bug en este script"
+"Alinea 50 farolas a lo largo de esta carretera", "Coloca 20 casas de ladrillo por el distrito con rotaciones aleatorias" — la IA los crea directamente en Studio. Actualiza propiedades en cualquier número de objetos con un solo comando.
 
-### Configurar la atmósfera del mapa
-"Cámbialo a ambiente de atardecer", "Hazlo oscuro como un día lluvioso"
+### Iluminación, clima y atmósfera en una frase
 
-### Generar terrenos
-Crea terrenos naturales como montañas, ríos, llanuras y cuevas solo con conversación
+"Cambia a un desierto polvoriento al atardecer", "Hazlo una noche tormentosa donde los relámpagos iluminen brevemente el área" — una frase y la iluminación, el cielo, la atmósfera y la niebla se actualizan al mismo tiempo.
 
-### Buscar e insertar assets
-Busca e inserta modelos gratuitos del Creator Store. "Busca e inserta un modelo de castillo medieval"
+### Esculpe terreno a través de la conversación
 
-### Análisis espacial y colocación
-"Encuentra espacios vacíos en esta área", "Analiza el área donde los monstruos pueden caminar"
+"Montañas al norte, un río en el centro, llanuras abiertas al sur" — genera cualquier paisaje conversando. Controla material, color, altura y suavizado. Construye mapas enteros sin tocar el editor de terreno.
 
-### Depuración y análisis
-Revisa logs de errores, encuentra problemas y corrige
+### Busca en Creator Store y coloca al instante
 
-> [Ver lista completa de funciones](tools/overview.md)
+"Encuentra un modelo de castillo medieval, colócalo en el centro del mapa y escálalo 1.5x" — busca assets gratuitos e insértalos directamente en tu proyecto.
+
+### Inteligencia espacial para el diseño de niveles
+
+"Encuentra espacio abierto para una nueva arena del jefe", "Muestra solo las áreas donde los monstruos realmente pueden patrullar" — la IA maneja el razonamiento espacial complejo y la lógica de colocación.
+
+### Animaciones, física y audio como sistemas conectados
+
+- "Mientras se reproduce la animación de dash, cambia las reglas de colisión jugador-enemigo."
+- "Haz fade in del BGM del jefe cuando se activa el ultimate, y vuelve suavemente cuando termina."
+
+Personajes, colisión y sonido trabajando juntos como sistema de juego, no como herramientas separadas.
+
+### Ejecuta cualquier código de Roblox directamente
+
+Cuando las herramientas integradas no son suficientes, la IA ejecuta Luau arbitrario en Studio.
+
+- "Encuentra todas las Parts en el Workspace con Anchored=false y listarlas."
+- "Actualiza en lote los objetos coincidentes y registra cada cambio."
+
+> [Ver todas las herramientas](tools/overview.md)
 
 ## Comenzar
-1. **Instalar el plugin de Roblox Studio** — Conecta Studio con la IA
+
+La instalación se completa en dos pasos:
+
+1. **Instalar el plugin de Roblox Studio** — Hace de puente entre Studio e IA
 2. **Registrar el servidor MCP en tu app de IA** — Para que la app de IA lo reconozca
 
-Toma solo 5 minutos. 👉 [Ver guía de instalación](installation/README.md)
+Solo toma 5 minutos. 👉 [Ver guía de instalación](installation/README.md)
 
-## Comienza con Pro
+## Upgrade Pro
 
-Crea sin límites. Sync bidireccional, capacidades de creación avanzadas y eficiencia de tokens de IA — todo en una sola actualización.
+Sync bidireccional, capacidades de creación avanzadas y eficiencia de tokens de IA — todo en una sola actualización.
 
 👉 [Guía de actualización Pro](pro-upgrade.md)
 
 ## Enlaces
+
 - [GitHub](https://github.com/hope1026/roblox-mcp)
 - [Reportar problemas](https://github.com/hope1026/roblox-mcp/issues)

package/docs/id/README.md

@@ -8,39 +8,63 @@
 
 ## Yang Bisa Kamu Lakukan
 
-### Buat Game Sekaligus
+### Dari Satu Ide ke Game yang Bisa Dimainkan
 
-"Buatkan game survival gaya Minecraft", "Buatkan game puzzle escape room" — AI merancang struktur game dan membuat map, objek, dan script langsung di Studio kamu. Dari ide sederhana langsung jadi game yang bisa dimainkan.
+"Buatkan game survival gaya Minecraft dengan siklus siang/malam, penambangan, crafting, dan wave defense." — Satu kalimat dan AI merancang struktur game, membangun map, membuat objek, serta menulis semua scriptnya.
 
 > **Tip**: Minta "buat rencana dulu" lalu review dan katakan "jalankan" untuk hasil lebih baik.
 
-### Membuat dan Menempatkan Objek
+### AI yang Sudah Membaca Seluruh Proyekmu
 
-"Buatkan rumah dari batu bata merah", "Tanam 10 pohon berjajar rapi" — AI langsung membuatnya di Roblox Studio. Bisa satu-satu, bisa ratusan sekaligus.
+AI menyinkronkan proyek Roblox kamu ke file lokal dan mempelajari setiap script, objek, dan struktur. Puluhan file dipahami sekaligus, dimodifikasi secara konsisten.
 
-### Menulis dan Mengedit Script
+- "Temukan semua tempat yang menggunakan RemoteEvents dan petakan alur pemanggilannya."
+- "Refaktor semua script AI musuh untuk menggunakan state machine yang terpadu."
+- "Rangkum hanya perubahan berisiko yang terjadi sejak kemarin."
 
-"Kalau player jump, munculkan efek partikel", "Cariin bug di script ini" — AI menulis dan merevisi kode langsung. AI juga bisa menganalisis script yang sudah ada dan memahami dependencies-nya.
+Kelola beberapa Place secara bersamaan. Lacak seluruh riwayat perubahan.
 
-### Mengatur Suasana Map
+### Script: Tulis, Refaktor, Debug — File Terkait Sekaligus
 
-"Ubah jadi suasana sunset", "Bikin gelap kayak hujan" — satu perintah, AI atur lighting, sky, dan fog otomatis.
+Bukan hanya file yang kamu tunjuk. AI menangani seluruh rantai dependensi.
 
-### Membuat Terrain
+- "Saat player jump, tambahkan partikel + suara + cooldown."
+- "Temukan semua koneksi event yang bisa menyebabkan memory leak dan perbaiki dengan aman."
+- "Ubah interface modul ini dan perbarui semua script yang mereferensikannya."
 
-Gunung, sungai, dataran, gua — semua bisa dibuat lewat chat. Material, warna, ukuran juga bisa diatur sesuka hati.
+### Buat dan Tempatkan Objek — Ratusan dengan Satu Perintah
 
-### Mencari dan Memasukkan Aset
+"Jajarkan 50 lampu jalan sepanjang jalan ini", "Tempatkan 20 rumah bata di seluruh distrik dengan rotasi acak" — AI langsung membuatnya di Studio. Perbarui properti di sejumlah objek manapun dengan satu perintah.
 
-Cari model gratis dan aset dari Creator Store, langsung masuk ke game. "Cari model kastil abad pertengahan terus masukin" — sesimpel itu.
+### Pencahayaan, Cuaca, dan Atmosfer dalam Satu Kalimat
 
-### Analisis Ruang dan Penempatan
+"Ubah jadi padang pasir berdebu saat matahari terbenam", "Buat malam badai di mana kilat sesekali menerangi area" — satu kalimat dan pencahayaan, langit, atmosfer, serta fog semuanya berubah sekaligus.
 
-"Cari tempat kosong di area ini", "Analisis area yang bisa dilewati monster" — AI menangani semua urusan spasial.
+### Pahatan Terrain Melalui Percakapan
 
-### Debugging dan Analisis
+"Pegunungan tebing di utara, sungai di tengah, dataran terbuka di selatan" — hasilkan lanskap apapun melalui percakapan. Kontrol material, warna, ketinggian, dan penghalusan. Bangun seluruh map tanpa menyentuh terrain editor.
 
-AI bisa cek log error, cari masalahnya, dan memperbaikinya bareng kamu.
+### Cari di Creator Store dan Langsung Pasang
+
+"Temukan model kastil abad pertengahan, taruh di tengah map, dan perbesar 1.5x" — cari asset gratis dan masukkan langsung ke proyekmu.
+
+### Kecerdasan Spasial untuk Level Design
+
+"Cari ruang kosong untuk arena bos baru", "Tampilkan hanya area yang benar-benar bisa dipatroli monster" — AI menangani penalaran spasial kompleks dan logika penempatan.
+
+### Animasi, Fisika, dan Audio sebagai Sistem yang Terhubung
+
+- "Selama animasi dash diputar, ubah aturan tabrakan player-musuh."
+- "Fade in BGM bos saat ultimate aktif, dan kembali dengan mulus saat selesai."
+
+Karakter, tabrakan, dan suara bekerja bersama sebagai sistem game, bukan alat terpisah.
+
+### Jalankan Kode Roblox Apapun Secara Langsung
+
+Ketika tools bawaan tidak cukup, AI mengeksekusi Luau sembarang di Studio.
+
+- "Temukan semua Part di Workspace dengan Anchored=false dan listkan."
+- "Perbarui objek yang cocok secara massal dan catat setiap perubahan."
 
 > [Lihat daftar lengkap](tools/overview.md)
 
@@ -53,9 +77,9 @@ Instalasi cuma dua langkah:
 
 5 menit kelar. 👉 [Lihat panduan instalasi](installation/README.md)
 
-## Mulai dengan Pro
+## Upgrade Pro
 
-Bangun tanpa batas. Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.
+Sync dua arah, kemampuan kreasi lanjutan, dan efisiensi token AI — semua dalam satu upgrade.
 
 👉 [Panduan Upgrade Pro](pro-upgrade.md)
 

package/docs/ja/README.md

@@ -8,39 +8,63 @@
 
 ## できること
 
-### ゲームを一度に作成
+### アイデア一つで、プレイ可能なゲームまで
 
-「マインクラフト風のサバイバルゲームを作って」「脱出パズルゲームを作って」のようにリクエストすると、AIがゲーム構造を設計し、マップ、オブジェクト、スクリプトまで直接作成してくれます。シンプルなアイデア一つで、プレイ可能なゲームを完成できます。
+「マインクラフト風サバイバルゲームを作って。昼夜サイクル、採掘、クラフト、ウェーブディフェンスまで。」 — 一文でAIがゲーム構造を設計し、マップ・オブジェクト・スクリプトまで直接作ってくれます。
 
-> **ヒント**: 「まず計画を立てて」とリクエストしてから、計画を確認して「実行して」と指示すると、より完成度の高い結果が得られます。
+> **ヒント**: 「まず計画を立てて」とリクエストし、計画を確認してから「実行して」と指示すると、より完成度の高い結果が得られます。
 
-### オブジェクトの作成と配置
+### プロジェクト全体を読み込んだAI
 
-「赤いレンガの家を作って」「木を10本一列に植えて」のように言うと、AIがRoblox Studioに直接作成してくれます。一つずつ作ることもできますし、数百個を一度に作ることもできます。
+AIがRobloxプロジェクトをローカルに同期して、すべてのスクリプト・オブジェクト・構造を把握します。数十ファイルを一度に理解し、一貫して修正します。
 
-### スクリプトの作成と修正
+- 「RemoteEventを使っている場所を全部見つけて呼び出しフローを整理して。」
+- 「敵AIのスクリプト全体を統一したステートマシン構造にリファクタリングして。」
+- 「昨日以降に変更されたファイルの中でリスクの高い変更だけ要約して。」
 
-「プレイヤーがジャンプしたらパーティクルを出して」「このスクリプトのバグを見つけて」のようにリクエストすると、AIが直接コードを作成・修正します。既存のスクリプトを分析し、依存関係も把握してくれます。
+複数のPlaceを同時に管理し、変更履歴も追跡できます。
 
-### マップの雰囲気設定
+### スクリプトの作成・リファクタリング・デバッグ、関連ファイルまとめて
 
-「夕焼けの雰囲気に変えて」「雨の日のように暗くして」の一言で、照明、空、霧を自動的に調整します。
+指定したファイルだけでなく、依存関係にある全ファイルをまとめて処理します。
 
-### 地形の生成
+- 「プレイヤーがジャンプしたときにパーティクル + サウンド + クールタイムを追加して。」
+- 「メモリリークの可能性があるイベント接続を全部見つけて安全に修正して。」
+- 「このモジュールのインターフェースを変えて、参照している全スクリプトも一緒に更新して。」
 
-山、川、平原、洞窟などの自然地形を会話だけで作成できます。素材、色、サイズも自由に調整できます。
+### オブジェクトの作成と配置 — 数百個も一コマンドで
 
-### アセットの検索と挿入
+「この道に沿って街灯を50本間隔を揃えて立てて」「レンガの家20軒をエリアごとにランダムな向きで配置して」 — AIがStudioに直接作成します。複数オブジェクトのプロパティをまとめて変更するのも一コマンドで済みます。
 
-Creator Storeから無料モデルとアセットを検索して、すぐにゲームに追加できます。「中世の城のモデルを探して入れて」のように言うだけです。
+### 照明・天気・演出を一文で
 
-### 空間分析と配置
+「夕焼けのほこりっぽい砂漠の雰囲気に変えて」「嵐の夜で、稲妻の瞬間だけ周りが明るくなるようにして」 — 一言で照明、空、大気、霧が一括で自動変更されます。
 
-「このエリアの空きスペースを見つけて」「モンスターが歩き回れるエリアを分析して」のような空間関連の作業もAIが処理します。
+### 会話で彫刻する自然地形
 
-### デバッグと分析
+「マップ北部に断崖の山脈、中央に川、南部に広い平原を作って」 — 山、川、平原、洞窟を会話だけで生成できます。素材、色、高さ、滑らかさを自由に調整し、地形エディタを開かずにマップ全体を完成させられます。
 
-ゲームのエラーログを確認し、問題を見つけて修正するところまでAIと一緒にできます。
+### Creator Storeのアセットを検索してすぐに配置
+
+「中世の城のモデルを見つけてマップ中央に配置して、スケールを1.5倍にして」 — 無料アセットを検索してプロジェクトにすぐ追加できます。
+
+### 空間インテリジェンスでレベルデザインまで
+
+「新しいボスアリーナに使える空きスペースを見つけて」「モンスターが実際にパトロールできるエリアだけ表示して」 — 複雑な空間推論と配置ロジックをAIが処理します。
+
+### アニメーション・物理・オーディオ、ゲームシステムとして連携
+
+- 「ダッシュアニメーション再生中はプレイヤーと敵の衝突ルールを変えて。」
+- 「アルティメット発動時に専用BGMをフェードイン、終了時に自然に戻して。」
+
+キャラクター、衝突、サウンドをバラバラなツールではなくゲームシステムとして連携させます。
+
+### どんなRoblox APIも直接実行
+
+内蔵ツールで足りないときは、AIがStudio内で任意のLuauコードを直接実行します。
+
+- 「Workspace全体からAnchored=falseのパーツだけ見つけてリストにして。」
+- 「条件に合うオブジェクトを一括更新して、変更結果をログに残して。」
 
 > [全機能リスト](tools/overview.md)
 
@@ -53,9 +77,9 @@ Creator Storeから無料モデルとアセットを検索して、すぐにゲ
 
 5分で終わります。👉 [インストールガイド](installation/README.md)
 
-## Proで始めよう
+## Proアップグレード
 
-制限なく制作しましょう。双方向Sync、高度な制作機能、AIトークン効率 — 一度のアップグレードで全てを手に入れる。
+双方向Sync、高度な制作機能、AIトークン効率 — 一度のアップグレードで全てを手に入れる。
 
 👉 [Proアップグレードガイド](pro-upgrade.md)
 

package/docs/ko/README.md

@@ -8,39 +8,63 @@
 
 ## 이런 것들을 할 수 있어요
 
-### 게임 한번에 만들기
+### 아이디어 하나로, 플레이 가능한 게임까지
 
-"마인크래프트 스타일 서바이벌 게임 만들어줘", "방탈출 퍼즐 게임 만들어줘"처럼 요청하면, AI가 게임 구조를 설계하고 맵, 오브젝트, 스크립트까지 직접 만들어줍니다. 간단한 아이디어 하나로 플레이 가능한 게임을 완성할 수 있어요.
+"마인크래프트 느낌 서바이벌 게임 만들어줘. 낮/밤 사이클, 채집, 제작, 웨이브 방어까지." — 한 문장이면 AI가 게임 구조를 설계하고, 맵·오브젝트·스크립트를 직접 만들어줍니다.
 
-> **Tip**: "먼저 계획을 세워줘"라고 요청한 뒤, 계획을 확인하고 "실행해줘"라고 지시하면 더 완성도 높은 결과를 얻을 수 있습니다.
+> **Tip**: "먼저 계획을 세워줘"라고 요청한 뒤 계획을 확인하고 "실행해줘"라고 지시하면 더 완성도 높은 결과를 얻을 수 있습니다.
 
-### 오브젝트 만들기와 배치
+### 내 프로젝트를 처음부터 끝까지 읽은 AI
 
-"빨간 벽돌 집을 만들어줘", "나무 10그루를 일렬로 심어줘"처럼 말하면 AI가 Roblox Studio에 직접 만들어줍니다. 하나씩 만들 수도 있고, 수백 개를 한번에 만들 수도 있어요.
+AI가 Roblox 프로젝트를 로컬에 동기화해서 모든 스크립트·오브젝트·구조를 파악합니다. 수십 개 파일을 한번에 이해하고 일관되게 수정합니다.
 
-### 스크립트 작성과 수정
+- "RemoteEvent 쓰는 곳 전부 찾아서 호출 흐름 정리해줘."
+- "적 AI 관련 스크립트 전체를 상태 머신 구조로 통일해줘."
+- "어제 이후 바뀐 파일 기준으로 위험한 변경만 요약해줘."
 
-"플레이어가 점프하면 파티클이 나오게 해줘", "이 스크립트에서 버그 찾아줘"처럼 요청하면 AI가 코드를 직접 작성하고 수정합니다. 기존 스크립트를 분석하고, 의존성도 파악해줘요.
+여러 Place를 동시에 관리하고, 변경 이력도 추적합니다.
 
-### 맵 분위기 설정
+### 스크립트 작성·리팩터링·디버깅, 연관 파일까지 한번에
 
-"석양 분위기로 바꿔줘", "비오는 날처럼 어둡게 해줘" 한마디면 조명, 하늘, 안개를 자동으로 조절합니다.
+기능 추가, 버그 수정, 성능 개선을 스크립트 하나가 아니라 연관 파일까지 묶어서 처리합니다.
 
-### 지형 생성
+- "플레이어가 점프할 때 파티클 + 사운드 + 쿨타임 넣어줘."
+- "메모리 누수 가능성 있는 이벤트 연결 전부 찾아서 안전하게 고쳐줘."
+- "이 모듈을 참조하는 모든 스크립트와 함께 인터페이스를 바꿔줘."
 
-산, 강, 평원, 동굴 같은 자연 지형을 대화만으로 만들 수 있습니다. 재질, 색상, 크기도 자유롭게 조절하세요.
+### 오브젝트 생성과 배치 — 수백 개도 명령 하나로
 
-### 에셋 검색과 삽입
+"이 도로 따라 가로등 50개 간격 맞춰 세워줘", "벽돌 집 20채를 구역별로 랜덤 회전 배치해줘" — AI가 Studio에 직접 만들어줍니다. 여러 오브젝트의 속성을 한번에 변경하는 것도 명령 하나면 충분합니다.
 
-Creator Store에서 무료 모델과 에셋을 검색해서 바로 게임에 넣을 수 있습니다. "중세 성 모델 찾아서 넣어줘"처럼 말하면 돼요.
+### 조명·날씨·연출을 한 문장으로
 
-### 공간 분석과 배치
+"석양의 먼지 낀 사막 분위기로 바꿔줘", "폭풍우 치는 밤, 번개 순간에만 주변이 밝아지게 해줘" — 한마디면 조명, 하늘, 대기, 안개가 한번에 자동으로 바뀝니다.
 
-"이 영역에 빈 공간 찾아줘", "몬스터가 걸어다닐 수 있는 영역 분석해줘" 같은 공간 관련 작업도 AI가 처리합니다.
+### 대화로 조각하는 자연 지형
 
-### 디버깅과 분석
+"맵 북쪽에 절벽 산맥, 중앙엔 강, 남쪽엔 넓은 평원 만들어줘" — 산, 강, 평원, 동굴을 대화만으로 생성합니다. 재질, 색상, 높이, 부드럽기를 원하는 대로 조절하고, 지형 편집기를 열지 않고도 맵 전체를 완성할 수 있습니다.
 
-게임 에러 로그를 확인하고, 문제를 찾아서 수정하는 것까지 AI와 함께할 수 있습니다.
+### Creator Store 에셋 검색과 즉시 배치
+
+"중세 성 모델 찾아서 맵 중앙에 배치하고 스케일 1.5배로 맞춰줘" — Creator Store에서 무료 모델을 검색해서 프로젝트에 바로 넣어줍니다.
+
+### 공간 지능으로 레벨 디자인까지
+
+"새 보스 아레나 들어갈 빈 공간 찾아줘", "몬스터가 실제로 순찰 가능한 영역만 추려서 표시해줘" — 복잡한 공간 추론과 배치 로직을 AI가 처리합니다.
+
+### 애니메이션·물리·오디오, 게임 시스템으로 연결
+
+- "대시 애니메이션 재생 중엔 플레이어-적 충돌 규칙 바꿔줘."
+- "궁극기 발동 시 전용 BGM 페이드인, 종료 시 자연스럽게 복귀시켜줘."
+
+캐릭터 움직임, 충돌 규칙, 사운드를 따로따로가 아니라 게임 시스템으로 연결해서 다룹니다.
+
+### 어떤 Roblox API든 직접 실행
+
+"이건 내장 도구엔 없는데?" 싶은 순간에도, AI가 임의의 Luau 코드를 Studio에서 직접 실행합니다.
+
+- "Workspace 전체에서 Anchored=false인 파트만 찾아 목록으로 보여줘."
+- "조건 맞는 오브젝트 일괄 수정하고 변경 결과 로그 남겨줘."
 
 > [전체 기능 목록 보기](tools/overview.md)
 
@@ -53,9 +77,9 @@ Creator Store에서 무료 모델과 에셋을 검색해서 바로 게임에 넣
 
 5분이면 끝나요. 👉 [설치 가이드 보기](installation/README.md)
 
-## Pro로 시작하세요
+## Pro로 업그레이드
 
-제한 없이 제작하세요. 양방향 Sync, 고급 제작 기능, AI 토큰 효율 — 한 번의 업그레이드로 모두 누리세요.
+양방향 Sync, 고급 제작 기능, AI 토큰 효율 — 한 번의 업그레이드로 모두 누리세요.
 
 👉 [Pro 업그레이드 가이드](pro-upgrade.md)