CrazyCrates — wtyczka do dodawania niestandardowych skrzynek i nagród w Minecraft

CrazyCrates — wtyczka do dodawania niestandardowych skrzynek i nagród w Minecraft

CrazyCrates pozwala dodawać skrzynki (crates) na serwer Minecraft. Każda skrzynka to blok w świecie lub pozycja w menu, którą gracz otwiera kluczem, aby otrzymać losową nagrodę. Wtyczka oferuje 11 różnych typów animacji, dwa rodzaje kluczy — fizyczne (przedmioty w ekwipunku) i wirtualne (przechowywane w bazie danych) — oraz system szans oparty na wagach zamiast procentów. Rozprowadzana bezpłatnie. 

Menu główne /crates ze skrzynkami w postaci przedmiotów w ekwipunku 

Typy skrzynek 

Każda skrzynka na serwerze to oddzielny plik .yml w folderze crates/. W pliku znajduje się parametr CrateType, który określa animację otwierania.

Przy pierwszym uruchomieniu wtyczka generuje 6 gotowych przykładów, które obejmują 5 zatwierdzonych typów. Dowolną z nich można otworzyć testowo bez klucza za pomocą polecenia /crazycrates forceopen <nazwa_pliku> <nick>.

Wszystkie dostępne podstawowe skrzynki 

Przewijanie - w ekwipunku pojawia się pozioma wstęga przedmiotów, która przewija się, stopniowo zwalnia i zatrzymuje się na wygranym przedmiocie pośrodku. Ten typ wykorzystują dwa przykłady — CrateExample.yml i AdvancedExample.yml.

Wykonanie CrateExample — pozioma wstęga przedmiotów przewija się i zatrzymuje na wygranym

Cosmic — w ekwipunku pojawia się kilka nagród do wyboru. Gracz klika w tę, którą chce zabrać. Jeśli przez 10 sekund niczego nie wybierze, wtyczka automatycznie przyznaje jedną nagrodę. Casino — skrzynka z poziomami (tiers). Najpierw animacja określa poziom, a następnie w jego obrębie — konkretną nagrodę. 

QuadCrate — po otwarciu wokół gracza na świecie respią się cztery fizyczne bloki-skrzynki. Gracz podchodzi do każdego z nich i otwiera je po kolei — każdy daje osobną nagrodę. 

Wonder — pojawia się okno z pełnym ekwipunkiem, z którego stopniowo znikają przedmioty; ten, który pozostanie, będzie nagrodą.

Klucze

Każda skrzynka wykorzystuje własny klucz. Fizyczny klucz — to zwykły przedmiot o niestandardowym wyglądzie, nazwie i opisie (lore), który gracz trzyma w ekwipunku. Wirtualny klucz nie zajmuje miejsca — jest przechowywany w bazie danych wtyczki i powiązany z kontem gracza.

Domyślnie fizyczny blok skrzynki akceptuje oba typy. Zachowanie to można zmienić w config.yml osobno dla każdej kombinacji.

Jeśli podczas otrzymywania klucza ekwipunek gracza jest pełny, wtyczka albo konwertuje go na wirtualny, albo upuszcza na ziemię — w zależności od ustawień. Próba otwarcia skrzynki bez klucza odpycha gracza.

Administratorzy mogą wydawać i odbierać klucze nawet graczom offline, rozdawać klucz wszystkim graczom online za pomocą jednego polecenia lub wydawać losowy klucz ze wszystkich dostępnych skrzynek. Gracze z odpowiednimi uprawnieniami mogą przekazywać swoje wirtualne klucze innym.

Fizyczny klucz do skrzynki — przedmiot z niestandardowym opisem

System szans 

Prawdopodobieństwo wylosowania każdej nagrody jest określane nie przez procenty, ale przez wagę — parametr Weight w pliku skrzynki. Im wyższa wartość wagi, tym częściej wypada nagroda; im niższa — tym rzadziej.

Maksymalny zakres to suma wszystkich wag w skrzynce. Jeśli trzy nagrody mają wagi 10, 15 i 25, zakres wynosi 50. Szansa na pierwszą to 20%, na drugą — 30%, na trzecią — 50%.

Zaleta takiego podejścia w porównaniu z procentami: nie trzeba pilnować, aby suma nie przekraczała 100. Można po prostu ustawiać wartości względne i dodawać nowe nagrody bez przeliczania pozostałych.

Komendy

Główne polecenie wtyczki to /crazycrates, z odpowiednikami /crates i /cc. Gracze mają dostęp tylko do /keys (podgląd swoich kluczy) i /crates (otwarcie menu).

Komendy administracyjne:

• /crazycrates give i /crazycrates take — wydanie lub odebranie klucza wybranemu graczowi, również offline.

• /crazycrates giveall — rozdanie klucza wszystkim graczom online jednocześnie.

• /crazycrates forceopen — darmowe otwarcie skrzynki dla gracza, bez klucza.

• /crazycrates editor — tryb rozmieszczania skrzynek w świecie: wskazujesz blok i przypisujesz do niego skrzynkę.

• /crazycrates debug — otrzymanie od razu wszystkich nagród ze skrzynki w celu przetestowania ustawień.

• /crazycrates mass-open — masowe otwarcie określonej liczby skrzynek naraz.

• /crazycrates reload — ponowne załadowanie wszystkich konfiguracji bez restartowania serwera.

• /crazycrates migrate — import skrzynek z innych wtyczek lub konwersja przestarzałego formatu plików.

Uprawnienia są podzielone na trzy maski (wildcards): crazycrates.players.* dla graczy, crazycrates.admin.* dla administratorów, crazycrates.schematic.* do pracy ze schematami (schematics). Gracza można wykluczyć z masowego rozdawnictwa /giveall za pomocą osobnego uprawnienia.

Konfiguracja

Wszystkie pliki wtyczki znajdują się w folderze plugins/CrazyCrates/. Główny to config.yml, w którym skupione są globalne ustawienia serwera. Skrzynki są przechowywane w podfolderze crates/ — każda w osobnym pliku. Folder examples/ zawiera przykłady od deweloperów, ale nie należy ich edytować: jest on całkowicie nadpisywany przy każdym wykonaniu /crazycrates reload. Wszystkie teksty wiadomości przeniesiono do pliku messages.yml i są one edytowane osobno.

W pliku config.yml warto zwrócić uwagę na kilka rzeczy. Hologramy nad skrzynkami pojawiają się automatycznie, jeśli na serwerze zainstalowano DecentHolograms, FancyHolograms lub CMI — wtyczka sama je wykryje. Jeśli żadnego z nich nie ma, hologramów po prostu nie będzie. Komunikaty do graczy można kierować na czat lub na pasek akcji (action bar) — w zależności od konfiguracji serwera. Logowanie operacji związanych z kluczami i skrzynkami jest włączane osobno dla konsoli i dla pliku; logi plikowe są archiwizowane do zip przy restarcie.

Każda skrzynka jest konfigurowana we własnym pliku. Oprócz typu animacji i listy nagród określa się tam wygląd klucza fizycznego, tekst hologramu nad blokiem, rozmiar i wygląd okna podglądu, dźwięki podczas losowania i po jego zakończeniu, a także możliwość ponownego losowania (reroll), jeśli wynik nie jest satysfakcjonujący.

Wnioski

CrazyCrates dodaje systemy animacji zarówno do sklepów za dotacje, jak i do progresji w grze na survivalu. System szans oparty na wagach jest wygodniejszy niż system procentowy podczas częstego edytowania — nie trzeba za każdym razem przeliczać całej listy.

Dla serwerów PvP i survival z systemem dotacji CrazyCrates to świetny wybór. Na prostym serwerze, gdzie potrzebna jest tylko jedna skrzynka bez animacji, wystarczy QuickCrate i minimalna konfiguracja.