Czego potrzebujesz
- Serwer Discord, na którym masz uprawnienie
Zarządzaj Serwerem(zazwyczaj właściciel lub admin). - Już utworzony profil serwera TopV — /setup-server jeśli jeszcze nie masz.
- Około 2 minuty. Konfiguracja w jednym przebiegu.
Dodaj bota do swojego Discorda
Kliknij przycisk. Discord otwiera prośbę o uprawnienia — zaakceptuj. Bot dołącza z minimalnymi uprawnieniami (czytanie członków i ról, wysyłanie wiadomości w wybranym kanale). Nic więcej.
Połącz bota z profilem TopV
W dowolnym kanale tekstowym wpisz:
/topv-linkTopV8 commandsDiscord poprosi o slug profilu — to część URL po topv.gg/servers/. Na przykład, jeśli profil to topv.gg/servers/saga-rp, wpisz saga-rp.
https://topv.gg/servers/saga-rp
Auto-sync co 6h. Uruchom
/topv-sync dla natychmiastowego resync.Wybierz role staff i roliste
Tak bot wie, kto jest w zespole i kto jest graczem. Otwórz dashboard TopV:
Otwórz dashboardPrzejdź do strony edycji serwera, przewiń do sekcji Role Discord i zaznacz wybrane role.
- Role staff — admini, modzi i zespół. Pojawiają się z awatarem + badge'em roli, auto-sync.
- Role rolistes — każdy członek z tą rolą otrzymuje swoją kartę TopV (postać, projekty, trofea, recenzje). Zachowuje ją na zawsze.
Discord Roles
Pick the Discord roles that represent your staff team and your players (rolistes). Staff will appear on your public profile, and rolistes will automatically get a player profile on TopV.
Wybierz kanał powiadomień
Zdecyduj, gdzie bot publikuje: wyniki sync, nowe trofea, recenzje, przypomnienia Weekly Spotlight. Uruchom:
/topv-channel #twoj-kanal/topv-channelchannel:Pro tip: wybierz prywatny kanał tylko dla staffu — większość wiadomości jest dla ciebie i zespołu.
Aktywuj system trofeów
Ten krok jest opcjonalny. Jeśli chcesz, by społeczność nagradzała momenty RP:
/topv-trophy-setupBot pyta, które kanały kwalifikują się do /eval i które role mogą tego używać (typowo staff + senior rolistes). Anti-abuse wbudowane:
- Cooldown między dwoma /eval tego samego autora.
- Dzienny limit na oceniającego (anti-flood).
- Gating ról — tylko skonfigurowane role mogą używać /eval.
- Pełny audit log: każdy punkt jest śledzalny do oceniającego i kanału.
Po aktywacji każdy członek z odpowiednią rolą może wpisać /eval @player w odpowiednim kanale. Punkt liczy się w rankingu TopV gracza.
TopV8 commands
IppoJinEvoVerse Académie | FAused/eval
Oceniający: IppoJin · EvoVerse Académie | FAWszystkie slash commands
/topv-linkŁączy ten serwer Discord z profilem serwera TopV.
/topv-syncWymusza świeży sync staff + rolistes. Po zmianie ról.
/topv-statusPokazuje status weryfikacji, połączony slug TopV, ostatnia sync.
/topv-channelWybierz kanał na sync, trofea, recenzje i przypomnienia Weekly Spotlight.
/topv-trophy-setupKonfiguruje kanały trofeów i role uprawnione do /eval. Opcjonalne.
/eval @playerPrzyznaje punkt trofeum graczowi. Tylko w skonfigurowanych kanałach.
/topv-helpPokazuje wszystkie komendy i podsumowanie systemu trofeów RP.
/topv-unlinkUsuwa połączenie między tym serwerem a profilem TopV.
Uprawnienia i prywatność
Co bot MOŻE robić
- Czytanie listy członków (intent GUILD_MEMBERS — zatwierdzony przez Discord).
- Czytanie przypisań ról (tylko odczyt) — identyfikacja staff i rolistes.
- Wysyłanie wiadomości w kanale ustawionym przez /topv-channel.
- Słuchać slash commands w dostępnych kanałach.
Co bot NIE może robić
- Banowanie, wyrzucanie lub timeout członków.
- Tworzenie, edycja lub usuwanie kanałów.
- Modyfikacja ról — tylko odczyt.
- Wysyłanie DM-ów do członków.
- Czytanie treści wiadomości (brak intent MESSAGE_CONTENT).
Rozwiązywanie problemów i FAQ
›/topv-link mówi 'Nieautoryzowany'
Twoje konto Discord nie jest właścicielem profilu TopV. Zaloguj się na właściwe konto lub przekaż własność przez /dashboard.
›Lista staffu nie pokazuje się na karcie
Upewnij się, że oznaczyłeś co najmniej jedną rolę jako 'staff' w dashboard, potem uruchom /topv-sync. Jeśli pusto, sprawdź czy bot widzi te role.
›Profile rolistes się nie tworzą
Ta sama logika — oznacz co najmniej jedną rolę jako 'roliste' i uruchom /topv-sync. Członkowie muszą mieć co najmniej jedną z tych ról. Profile tworzone w sekundach.
›/eval mówi, że kanał nie jest uprawniony
Uruchom /topv-trophy-setup ponownie i dodaj bieżący kanał do listy uprawnionych. Punkty liczą się tylko z kanałów wyraźnie zatwierdzonych.
›Czy mogę odinstalować bota później?
Tak, w dowolnym momencie. Najpierw uruchom /topv-unlink (aby profil wiedział, że serwer nie jest już połączony), potem usuń bota. Nie są przechowywane żadne twoje dane poza zapisem weryfikacji.
›Czy to coś kosztuje?
Nie. Bot jest i pozostanie darmowy. Brak powiązanego upsellu. Plany Premium TopV istnieją (widoczność w rankingach, Weekly Spotlight, itp.) ale są całkowicie niezależne od bota.