Edytor skryptów

Edytor skryptów w Studio jest głównym narzędziem do skryptowania w Roblox. To samodoskonalące się środowisko, które może pomóc Ci pisać kod o dużym wpływie, skrócić czas rozwoju i iterować w swoich grach. Może poprawić Twoje doświadczenie w skryptowaniu poprzez:

• Formatowanie i podświetlanie składni w Twoim kodzie.
• Oferowanie sposobów na autouzupełnianie fraz w Twoim kodzie podczas pisania.
• Pomaganie w nawigacji po kodzie poprzez skakanie do deklaracji zmiennych i funkcji.
• Pomaganie w znajdowaniu i zamienianiu kodu w otwartych skryptach lub wszystkich skryptach.
• Zapewnienie informacji zwrotnej w czasie rzeczywistym na temat jakości i wydajności Twojego kodu.

Edytor skryptów obsługuje wszystkie typy skryptów i otwiera się automatycznie, gdy tworzysz nowy skrypt lub dwukrotnie klikasz istniejący skrypt w oknie Eksploratora.

Funkcje autouzupełniania

Funkcje autouzupełniania Edytora skryptów generują informacje związane z kodem, które mogą poprawić Twoją efektywność programowania, takie jak:

• Informowane sugestie dotyczące tego, jak dokończyć frazy podczas ich pisania, które są kontekstowe dla modelu danych gry. Na przykład, jeśli masz Model w Workspace o nazwie RocketShip, autouzupełnianie sugeruje RocketShip, gdy wpisujesz workspace.roc i wskazuje, że jest to Model.

  

  Użyj klawiszy ↑ i ↓, aby przeglądać sugestie, a następnie naciśnij Tab lub Enter, aby zaakceptować sugestię i wstawić pełną frazę.

• Autouzupełnianie nazw dla zmiennych i funkcji, które deklarujesz, pomagając uniknąć uciążliwych literówek.

  

• Wyskakujące okna dokumentacji z przykładami kodu, które są podobne do tych w Dokumentacji API silnika, dając Ci kontekst dotyczący użycia API.

  

• Podpowiedzi najeżdżane myszką, które możesz dostosować własną zdefiniowaną dokumentacją.

  

• Diagnostyka analizy skryptów najeżdżana myszką z informacjami, które możesz wykorzystać do rozwiązywania błędów.

  

• Podpisy funkcji podczas wpisywania argumentu, dostarczając Ci odniesienia do jej parametrów i wartości zwracanych.

  

Nawigacja po kodzie

Przejdź do deklaracji

Możesz skoczyć do deklaracji funkcji lub zmiennej, przytrzymując Ctrl na Windows lub ⌘ na Mac, gdy klikniesz wywołanie, lub klikając prawym przyciskiem myszy jego wywołanie i klikając Przejdź do deklaracji.

Filtr funkcji skryptu

Filtr funkcji skryptu wyświetla listę wszystkich funkcji zadeklarowanych w skrypcie. Aby go otworzyć, naciśnij AltF na Windows lub ⌥F na Mac. Gdy lista jest otwarta, możesz przeglądać podpisy każdej funkcji, filtrować je według nazwy i dwukrotnie kliknąć jedną, aby skoczyć do jej deklaracji.

Znajdź i zamień

Widget Znajdź/Zamień pozwala na znajdowanie i zamienianie kodu w otwartym skrypcie. Widget obsługuje dopasowywanie wielkości liter, dopasowywanie całego słowa oraz wyszukiwanie za pomocą wyrażeń regularnych. Aby go otworzyć, naciśnij CtrlF na Windows lub ⌘F na Mac.

Informacja zwrotna w czasie rzeczywistym

Analiza skryptów

Okno Analiza skryptów, dostępne przez przycisk Analiza w pasku narzędzi zakładki Skrypt w Studio, wykonuje analizę statyczną Twoich skryptów i wyświetla aktywne błędy i ostrzeżenia. Aby uzyskać więcej informacji na temat błędów i ostrzeżeń, zobacz dokumentację Linting Luau.

Wyjście

Okno Wyjście wyświetla błędy zarejestrowane podczas uruchamiania skryptów, wiadomości z silnika Roblox, wiadomości z wywołań do print(), oraz błędy z wywołań do warn().

Asystent kodu

Asystent kodu to funkcja, która sugeruje linie lub funkcje kodu podczas pisania, pomagając Ci kodować bardziej efektywnie i skupić się. Na podstawie kontekstów z Twojego komentarza i kodu, sugestie będą wyzwalane na dwa sposoby:

• Automatycznie, gdy zatrzymasz się na linii na kilka sekund, a model AI ma wystarczająco dużo kontekstu do sugestii.
• Ręcznie za pomocą skrótu Alt∖ na Windows lub ⌥∖ na Mac.

Naciśnij Tab, aby zaakceptować sugestię, lub zignoruj ją, kontynuując pisanie. Obecnie Twój skrypt musi zawierać przynajmniej kilka linii kodu, aby wyzwolić sugestię.

Poprawa sugestii

Aby uzyskać dokładniejsze i bardziej odpowiednie sugestie, zaleca się przestrzeganie zasad czystego kodowania, niezależnie od pomocy, i:

• Dzielić swój kod na mniejsze funkcje.
• Używać opisowych nazw skryptów, które oddają ogólny zamiar tego, co każdy skrypt robi. Na przykład, nazwij skrypt SyncCustomSounds zamiast po prostu Sounds.
• Przypisywać opisowe nazwy dla parametrów, funkcji i skryptów. Na przykład, nazwij część GreenSphere zamiast po prostu grs, lub nazwij funkcję generateSphere() zamiast gen(). Używanie nazwanych funkcji w porównaniu do funkcji anonimowych może również przynieść lepsze wskazówki.
• Konsekwentnie dodawać dobrze napisane komentarze, które opisują zadanie, które wdrażasz oraz jakie powinny być wejścia/wyjścia.

  • Rozważ dodanie kilku przykładowych wywołań z oczekiwanymi wynikami w komentarzach.
  • Sugeruj, jak rozwiązać problem, na przykład -- Użyj raycast.
  • Użyj dokładnej nazwy funkcji lub zmiennej, którą zdefiniowałeś, na przykład -- Utwórz 10 obiektów greenSphere zamiast -- Utwórz 10 sfer.
• Jeśli jesteś początkującym skryptowcem, zacznij od podstawowych projektów, takich jak "spraw, aby gracz skakał, gdy dotknie części" lub użyj narzędzia do generowania małych fragmentów kodu, które możesz rozwijać w miarę wzrostu swojej wiedzy.

Ograniczenia

Narzędzie pomaga zautomatyzować podstawowe zadania kodowania, ale nie zawsze sugeruje idealny kod. Znane ograniczenia obejmują:

• Ręczne wyzwalanie nie zawsze wymusza wygenerowanie sugestii.
• Sugestie są uczone maszynowo na podstawie korpusu kodu i mogą odzwierciedlać pewne ograniczenia kodu, na którym są trenowane. Na przykład, sugestie mogą nie używać nowszych API na rzecz starszych API, lub mogą używać Lua zamiast Luau.
• Narzędzie może generować niepoprawne lub mylące informacje, które nie są przydatne dla Twojego celu.
• Wewnętrzne filtry próbują blokować obraźliwy język, ale nie są wszechobecne i istnieje możliwość, że narzędzie może generować obraźliwe lub stronnicze informacje.
• Sugestie mogą być takie same, podobne lub różne wśród użytkowników, nawet przy tych samych podpowiedziach. Twój kod jednak nigdy nie będzie dzielony z innymi.
• Sugestia może być niekompletna z powodu ograniczonej długości wyjścia z modeli uczenia.
• Istnieje dzienny limit liczby sugestii, a po osiągnięciu limitu nie otrzymasz żadnych sugestii do następnego dnia.

Prywatność kodu

Obecnie Roblox nie używa żadnych danych niepublicznych do trenowania modeli uczenia. Narzędzie korzysta tylko z małego podzbioru darmowych zasobów rynkowych do dostrajania dużych modeli językowych, a podzbiór przeszedł różne kontrole jakości i filtrów bezpieczeństwa.

Ponadto wszystkie sugestie są generowane przez model AI i nie przenoszą się z jednego użytkownika do drugiego. Ponieważ Twój kod nie jest używany do trenowania modelu, nie będzie sugerowany innym użytkownikom Asystenta kodu, z jednym wyjątkiem kodu publikowanego w darmowych przedmiotach rynkowych.

Wielokrotny kursor

Edytor skryptów obsługuje użycie wielu kursorów, aby dokonywać edycji jednocześnie. Możesz dodawać kursory w zależności od swoich potrzeb za pomocą kliknięcia myszą lub skrótu klawiaturowego. Początkowy kursor nazywa się głównym kursorem, a dodatkowe kursory nazywają się drugorzędnymi kursorami.

• Edycje, które dokonujesz na głównym kursorze, kopiują się do drugorzędnych kursorów. Każda edycja liczy się jako jedna akcja, więc cofnięcie/ponowne wykonanie edycji dotyczy wszystkich kursorów.
• Widgety, takie jak autouzupełnianie, pojawiają się na głównym kursorze, ale nie na drugorzędnych kursorach.
• Wszystkie standardowe skróty klawiaturowe do edytowania skryptów działają z edytowaniem wieloma kursorami, w tym wcięcia kodu, przełączania komentarzy i usuwania linii.

Poniższa tabela podsumowuje przepływy pracy z wieloma kursorami i ich skróty.

Dodawanie kursorów

Możesz dodawać kursory za pomocą kombinacji skrótów klawiaturowych i ruchów myszą. Kursory łączą się, jeśli zajmują tę samą przestrzeń, na przykład, jeśli dodasz kursory za pomocą klawiszy strzałek lub usuniesz wszystkie znaki między kursorami.

W lokalizacji myszy

Aby dodać kursor w lokalizacji wskaźnika myszy:

1. Przytrzymaj Alt na Windows lub ⌥ na Mac.

2. Kliknij, gdzie chcesz dodać kursor.

Przy przeciąganiu myszy

Możesz przeciągnąć mysz, aby dodać kursor do wyboru, podzielić wieloliniowy wybór na linie lub wybrać kolumny i bloki kodu/białych znaków.

Aby dodać kursor do wyboru kodu poprzez przeciąganie:

1. Przytrzymaj Alt na Windows lub ⌥ na Mac.

2. Kliknij i przeciągnij myszą po wyborze kodu.

Powyżej i poniżej głównego kursora

Aby dodać kursor bezpośrednio powyżej lub poniżej głównego kursora:

1. Naciśnij i przytrzymaj CtrlAlt na Windows lub ⌘⌥ na Mac.

2. Naciśnij strzałki ↑ lub ↓.

Do dopasowanych wyborów

Możesz dodać kursory do wszystkich dopasowań wyboru lub do następnego/poprzedniego dopasowania, a opcjonalnie przełączać, czy dopasowania mają być wrażliwe na wielkość liter i/lub dopasowywać całe słowo.

Aby dodać kursor do wszystkich dopasowań wybranego fragmentu:

1. Wybierz kod, którego chcesz szukać w dopasowaniach.

2. Naciśnij ShiftAltL na Windows lub Shift⌥L na Mac.

Usuwanie kursorów

Możesz usunąć kursory za pomocą następujących skrótów klawiaturowych i ruchów myszą. Alternatywnie, możesz wyjść z edytowania wieloma kursorami, naciskając Esc.

W lokalizacji myszy

Aby usunąć kursor:

1. Przytrzymaj Alt na Windows lub ⌥ na Mac.

2. Kliknij kursor, który chcesz usunąć.

Ostatnio dodany

Aby usunąć ostatnio dodany kursor, naciśnij CtrlU na Windows lub ⌘U na Mac.

Kopiowanie i wklejanie kursorów

Kopiowanie wyboru kodu obejmuje kursory w nim. Zachowanie wklejania zależy od liczby kursorów w źródle i liczby kursorów w miejscu docelowym:

• Jeśli liczba kursorów jest taka sama, każdy skopiowany kursor wkleja się do każdego odpowiadającego kursora docelowego.
• Jeśli liczba kursorów jest różna, każdy kursor w miejscu docelowym otrzymuje całe wklejenie z każdym skopiowanym kursorem jako nową linię.

Formatowanie podczas pisania

Naciśnięcie enter/return automatycznie wciśnie każdy kursor w nowej linii w stosunku do poprzedniej linii. Jeśli poprzednia linia zaczyna się od niekompletnego bloku, formatter spróbuje go dokończyć.

Ustawienia edytora

Wiele opcji dostosowywania jest dostępnych za pośrednictwem zakładki Edytor skryptów w Ustawieniach Studio. Często modyfikowane opcje obejmują:

Skróty klawiaturowe

Edytor skryptów ma następujące skróty klawiaturowe.