Instalacja

Notatka

💬 Potrzebujesz pomocy? Wsparcie, aktualizacje i dzienniki zmian znajdziesz na Discordzie Mic Scripts. Otwórz ticket, podając swój identyfikator transakcji Tebex oraz błąd z konsoli.

Pięć minut: jeden plik SQL, jedna linia w config.lua, jedna linia w server.cfg.

---

Zanim zaczniesz

Potrzebujesz	Dlaczego
lb-phone	Aplikacja działa wewnątrz tego telefonu
oxmysql	Oferty, polubienia i utarg są przechowywane w bazie danych
ESX, QBCore lub QBox	Ekwipunek, pieniądze oraz tożsamość gracza

---

1. Umieść folder na miejscu

Wrzuć mic_pawnshop do swoich zasobów, na przykład resources/[mic]/mic_pawnshop.

Uwaga

Zachowaj nazwę folderu mic_pawnshop. Ekrany aplikacji komunikują się z zasobem dokładnie pod tą nazwą; po zmianie nazwy aplikacja otworzy się, ale pozostanie pusta.

---

2. Baza danych

Zaimportuj jednorazowo plik pawnshop.sql z folderu zasobu za pomocą HeidiSQL, phpMyAdmin lub innego narzędzia. Tworzy on trzy tabele:

Tabela	Co przechowuje
pawn_offers	Każde ogłoszenie: przedmiot, ilość, cena, typ ceny, sprzedający, daty oraz metadane
pawn_earnings	Utarg każdego sprzedającego oczekujący na wypłatę
liked_offers	Informacje o tym, kto polubił daną ofertę

Zasób nie tworzy tych tabel automatycznie.

Działa poprawnie, gdy wszystkie trzy tabele znajdują się w tej samej bazie danych, z której korzysta Twój serwer.

---

3. Uruchom skrypt po jego zależnościach

W pliku server.cfg dodaj ensure mic_pawnshop w linii poniżej oxmysql, swojego frameworka oraz lb-phone.

Aplikacja czeka na lb-phone i rejestruje się ponownie przy każdym restarcie lb-phone, więc późniejsze uruchomienie telefonu nie stanowi problemu; jednak framework i oxmysql muszą działać wcześniej.

---

4. Wskaż swój framework i ekwipunek

Otwórz config.lua:

Opcja	ESX	QBCore	QBox
Config.Framework	"esx"	"qb"	"qb"
Config.InventoryImagePath	"ox_inventory/web/images/"	"qb-inventory/html/images/"	"ox_inventory/web/images/"

Framework nie jest wykrywany automatycznie i zapisuje się go małymi literami. W przypadku QBox użyj "qb": QBox uruchamia zasoby QBCore poprzez swoją warstwę kompatybilności. Ścieżka obrazków służy wyłącznie do wyświetlania ikon w aplikacji — zadziała każdy ekwipunek, o ile ścieżka wskazuje na folder z obrazkami przedmiotów.

---

5. Przedmioty

Nie trzeba dodawać żadnych nowych przedmiotów. Aplikacja pozwala sprzedawać to, co gracze już posiadają. Wszystko, czym handel ma być zablokowany, wpisz do Config.BlackList (zobacz Personalizacja).

---

6. Pierwszy test

1. Otwórz lb-phone. Aplikacja Pawn Shop jest już na ekranie głównym — instaluje się domyślnie.
2. Utwórz ofertę: wybierz przedmiot z ekwipunku, ustaw ilość oraz cenę i wybierz Unit (za sztukę) lub Total (za całość).
3. Na drugiej postaci otwórz aplikację i kup ten przedmiot.

Działa poprawnie, gdy przedmiot znika z ekwipunku sprzedającego w momencie wystawienia oferty, trafia do kupującego po zakupie, a sprzedający widzi pieniądze w sekcji Pending na górze aplikacji, gotowe do wypłaty.

---

Zanim otworzysz serwer dla graczy

• Zdecyduj, skąd pobierane są pieniądze. Config.Bank = true korzysta z kont bankowych. Płatność przedmiotami wymaga, aby gotówka była przedmiotem w ekwipunku — przeczytaj najpierw sekcję Personalizacja.
• Rozważnie ustaw Config.Expire. Wygasła oferta jest usuwana razem z przedmiotami; nie wracają one do sprzedającego.
• Uzupełnij Config.BlackList o wszystko, co nie powinno przechodzić z rąk do rąk: domyślna lista zawiera jedynie burger oraz weapon_appistol jako przykłady.
• Przenieś lombard w wybrane przez siebie miejsce, jeśli włączysz opcję Config.RequireLocation.