CrazyCrates — een plug-in voor het toevoegen van aangepaste kisten en beloningskratten in Minecraft

CrazyCrates — een plug-in voor het toevoegen van aangepaste kisten en beloningskratten in Minecraft

CrazyCrates maakt het mogelijk om kratten (crates) aan een Minecraft-server toe te voegen. Elke kist is een blok in de wereld of een positie in een menu die de speler opent met een sleutel om een willekeurige prijs te ontvangen. De plug-in biedt 11 verschillende soorten animaties, twee soorten sleutels — fysieke (items in de inventaris) en virtuele (opgeslagen in de database) — en een op gewicht gebaseerd kansensysteem in plaats van percentages. Het wordt gratis gedistribueerd. 

Hoofdmenu /crates met kisten weergegeven als items in de inventaris 

Soorten kisten 

Elke kist op de server is een aparte .yml-file in de crates/ map. Het bestand heeft een CrateType-parameter, die de openingsanimatie bepaalt.

Bij de eerste keer opstarten genereert de plug-in 6 kant-en-klare voorbeelden die 5 bevestigde typen dekken. Je kunt ze elk testen zonder sleutel met de opdracht /crazycrates forceopen <bestandsnaam> <nickname>.

Alle beschikbare basiskisten 

Scroll - in de inventaris verschijnt een horizontaal lint van items dat scrolt, geleidelijk vertraagt en stopt bij het winnende item in het midden. Dit type wordt door twee voorbeelden gebruikt — CrateExample.yml en AdvancedExample.yml.

Uitvoering CrateExample — een horizontaal lint van items scrolt en stopt bij de winnaar

Cosmic — in de inventaris verschijnen verschillende prijzen om uit te kiezen. De speler klikt op de prijs die hij wil nemen. Als er binnen 10 seconden niets wordt geselecteerd, geeft de plug-in automatisch een prijs. Casino — een kist met niveaus (tiers). Eerst bepaalt de animatie het niveau en daarna daarin — de specifieke prijs. 

QuadCrate — bij opening spawnen er vier fysieke kist-blokken rondom de speler in de wereld. De speler benadert elk van hen en opent ze één voor één — elk geeft een aparte prijs. 

Wonder — er verschijnt een venster met een volledige inventaris waaruit de items geleidelijk verdwijnen; degene die overblijft, wordt de prijs.

Sleutels

Elke kist gebruikt zijn eigen sleutel. Een fysieke sleutel — is een regulier item met een aangepast uiterlijk, naam en beschrijving (lore), die de speler in zijn inventaris bewaart. Een virtuele sleutel neemt geen ruimte in beslag — hij is opgeslagen in de database van de plug-in en is gekoppeld aan het account van de speler.

Standaard accepteert een fysiek kistblok beide typen. Het gedrag kan afzonderlijk per combinatie worden gewijzigd in config.yml.

Als de inventaris van de speler vol is bij ontvangst van een sleutel, converteert de plug-in deze in een virtuele of laat hem op de grond vallen — afhankelijk van de instellingen. Pogingen om een kist zonder sleutel te openen duwt de speler terug.

Beheerders kunnen sleutels geven en wegnemen, zelfs bij offline spelers, een sleutel tegelijk aan alle online spelers uitdelen via een enkele opdracht, of een willekeurige sleutel geven van alle beschikbare kisten. Spelers met de juiste toestemming kunnen hun virtuele sleutels aan anderen overdragen.

Fysieke sleutel voor een kist — een item met een aangepaste beschrijving

Kansensysteem 

De kans op elke prijs wordt niet bepaald door percentages, maar door gewicht — de parameter Weight in het bestand van de kist. Hoe hoger de gewichtswaarde, hoe vaker de prijs valt; hoe lager, hoe minder vaak.

Het maximale bereik is de som van alle gewichten in de kist. Als drie prijzen de gewichten 10, 15 en 25 hebben, is het bereik 50. De kans op de eerste is 20%, de tweede — 30% en de derde — 50%.

Het voordeel van deze benadering ten opzichte van percentages: het is niet nodig om ervoor te zorgen dat de som niet boven de 100 uitkomt. Je kunt gewoon relatieve waarden instellen en nieuwe prijzen toevoegen zonder de rest opnieuw te hoeven berekenen.

Opdrachten

De hoofdopdracht van de plug-in is /crazycrates, met aliassen /crates en /cc. Spelers hebben alleen toegang tot /keys (bekijk hun sleutels) en /crates (open het menu).

Admin-opdrachten:

• /crazycrates give en /crazycrates take — een sleutel geven of afnemen van een specifieke speler, zelfs offline.

• /crazycrates giveall — tegelijkertijd een sleutel uitdelen aan alle online spelers.

• /crazycrates forceopen — een kist voor een speler gratis openen, zonder sleutel.

• /crazycrates editor — plaatsingsmodus voor kisten in de wereld: je wijst naar een blok en koppelt er een kist aan.

• /crazycrates debug — in één keer alle prijzen van de kist ontvangen om de instellingen te testen.

• /crazycrates mass-open — massaal openen van een opgegeven aantal kisten tegelijk.

• /crazycrates reload — herlaad alle configuraties zonder de server opnieuw te starten.

• /crazycrates migrate — kisten importeren vanuit andere plug-ins of het oude bestandsformaat converteren.

Rechten zijn verdeeld in drie wildcards: crazycrates.players.* voor spelers, crazycrates.admin.* voor admins, crazycrates.schematic.* voor het werken met schematics. Een speler kan via een aparte toestemming worden uitgesloten van een massale /giveall.

Instellingen

Alle plug-inbestanden bevinden zich in de map plugins/CrazyCrates/. De belangrijkste is config.yml, waar wereldwijde serverinstellingen zijn geconcentreerd. Kisten worden opgeslagen in de submap crates/ — elk in een afzonderlijk bestand. De map examples/ bevat voorbeelden van de ontwikkelaars, maar u moet ze niet bewerken: deze wordt volledig overschreven bij elke /crazycrates reload. Alle berichtteksten zijn overgezet naar messages.yml en worden afzonderlijk bewerkt.

In config.yml moet u op een paar dingen letten. Hologrammen boven kisten verschijnen automatisch als DecentHolograms, FancyHolograms of CMI op de server is geïnstalleerd — de plug-in pikt ze zelf op. Als die er niet is, komen er gewoon geen hologrammen. Berichten aan spelers kunnen naar de chat of de actiebalk (action bar) worden gestuurd — afhankelijk van hoe de server is ingesteld. Loggen van acties met sleutels en kisten is afzonderlijk ingeschakeld voor de console en voor het bestand; bestandslogboeken worden bij een herstart in zip gearchiveerd.

Elke kist wordt in een eigen bestand geconfigureerd. Naast het animatietype en de prijzenlijst definieert het het uiterlijk van de fysieke sleutel, de hologramtekst boven het blok, de grootte en het ontwerp van het voorbeeldvenster, geluiden tijdens het scrollen en bij voltooiing, evenals de mogelijkheid om opnieuw te rollen (reroll) als het resultaat niet naar tevredenheid was.

Conclusie

CrazyCrates voegt animatiesystemen toe voor zowel donatiewinkels als de spelvoortgang in survival. Het op gewicht gebaseerde kansensysteem is handiger dan percentages bij actief bewerken — je hoeft niet elke keer de hele lijst opnieuw te berekenen.

Voor PvP- en survivalservers met een donatiesysteem is CrazyCrates een handige keuze. Voor een simpele server waar één kist zonder animaties nodig is, zijn QuickCrate en minimale configuratie voldoende.