zPermissions — Wtyczka Superperms dla Bukkit

zPermissions jest przede wszystkim implementacją Superperms (znaną również jako uprawnienia Bukkit) opartą na bazie danych SQL. Obsługuje również przechowywanie w plikach płaskich. Znaczące cechy to: obsługa wielu światów, rangi z wieloma ścieżkami/poziomami, dziedziczenie grup na dowolną głębokość (w granicach rozsądku), oraz opcjonalne uprawnienia zależne od regionu z użyciem regionów WorldGuard, Residence, Factions lub Factoid.

There is no built-in build protection (I rely on other plugins for that). zPermissions focuses on permissions and only permissions.

Nie ma wbudowanej ochrony budowy (polegam na innych wtyczkach w tym). zPermissions koncentruje się na uprawnieniach i tylko na uprawnieniach.

I aim to keep zPermissions a simple, yet feature-rich, Superperms provider.

Chcę, aby zPermissions było prostym, a jednocześnie bogatym w funkcje dostawcą Superperms.

zPermissions supports UUIDs as of the 1.3beta1 release! See the notes for that release for details.

zPermissions obsługuje UUID-ów od wydania 1.3beta1! Zobacz notatki do tego wydania po szczegóły.

[ Dokumentacja szybkiego uruchomienia | Dla administratorów serwera | Najczęściej zadawane pytania | Więcej dokumentacji poniżej! ]

Pytania? Problemy?

Najpierw sprawdź proszę znane problemy oraz Najczęściej zadawane pytania.

Jeśli twoje pytanie wciąż pozostaje bez odpowiedzi, proszę napisz na forum.

Na wszelkie błędy/problemy, proszę utwórz zgłoszenie na dev.bukkit.org.

Jeśli Cię jeszcze nie znam, wiadomości prywatne będą ignorowane.

Funkcje

• Różnorodne opcje przechowywania, od SQL po pliki płaskie. Używa bazy danych Bukkit do przechowywania uprawnień (tj. ustawień w bukkit.yml). Powinien działać z większością baz danych obsługiwanych przez Avaje Ebean — specjalnie przetestowałem PostgreSQL, MySQL i H2. Domyślna baza danych Bukkit, SQLite, nie jest obsługiwana. ZPermissions automatycznie przełącza się na przechowywanie w plikach płaskich, jeśli SQLite będzie używana.

• Dziedziczenie grup. Grupom mogą dziedziczyć uprawnienia z wielu grup nadrzędnych.

• Gracze mogą należeć do więcej niż jednej grupy. Kolejność stosowania uprawnień grup jest jasno określona i opiera się na wadze grup (która jest konfigurowalna, oczywiście).

• Wsparcie dla wielu światów. Uprawnienia przydzielone graczom i grupom mogą być powiązane z określonym światem.

• Opcjonalne wsparcie regionów. Uprawnienia mogą być również powiązane z regionami WorldGuard lub rezydencjami Residence.

• Wiele ścieżek awansu! Korzystając z uprawnień, możesz także ograniczyć, kto może promować/demotować innych i które ścieżki mogą użyć. Dodatkowo każdy gracz może być promowany/demotowany na wielu ścieżkach.

• Krótkoterminowe tymczasowe uprawnienia. Nadaj graczowi węzeł uprawnienia, który będzie ważny od kilku sekund do kilku minut.

• Tymczasowe przypisania grup. Przypisz grupę graczowi i ustaw wygaśnięcie członkostwa po 1 dniu... kilka miesięcy... lub roku! Dowolny okres, jaki chcesz.

• Prefiksy i sufiksy czatu dla graczy i grup. Nadal wymagana jest wtyczka formatowania czatu zgodna z Vault, np. Herochat, zChat, itp.

• API. zPermissions oferuje wszechstronne tylko do odczytu API, z którego mogą korzystać inne wtyczki. (Chociaż polecałbym kodowanie przeciwko Vault zamiast tego.)

• Wsparcie metadanych. Gracze i grupy mogą mieć dowolne metadane z nimi związane. Wartości metadanych mogą być łańcuchami znaków, liczbami całkowitymi, liczbami rzeczywistymi (podwójna precyzja) oraz wartościami logicznymi. Metadane mogą być zapytane za pomocą natywnego API lub Vault Chat API.

• Automatyczne uprawnienia grup. Wraz z nadejściem uprawnień Superperms/Bukkit, zalecany sposób testowania członkostwa w grupie to używanie uprawnień. zPermissions może automatycznie ustawiać uprawnienie na podstawie nazwy grupy dla każdej grupy. Domyślne, konfigurowalne uprawnienie to group.<groupname> (kompatybilne od razu z WorldEdit i WorldGuard!).

• Domyślna grupa, którą można ponownie przypisać. Domyślna grupa (grupa przypisywana graczom, którzy nie należą do żadnych grup) nazywana jest default. Można ją zmienić.

Koncepcje

• Grupy są „uniwersalne” — we wszystkich światach. Nie ma planów wprowadzania grup specyficznych dla świata.

• Jednak gracze i grupy mogą mieć uprawnienia specyficzne dla świata i/lub regionu. Te uprawnienia obowiązują tylko wtedy, gdy gracz znajduje się w tym konkretnym świecie i/lub regionie.

• Istnieją 4 „poziomy” uprawnień: uniwersalne, specyficzne dla świata, specyficzne dla regionu, a na końcu region- i świat-specyficzne. Najbardziej ogólne uprawnienia są stosowane jako pierwsze, najpierw wszystkie uprawnienia grup, a następnie uprawnienia gracza:

  1. Uprawnienia grup uniwersalne
  2. Uprawnienia grup specyficzne dla świata
  3. Uprawnienia grup specyficzne dla regionu
  4. Uprawnienia grup specyficzne dla regionu i świata
  5. Uprawnienia gracza uniwersalne
  6. Uprawnienia gracza specyficzne dla świata
  7. Uprawnienia gracza specyficzne dla regionu
  8. Uprawnienia gracza specyficzne dla regionu i świata

• Gracze mogą należeć do wielu grup. Grupy mogą mieć przypisaną wagę — wyższa waga oznacza, że grupa jest stosowana później, co powoduje, że nadpisuje wcześniejsze grupy. Grupy o tej samej wadze są stosowane alfabetycznie.

• Grupy mogą dziedziczyć po jednej lub wielu grupach rodziców. Rodzice grup są stosowani w odwróconej kolejności, tak aby pierwszy rodzic grupy nadpisywał wszystkie kolejny rodziców.

Instalacja i użycie

Umieść plik zPermissions.jar w katalogu plugins serwera. Uruchom serwer. Spowoduje to utworzenie pliku config.yml w katalogu plugins/zPermissions serwera. Możesz chcieć edytować ten plik, aby ustawić domyślną grupę i domyślną ścieżkę. Możesz także stworzyć swoje ścieżki.

Wpisz /permissions, aby rozpocząć. (/perm lub /p mogą również działać, jeśli te aliasy są dostępne.)

Węzły uprawnień w podkomendach get, set i unset mogą być określane jako:

• <permission> — Niekwalifikowany węzeł uprawnienia dotyczy wszystkich światów i wszystkich regionów.
• <world>:<permission> — Aby uprawnienie było specyficzne dla świata, poprzedź je nazwą świata, a następnie dwukropkiem.
• <region>/<permission> — Aby uprawnienie było region-specyficzne, poprzedź je nazwą regionu, ukośnikiem.
• <region>/<world>:<permission> — Możesz również uczynić uprawnienie zarówno region- jak i świat-specyficzne, łącząc te dwa kwalifikatory. Na razie kwalifikator regionu musi zawsze występować jako pierwszy.

Polecenia rang

Polecenia rang będą normalnie rozgłaszać zmiany do wszystkich administratorów. Polecenia rang mają opcję -q, aby działać w trybie cichym, np. podczas wywoływania przez zautomatyzowane procesy. Będą one jednak nadal logować swoje działania do dziennika serwera w celach audytu bezpieczeństwa. W przeciwieństwie do -q, będą również przyjmować -Q, które powoduje rozgłaszanie zmian wszystkim użytkownikom.

Więcej dokumentacji

• Uprawnienia
• Szczegółowe użycie poleceń
• Tymczasowe uprawnienia i grupy
• Dostosowywanie nazw tabel
• Wsparcie Vault
• Dla programistów wtyczek
• Aktualizacje schematu

Licencja i źródło

zPermissions jest wydawane na licencji Apache License, Version 2.0.

Źródła mogą być znalezione na GitHubie:

• zPermissions
• ToHPluginUtils

Kompilacje deweloperskie tego projektu można uzyskać na podanym serwerze CI. Te kompilacje nie zostały zatwierdzone przez personel BukkitDev. Używaj ich na własne ryzyko.

• zPermissions (Wymaga ToHPluginUtils.jar)
• zPermissions-standlone (zawiera ToHPluginUtils, jak wersja dystrybuowana na dev.bukkit.org)

Do zrobienia

• Bardziej obszerne testy jednostkowe, zwłaszcza interfejsu usługi.
• Lepsza organizacja dokumentacji.