Dokumentacja RPHub

📚 Spis treści

1. Wprowadzenie2. Dla właścicieli serwerów2.1 Rejestracja i logowanie2.2 Tworzenie serwera2.3 Konfiguracja integracji2.4 Zarządzanie produktami2.5 Wypłaty3. Dla klientów4. Integracja z FiveM5. Integracja z Discord6. Najczęstsze problemy

📖 Wprowadzenie

RPHub to platforma umożliwiająca automatyczną sprzedaż rang VIP, itemów i innych produktów na serwerach FiveM i Discord. System automatycznie przyznaje nagrody po zaksięgowaniu płatności.

🔐 Logowanie przez Discord
🛒 Automatyczny sklep online
🤖 Automatyczne role Discord
🎮 Integracja z FiveM
💳 Płatności Stripe
💰 System wypłat

👑 Dla właścicieli serwerów

Rejestracja i logowanie

  1. Wejdź na stronę https://rphub.pl
  2. Kliknij "Zaloguj przez Discord"
  3. Zaakceptuj uprawnienia aplikacji
  4. Po pierwszym logowaniu podaj adres email

Tworzenie serwera

  1. W dashboardzie kliknij "Dodaj serwer"
  2. Wypełnij nazwę i slug (np. moj-serwer)
  3. Wybierz plan: Basic (10 zł/mc + 5% prowizji) lub Pro (25 zł/mc + 0% prowizji)
  4. Pierwszy serwer - 14 dni trial ZA DARMO!

Konfiguracja integracji

🤖 Discord:

  • ID serwera Discord (Guild ID) – Ustawienia Discord → Widżet
  • Zaproś bota RPHub na swój serwer przez link autoryzacyjny
  • ID roli VIP – rola nadawana po zakupie

🎮 FiveM:

  • IP serwera FiveM (np. 123.123.123.123:30120)
  • Kliknij "Generuj nowy klucz" – wygeneruje się unikalny API Key
  • Pobierz paczkę integracyjną (QBCore lub ESX) i wgraj na serwer

Zarządzanie produktami

  • Dashboard → Produkty → Dodaj produkt
  • Ustaw nazwę, cenę, opis i obrazek (opcjonalnie)
  • Wybierz typ: Discord, FiveM lub Hybryda
  • Ustaw limitowaną ilość (opcjonalnie)
  • Dodaj nagrody – możesz dodać wiele: role Discord, itemy, pieniądze, pracę

Wypłaty

  • Dashboard → Wypłaty → Złóż wniosek
  • Minimalna kwota: 50 zł
  • Metody: PayPal, Stripe, przelew bankowy
  • Po zatwierdzeniu przez admina – środki zostają przelane

🛍️ Dla klientów

Zakup produktu

  1. Wejdź na stronę sklepu: https://rphub.pl/store/nazwa-serwera
  2. Wybierz produkt i kliknij "Kup teraz"
  3. Wpisz nick Steam / Discord i adres email
  4. Wybierz metodę płatności (karta, BLIK, Przelewy24)
  5. Po opłaceniu nagrody są przyznawane automatycznie

Otrzymywanie nagród

  • 🎭 Rola Discord – nadawana natychmiast
  • 📦 Item FiveM – trafia do ekwipunku
  • 💰 Pieniądze FiveM – dodawane do gotówki
  • 💼 Praca FiveM – zmieniana automatycznie

🎮 Integracja z FiveM

Instalacja skryptu QBCore

  1. Pobierz paczkę qbcore.zip z panelu ustawień serwera
  2. Wypakuj folder RPHub do resources/
  3. Dodaj ensure RPHub do server.cfg
  4. Skonfiguruj config.lua:
Config = {}
Config.APIKey = 'twoj-wygenerowany-klucz-api'
Config.ServerIP = 'twoj.adres.ip:30120'
Config.Cooldown = 60
Config.Debug = true

Instalacja skryptu ESX

  1. Pobierz paczkę esx.zip z panelu ustawień serwera
  2. Wypakuj folder do resources/
  3. Dodaj ensure RPHub do server.cfg
  4. Skonfiguruj config.lua (tak samo jak dla QBCore)

🤖 Integracja z Discord

Dodanie bota RPHub na serwer

  • Kliknij link: Zaproś bota RPHub
  • Wybierz swój serwer i kliknij "Autoryzuj"
  • W panelu RPHub → ustawienia serwera → wpisz ID swojego serwera (Guild ID)
  • Bot automatycznie będzie obsługiwał komendy na Twoim serwerze

Komendy bota RPHub

!RPHub stats – 📊 statystyki sklepu
!RPHub zakupy @user – 📋 zakupy użytkownika
!RPHub pomoc – ❓ lista komend

⚠️ Najczęstsze problemy

❓ Nagroda nie została przyznana

Sprawdź czy serwer FiveM jest online, czy API key w config.lua jest poprawny i czy gracz jest online na serwerze.

❓ Bot Discord nie nadaje roli

Sprawdź czy bot ma uprawnienia do zarządzania rolami i czy rola jest niżej niż najwyższa rola bota.

❓ Sklep nie działa po wygaśnięciu subskrypcji

Odnów subskrypcję w panelu → Subskrypcja. Sklep wróci do działania automatycznie.

❓ Klient nie otrzymał emaila

Sprawdź czy klient podał poprawny adres email i czy nie trafił do folderu SPAM.

❓ Nie znalazłeś odpowiedzi? Skontaktuj się z nami