PermissionsEx (PEX) - plugin na serwery Minecraft pracujące pod silnikiem Bukkit, Spigot lub MCPC+ umożliwiający tworzenie oraz przydzielanie rang graczom na serwerze.
Instalacja
Aby zainstalować ten plugin na swój serwer należy wgrać przez FTP do katalogu plugins plik PermissionsEx.jar dostępny pod tym linkiem.
Ściągamy wersję pasującą do wersji naszego serwera i wgrywamy go do wcześniej wspomnianego katalogu plugins.
Po wgraniu tego pliku na serwer należy zrestartować serwer. Nie używajmy /reload gdyż może to spowodować problemy z serwerem. Po restarcie serwera w katalogu plugins powinien utworzyć się nowy folder o nazwie PermissionsEx. W nim powinny zostać utworzone 2 pliki - config.yml oraz permissions.yml. Jeśli jednak tak się nie stało, sprawdź czy masz odpowiednią wersję pluginu. Plugin jest dostępny do wersji: 1.8.1.
Konfiguracja
Teraz przejdźmy do konfiguracji naszych rang. Pliku config.yml w ogóle nie ruszamy, zostawiamy go takiego jakim jest.
Interesuje nas plik permissions.yml. Ściągamy go przez klienta FTP na swój twardy dysk i, najlepiej za pomocą programu Notepad++, otwieramy go. Ukaże nam się taki oto tekst:
groups: default: default: true permissions: - modifyworld.*
Okej, omówmy teraz każdą linijkę tego pliku.
Pierwsza linijka zawiera napis groups:
Oznacza ona po prostu grupy, czyli rangi. Nic w niej nie zmieniamy. Występuje tylko jedna taka linia w całym pliku. Należy pamiętać, że nie może być przed nią żadnej spacji.
Kolejna linia naszego pliku konfiguracyjnego to
default:
Jest to po prostu nazwa naszej rangi. Może ona składać się z:
- wielkich i małych liter (tylko łacińskich! Czyli bez ą, ę i innych polskich liter)
- podkreślenia _
- myślnika -
- cyfr
Przykłady:
- Admin
- kolorowe_kwiatki
- Gracz
Wielkość liter w nazwie rangi nie ma znaczenia. Przed nazwą muszą znaleźć się dwie spacje.
Kolejna linijka to default: true
Określa ona, czy jest to domyślna ranga. Domyślną rangę otrzymuje automatycznie każdy gracz, który wejdzie na serwer. Dostępne są dwie wartości: true (tak) i false (nie).
Przed nazwą muszą znaleźć się cztery spacje.
Następne linijki to: permissions: - modifyworld.*
Są to permisje, czyli uprawnienia danej rangi. W tym przypadku modifyworld.* oznacza to iż ranga może modyfikować świat, tj. np. niszczyć bloki.
Permisje są uzależnione od pluginów. Przykładowe uprawnienie do używania komendy /spawn
z pluginu Essentials wygląda następująco:
- essentials.spawn
Należy pamiętać, iż przed uprawnieniami również muszą znajdować się cztery spacje. Jest to bardzo ważne, inaczej nasz plugin nie będzie poprawnie działał. Po przejściu do nowej linii będzie wyglądało na to, że program zrobił za nas te cztery spacje. Nic bardziej mylnego. Należy wtedy wcisnąć klawisz backspace i zrobić ręcznie cztery spacje, po czym dopisać uprawnienie.
Permisja
- ‘*’
Dodaje wszystkie uprawnienia ze wszystkich pluginów tejże grupie.
Między linijkami default: true/false
oraz permissions:
można dopisać jeszcze jedną
prefix: ‘kolor Nazwa’
Dzięki temu będzie wyświetlana nazwa grupy; przykład to: prefix: ‘&5[Swiezak]'
Przykładowa konfiguracja
Tak wygląda przykładowy plik konfiguracyjny permissionsex.yml groups: Gracz: default: true prefix: ‘&7[Gracz]’ permissions: - modifyworld.* - essentials.spawn - essentials.sethome - essentials.delhome - essentials.home - essentials.rules - essentials.help Admin: default: false prefix: ‘&4[Admin]’ permissions: - ‘*’
Jest to taki plik konfiguracyjny ograniczony do minimum. Po wklejeniu tego do naszego pliku permissionsex.yml utworzone zostają dwie rangi: Gracz i Admin. Gracz jest rangą domyślną. Ma dostęp do komend: /spawn
, /sethome
, /delhome
, /home
, /rules
oraz /help
.
Po każdym zmienieniu pliku permissions.yml musimy wgrać ten plik na serwer (tam gdzie był, czyli folder PermissionsEx) i wpisać komendę /pex reload
lub /reload
by wcielić ten plik w życie serwera.
Komendy
Przyszedł czas na komendy. Te z pluginu PermissionsEx nie są łatwe do zapamiętania, lecz uwierzcie mi, nauczycie ich się raz i zapamiętacie na całe życie :)
/pex
- wyświetla listę dostępnych komend/pex user GRACZ
- po użyciu tej komendy zobaczymy jaką rangę posiada ten gracz/pex user GRACZ group set RANGA
- komenda dająca rangę jakiemuś graczowi, np./pex user McHalt group set Admin
da graczowi McHalt rangę Admin/pex reload
- przeładowuje plik permissions.yml
Permissions
Wszystkie permisje wraz z opisami (niestety w języku angielskim) znajdziesz pod tym linkiem.