Residence - ochrona terenu na serwerze Minecraft

Co to jest Residence

Residence to plugin serwerowy rozwijany przez użytkownika Zrips, dostępny na SpigotMC. Jego głównym zadaniem jest umożliwienie graczom samodzielnej ochrony własnych terenów bez angażowania administracji serwera. Gracz zaznacza obszar kilokiem selekcji, nadaje mu nazwę i od tej chwili nikt nieupoważniony nie może budować, niszczyć ani wchodzić na ten teren.

Plugin istnieje od czasów Minecrafta 1.7 i przez lata stał się jedną z dwóch dominujących opcji ochrony gruntów obok WorldGuard. Jego główna przewaga to orientacja na gracza: całe zarządzanie odbywa się przez intuicyjne komendy lub GUI, bez ingerencji admina. WorldGuard z kolei częściej stosuje się do globalnych stref administracyjnych.

Residence integruje się z Vault i każdym pluginem ekonomii, co otwiera możliwość kupna, sprzedaży i wynajmu ziemi między graczami. To czyni go fundamentem serwerów survival z ekonomią.

Tworzenie rezydencji

Proces tworzenia rezydencji jest prosty i zajmuje kilkanaście sekund:

1. Wpisz /res select lub użyj komendy /res tool, żeby dostać kilof selekcji (domyślnie drewniany kilof).
2. Kliknij lewym przyciskiem myszy w jeden narożnik obszaru, a prawym w drugi - tak samo jak w WorldEdit.
3. Wpisz /res create NazwaRezydencji, żeby zarejestrować zaznaczony obszar.

Zaznaczenie jest trójwymiarowe: obejmuje całą wysokość od Y=0 do Y=255 (lub szczytu wymiaru), chyba że admin ograniczył wysokość w konfiguracji. Dzięki temu gracz chroni nie tylko powierzchnię, ale też podziemia i budowle na dachu.

Po utworzeniu rezydencji warto nadać jej opis i przypisać zaufanych graczy:

/res info NazwaRezydencji       # sprawdzenie informacji o rezydencji
/res set NazwaRezydencji message Mój dom!  # ustawienie opisu
/res pset NazwaRezydencji Gracz2 build t   # danie uprawnień do budowania innemu graczowi

Flagi ochronne

Sercem Residence są flagi - przełączniki kontrolujące, co może dziać się wewnątrz rezydencji. Każdą flagę można ustawić na true (dozwolone), false (zablokowane) lub usunąć (domyślne zachowanie serwera). Komendy: /res set NazwaRezydencji flagName t/f lub /res gui (graficzny interfejs).

Flagi można ustawiać też per gracz, co daje precyzyjną kontrolę. Przykład: publiczny budynek z ochroną skrzyń, ale możliwością używania drzwi przez wszystkich:

/res set MojBudynek use t          # wszyscy mogą używać drzwi/dźwigni
/res set MojBudynek container f   # nikt nie grzebie w skrzyniach
/res pset MojBudynek Znajomy container t  # poza Znajomym, który może

Subzony

Subzony to rezydencje wewnątrz rezydencji. Właściciel dużego terenu może wydzielić w nim mniejsze obszary z innymi uprawnieniami - na przykład publiczna farma na prywatnym gruntcie, gdzie goście mogą zbierać plony, ale nie budować.

Tworzenie subzony:

# Zaznacz obszar wewnątrz istniejącej rezydencji
/res select
# kliknij narożniki kiloofem
/res subzone GłównaRezydencja NazwaSubzony

Subzony dziedziczą flagi rodzica, ale możesz je nadpisać lokalnie. Jeśli w głównej rezydencji build jest false, subzona może mieć build true dla wybranych graczy. To pozwala tworzyć złożone struktury: miasto z prywatnymi działkami, wspólną fabryką i publicznym rynkiem - wszystko w jednej, zarządzanej hierarchii.

Właściciel może przypisać subzonę innemu graczowi poleceniem /res subzone z odpowiednimi flagami, przekazując mu niejako "podnajmowany" grunt bez utraty kontroli nad całością terenu.

Rynek gruntów

Residence oferuje wbudowany rynek nieruchomości - jeden z powodów, dla których plugin jest tak popularny na serwerach survival z ekonomią. Wymaga działającego Vault i pluginu ekonomii (np. EssentialsX).

Sprzedaż rezydencji

/res market sell NazwaRezydencji 5000   # wystawiasz za 5000 monet
/res market info NazwaRezydencji        # sprawdzasz cenę i status
/res market unsell NazwaRezydencji      # ściągasz ogłoszenie

Kupujący może obejrzeć rezydencję poleceniem /res tp NazwaRezydencji i sfinalizować zakup przez /res market buy NazwaRezydencji. Po transakcji właściciel się zmienia automatycznie - Residence aktualizuje flagi i uprawnienia.

Wynajem

/res market rent NazwaRezydencji 200 7d   # wynajem za 200 monet na 7 dni
/res market rentout NazwaRezydencji       # lista aktywnych wynajmów

Wynajem działa przez określony czas. Po wygaśnięciu, jeśli lokator nie odnowi, rezydencja wraca do właściciela wraz ze wszystkimi oryginalnymi flagami. To świetna mechanika dla serwerów z apartamentami na spawnie czy sklepami na targu.

Lista ogłoszeń

/res market list            # wszystkie rezydencje na sprzedaż
/res market list rent       # tylko te do wynajęcia

Uprawnienia graczy

Residence ma rozbudowany system uprawnień per gracz i per ranga. Właściciel rezydencji może nadać innym graczom konkretne flagi bez dawania im pełnej kontroli:

Uprawnienia można przydzielać też grupom (przez integrację z LuckPerms lub wbudowany system grup Residence). Na przykład ranga "VIP" może automatycznie mieć flagę move true w strefach premium, bez indywidualnego dodawania każdego gracza.

Admin serwera zarządza limitami przez uprawnienia LuckPerms. Przykładowe nody:

• residence.max.res.10 - gracz może mieć maksymalnie 10 rezydencji
• residence.max.size.10000 - łączna powierzchnia do 10 000 bloków X*Z
• residence.max.subzones.5 - do 5 subzon na rezydencję
• residence.admin - pełne uprawnienia administracyjne pluginu

Residence vs WorldGuard

Oba pluginy chronią tereny, ale celują w inne zastosowania. Oto zestawienie kluczowych różnic:

Najlepsza praktyka na serwerach survival to użycie obu równocześnie: WorldGuard dla stref administracyjnych (spawn, areny PvP, farmy publiczne) i Residence dla terenów grackich. Nie nakładaj ich obszarów na siebie - priorytety flag mogą powodować trudne do debugowania konflikty.

Komendy

Pełna lista najważniejszych komend Residence:

Konfiguracja

Główny plik konfiguracyjny to plugins/Residence/config.yml. Najważniejsze opcje do dostosowania po instalacji:

Global:
  # Limit rezydencji na gracza
  ResidenceMaxAmount: 10
  # Maksymalna powierzchnia (X*Z) łącznie dla gracza
  MaxResidenceSize: 10000
  # Koszt tworzenia rezydencji (za blok, wymaga Vault)
  ResidenceCostPerBlock: 0.1
  # Czy nowa rezydencja ma domyślnie włączoną ochronę build
  DefaultFlags:
    build: false
    destroy: false
    use: true
    container: false
    move: true
    pvp: false
    explode: false
    firespread: false

# Integracja z ekonomią
Economy:
  # Waluta z Vault
  UseEconomy: true

# Wiadomości po wejściu i wyjściu z rezydencji
Gui:
  # Czy pokazywać tytuł ekranowy przy wejściu na teren
  ShowTitleOnEnter: true
  TitleOnEnter: "&6Rezydencja &e{ResidenceName}"
  SubTitleOnEnter: "&7Właściciel: &f{Owner}"

Limity per ranga konfiguruje się przez LuckPerms lub w pliku plugins/Residence/groups.yml:

Groups:
  default:
    MaxRes: 3
    MaxSize: 5000
    MaxSubzones: 3
  vip:
    MaxRes: 10
    MaxSize: 20000
    MaxSubzones: 10
  premium:
    MaxRes: 25
    MaxSize: 50000
    MaxSubzones: 25

Po każdej zmianie w config.yml przeładuj plugin poleceniem /res reload z konsoli lub konta admin - restart serwera nie jest konieczny.

Porady dla adminów

• Ustaw koszt za blok - opcja ResidenceCostPerBlock sprawia, że gracze muszą zapracować na duże tereny. Zapobiega zaklejaniu mapy tysiącami pustych rezydencji-rezerwacji.
• Ogranicz wysokość zaznaczenia - parametr MaxHeight i MinHeight w config.yml pozwalają ograniczyć rezydencje do np. Y 40-200, żeby gracze nie blokowali podziemnych złóż rudy w warstwie betrock.
• Włącz powiadomienia o wejściu - opcja ShowTitleOnEnter buduje atmosferę: gracze widzą nazwę rezydencji i właściciela kiedy wchodzą na czyjś teren. Dobra mechanika społecznościowa.
• Użyj grup zamiast LuckPerms dla limitów - jeśli nie korzystasz z LuckPerms, plik groups.yml jest prostszą opcją do różnicowania limitów między rangami.
• Zablokuj flagę move w strefach admina - jeśli masz WorldGuard na spawnie, upewnij się że Residence nie może pokrywać tej strefy. Ustaw globalną rezydencję __global__ i ogranicz tworzenie nowych w promieniu spawnu.
• Monitoruj rozmiar bazy danych - Residence zapisuje każdą rezydencję w pliku plugins/Residence/data/. Na dużych serwerach po roku gry pliki mogą urosnąć do kilkudziesięciu MB. Regularnie czyść porzucone rezydencje przez /res listall i kontakt z graczami.
• Integracja z Dynmap - Residence ma wbudowane wsparcie dla Dynmap: opcja DynmapMarker rysuje granice rezydencji na mapie online. Gracze mogą przeglądać sąsiedztwo przed zakupem terenu.

Powiązane artykuły: WorldGuard (globalna ochrona stref), Vault (ekonomia dla rynku gruntów), EssentialsX (ekonomia i komendy serwera), katalog wszystkich pluginów.