Agency-Banking
Kompletny bank dla FiveM działający na QBCore, Qbox, ESX lub w pełni standalone.

01Przegląd
Kompletny bank dla FiveM działający na QBCore, Qbox, ESX lub w pełni standalone. Gracze otrzymują portfel z kontem bankowym i gotówką, karty bankowe w czterech motywach, przelewy po ID lub do pobliskich graczy, lokaty terminowe z oprocentowaniem ustalanym przez serwer, handel akcjami i kryptowalutami, PIN do bankomatu oraz pełny rejestr aktywności. Bez frameworka bank prowadzi własne konta, a inne zasoby mogą używać go jako systemu pieniędzy poprzez exporty serwera. Dwa wyglądy menu, 13 języków, markery lub qb-target / ox_target, suwak rozmiaru interfejsu dla każdego gracza, tabele tworzące się automatycznie przy pierwszym uruchomieniu oraz darmowa aplikacja Agency Companion do sprawdzania salda, przelewów, lokat i kart w podróży.
02Funkcje
+Warto wiedzieć
Agency-Banking to kompletny bank dla serwerów FiveM. Działa na QBCore, Qbox lub ESX, a na serwerze bez frameworka prowadzi własne konta. Gracze zarządzają swoimi pieniędzmi w oddziałach banków i bankomatach: portfel ze stanem konta i gotówką, karty bankowe w czterech motywach, przelewy, lokaty terminowe, handel akcjami i kryptowalutami oraz pełny dziennik aktywności. Tabele w bazie danych są tworzone przy pierwszym uruchomieniu, a darmowa aplikacja Agency Companion przenosi saldo, przelewy, lokaty terminowe i karty na prawdziwy telefon gracza.
- Każdy framework lub żaden
- Przy Config.Framework = 'auto' bank sam wykrywa QBCore, Qbox lub ESX i korzysta z ich pieniędzy. Dopiero gdy żaden z nich nie jest zainstalowany, przełącza się na standalone: gracze są identyfikowani po licencji Rockstar, a salda znajdują się we własnej tabeli banku, współdzielonej z Agency Phone, jeśli jest zainstalowany, lub w twoich własnych funkcjach poprzez Config.Standalone.
- Wszystko, czego gracze oczekują od banku
- Portfel wyświetla stan konta bankowego i gotówkę obok siebie. Gracze mogą wpłacać i wypłacać środki, przesyłać pieniądze za pomocą ID na serwerze lub do osoby stojącej w pobliżu, tworzyć karty bankowe w czterech motywach oraz zabezpieczać bankomat kodem PIN, który blokuje się na 60 sekund po pięciu błędnych próbach. Lokaty terminowe trwają domyślnie 7, 14 lub 30 dni z oprocentowaniem określonym w konfiguracji serwera, a ekrany giełdowe pozwalają handlować akcjami i kryptowalutami.
- System finansowy dla innych zasobów
- Exporty serwera, takie jak GetBankBalance, AddBankMoney i RemoveBankMoney, działają identycznie na każdym frameworku. Na serwerze standalone stanowią one system pieniędzy: sklep, praca lub garaż pobiera opłaty i płaci graczom przez bank, a otwarty bank od razu pokazuje nowe saldo. Dwa wyglądy menu, 13 języków, markery lub qb-target / ox_target oraz suwak rozmiaru interfejsu dla każdego gracza dopełniają całości.
?Często zadawane pytania
Czy Agency-Banking wymaga QBCore lub ESX?
Nie. Działa z QBCore, Qbox i ESX, a bez frameworka działa standalone z własnymi kontami. Jedynym wymaganym zasobem jest oxmysql. Pozostaw Config.Framework na 'auto': konsola serwera wyświetli wtedy Framework detected z nazwą lub Running standalone.
Czy muszę zaimportować plik SQL?
Nie. Przy każdym starcie zasób tworzy potrzebne tabele i dodaje brakujące kolumny ze starszej bazy danych, zarówno na MariaDB, jak i MySQL 8. Plik agency_banking.sql jest przeznaczony tylko dla serwerów, które wolą konfigurować bazę danych ręcznie.
W jaki sposób inne skrypty wypłacają środki graczom lub pobierają od nich opłaty?
Poprzez exporty serwera. exports['Agency-Banking']:AddBankMoney(source, amount, reason) wpłaca pieniądze, a RemoveBankMoney zwraca false i nic nie pobiera, gdy stan konta jest zbyt niski. Ta sama para istnieje dla gotówki. W QBCore i ESX otwarty bank sam śledzi zmiany pieniędzy w frameworku; po każdej innej zmianie wywołaj agency_banking:client:MoneyChanged dla tego gracza.
Czy gracze mogą zmienić rozmiar banku?
Tak. Suwak rozmiaru wyświetlania w Settings skaluje bank od 60 do 150 procent z krokiem co 1 procent. Przesuwa się płynnie podczas przeciągania, tekst jest ponownie renderowany z pełną ostrością po zatrzymaniu suwaka, a każdy gracz zachowuje swój własny rozmiar.
Jak zaktualizować ze starszej wersji?
Zabezpiecz własne wartości, podmień pliki resource i użyj nowego config.lua, który dodaje Config.Design, Config.Framework, Config.Standalone oraz Config.Commands. Zrestartuj resource: konta, karty i lokaty terminowe pozostają w bazie danych, a brakujące kolumny są dodawane przy starcie.