Przetłumacz FiveM

Jak bezpiecznie tłumaczyć FiveM skrypty (ręcznie + AI)

Tłumacz istniejące wartości lokalne zasobu, zachowując klucze, symbole zastępcze, kody sterujące i składnię pliku. Ręczna edycja zapewnia maksymalną kontrolę; AI może przyspieszyć przeglądany pakiet. Żadna z tych metod nie pozwala na bezpieczne tłumaczenie każdego cytowanego ciągu w kodzie źródłowym.

Przeglądano 9 sierpnia 2026 r. w odniesieniu do oficjalnego Cfx.re dokumentacja manifestu zasobu I wytyczne dotyczące piaskownicy, bieżący instrukcja obsługi Notepad++ I dokumentacja DeepL.

Znajdź obsługiwany system lokalizacji

Przeczytaj dokumentację zasobu i fxmanifest.lua. Szukaj katalogów lokalizacji, słowników JSON/Lua, plików tłumaczeń NUI i ustawień języka. Użyj systemu dostarczonego przez twórcę. Nie dodawaj lua54 jako poprawki tłumaczenia; ta opcja manifestu jest przestarzała i niezwiązana z lokalizacją.

Wykonaj kopię zapasową i sporządź spis widocznych ciągów znaków

  1. Skopiuj zasób lub utwórz gałąź kontroli wersji.
  2. Zanotuj dokładną wersję i skonfigurowany język.
  3. Wymień etykiety widoczne dla graczy, powiadomienia, tekst menu i komunikaty pomocy.
  4. Wyklucz klucze, nazwy zdarzeń, polecenia, kolumny bazy danych, ścieżki plików i identyfikatory, chyba że dokumentacja wyraźnie oznaczy je jako możliwe do przetłumaczenia.
  5. Utwórz glosariusz dla terminów frameworka, prac, przedmiotów i terminologii serwera.

Metoda ręczna: edytuj tylko wartości

W edytorze świadomym składni, takim jak Notepad++, zmień czytelną dla człowieka wartość po prawej stronie, zachowując klucz i strukturę.

{
  "garage_open": "Open garage",
  "price_label": "Price: %s"
}

Dla innego języka, przetłumacz Open garage I Price, ale zachowaj garage_open, price_label I %s. Zachowaj sekwencje ucieczki, cudzysłowy, przecinki, nawiasy klamrowe, kody kolorów takie jak ~r~, oraz tokeny formatowania takie jak %s, %d Lub {name} dokładnie.

Metoda AI: wyślij ograniczoną partię tylko wartości

Dostarcz tylko wpisy lokalizacji potrzebne do tłumaczenia — nie cały prywatny zasób, konfigurację serwera, klucz licencyjny, webhook, dane gracza ani eksport bazy danych. Podaj język źródłowy i docelowy, glosariusz i niezmienne tokeny. Wymagaj tego samego ustrukturyzowanego formatu i poproś model o pozostawienie kluczy i wszystkich symboli zastępczych bez zmian.

Wyjście AI jest wersją roboczą. Modele mogą zmienić nazwę klucza, zmodyfikować interpunkcję, przetłumaczyć polecenie, pominąć symbol zastępczy lub zwrócić nieprawidłowy JSON/Lua, brzmiąc przy tym pewnie. Przejrzyj różnice wpis po wpisie.

Zweryfikuj przed uruchomieniem zasobu

  • Przetwórz JSON za pomocą parsera JSON i Lua za pomocą obsługiwanego przepływu pracy lint/test projektu.
  • Porównaj kompletny zestaw kluczy z lokalizacją źródłową.
  • Sprawdź dokładne dopasowanie symboli zastępczych i kodów sterujących dla każdego wpisu.
  • Szukaj przypadkowych zmian w poleceniach, nazwach zdarzeń i adresach URL.
  • Sprawdź różnice pod kątem dodanych komentarzy lub znaczników Markdown.

Testuj w UI

Uruchom przetłumaczoną lokalizację na stagingu i przejdź przez każdy widoczny przepływ: menu, powiadomienie, błąd, potwierdzenie, walidacja danych wejściowych i tekst pomocy. Sprawdź przycinanie, podziały wierszy, znaki akcentowane, błędy związane z liczbą mnogą/kontekstem oraz zachowanie od prawej do lewej, jeśli dotyczy. Przejrzyj logi przeglądarki/NUI, F8 i serwera.

Zbuduj pamięć tłumaczeń wielokrotnego użytku

Przechowuj zatwierdzone pary źródło/wartość, decyzje dotyczące glosariusza i notatki recenzenta poza pakietem dostawcy. Gdy zasób się zaktualizuje, porównaj nową lokalizację źródłową z poprzednią wersją i tłumacz tylko dodane lub zmienione klucze. Nigdy nie nadpisuj nowej lokalizacji dostawcy w ciemno starym pełnym plikiem.

Bezpiecznie wycofaj zmiany

Zachowaj oryginalną lokalizację i konfigurację. Jeśli wystąpi regresja w parsowaniu, UI lub zachowaniu w czasie działania, przywróć znane dobre pliki, zrestartuj zasób i potwierdź, że domyślny język działa. Popraw tłumaczenie w nowej wersji, zamiast edytować produkcję bez porównania różnic.

Dodaj komentarz