Tekst UI dla FiveM: Notatki źródłowe i konfiguracyjne

Tekst UI dla FiveM: Notatki źródłowe i konfiguracyjne

sc_textUI to niezależny od frameworka zasób FiveM NUI, który wyświetla klawisz interakcji i komunikat za pomocą eksportów klienta lub zdarzeń serwera. FiveMX sprawdził publiczne repozytorium ScubeScripts/sc_textUI 23 lipca 2026 w commicie e97687f41b97.

Zweryfikowany interfejs

Manifest identyfikuje wersję 1.0.0, deklaruje ui/textui.html jako swoją stronę NUI i eksporty showUI oraz hideUI. README dokumentuje wywołania klienta exports.sc_textUI:showUI(key, message) I exports.sc_textUI:hideUI(). Kod serwera może wywoływać odpowiadające mu zdarzenia klienta z identyfikatorem gracza, klawiszem i komunikatem.

Pakiet nie wymaga ESX ani QBCore w swoim manifeście. Jego plik README zawiera osobny przykład zastępowania funkcji ESX TextUI, dzięki czemu wiadomości takie jak Press [E] to use są dzielone na klucz i etykietę przed wywołaniem eksportu sc_textUI.

Instalacja i integracja

  1. Sklonuj lub pobierz repozytorium twórcy i przypnij przejrzany commit.
  2. Umieść sc_textUI w katalogu zasobów i dodaj ensure sc_textUI przed zasobami, które wywołują jego eksporty.
  3. Zastępuj jedną interakcję na raz i zachowaj oryginalne wywołanie UI dostępne do wycofania.
  4. Zawsze ukrywaj UI, gdy gracz opuszcza zasięg interakcji, zasób się zatrzymuje lub odpowiedni stan się zmienia.
  5. Przetestuj zarówno eksporty klienta, jak i wszelkie wiadomości wyzwalane przez serwer z normalnymi uprawnieniami gracza.

Sprawdzenie UX i wydajności

Sprawdź podpowiedzi w rozdzielczościach 16:9, ultrawide i mniejszych laptopach, z długim przetłumaczonym tekstem i różnym skalowaniem UI. Potwierdź, że podpowiedzi nie nakładają się, gdy dwa zasoby wywołują UI, i że przestarzała podpowiedź znika po śmierci, teleportacji, ponownym połączeniu lub restarcie zasobu.

Przykład w README zapętla się co klatkę, gdy marker jest w pobliżu. Jest to przykładowy kod integracji, a nie wymóg samego UI. Profiluj zasób, który posiada pętlę bliskości i unikaj duplikatów pętli z kilku systemów interakcji.

Licencja i status źródła

Repozytorium zawiera licencję GPL-3.0. Zachowaj jej informacje i zapoznaj się z obowiązkami przed dystrybucją zmodyfikowanej wersji. FiveMX nie przeprowadził formalnego testu wydajności; przegląd kodu źródłowego potwierdza interfejs i pliki, a nie kompatybilność z każdym UI lub wersją frameworka.

Powiązane wskazówki FiveMX

Dodaj komentarz