MiningRewards — Przegląd

Przegląd

Ta dokumentacja opisuje MiningRewards 4.5.0: 20 rodzajów nagród, tworzenie i edycję w GUI, ograniczenia światów i regionów, uprawnienia oraz ochronę przed nagradzaniem za postawione bloki. Poniższy katalog zachowuje dokładne identyfikatory Reward_type używane w plikach nagród.

Pierwsza nagroda
Uruchom /mr create example_reward. Wybierz typ, bloki aktywujące, skonfiguruj wartości, ustaw szansę i pozostałe warunki przed zapisaniem. Użyj /mr list, aby sprawdzić zapisaną nagrodę. Testuj w Survival na naturalnym pasującym bloku; Creative i bloki postawione przez graczy są domyślnie wykluczone.

Lista ma strony i sortowanie A–Z/Z–A. Szczegóły podglądu są w opisie przedmiotu przy odpowiednim uprawnieniu. Lewe kliknięcie otwiera edytor. Shift + prawe uzbraja usunięcie; powtórz, aby potwierdzić. Komenda remove usuwa bez tego potwierdzenia GUI. Edycja nie wymaga ponownego tworzenia nagrody, ale zmiana jej typu nie jest opcją edytora.

Warunki i aktywacja
Blok może pasować do wielu nagród z własną szansą i ograniczeniami. GUI przyjmuje 0.01–100%; wartość 0 w pliku nigdy nie aktywuje nagrody. Domyślny limit wynosi 3 pomyślne nagrody na blok. Cooldown jest sprawdzany przed pętlą nagród, więc ogranicza późniejsze niszczenia bloków, a nie liczbę nagród z tego samego zdarzenia. Anulowane zdarzenia i rekurencyjne zdarzenia Vein Burst nie uruchamiają przetwarzania nagród.

Globalne DisabledWorlds blokuje wszystkie nagrody w pasujących światach. Lista DisabledWorlds nagrody dodaje własne ograniczenie. Przy dostępnym WorldEdit i WorldGuard wyłączone regiony mają pierwszeństwo; niepusta lista dozwolonych wymaga bloku w dozwolonym regionie. Bez integracji lub dostępnego menedżera regionów ograniczenia regionów nie są egzekwowane. Wybieraj istniejące regiony i załadowane światy w GUI.

Wszystkie typy nagród
DROP_ITEM — Upuszczenie przedmiotu
– Przyznaj graczowi dodatkowy konfigurowalny przedmiot.
MULTIPLE_DROP — Wielokrotny drop
– Przyznaj wiele kopii przedmiotu wydobytego bloku.
GIVE_MONEY — Przyznanie pieniędzy
– Nagradzaj gracza walutą serwera przez Vault.
GIVE_LEVEL — Przyznanie poziomu
– Przyznaj jeden lub więcej poziomów doświadczenia.
GIVE_EXPERIENCE — Przyznanie doświadczenia
– Przyznaj konfigurowalną ilość bezpośredniego doświadczenia.
SPAWN_BONUS_CHEST — Przywołanie skrzyni bonusowej
– Utwórz skrzynię zawierającą skonfigurowane przedmioty nagrody.
GIVE_POTION_EFFECT — Przyznanie efektu mikstury
– Nałóż wybrany efekt mikstury na skonfigurowany czas.
COMMAND — Komenda
– Wykonaj jedną lub więcej komend serwera przy aktywacji nagrody. Obsługuje zmienne takie jak %PLAYER% oraz %BLOCK%.
REPAIR_TOOL — Naprawa narzędzia
– Napraw narzędzie użyte do wykopania bloku.
EXPLOSION_REWARD — Nagroda eksplozji
– Utwórz eksplozję w lokalizacji wykopanego bloku.
RENEW_BLOCK — Odnowienie bloku
– Zastąp wykopany blok tym samym typem bloku.
CYCLE_ORE — Zmiana rudy
– Zastąp wykopany blok losowo wybraną skonfigurowaną rudą.
ENCHANTMENT_REWARD — Nagroda zaklęcia
– Dodaj wybrane zaklęcie i poziom do narzędzia górniczego gracza.
GIVE_RANDOM_EFFECT — Przyznanie losowego efektu
– Przyznaj graczowi jeden losowy efekt ze skonfigurowanej listy.
VEIN_BURST — Wydobycie żyły
– Automatycznie wydobywaj połączone bloki rudy z konfigurowalnym promieniem i limitem bloków.
GOLDEN_APPLE — Złote jabłko
– Nałóż konfigurowalną regenerację, absorpcję i korzyści żywieniowe oparte na nagrodzie złotego jabłka.
ORE_SMELTER — 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.
PROSPECTOR_PULSE — 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.
MINING_SHIELD — 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ę.
AUTO_PICKUP — 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.

Szczególne zachowanie nagród
Auto Pickup zbiera zwykłe zdarzenie dropu aktywowanego bloku, a nie każdego kolejnego bloku. CollectExperience przyznaje XP tego bloku od razu; OverflowAtPlayer wybiera miejsce wypadania nadmiaru. Zwykły drop jest dla tej nagrody wymuszony. Inne nagrody wyłączające zwykły drop mogą uniemożliwić zbieranie, więc testuj ich połączenia na tym samym bloku.

Mining Shield przyznaje 1–20 ładunków na aktywację, trwa 5–600 sekund i zmniejsza obrażenia o 10–100%. Powtórne aktywacje łączą ładunki do 100 i zachowują późniejsze wygaśnięcie oraz silniejszą redukcję. Każde kwalifikujące się zdarzenie obrażeń zużywa ładunek. Przyczyny VOID, SUICIDE i KILL są wykluczone. Tarcze znikają przy śmierci, wylogowaniu i wyłączeniu pluginu.

Prospector Pulse skanuje załadowany teren: promień 4–24, 1–8 celów i czas 2–30 sekund. HiddenOnly wymaga zakrytych bloków rudy. TargetOres wybiera grupy rud. Wyświetla prywatne wskazówki cząsteczek i bossbar, nie wydobywa celów i informuje o braku wyników. Nowa aktywacja zastępuje poprzedni impuls gracza.

Vein Burst podąża za połączonymi blokami tego samego materiału, także po przekątnej, w promieniu 1–8. Limit jest mniejszą z wartości MaxBlocks i Safety.MaxVeinBurstBlocks i obejmuje blok początkowy. Dodatkowe niszczenia są przekazywane pluginom ochrony i nie uruchamiają kolejnych łańcuchów MiningRewards. Przetwarza tylko załadowany teren.