CrazyCrates — plugin pro přidání vlastních beden a truhel s odměnami v Minecraftu

CrazyCrates — plugin pro přidání vlastních beden a truhel s odměnami v Minecraftu

CrazyCrates umožňuje přidávat na server Minecraftu bedny (crates). Každá bedna je blok ve světě nebo pozice v menu, kterou hráč otevře klíčem a získá náhodnou cenu. Plugin poskytuje 11 různých typů animací, dva typy klíčů — fyzické (předměty v inventáři) a virtuální (uložené v databázi) — a systém šancí založený na váze místo procent. Je šířen zdarma. 

Hlavní menu /crates s bednami zobrazenými jako předměty v inventáři 

Typy beden 

Každá bedna na serveru je samostatný .yml soubor ve složce crates/. Soubor má parametr CrateType, který určuje animaci otevírání.

Při prvním spuštění plugin vygeneruje 6 hotových příkladů, které pokrývají 5 potvrzených typů. Kterýkoli z nich můžete otevřít pro test bez klíče pomocí příkazu /crazycrates forceopen <název_souboru> <přezdívka>.

Všechny dostupné základní bedny 

Scroll - v inventáři se objeví horizontální pás předmětů, který se posouvá, postupně zpomaluje a zastaví se na vítězném předmětu uprostřed. Tento typ využívají dva příklady — CrateExample.yml a AdvancedExample.yml.

Provedení CrateExample — horizontální pás předmětů se posouvá a zastaví na vítězi

Cosmic — v inventáři se objeví několik cen na výběr. Hráč klikne na tu, kterou si chce vzít. Pokud není do 10 sekund vybráno nic, plugin automaticky vydá jednu cenu. Casino — bedna s úrovněmi (tiers). Animace nejprve určí úroveň a poté v ní — konkrétní cenu. 

QuadCrate — při otevření se kolem hráče ve světě objeví čtyři fyzické bloky beden. Hráč k nim přistoupí a otevírá je jednu po druhé — každá dá samostatnou cenu. 

Wonder — objeví se okno s plným inventářem, ze kterého předměty postupně mizí; ten, který zůstane, bude výhrou.

Klíče

Každá bedna používá svůj vlastní klíč. Fyzický klíč — je běžný předmět s vlastním vzhledem, názvem a popisem (lore), který hráč drží ve svém inventáři. Virtuální klíč nezabírá místo — je uložen v databázi pluginu a je vázán k účtu hráče.

Ve výchozím nastavení přijímá fyzický blok bedny oba typy. Chování lze změnit v config.yml samostatně pro každou kombinaci.

Pokud je inventář hráče při přijímání klíče plný, plugin jej buď převede na virtuální, nebo jej upustí na zem — v závislosti na nastavení. Pokus o otevření bedny bez klíče hráče odstrčí.

Administrátoři mohou dávat a odebírat klíče i offline hráčům, rozdat klíč všem online hráčům najednou pomocí jediného příkazu nebo dát náhodný klíč ze všech dostupných beden. Hráči s příslušným oprávněním mohou převádět své virtuální klíče na ostatní.

Fyzický klíč k bedně — předmět s vlastním popisem

Systém šancí 

Pravděpodobnost každé ceny není určena procenty, ale váhou — parametrem Weight v souboru bedny. Čím vyšší je hodnota váhy, tím častěji cena padá; čím nižší, tím méně často.

Maximální rozsah je součet všech vah v bedně. Pokud mají tři ceny váhy 10, 15 a 25, je rozsah 50. Šance na první je 20 %, na druhou — 30 % a na třetí — 50 %.

Výhoda tohoto přístupu oproti procentům: Není nutné zajistit, aby součet nepřesáhl 100. Můžete jednoduše nastavit relativní hodnoty a přidat nové ceny bez přepočítávání zbytku.

Příkazy

Hlavní příkaz pluginu je /crazycrates s aliasy /crates a /cc. Hráči mají přístup pouze k /keys (prohlížení svých klíčů) a /crates (otevření menu).

Příkazy pro adminy:

• /crazycrates give a /crazycrates take — dejte nebo odeberte klíč konkrétnímu hráči, včetně těch offline.

• /crazycrates giveall — distribuovat klíč všem online hráčům současně.

• /crazycrates forceopen — otevřít bednu pro hráče zdarma, bez klíče.

• /crazycrates editor — režim umisťování beden ve světě: ukážete na blok a svážete s ním bednu.

• /crazycrates debug — získejte všechny ceny bedny najednou a otestujte nastavení.

• /crazycrates mass-open — masové otevírání zadaného počtu beden najednou.

• /crazycrates reload — znovu načíst všechny konfigurace bez restartování serveru.

• /crazycrates migrate — importovat bedny z jiných pluginů nebo převést starší formát souborů.

Oprávnění jsou rozdělena na tři wildcards: crazycrates.players.* pro hráče, crazycrates.admin.* pro adminy, crazycrates.schematic.* pro práci se schematics. Hráče lze vyloučit z hromadné distribuce /giveall pomocí samostatného oprávnění.

Nastavení

Všechny soubory pluginu jsou umístěny ve složce plugins/CrazyCrates/. Hlavní je config.yml, kde jsou soustředěna globální nastavení serveru. Bedny jsou uloženy v podsložce crates/ — každá v samostatném souboru. Složka examples/ obsahuje příklady od vývojářů, ale neměli byste je upravovat: při každém načtení /crazycrates reload se zcela přepíše. Všechny texty zpráv jsou vyjmuty do messages.yml a upravují se samostatně.

V souboru config.yml byste měli věnovat pozornost několika věcem. Hologramy nad bednami se objeví automaticky, pokud je na serveru nainstalován DecentHolograms, FancyHolograms nebo CMI — plugin je sám zachytí. Pokud tam žádný není, hologramy jednoduše nebudou. Zprávy hráčům lze směrovat buď do chatu, nebo do action baru — v závislosti na tom, jak je server nastaven. Protokolování akcí s klíči a bednami je povoleno samostatně pro konzoli a pro soubor; soubory protokolů se při restartu archivují do formátu zip.

Každá bedna je nakonfigurována ve svém vlastním souboru. Kromě typu animace a seznamu cen definuje vzhled fyzického klíče, text hologramu nad blokem, velikost a vzhled okna s náhledem, zvuky během posouvání a po dokončení, stejně jako možnost znovu vytočit (reroll) cenu, pokud výsledek nebyl uspokojivý.

Závěr

CrazyCrates přidává systémy animací jak pro obchody s dary, tak pro postup ve hře v přežití. Systém šancí založený na váze je při aktivní editaci pohodlnější než ten procentuální — není nutné pokaždé přepočítávat celý seznam.

Pro PvP a survival servery se systémem darů je CrazyCrates pohodlnou volbou. Pro jednoduchý server, kde je potřeba jedna bedna bez animací, postačí QuickCrate a minimální konfigurace.