Dokumentacja RoCode

Czym jest RoCode

RoCode (RoCode.app) to agent AI do programowania w Roblox Studio. Opisujesz funkcję na czacie w przeglądarce na rocode.app. Potem darmowy plugin RoCode z Creator Store Roblox wykonuje kroki agenta w grze, którą masz otwartą: czyta obiekty i skrypty potrzebne w danym kroku, pisze Luau, tworzy lub edytuje Scripty, LocalScripty, ModuleScripty i inne instancje, a przed zakończeniem sprawdza w Studio, czy jego skrypty się kompilują.

DeepSeek V4 Flash, GLM 5.3 Flash, Claude Sonnet 5.5, Claude Opus 5.5 i GPT-6 Astra to modele innych firm, które RoCode uruchamia przez OpenRouter z własnymi instrukcjami i narzędziami Studio. RoCode nie ma własnych modeli.

RoCode (rocode.app) to nie Roo Code, rozszerzenie do VS Code, ani RoCodes.gg, ani rocode.org.

Wymagania

Nie potrzebujesz: aplikacji desktopowej, wiersza poleceń, plików konfiguracyjnych, serwera MCP ani hasła do Roblox. RoCode nigdy nie prosi o twoje hasło do Roblox.

Instalacja pluginu i parowanie z czatem

Instalacja i połączenie krok po kroku

1. Załóż darmowe konto. Zaloguj się na rocode.app kodem z e-maila, przez Google, Roblox lub Discord.
2. Zainstaluj plugin. Otwórz plugin RoCode w Creator Store i zainstaluj go. Zainstalowane pluginy pojawiają się w zakładce Plugins w Studio. W menedżerze pluginów Studio RoCode widnieje jako RoCode AI.
3. Zaakceptuj uprawnienia. Gdy Studio zapyta, zezwól na żądania HTTP do relay.rocode.app i na Script Injection. Tabela niżej wyjaśnia dlaczego.
4. Otwórz grę w Roblox Studio: taką, nad którą pracujesz, albo nowy Baseplate.
5. Otwórz czat. Otwórz rocode.app/chat w przeglądarce na komputerze. Jeśli w Studio jesteś zalogowany na to samo konto Roblox, którym zalogowałeś się w RoCode lub które do niego podpiąłeś, połączy się samo (plugin 3.9.13 lub nowszy). Jeśli czat pokazuje Connect Studio, kliknij.
6. Albo użyj kodu parowania. Jeśli Studio nie połączy się samo, panel RoCode pokaże 8-znakowy kod; jeśli go nie widzisz, kliknij Use a pairing code. Na karcie Connect to Roblox Studio na czacie wpisz kod i kliknij Connect.
7. Potwierdź w Studio. Po wpisaniu kodu panel RoCode pokazuje wiersz potwierdzenia z twoim kontem. Kliknij tam Connect (albo Allow). Panel czeka do 2 minut, a potem pokazuje nowy kod.

Uprawnienia Studio, o które prosi plugin

Jedno ustawienie Studio jest opcjonalne i należy do ciebie: Enable Studio Access to API Services. Potrzebujesz go, żeby testować zapis przez data stores w Studio, a RoCode nie może go zmienić za ciebie. W Studio otwórz File > Experience Settings > Security, włącz je i kliknij Save. Gra musi być wcześniej opublikowana. Studio używa wtedy tych samych data stores co gra na żywo, więc Roblox zaleca włączać to tylko w osobnej kopii testowej.

Jak działa parowanie

Od 27 września 2026 otwarty czat nie łączy już dowolnego Studio z tej samej sieci. Studio łączy się jednorazowym 8-znakowym kodem albo tylko wtedy, gdy jesteś w nim zalogowany na konto Roblox podpięte do twojego konta RoCode. Więcej szczegółów w dokumentacji po angielsku.

Twój pierwszy przebieg

Czat nie wyśle wiadomości, dopóki nie ma połączonego Studio: przycisk wysyłania jest nieaktywny, a po najechaniu myszką pokazuje Connect the plugin first. Gdy Studio jest połączone, opisz zmianę.

Napisz dobry pierwszy prompt

• Jedna funkcja naraz. Działa lepiej niż cała gra w jednej wiadomości.
• Powiedz, co ma się dziać, zwykłymi słowami. Nie potrzebujesz nazw klas ani wiedzy, gdzie trafiają skrypty.
• Wskaż to, co ważne. Wpisz / w polu wiadomości, żeby dołączyć dokładną ścieżkę obiektu ze Studio, na przykład skryptu, który chcesz zmienić. Przyciskiem + możesz też dołączyć do 12 plików tekstowych (łącznie 20 000 znaków) i do 4 obrazów na wiadomość, przy każdym modelu.
• Tylko pytanie? Przełącz pole wiadomości na Ask, a w twojej grze nic się nie zmieni.
• Albo podyktuj. Przycisk mikrofonu nagrywa twój prompt; transkrypcja pojawia się w polu wiadomości, żebyś mógł ją poprawić i wysłać.

Przykładowy prompt napisany przez nas. Nazwy narzędzi są prawdziwe, ale to, co zrobi przebieg, zależy od twojej gry. Z pluginem 3.9 lub nowszym RoCode może sam zrobić krótki test; zawsze możesz kliknąć Play w Studio, żeby sprawdzić wynik.

Gdzie RoCode umieszcza rzeczy

Co widzisz podczas pracy

• Dziennik krok po kroku. Czat pokazuje każdy krok z nazwą narzędzia. Każdy odczyt i każde usunięcie pojawia się ze swoją ścieżką.
• Ile to trwa. Zależy od zadania, rozmiaru twojej gry i modelu. Przebieg może trwać do 80 tur modelu albo 5 godzin. Czat pokazuje, ile kredytów zużywa przebieg w trakcie pracy.
• Następny prompt może czekać w kolejce. Gdy przebieg trwa, możesz dodać do kolejki następny prompt. Możesz mieć do 3 przebiegów naraz.
• Bez edycji w trakcie testu. Jeśli test trwa, gdy przychodzi pora na zmianę, RoCode najpierw zatrzymuje test, także taki, który uruchomiłeś ty. Jeśli Studio po 20 sekundach nadal jest w trybie Play, nic nie zmienia i prosi cię o kliknięcie Stop.

Zatrzymywanie i kontynuowanie

Przebieg możesz zatrzymać w każdej chwili. Jeśli przebieg zatrzyma się w połowie, przez błąd albo limit użycia, zmiany zrobione do tego momentu zostają, a Continue kontynuuje od miejsca, w którym się zatrzymał. Przebiegi, które zatrzymasz, liczą się do miejsca zatrzymania. Gdy przebieg nie uda się przez problem po naszej stronie, jego kredyty automatycznie wracają na twoje saldo.

Tryby Build i Ask

Każda wiadomość działa w jednym z dwóch trybów. Build jest domyślny i zmienia twoją grę. Ask, dodany 9 października 2026, odpowiada na pytania o twoją grę i niczego nie zmienia.

Żeby zmienić tryb, kliknij przełącznik trybu na pasku pod polem wiadomości i wybierz Ask albo Build. Wybór jest zapamiętywany w tej przeglądarce, więc sprawdź przełącznik przed wysłaniem zmiany. Ask też potrzebuje połączonego Studio, bo czyta twoją grę. Gdy Ask zaproponuje poprawkę, przełącz na Build i poproś o zmianę.

Sprawdzenia, Output i cofanie

Check Script przepuszcza skrypt przez kompilator Luau w Studio. Błąd kompilacji wraca z numerem linii i kolumny. Ostrzega też przed ryzykownymi wzorcami, takimi jak wait(), spawn() i delay() zamiast task.wait(), task.spawn() i task.delay(), loadstring, require, który nie wskazuje na ModuleScript, albo nazwa w GetService, która nie istnieje. Nie sprawdza typów, nie robi lintowania ani nie uruchamia twojego kodu, więc wykrywa błędy kompilacji i niektóre ryzykowne wzorce, a nie błędy logiki. Jeśli sprawdzenie się nie uda, RoCode nie może skończyć, dopóki kolejne nie przejdzie; po dwóch próbach może skończyć i mówi ci, co nadal nie działa.

Błędy z twoich testów. RoCode czyta Output Studio tylko wtedy, gdy wymaga tego dany krok, zwykle przez Check Output. Żeby naprawić problem, który znalazłeś sam: kliknij Play w Studio i odtwórz problem, powiedz RoCode, co się zepsuło (możesz wcześniej kliknąć Stop: linie Server i Client z ostatniego testu są zapisywane), pozwól mu przeczytać Output i poprawić skrypt, a potem znów kliknij Play, żeby to potwierdzić.

Krótki test. Z pluginem 3.9 lub nowszym przebieg Build może kliknąć Play na test do 30 sekund, zebrać błędy i ostrzeżenia serwera i klienta, a potem zatrzymać test. Robi to najwyżej dwa razy na przebieg, plus raz, żeby sprawdzić własną poprawkę. Z pluginem 3.9.11 lub nowszym postać testowa chodzi, skacze i staje na partach, a z 3.9.15 lub nowszym także naciska klawisze, klika przyciski na ekranie i pisze. Potem sprawdza, czy rzeczy się wydarzyły, i zgłasza każde sprawdzenie jako zaliczone albo niezaliczone. Nie wie, czy gra jest fajna.

Przegląd wizualny. Z pluginem 3.9.14 lub nowszym przebieg Build, który zbudował coś widocznego, przed zakończeniem robi zrzuty ekranu w Studio, w trybie edycji, a model AI szuka oczywistych problemów, takich jak party wiszące w powietrzu albo zapadnięte w ziemię, dziury czy zła skala, żeby agent poprawił te, które są prawdziwe. Czat nie pokazuje zrzutów ekranu, a RoCode ich nie zapisuje.

Cofanie. RoCode ustawia w Studio punkt cofania przed i po każdej grupie zmian, więc Ctrl+Z (⌘Z na Macu) cofa jego pracę grupa po grupie, dopóki Studio jest otwarte. Jeden przebieg to zwykle kilka grup. Przycisk Revert na czacie cofa tylko rozmowę, nie Studio.

Usuwanie. Od 9 października 2026 RoCode usuwa obiekt tylko wtedy, gdy wcześniej sam go utworzył w tym samym czacie, gdy twoja wiadomość prosi o jego usunięcie albo przebudowę, albo gdy zapytał cię i powiedziałeś tak. Z pluginem 3.8.5 lub nowszym usunięty obiekt nie jest niszczony: trafia do folderu RoCodeTrash w ServerStorage, który przechowuje usunięcia z 30 ostatnich przebiegów (do 25 000 obiektów). Szczegóły w Deletions (po angielsku).

Modele, kredyty i plany

Czym jest kredyt. Kredyt mierzy, ile kosztuje obliczenie przebiegu. Mocniejsze modele i dłuższe przebiegi zużywają więcej. Według obecnych stawek zaawansowane zadanie zużywa około 4 kredytów, a standardowe zadanie (DeepSeek V4 Flash) około 0,4. To daje w Pro około 35 zaawansowanych zadań miesięcznie albo 350 standardowych, w Studio około 80 lub 750, a w Ultra około 125 lub 1200. Długie zadania zużywają więcej. Z darmowym modelem 1 kredyt wystarcza na jedno lub dwa małe zadania.

• Każdy plan ma wszystkie 27 narzędzi. Płatne plany dodają więcej modeli, twój własny klucz OpenRouter i brak dziennego limitu, a ich przebiegi idą w kolejce przed przebiegami Startera. Płatne plany dostają też 2 darmowe kredyty dziennie z DeepSeek V4 Flash.
• Darmowe kredyty nie wymagają dołączenia do Discorda RoCode, płatny plan też nie.
• Kredyty Startera odnawiają się codziennie o 00:00 UTC; w planach miesięcznych co miesiąc, gdy zostanie przetworzona twoja płatność, a w planach rocznych co 30 dni. Kredyty z planu się nie kumulują.
• Pakiety kredytów, w każdym planie: 50 kredytów za 4,99 $, 220 za 19,99 $, 580 za 49,99 $ i 1200 za 99,99 $. Nigdy nie wygasają.
• Paddle obsługuje płatność jako sprzedawca (merchant of record). RoCode nie przechowuje danych kart. Jeśli masz mniej niż 18 lat, zapytaj właściciela karty przed zakupem.
• Pełny zwrot w ciągu 14 dni od każdej płatności, także odnowień i pakietów, z dowolnego powodu, gdziekolwiek mieszkasz. Zwrot zgłaszasz na paddle.net albo odpowiadając na potwierdzenie od Paddle. Po zwrocie nowe plany, zmiany planu na wyższy i pakiety są wstrzymane na 60 dni.

Zmiany planu na wyższy, inne zmiany planu i pełne porównanie są na stronie z cenami (po angielsku).

Bezpieczeństwo: do czego RoCode ma dostęp i jak to cofnąć

• Tylko serwer RoCode. Własne żądania pluginu idą tylko do relay.rocode.app, przez szyfrowane połączenie. Samo Studio łączy się z Roblox, żeby załadować modele z Creator Store, które wstawia Insert Model, a z pluginem 3.9.13 lub nowszym, żeby sprawdzić nazwę konta Roblox, na które jesteś w nim zalogowany.
• Nigdy twoje hasło. RoCode nigdy nie prosi o twoje hasło do Roblox i nigdy nie przesyła pliku twojej gry.
• Jedno okno Studio. Naraz z twoim kontem połączone jest tylko jedno okno Studio. Gdy wymaga tego dany krok, RoCode może odczytać dowolny obiekt lub skrypt gry otwartej w tym oknie, a to, co odczyta, przechodzi przez OpenRouter do dostawcy, który hostuje model.
• Bez publikowania i wydawania. Plugin nie ma kodu do publikowania ani zapisywania twojej gry, przesyłania assetów czy wydawania Robux. Insert Model wstawia tylko assety, które już istnieją w Creator Store, znalezione po twoich słowach albo po podanym przez ciebie ID assetu lub linku, i usuwa skrypty, które ma model.
• Tryb tylko do odczytu. Ask może używać tylko 10 narzędzi do odczytu, a serwer RoCode odrzuca każde narzędzie, które zmieniłoby twoją grę, zanim trafi do Studio.
• Twój klucz. Jeśli dodasz własny klucz OpenRouter, jest szyfrowany AES-256-GCM przed zapisaniem.
• Płatność. Płacisz w kasie Paddle, więc kartę podajesz w Paddle, a nie w formularzu RoCode.

Kto prowadzi RoCode: jednoosobowa działalność w Wielkiej Brytanii, działająca jako RoCode (zobacz warunki (po angielsku)); e-mail support@rocode.app. Pełne informacje o prywatności w sekcji Privacy and security (po angielsku).

Ograniczenia i to, czego RoCode nie robi

Czego RoCode dziś nie robi

• Nie ocenia, czy twoja gra jest fajna, ani nie gra w nią za ciebie poza własnymi krótkimi testami.
• Nie robi zrzutów ekranu, gdy twoja gra działa. Przegląd wizualny obejmuje tylko to, co zbudował przebieg Build, w trybie edycji.
• Nie rzeźbi ani nie maluje terenu ręcznie. Może zbudować Terrain (wzgórza, góry, jeziora, rzeki, wyspy i plaże) wygenerowanym skryptem; ręczne poprawki należą do ciebie.
• Nie generuje od zera meshy, tekstur ani animacji. Zamiast tego Insert Model wstawia modele, które już istnieją w Creator Store: znalezione po twoich słowach albo model, decal lub mesh po podanym przez ciebie ID assetu lub linku.
• Nie publikuje ani nie zapisuje twojej gry i nie zmienia ustawień twojego doświadczenia na stronie Roblox.
• Nie buduje skończonej, wyważonej gry z jednego zdania.
• Nie działa na telefonie.

Nie ma też narzędzi do game passów, developer products, przesyłania assetów ani włączania API Services. Pełna lista 27 narzędzi, 12 gotowych struktur i 7 układów interfejsu jest w The 27 tools (po angielsku), a wszystkie limity w Limits (po angielsku).

Rozwiązywanie problemów

Większość problemów z konfiguracją to jeden z tych przypadków. Jeśli twój nie, zapytaj na Discordzie RoCode, bo tam udzielamy wsparcia. Wszystkie przypadki są w Troubleshooting (po angielsku).

Najczęstsze pytania

Źródła i dalsza lektura

• Pełna dokumentacja RoCode (po angielsku). 27 narzędzi, prywatność i wszystkie limity
• Plugin RoCode w Creator Store Roblox. plugin opisany na tej stronie
• Ceny (po angielsku). wszystkie plany, pakiety kredytów i zwroty
• Warunki korzystania (po angielsku)
• Roblox Creator Docs: Data stores (po angielsku). włączanie dostępu Studio do API Services