Wróć do bloga
Scripts3 min czytania

Agency-Banking: Kompletny bank dla FiveM, z frameworkiem lub bez

Portfel, karty, przelewy, lokaty terminowe, handel akcjami i krypto, PIN do bankomatu. Agency-Banking działa na QBCore, Qbox, ESX lub standalone z exportami pieniędzy.

Agency Scripts

Założyciel i główny deweloper w Agency Scripts

Dokumentacja

Konfiguracja, exporty i eventy Agency-Banking w jednym miejscu.

Otwórz Docs

Kompletny bank dla twojego miasta

Agency-Banking zamienia każdy oddział banku i bankomat w pełnoprawną aplikację bankową. Gracze widzą stan konta i gotówkę obok siebie, przesyłają pieniądze oraz zarządzają kartami, lokatami terminowymi i inwestycjami w jednym miejscu. Działa na QBCore, Qbox lub ESX, a na serwerze bez frameworka prowadzi własne konta. Jedynym wymaganym resource jest oxmysql.

Wszystko w menu

  • Portfel: saldo bankowe i gotówka, wpłaty i wypłaty.
  • Przelewy: według ID serwera lub graczowi stojącemu w pobliżu.
  • Karty: karty bankowe w czterech motywach.
  • PIN do bankomatu: blokuje się na 60 sekund po pięciu nieudanych próbach.
  • Lokaty terminowe: Domyślnie 7, 14 lub 30 dni, według stawek z konfiguracji serwera, nigdy od gracza.
  • Rynki: handel akcjami i kryptowalutami.
  • Dziennik aktywności: pełna historia konta.

Wykryto framework lub standalone

Ustaw opcję frameworka na auto, a bank sam wykryje QBCore, Qbox lub ESX, nawet jeśli uruchomi się później. Przy każdym starcie konsola serwera informuje, jaki framework został wykryty lub że bank działa w trybie standalone. Tryb standalone jest wybierany tylko wtedy, gdy żaden z nich nie jest zainstalowany.

W trybie standalone gracze są identyfikowani po licencji Rockstar, a administratorzy pobierani z ACE lub listy licencji w pliku config. Stan konta i gotówka są przechowywane bezpośrednio przez bank. Po zainstalowaniu Agency-Phone telefon i bank współdzielą to samo saldo, a serwery z własnym systemem ekonomii mogą go połączyć za pomocą kilku hooków w pliku config.

System pieniędzy dla twoich pozostałych skryptów

Exporty serwera działają tak samo na każdym frameworku. Na serwerze standalone stanowią one system pieniędzy: sklep, praca lub garaż wypłaca i pobiera środki od graczy przez bank, a otwarty bank natychmiast pokazuje nowe saldo.

-- pay a player into their bank account
exports['Agency-Banking']:AddBankMoney(source, 500, 'Paycheck')

-- charge a player: returns false and takes nothing if the balance is too low
if not exports['Agency-Banking']:RemoveBankMoney(source, 150, 'Garage fee') then
    -- not enough money
end

Ta sama para istnieje dla gotówki z AddCashMoney i RemoveCashMoney, obok GetBankBalance, GetCashBalance, AddTransaction dla dziennika aktywności oraz GetFramework. W QBCore i ESX otwarty bank sam śledzi zmiany stanu konta frameworka. Po każdej innej zmianie wywołaj agency_banking:client:MoneyChanged dla tego gracza.

Sprawdzono na serwerze

Wypłaty, oprocentowanie, lokaty terminowe, karty i transakcje są sprawdzane po stronie serwera, więc zmodyfikowany klient nie może tworzyć pieniędzy ani manipulować kartami innych graczy. Parowanie z Companion nie daje żadnych uprawnień bankowych: każda operacja finansowa z aplikacji jest ponownie walidowana na serwerze.

Dwa projekty i suwak rozmiaru

Menu jest zgodne z designem Agency: solidny ciemny panel, złote akcenty, zaokrąglone przyciski i złote podświetlenie przesuwające się wzdłuż paska bocznego. Serwery, które wolą klasyczny niebieski wygląd, przełączają ustawienie designu na v1 i zachowują wszystkie funkcje.

Każdy gracz może skalować bank od 60 do 150 procent co 1 procent w Ustawieniach, a każdy gracz zachowuje swój własny rozmiar. Bank obsługuje 13 języków i otwiera się przy znacznikach lub przez qb-target lub ox_target.

Instalacja i aktualizacje

Import SQL nie jest wymagany: każda tabela, kolumna i indeks są tworzone przy pierwszym uruchomieniu na MariaDB i MySQL 8. Dołączony agency_banking.sql jest tylko dla serwerów, których użytkownik bazy danych nie może tworzyć tabel. Domyślnie /openbank jest tylko dla administratorów, a jeden przełącznik w konfiguracji udostępnia to każdemu graczowi.

Aktualizacje są bezpłatne dla każdego, kto posiada już Agency-Banking. Konta, karty, transakcje, lokaty terminowe i powiązania Companion pozostają nienaruszone po aktualizacji. Użyj nowego pliku config.lua zamiast kopiować stary i uruchom komendę refresh przed restartem zasobu, jeśli manifest uległ zmianie.

Bankowość na prawdziwym telefonie

Agency-Banking łączy się z darmową aplikacją Agency Companion na iOS i Androida, samodzielnie i niezależnie od Agency-Phone: saldo, przelewy, karty, lokaty terminowe i PIN do bankomatu w trasie. Gracze parują się z /abconnect, krótki /abc, lub za pomocą kodu QR w menu banku.

Zdobądź Agency-Banking

Agency-Banking jest dostępny w Sklep Agency Scripts, a dokumentacja obejmuje konfigurację, exports i events.

Pasujący skrypt

Gotowe na twój serwer, aktualizacje w zestawie.

Gotowy, aby zacząć?

Kup skrypty w naszym sklepie lub dołącz do Discorda, aby uzyskać wsparcie, aktualizacje i sprawdzić nadchodzące nowości.