Referrals

Referrals

Referrals

Kiedykolwiek chciałeś nagrodzić graczy za kierowanie ludźmi na twój serwer? widzisz, że twój serwer jest pusty przez większość czasu? wtedy Referrals jest dla Ciebie! Referrals to bardzo konfigurowalny dodatek, który pozwala nagradzać graczy, którzy przyprowadzają nowych ludzi na twój serwer. Więc jak to działa? w zasadzie użytkownicy mogą generować kody poleceń za pomocą polecenia /generatecode. te kody mogą być następnie używane przez nowych graczy przy użyciu polecenia /redeem <code> to przyzna graczowi i polecającemu konfigurowalne nagrody w formie przedmiotów, ekonomii lub nawet uruchomienie poleceń konsoli! gracze mogą także użyć polecenia /referstats, aby zobaczyć ilu ludzi ich poleciło albo /codes, aby zobaczyć ich aktualne aktywne kody.

/redeem has be changed to /redeemcode in v0.42 and above!

Features

• super-konfigurowalny
• Konfiguracja wiadomości
• Przyznawaj graczom nagrody w formie pieniędzy, przedmiotów lub nawet uruchamiaj polecenia konsoli za polecenie innego gracza na twój serwer
• strona pomocy /help referrals
• konfigurowalna liczba maksymalnych kodów
• skonfiguruj wymaganą ilość czasu gry gracza, aby mógł wygenerować kod
• twórz własne kody
• ustaw, czy używać nazw graczy zamiast kodów
• kod usuwany po użyciu
• Sprawdza, czy gracze grali wcześniej podczas uruchamiania wtyczki, aby upewnić się, że starzy gracze nie będą się nawzajem polecać
• Gracze nie mogą polecać samych siebie
• Gracze nie mogą polecać użytkowników z tego samego adresu IP
• gracze nie mogą odebrać więcej niż jednego kodu
• Konfiguracja automatycznych aktualizacji wraz z aktualizacjami
• plik logów zapisujący wszystkie zapisy poleceń (włączany po ustawieniu wartości "showReferralsLog" w konfiguracji na true)
• wyświetl statystyki dotyczące tego, ilu ludzi Ty/podany gracz polecili
• opcje konfiguracyjna zezwalająca graczom na odebranie kodu tylko przy pierwszym logowaniu
• opcje konfiguracyjna dezaktywująca kody starych użytkowników
• 839,299,365,868,340,224 możliwych kodów, To ponad 839 kwadrylionów!

ShowCase by SGTCaze

How to Use

1. Gracz, który chce polecić innego gracza, wpisuje /generatecode, aby wygenerować kod do użycia przez innego gracza. Możesz również użyć /codes, aby wyświetlić swoje aktywne kody. W konfiguracji można ustawić maksymalną liczbę kodów.
2. Gracz, który został polecony, loguje się i zostaje poinformowany wiadomością, która mówi, aby użył polecenia /redeem <code> do odebrania kodu polecającego. Wiadomość ta może być zmieniona w konfiguracji wiadomości.
3. Obaj gracze otrzymują konfigurowalne nagrody za polecenie kogoś i odebranie kodu (aby używanie polecenia /redeem miało sens). Można również dodać specjalne nagrody po osiągnięciu określonej liczby poleceń.

Commands

Poniżej znajduje się lista poleceń i ich działanie

[ ] = Opcjonalne
< > = Wymagane

/redeemcode <code> - Polecenie używane do odbioru kodu użytkownika, potwierdzające, że to on Ciebie polecił.

(W wersjach przed v0.42 użyj /redeem)

/generatecode [code] - Polecenie używane do wygenerowania kodu, który ma być użyty w /redeem <code>, Jeśli na serwerze to włączono i wpiszesz /generatecode z kodem po nim, zostanie utworzony kod o tej nazwie.

/codes - Polecenie do wyświetlenia twoich aktywnych kodów.

/refertop [page] - Umożliwia wyświetlenie, kto jest na szczycie listy polecających na twoim serwerze.

/referstats [player] - Umożliwia wyświetlenie statystyk poleceń dla podanego gracza. Domyślnie do nadawcy, jeśli nie podano gracza.

/help referrals - Wyświetla stronę pomocy dotycząca Referrals

/fixrefferers - Ustawia czas gry wszystkim graczom na 0, używane w przypadku wystąpienia błędu, gdy gracze nie mogą użyć /generatecode, ponieważ mówi ono, że muszą grać jeszcze długi czas.

How to Install

Aby zainstalować tę wtyczkę, po prostu przeciągnij plik referrals.jar do folderu plugins na serwerze i uruchom ponownie serwer!

Permissions

Poniżej znajduje się lista uprawnień wraz z krótkim opisem tego, co robią i jak są domyślnie ustawione. Nie dodawaj dwukropka ( :) po uprawnieniu, to tylko wskazanie, że jest związane z kolejnymi liniami.

    referrals.fix:
        description: Allows you to use /fixreferrers
        default: false
    referrals.redeem:
        description: Allows you to redeem someones code in-game
        default: true
    referrals.generate:
        description: Allows you to generate a referral code
        default: true
    referrals.stats:
        description: Allows you to view your referral stats
        default: true
    referrals.top:
        description: Allows you to view the referral top list
        default: true

Set Rewards for when players reach certain goals

Wielu ludzi w komentarzach wyraża, że nie wiedzą, jak ustawić nagrody na określonych celach. Aby to zrobić, przeczytaj wszystko w sekcji konfiguracyjnej pod sekcją Prizes.

Config

Poniżej znajduje się domyślna konfiguracja wraz z opisem poszczególnych wartości.

showReferralsLog: false
loginMessageDelay: 40
usePlayerNames: false
allowCustomCodes: false
autoUpdate: true
checkIpAdress: true
onlyAllowReferralsFirstLogin: true
requiredPlayTime: 0
maxCodes: 1
useEconomy: false
removeOldUsersCodes: 14
Prizes:
  onRedeem:
    money: 20
    items:
      - DIAMOND:0:2
    commands:
  onEvery:
    money: 100
    items:
      - DIAMOND:0:5
    commands:
  on5:
    money: 500
    items:
      - DIAMOND:0:10
    commands:
      - referstats @p

showReferralsLog: false - ustawia, czy ma być tworzony plik logów z zapisami wszystkich poleceń poleceń

loginMessageDelay: 40 - ustawia czas opóźnienia wiadomości FirstLogin; liczba ticków (20 ticków = 1 sekunda).

usePlayerNames: false - prawda lub fałsz, ustawia czy używać nazw graczy zamiast kodów do polecania ludzi

onlyAllowReferralsFirstLogin - true lub false, ustawia czy gracze mogą użyć polecenia /redeem <code> tylko podczas pierwszego logowania.

maxCodes - liczba, określa maksymalną liczbę aktywnych kodów, które gracz może mieć w danym momencie.

useEconomy - true lub false, ustawia czy używać integracji z ekonomią do przydzielania pieniędzy graczom, gdy polecają kogoś lub odbierają kod.

checkIpAdress - true lub false, ustawia czy blokować polecenia polecające z tym samym adresem IP. Można użyć, aby zapobiec korzystaniu z wielu kont w celu uzyskania nagród.

Prizes - lista wszystkich nagród, które mogą być przyznane graczom. onRedeem zostanie przyznane graczom, którzy odebrali kod, a onEvery zostanie przyznane graczom, którzy kogoś polecili, chyba że osiągną kamień milowy poleceń. on<number> zostanie przyznany graczom po osiągnięciu wymaganego numeru poleceń. Przykład: "on5" nagrodzi graczy, którzy zdobyli 5 poleceń.

money - liczba, określa ilość pieniędzy, jaką gracz dostanie po nagrodzie. Działa tylko jeśli useEconomy ustawione na true

items - lista przedmiotów, które będą nagrodzone graczom, składa się z NameOfItem:dataValue:amount. na przykład "DIAMOND:0:50" dałoby graczowi 50 diamentów. Jeśli nie chcesz nagradzać gracza przedmiotami, po prostu wyczyść wszystko po items:, ale nie usuwaj samej sekcji items:

commands - lista poleceń do wykonania po otrzymaniu nagrody. Możesz użyć symbolu "@p" do użycia nazw graczy, po prostu wpisz @p i zostanie zastąpione imieniem gracza, lub @r i zostanie zastąpione nazwą gracza, który był polecany albo jeśli używane w onRedeem, zostanie zastąpione nazwą polecającego. Przykład: "gamemode 1 @p" – ustawi tryb gry gracza, który otrzyma nagrodę na 1, lub "gamemode @r 1" – ustawi tryb gracza, który został polecony.

requiredPlayTime - wymagana ilość czasu grania gracza, aby mógł polecać komuś, liczona w minutach.

removeOldUsersCodes - liczba dni, po których kody starych użytkowników będą usuwane; ustaw na 0, jeśli nie chcesz ich usuwać.

Messages

referrals zawiera niestandardowy plik konfiguracyjny dla wiadomości. Poniżej domyślne konfiguracje wiadomości wraz z opisem ich użycia.

Aby używać kolorów w swoich wiadomościach, po prostu używaj numerów/ liter kolorów w tekście z znakiem & z przodu. Na przykład "&cpotato!" sprawiłoby, że tekst "potato!" byłby czerwony.

istnieją także specjalne kody zaczynające się od symbolu @, które włączają nazwy graczy/kodów do twojej wiadomości. Uwaga: dostępne są one tylko w niektórych wiadomościach.

@n - podaje imię gracza, który mógł cię polecić lub który odebrał twój kod.

@c - wyświetla kod polecenia zamiast @c

@r - wyświetla liczbę poleceń, które gracz wykonał

MESSAGE_FIRST_LOGIN: "&aType /redeem <code> to set who referred you and get some &6Free Items!"
MESSAGE_INVALID_CODE: "&cThe code you have entered is invalid"
MESSAGE_INVALID_PLAYER: "&c unable to find the player @p"
MESSAGE_INVALID_PAGE: "&cThere is no page number @n"
MESSAGE_NO_PERMISSION: "&cSorry, You do not have the required permissions"
MESSAGE_NO_CODES: "&cYou have not generated any codes, /codes to view your codes"
MESSAGE_NOT_PLAYER: "&cYou must be a player to run this command"
MESSAGE_VIEW_CODES: "&a Below is a list of all your active &6referral codes"
MESSAGE_VIEW_CODE: "&a - &6@c"
MESSAGE_VIEW_STATS: "&aYou have referred &6@r &apeople"
MESSAGE_VIEW_STATS_OTHERS: "&6@n &ahas referred &6@r &apeople"
MESSAGE_REFFER_SELF: "&cYou can not refer yourself!"
MESSAGE_SAME_IP: "&cYou can not refer someone with the same ip address as you!"
MESSAGE_TOP_HEADER: "&aReferrals top, Page &6@p"
MESSAGE_TOP: "&a@n - &6@p&a: &6@r"
MESSAGE_NOT_NUMBER: "&c@s must be a number"
MESSAGE_MAX_CODES_REACHED: "&cYou have already reached the max amount of codes, /codes to view your codes"
MESSAGE_REDEEM_REFERRERS_CODE: "&cyou can not have been referred by the person you referred"
MESSAGE_REFERRED: "&6@n has redeemed your code"
MESSAGE_ALREADY_REDEEMED: "&cYou can only redeem 1 code"
MESSAGE_BELOW_REQUIRED_PLAYTIME: "&cyou must play another @t minutes before you can refer someone"
MESSAGE_BEEN_REFFERED: "&aYou have been referred by &6@n"
MESSAGE_CREATE_CODE: "&aSuccesfully registered code: &6@c"
MESSAGE_FIX_REFERRERS: "&cSuccesfully fixed referrers"
MESSAGE_USEPLAYERNAME: "&cThere is no need to generate a code, you can just use your username!"

Source

Źródło Referrals można znaleźć wewnątrz pliku JAR; śmiało zajrzyj i zerknij.

How to use on Bungee Servers

Jeśli uruchomisz tę wtyczkę na serwerze Bungee, możesz zauważyć, że uniemożliwi to polecanie graczy i wyśle wiadomość "nie możesz polecać graczy z tym samym adresem IP" lub coś w tym stylu.

Aby to naprawić, przejdź do konfiguracji i zmień wartość "checkIpAdress: true" na "checkIpAdress: false".

Edyt: możesz także, jeśli chcesz, ustawić, aby używać rzeczywistego adresu IP gracza na Bungee, aby upewnić się, że ludzie nie polecają innych z tego samego adresu IP. Dzięki theoneofcheese123 za poinformowanie mnie o tym.

Aby ustawić Bungee, aby używało rzeczywistych adresów IP graczy, wystarczy wejść do plików bukkit.yml i spigot.yml (jeśli używasz Spigota) i upewnić się, że masz zarówno adres serwera/VPs/server IP, jak i 127.0.0.1 pod "bungee-proxies:" tak jak poniżej -

bungee-proxies:

- 127.0.0.1

- 198.27.70.213

To spowoduje, że BungeeCord będzie wysyłać prawdziwe adresy IP graczy, co umożliwi tej wtyczce użycie weryfikacji IP

Found an Error?

proszę napisz poniżej w tym szablonie a ja się tym zajmę:

version:
error description:
stacktrace(if any):
config:

również proszę używać tagów kodu dla swojego configa i stosu śledzenia, aby było łatwiej czytać; tagi kodu można użyć, klikając ikonę trzech trybików po prawej stronie paska narzędzi obok ikon linku i obrazka.

MCStats

Ta wtyczka używa metryk do rejestrowania danych. Jeśli chcesz to wyłączyć, po prostu przejdź do folderu z wtyczkami, następnie do folderu PluginMetrics i otwórz plik config.yml i zmień opt-out: false na opt-out: true. Metryki są pomocne, aby zobaczyć statystyki dotyczące tego, jak twoja wtyczka funkcjonuje, na przykład ile serwerów z niej korzysta.

Przykłady danych, które metryki gromadzą:

• Rodzaj serwera / Wersja
• Wersja Java
• Wersja Minecraft
• Wersja metryk!
• Liczba graczy
• System operacyjny i wersja
• Tryb uwierzytelniania

Co dane metryki nie zbierają:

• Adresy IP
• Nicki
• Inne prywatne informacje

Poniżej znajdują się wyniki generowane przez metryki.

Donate

Darowizny pomagają mi znaleźć czas na aktualizacje tej wtyczki! chociaż nie są obowiązkowe, darowizny są bardzo mile widziane! przycisk darowizny można znaleźć w prawym górnym rogu strony, jeśli chcesz mi pomóc!

Official Server

Oficjalny serwer wtyczki Referrals to lividiusgaming, zagraj na hub.lividiusgaming.com