Set Homes Two

Wprowadzenie

Ta wtyczka pozwala graczom na ustawienie wielu domów, w różnych światach, a następnie łatwe ich teleportowanie. Ponadto administratorzy serwera mogą zablokować niektóre wymiary, ograniczając możliwość ustawienia domu w tych wymiarach. Jeśli dom został już utworzony w danym wymiarze, a ten wymiar zostanie zablokowany później, gracz nadal zobaczy dom w swoim ekwipunku, ale nie będzie mógł się do niego teleportować. Korzystając z konfiguracji, możesz kontrolować ustawienia takie jak: maksymalna liczba domów, czas odnowienia teleportu i opóźnienie teleportu. Także wszystkie komunikaty wysyłane do użytkownika są całkowicie konfigurowalne.

Instalacja

Wystarczy umieścić pobrany plik jar w folderze "plugins" serwera i uruchomić serwer. Przy pierwszym uruchomieniu zostanie utworzona domyślna konfiguracja, a po tym możesz wprowadzać dowolne edycje. Przykładowa konfiguracja znajduje się również tuż przed sekcją zrzutów ekranu.

Uwaga: Aby maxHomes działało, musisz zainstalować poniższą miękką zależność oraz skonfigurować grupy dla odpowiedniej wtyczki uprawnień.

Miękkie zależności

• LuckPerms

Polecenia

• /create-home [name] [display_material | d | default] [description] - Utworzy dom, w którym stoi gracz, z podaną nazwą, wybranym materiałem i opisem.
• /go-home [name] - ZTeleportuje gracza do domu o podanej nazwie. Gracze będą również potrzebować uprawnienia sh2.teleport, aby skutecznie użyć tego polecenia.
• /list-homes - Wyświetla listę domów utworzonych przez gracza. Dom można teleportować, klikając na podkreśloną nazwę domu (wymagane posiadanie uprawnień sh2.teleport i sh2.go-home).
• /delete-home [name] - Usunie dom o podanej nazwie.
• /add-to-blacklist [dimension names] - Doda wymienione wymiary do czarnej listy. Jeśli wymiar znajduje się na tej liście, gracze nie będą mogli zapisać swoich domów w tym wymiarze.
• /remove-from-blacklist [dimension names] - Usunie wymienione wymiary z czarnej listy.
• /get-blacklisted-dimensions - Zwróci listę wymiarów znajdujących się na czarnej liście.
• /set-max-homes [group name] [number] - Zaktualizuje maksymalną liczbę domów, które gracze mogą ustawić. Jeśli wtyczka obsługuje różne grupy (tier) dla graczy, będziesz musiał podać nazwę grupy oprócz liczby maksymalnych domów. Jeśli wtyczka ma tylko jedną grupę lub tier, wystarczy podać samą liczbę maksymalnych domów.

Uprawnienia

• sh2.give-homes-item - Pozwala graczowi otrzymać przedmiot umożliwiający przeglądanie/teleportację domów.
• sh2.create-home - Pozwala graczowi tworzyć domy.
• sh2.go-home - Pozwala graczowi wykonać go-home.
• sh2.list-homes - Pozwala graczowi wyświetlić listę swoich domów na czacie.
• sh2.delete-home - Pozwala graczowi usuwać własne domy.
• sh2.teleport - Pozwala graczowi teleportować się do utworzonych domów.
• sh2.add-to-blacklist - Dodaje wymiary do czarnej listy.
• sh2.remove-from-blacklist - Usuwa wymiary z czarnej listy.
• sh2.get-blacklisted-dimensions - Pobiera listę czarnych wymiarów.
• sh2.get-player-homes - Pobiera listę domów danego gracza.
• sh2.set-max-homes - Ustawia maksymalną liczbę domów dla wszystkich graczy lub poszczególnych grup.

Dodatkowe funkcje

• Czas potrzebny na teleport do zapisanego domu można skonfigurować.
• Gracze mogą wybrać, który przedmiot Minecraft będą używać jako ikonę swoich zapisywanych domów (każdy dom może używać innego przedmiotu Minecraft).
• Administratorzy serwera mogą konfigurować, jaki domyślny przedmiot będzie ikoną zapisywanych domów.

Przykładowa konfiguracja

# -- DOMY --
# Przedmiot, którego gracz użyje gdy
# prawym kliknięciem otworzy listę domów.
openHomeItem: "compass"

# Domyślny przedmiot gdy polecenie create-home
# podaje jedynie nazwę domu, lub otrzymuje jedynie
# domyślny materiał.
defaultHomeItem: "white_wool"

# Tytuł ekwipunku wyświetlającego
# listę domów gracza.
inventoryTitle: "Twoje domy"

# Włączono maksymalną liczbę domów.
maxHomeEnabled: false

# Typ maksymalnej liczby domów.
# Opcje: singular | groups
# Przykład typu singular maxHomesType:
# maxHomesType: "singular"
# maxHomes: 5
maxHomesType: groups
maxHomes:
  admin: 5
  user: 4

# -- TELEPORTOWANIE --
teleportTitle: "Proszę stań w miejscu"
teleportSubtitle: "Zostaniesz teleportowany za %d sekund..." # Możesz użyć %d tutaj jako zastępnika licznika sekund.
teleportSuccess: "Teleportowano do %s" # Możesz użyć %s tutaj jako zastępnika nazwy domu, do którego został wykonany teleport.
cancelOnMove: true # true | false
delay: 3 # (sekundy) 0 to brak opóźnienia.

# -- WIADOMOŚCI --
homeCreated: "%s został(a) pomyślnie utworzony." # Możesz użyć %s tutaj jako zastępnika nazwy domów gracza.
homeDeleted: "%s został(a) pomyślnie usunięty." # Możesz użyć %s tutaj jako zastępnika nazwy domów gracza.
dimensionAddedToBlacklist: "%s został(a) dodany(a) do czarnej listy." # Możesz użyć %s tutaj jako zastępnika nazw wymiarów.

# -- KOMUNIKATY BŁĘDÓW --
invalidHomeItem: "Wprowadzony materiał nie jest prawidłowy, spróbuj innego."
falseHomeItem: "Ten przedmiot domu nie należy do Ciebie."
teleportedWhileTeleporting: "Nie możesz teleportować, gdy już teleportujesz."
movedWhileTeleporting: "Teleportacja została anulowana, ponieważ się poruszyłeś."
noHomes: "Nie utworzyłeś jeszcze żadnych domów. Użyj /create-home, aby utworzyć swój pierwszy."
teleportToBlacklistedDimension: "Nie możesz teleportować do tego domu, ponieważ wymiar jest na czarnej liście."
maxHomesReached: "Osiągnięto maksymalną dozwoloną liczbę domów."
dimensionBlacklisted: "Nie możesz ustawić domu w tym wymiarze, ponieważ jest on na czarnej liście."

# -- DEBUGGING --
debugLevel: "error" # Opcje to: error | info