MiningRewards

MiningRewards pozwala nagradzać graczy za wydobywanie wybranych bloków na serwerach Spigot i Paper. Nagrody tworzysz i dopasowujesz w menu gry, mając wszystkie potrzebne ustawienia pod ręką.

Nagrody mogą przyznawać przedmioty, pieniądze, doświadczenie, efekty mikstur i zaklęcia. Mogą też uruchamiać komendy, naprawiać narzędzia, zastępować lub przekształcać bloki, wydobywać połączone żyły rud i skanować pobliski teren. Mining Shield zapewnia tymczasową ochronę, a Auto Pickup kieruje wydobyte przedmioty prosto do ekwipunku gracza.

✅ Tworzenie i zarządzanie nagrodami

• Zarządzanie przez GUI – Twórz, edytuj, przeglądaj, sortuj i usuwaj nagrody bezpośrednio w menu ekwipunku.
  
• Kreator nagród krok po kroku – Konfiguruj każdą nagrodę za pomocą kreatora z osobnymi krokami dla:
  
  • Nazwa nagrody
    
  • Typ nagrody
    
  • Bloki aktywujące
    
  • Ustawienia właściwe dla nagrody
    
  • Szansa aktywacji
    
  • Dostęp VIP
    
  • Wyłączone światy
    
  • Regiony WorldGuard
    
  • Zwykłe przedmioty z bloków
    
  
  
• Osobne pliki nagród – Każda nagroda jest przechowywana w osobnym pliku w folderze Rewards.
  
• Bezpieczne nazwy nagród – Nazwy nagród są sprawdzane przed tworzeniem, zmianą nazwy, wczytywaniem lub usuwaniem nagród.
  
• Automatyczne aktualizacje konfiguracji – Brakujące wpisy konfiguracji i wiadomości są w razie potrzeby dodawane przy starcie.
  

✅ 20 typów nagród
Do wyboru masz następujące rodzaje nagród:

• Upuszczenie przedmiotu – Przyznaj graczowi dodatkowy konfigurowalny przedmiot.
  
• Wielokrotny drop – Przyznaj wiele kopii przedmiotu wydobytego bloku.
  
• Przyznanie pieniędzy – Nagradzaj gracza walutą serwera przez Vault.
  
• Przyznanie poziomu – Przyznaj jeden lub więcej poziomów doświadczenia.
  
• Przyznanie doświadczenia – Przyznaj konfigurowalną ilość bezpośredniego doświadczenia.
  
• Przywołanie skrzyni bonusowej – Utwórz skrzynię zawierającą skonfigurowane przedmioty nagrody.
  
• Przyznanie efektu mikstury – Nałóż wybrany efekt mikstury na skonfigurowany czas.
  
• Komenda – Wykonaj jedną lub więcej komend serwera przy aktywacji nagrody. Obsługuje zmienne takie jak %PLAYER% oraz %BLOCK%.
  
• Naprawa narzędzia – Napraw narzędzie użyte do wykopania bloku.
  
• Nagroda eksplozji – Utwórz eksplozję w lokalizacji wykopanego bloku.
  
• Odnowienie bloku – Zastąp wykopany blok tym samym typem bloku.
  
• Zmiana rudy – Zastąp wykopany blok losowo wybraną skonfigurowaną rudą.
  
• Nagroda zaklęcia – Dodaj wybrane zaklęcie i poziom do narzędzia górniczego gracza.
  
• Przyznanie losowego efektu – Przyznaj graczowi jeden losowy efekt ze skonfigurowanej listy.
  
• Wydobycie żyły – Automatycznie wydobywaj połączone bloki rudy z konfigurowalnym promieniem i limitem bloków.
  
• Złote jabłko – Nałóż konfigurowalną regenerację, absorpcję i korzyści żywieniowe oparte na nagrodzie złotego jabłka.
  
• Przetapiacz rud – Zastąp surowe przedmioty z rud sztabkami. Można skonfigurować Fortunę, doświadczenie z pieca i efekty wizualne. Obsługuje żelazo, złoto, miedź i pradawne zgliszcza.
  
• Impuls poszukiwacza – Skanuj załadowany teren w poszukiwaniu wybranych rud i pokazuj graczowi prywatny kompas z cząsteczek. Można skonfigurować promień, czas, grupy rud, maksymalną liczbę celów i tryb tylko ukrytych rud.
  
• Tarcza górnicza – Przyznaj tymczasową tarczę opartą na ładunkach, z konfigurowalną liczbą ładunków, czasem, redukcją obrażeń i efektami wizualnymi. Kolejne aktywacje dodają ładunki do limitu bezpieczeństwa i zachowują silniejszą ochronę.
  
• Automatyczne zbieranie – Kieruj przedmioty z wykopanego bloku bezpośrednio do ekwipunku gracza. Opcjonalnie zbieraj doświadczenie bloku natychmiast, wybieraj, czy nadmiar przedmiotów ma wypadać przy graczu czy bloku, i włączaj efekty zbierania. Zawiera osobne ustawienia kreatora i edytora.
  

✅ Warunki nagród i kontrola szans

• Wiele bloków aktywujących – Przypisz kilka typów bloków do jednej nagrody zamiast tworzyć osobną nagrodę dla każdego bloku.
  
• Indywidualna szansa aktywacji – Konfiguruj szansę każdej nagrody niezależnie, od 0.01% do 100%.
  
• Szybka regulacja szansy – Dostosowuj szansę bezpośrednio w GUI, używając kroków 0.01%, 0.1%, 1% oraz 10%.
  
• Wiele nagród z jednego bloku – Przypisz kilka nagród do tego samego bloku, każdą z własną szansą i ograniczeniami.
  
• Kontrola zwykłego dropu – Zdecyduj, czy wykopany blok nadal ma upuszczać swój zwykły przedmiot po aktywacji nagrody. Auto Pickup pozostawia zwykły drop włączony, aby móc go zebrać.
  

✅ Ustawienia globalne i ochrona przed nadużyciami

• Globalny przełącznik nagród – Włączaj lub wyłączaj przetwarzanie nagród dla zwykłych graczy bez usuwania skonfigurowanych nagród.
  
• Obejście administracyjne – Pozwalaj uprawnionej administracji nadal otrzymywać nagrody, gdy globalny przełącznik jest wyłączony.
  
• Ochrona bloków postawionych – Zapobiegaj stawianiu i wielokrotnemu niszczeniu własnych bloków w celu farmienia nagród.
  
• Trwała baza ochrony – Lokalizacje bloków postawionych przez graczy są zapisywane w SQLite i pozostają chronione po restartach serwera.
  

✅ Bezpieczeństwo nagród i kontrola wydajności

• Limit nagród na blok – Ogranicz liczbę nagród aktywowanych przez jedno zniszczenie bloku. Domyślnie jest to 3, konfigurowalne przez Safety.MaxRewardsPerBlockBreak.
  
• Czas odnowienia gracza – Opcjonalnie ustaw odstęp w tickach między pomyślnymi aktywacjami nagród dla każdego gracza. Domyślnie wyłączony.
  
• Kontrola trybu Creative – Domyślnie pomijaj nagrody dla graczy w Creative, z możliwością zmiany ustawienia.
  
• Limity wydobycia żyły – Połącz promień i limit bloków każdej nagrody z globalnym maksimum wydobywanych bloków. Dodatkowe bloki wywołują zdarzenia niszczenia, aby pluginy ochrony mogły je anulować, bez uruchamiania rekurencyjnych łańcuchów nagród.
  
• Kontrola eksplozji – Konfiguruj maksymalną siłę eksplozji i możliwość niszczenia bloków przez eksplozje nagród. Niszczenie bloków jest domyślnie wyłączone.
  
• Limity zaklęć – Domyślnie używaj normalnych limitów poziomu zaklęć, z opcjonalnym ustawieniem niebezpiecznych zaklęć.
  
• Ograniczenia komend – Ustaw maksymalną długość komendy i blokowane prefiksy dla nagród komend.
  
• Walidacja nagród – Pomijaj nagrody z brakującymi lub nieprawidłowymi wymaganymi wartościami. Błędy podczas wykonania są zapisywane w logu, a nieudana nagroda jest pomijana.
  

✅ Ograniczenia światów

• Globalnie wyłączone światy – Wyłączaj nagrody za kopanie w wybranych światach z ustawień globalnych.
  
• Światy wyłączone dla nagrody – Wyłączaj pojedynczą nagrodę w wybranych światach przez stronicowane GUI.
  

✅ Obsługa regionów WorldGuard
Po zainstalowaniu WorldEdit i WorldGuard możesz ograniczyć działanie nagród do wybranych regionów:

• Dozwolone regiony – Pozwalaj nagrodzie aktywować się tylko wewnątrz wybranych regionów WorldGuard.
  
• Wyłączone regiony – Zapobiegaj aktywacji nagrody w wybranych regionach.
  
• GUI zarządzania regionami – Dodawaj, usuwaj i resetuj dozwolone lub wyłączone regiony bezpośrednio w menu ekwipunku.
  

✅ Uprawnienia nagród

• Opcjonalne nagrody VIP – Oznaczaj pojedyncze nagrody jako chronione uprawnieniami.
  
• Globalny wymóg uprawnienia – Wymagaj uprawnienia dla każdej skonfigurowanej nagrody.
  
• Uprawnienie wszystkich nagród – Przyznawaj dostęp do wszystkich nagród chronionych uprawnieniami za pomocą miningrewards.reward.all.
  
• Uprawnienie pojedynczej nagrody – Przyznawaj dostęp do jednej wybranej nagrody za pomocą miningrewards.reward.<reward_name>.
  
• Osobne uprawnienia administracji – Kontroluj niezależnie dostęp do menu głównego, listy nagród, podglądu, kreatora, edytora, usuwania i ustawień globalnych.
  

✅ Lista nagród i GUI podglądu

• Stronicowana lista nagród – Przeglądaj wszystkie skonfigurowane nagrody w uporządkowanym menu ekwipunku.
  
• Szczegółowy podgląd – Wyświetlaj typ nagrody, bloki aktywujące, szansę, status VIP, zwykły drop, ograniczenia regionów i wartości właściwe dla nagrody.
  
• Sortowanie – Przełączaj kolejność alfabetyczną A–Z oraz Z–A.
  
• Szybka edycja – Otwieraj kompletny edytor przez Lewe kliknięcie.
  
• Bezpieczne usuwanie – Usuwaj nagrodę za pomocą chronionego potwierdzenia Shift + prawe kliknięcie.
  

✅ Kompletny edytor nagród
Istniejącą nagrodę możesz edytować w dowolnym momencie, bez tworzenia jej od nowa. Zależnie od jej rodzaju zmienisz:

• Nazwa nagrody
  
• Bloki aktywujące
  
• Szansa aktywacji
  
• Wartości właściwe dla nagrody
  
• Wymóg VIP
  
• Zwykłe przedmioty z bloków
  
• Wyłączone światy
  
• Regiony WorldGuard
  

✅ Efekty, dźwięki i wiadomości

• Efekty aktywacji – Wyświetlaj konfigurowalne efekty wizualne przy aktywacji nagrody.
  
• Dźwięki aktywacji – Odtwarzaj konfigurowalny dźwięk po pomyślnej nagrodzie.
  
• Wiadomości gracza – Wysyłaj informacje o nagrodzie graczowi, który ją aktywował.
  
• Globalne ogłoszenia – Ogłaszaj pomyślne nagrody innym graczom online.
  
• Wiadomości konsoli – Zapisuj pomyślne aktywacje nagród w konsoli serwera.
  
• Niezależne przełączniki – Osobno włączaj lub wyłączaj wiadomości gracza, globalne ogłoszenia i wiadomości konsoli.
  
• Edytowalne wiadomości – Dostosowuj prefiksy, wiadomości, wartości i zmienne w Messages.yml.
  

✅ Komendy i administracja
Użyj /miningrewards lub aliasu /mr, aby otworzyć menu główne i narzędzia administracyjne:

• /miningrewards
  
• /miningrewards list
  
• /miningrewards create
  
• /miningrewards create <reward_name>
  
• /miningrewards edit <reward_name>
  
• /miningrewards remove <reward_name>
  
• /miningrewards globalsettings
  

Podpowiedzi pod klawiszem Tab ułatwiają wpisywanie podkomend pluginu.

✅ Integracje i zgodność

• Ekonomia Vault – Nagrody pieniężne stają się dostępne po zainstalowaniu Vault i zgodnego dostawcy ekonomii.
  
• WorldEdit i WorldGuard – Opcjonalne ograniczenia nagród według regionów.
  
• SQLite – Trwałe przechowywanie ochrony bloków postawionych.
  
• Spigot i Paper – Zaprojektowany dla serwerów korzystających z API Spigot/Paper 26.2 i Java 25.