Buduj z wykorzystaniem harnessu do kodowania

Ten przewodnik oraz towarzyszące wideo przeprowadzą Cię przez proces łączenia edytora kodu z obsługą AI z Roblox Studio za pośrednictwem MCP, aby Twój agent mógł czytać, pisać i testować grę w Twoim imieniu.

Na końcu będziesz mieć folder projektu, który synchronizuje się z Studio za pomocą Script Sync (funkcji, która pozwala na używanie własnego edytora do pisania kodu), połączenie MCP, które pozwala Twojemu agentowi bezpośrednio kontrolować Studio, oraz repozytorium Git gotowe do rozwoju.

Krok 1: Zainstaluj wymagane komponenty

Będziesz potrzebować następujących komponentów przed rozpoczęciem:

1. Edytor tekstu z obsługą AI - Najpopularniejsze opcje to Visual Studio Code i Cursor. Cursor ma wbudowanego asystenta AI, podczas gdy VS Code wymaga rozszerzenia, takiego jak Claude Code. Oba działają dobrze, więc wybierz ten, który wolisz.
2. Roblox Studio - Pobierz je z create.roblox.com.
3. Git - Zainstaluj go z git-scm.com.

   • Na Windowsie możesz użyć WinGet: winget install --id Git.Git -e --source winget.
   • Na macOS możesz użyć Homebrew: brew install git.

Krok 2: Zaloguj się wszędzie

1. Twój edytor tekstu:

   • VS Code — Proces logowania różni się w zależności od rozszerzenia. Dla Claude Code kliknij ikonę Claude w pasku aktywności, zaloguj się swoim kontem Anthropic i potwierdź, że panel czatu jest otwarty. Inni dostawcy działają podobnie.
   • Cursor — Otwórz Cursor, zaloguj się swoim kontem Cursor i potwierdź, że panel czatu jest otwarty. Możesz użyć dowolnego modelu, który wolisz.
2. Roblox Studio — Otwórz Studio, zaloguj się swoim kontem Roblox i potwierdź, że możesz utworzyć nowe miejsce.

Krok 3: Pobierz repozytorium startowe

Repozytorium startowe daje Ci układ folderów oraz plik .gitignore, aby Git zobowiązywał się tylko do części Twojego projektu, które mają znaczenie. Większość ręcznej konfiguracji jest już dla Ciebie przygotowana.

1. Pobierz repozytorium startowe i rozpakuj je. Już zawiera folder o nazwie WaveSurvival.
2. W swoim edytorze wybierz Plik → Otwórz folder i wybierz WaveSurvival. Powinieneś zobaczyć trzy foldery wewnątrz:

   • ServerScriptService/ zawiera skrypty serwerowe, takie jak logika gry, AI wrogów i zarządzanie falami.
   • ReplicatedStorage/ zawiera wspólne moduły, z których mogą korzystać zarówno serwer, jak i klient.
   • StarterPlayerScripts/ zawiera skrypty klienckie, które działają dla każdego gracza.

Pliki .gitkeep w każdym folderze są miejscami zajmowanymi, aby Git śledził foldery, gdy są one jeszcze puste.

Krok 4: Utwórz pusty projekt w Roblox Studio

1. Otwórz Roblox Studio i kliknij Nowe doświadczenie.
2. Wybierz Plik → Zapisz do pliku, przejdź do folderu WaveSurvival i zapisz miejsce jako WaveSurvival.rbxlx. .gitignore repozytorium startowego już wyklucza pliki .rbxlx z Gita.
3. Utrzymuj Studio otwarte. Będziesz go potrzebować do Script Sync i MCP.

Krok 5: Włącz wersję beta Script Sync

Script Sync jest funkcją beta, więc musisz ją włączyć, zanim będziesz mógł jej używać.

1. W Studio wybierz Plik → Funkcje beta.
2. Znajdź Script Sync, włącz go i kliknij Zapisz.
3. Uruchom ponownie Studio, gdy zostaniesz o to poproszony.

Krok 6: Połącz Script Sync

Łączysz Script Sync raz na projekt, powiązując każdą usługę Studio z odpowiadającym folderem na dysku.

1. W Eksploratorze kliknij prawym przyciskiem myszy ServerScriptService.
2. Wybierz Script Sync → Synchronizuj do, a następnie przeszukaj folder WaveSurvival.
3. Powtórz dla ReplicatedStorage i StarterPlayerScripts.

Wszystkie pliki .luau, które utworzysz w tych folderach, pojawią się teraz automatycznie jako skrypty w Studio.

Krok 7: Zweryfikuj Script Sync

W panelu czatu swojego edytora wywołaj swojego agenta:

W Studio sprawdź Eksplorator. Powinieneś zobaczyć Test pojawiający się pod ServerScriptService. Przeprowadzisz głębszą, napędzaną przez agenta kontrolę po połączeniu z MCP.

Krok 8: Włącz połączenie MCP

Serwer Studio MCP pozwala Twojemu agentowi AI interagować z Studio bezpośrednio, czytając drzewo gry, tworząc obiekty, uruchamiając skrypty i sprawdzając wyniki. Pokrywa wszystko, do czego Script Sync nie ma dostępu, takie jak StarterGui i StarterPack.

1. W Studio otwórz okno Asystenta, używając przycisku Asystent w prawym górnym rogu.
2. Kliknij ⋯ → Zarządzaj serwerami MCP.
3. Potwierdź, że MCP jest włączone.
4. Pod Szybkie połączenie, włącz Cursor lub Visual Studio Code.

Jeśli zainstalowałeś swój edytor podczas otwartego Studio, możesz potrzebować ponownie uruchomić Studio, swój edytor lub oba, aby nawiązać połączenie. Aby uzyskać więcej szczegółów, zobacz Połącz z serwerem MCP Roblox Studio.

Krok 9: Zweryfikuj połączenie MCP

Wywołaj swojego agenta:

Możesz potrzebować zatwierdzić polecenie lub dodać narzędzie MCP do listy dozwolonych. Dla świeżego szablonu Baseplate odpowiedź opisuje domyślny Camera, Terrain, Baseplate i SpawnLocation oraz potwierdza, że nie ma jeszcze innej zawartości.

Krok 10: Uruchom kontrolę end-to-end

Zwróć swojego agenta, aby jednocześnie zweryfikować pełną konfigurację:

Obserwuj w Studio, a zobaczysz, jak agent rozpoczyna testowanie, aby potwierdzić wyniki.

Krok 11: Zatwierdź do Gita

Teraz masz czystą, działającą konfigurację, co czyni to dobrym momentem na zatwierdzenie. Z terminala:

git add .
git commit -m "Połączono synchronizację skryptów i zweryfikowano MCP"

Następne kroki

Twój projekt jest teraz zsynchronizowany z Studio, twój agent AI może z nim rozmawiać bezpośrednio, a Ty masz repozytorium Git do śledzenia zmian i postępów.

Od teraz możesz używać pliku WAVE_SURVIVAL.md z projektu startowego jako kontekstu dla swojego agenta do budowy gry o przetrwaniu fal. Postępuj razem z towarzyszącym wideo, aby zbudować grę po jednej przetestowanej fazie na raz.