CrazyCrates — un plugin pour ajouter des caisses personnalisées et des coffres de récompenses dans Minecraft

CrazyCrates — un plugin pour ajouter des caisses personnalisées et des coffres de récompenses dans Minecraft

CrazyCrates permet d'ajouter des caisses (crates) sur un serveur Minecraft. Chaque caisse est un bloc dans le monde ou un élément dans un menu que le joueur ouvre avec une clé pour recevoir un prix aléatoire. Le plugin propose 11 types d'animations différentes, deux types de clés — physiques (objets dans l'inventaire) et virtuelles (stockées dans la base de données) — et un système de chances basé sur le poids plutôt que sur des pourcentages. Il est distribué gratuitement. 

Menu principal /crates avec des caisses affichées sous forme d'objets dans l'inventaire 

Types de caisses 

Chaque caisse sur le serveur est un fichier .yml distinct dans le dossier crates/. Le fichier possède un paramètre CrateType, qui détermine l'animation d'ouverture.

Lors du premier lancement, le plugin génère 6 exemples prêts à l'emploi qui couvrent 5 types confirmés. Vous pouvez ouvrir n'importe lequel d'entre eux pour un test sans clé avec la commande /crazycrates forceopen <nom_fichier> <pseudo>.

Toutes les caisses de base disponibles 

Scroll - dans l'inventaire apparaît un ruban horizontal d'objets, qui défile, ralentit progressivement et s'arrête sur l'objet gagnant au milieu. Ce type est utilisé par deux exemples — CrateExample.yml et AdvancedExample.yml.

Exécution de CrateExample — un ruban horizontal d'objets défile et s'arrête sur le gagnant

Cosmic — plusieurs prix apparaissent dans l'inventaire au choix. Le joueur clique sur celui qu'il veut prendre. Si rien n'est sélectionné dans les 10 secondes, le plugin distribue un prix automatiquement. Casino — une caisse avec des niveaux (tiers). L'animation détermine d'abord le niveau, puis à l'intérieur de celui-ci — le prix spécifique. 

QuadCrate — lors de l'ouverture, quatre blocs-caisses physiques apparaissent autour du joueur dans le monde. Le joueur s'approche de chacun et les ouvre un par un — chacun donne un prix distinct. 

Wonder — une fenêtre avec un inventaire complet apparaît d'où les objets disparaissent progressivement ; celui qui reste sera le prix.

Clés

Chaque caisse utilise sa propre clé. Une clé physique — est un objet régulier avec une apparence, un nom et une description (lore) personnalisés, que le joueur garde dans son inventaire. Une clé virtuelle ne prend pas de place — elle est stockée dans la base de données du plugin et est liée au compte du joueur.

Par défaut, un bloc-caisse physique accepte les deux types. Le comportement peut être modifié dans config.yml séparément pour chaque combinaison.

Si l'inventaire du joueur est plein lors de la réception d'une clé, le plugin la convertit soit en virtuelle soit la jette au sol — selon les paramètres. Tenter d'ouvrir une caisse sans clé repousse le joueur.

Les administrateurs peuvent donner et retirer des clés même aux joueurs hors ligne, distribuer une clé à tous les joueurs en ligne simultanément via une seule commande, ou donner une clé aléatoire parmi toutes les caisses disponibles. Les joueurs avec la permission appropriée peuvent transférer leurs clés virtuelles à d'autres.

Clé physique d'une caisse — un objet avec une description personnalisée

Système de chances 

La probabilité de chaque prix n'est pas déterminée par des pourcentages, mais par le poids — le paramètre Weight dans le fichier de la caisse. Plus la valeur de poids est élevée, plus le prix tombe souvent ; plus elle est basse, plus c'est rare.

La plage maximale est la somme de tous les poids dans la caisse. Si trois prix ont des poids de 10, 15 et 25, la plage est de 50. La chance du premier est de 20%, du deuxième — 30%, et du troisième — 50%.

L'avantage de cette approche par rapport aux pourcentages : il n'est pas nécessaire de s'assurer que la somme ne dépasse pas 100. Vous pouvez simplement définir des valeurs relatives et ajouter de nouveaux prix sans recalculer le reste.

Commandes

La commande principale du plugin est /crazycrates, avec les alias /crates et /cc. Les joueurs n'ont accès qu'à /keys (voir leurs clés) et /crates (ouvrir le menu).

Commandes administrateur :

• /crazycrates give et /crazycrates take — donner ou retirer une clé à un joueur spécifique, même hors ligne.

• /crazycrates giveall — distribuer une clé à tous les joueurs en ligne en même temps.

• /crazycrates forceopen — ouvrir une caisse pour un joueur gratuitement, sans clé.

• /crazycrates editor — mode de placement des caisses dans le monde : pointez sur un bloc et liez-y une caisse.

• /crazycrates debug — recevoir tous les prix de la caisse en une fois pour tester les paramètres.

• /crazycrates mass-open — ouverture massive d'un nombre spécifié de caisses à la fois.

• /crazycrates reload — recharger toutes les configurations sans redémarrer le serveur.

• /crazycrates migrate — importer des caisses à partir d'autres plugins ou convertir l'ancien format de fichier.

Les permissions sont divisées en trois wildcards : crazycrates.players.* pour les joueurs, crazycrates.admin.* pour les admins, crazycrates.schematic.* pour travailler avec des schematics. Un joueur peut être exclu d'une distribution massive /giveall via une permission distincte.

Configuration

Tous les fichiers du plugin se trouvent dans le dossier plugins/CrazyCrates/. Le principal est config.yml, où se concentrent les paramètres globaux du serveur. Les caisses sont stockées dans le sous-dossier crates/ — chacune dans un fichier séparé. Le dossier examples/ contient des exemples des développeurs, mais vous ne devriez pas les éditer : il est complètement écrasé à chaque /crazycrates reload. Tous les textes de messages sont extraits dans messages.yml et édités séparément.

Dans config.yml, vous devriez prêter attention à certaines choses. Les hologrammes au-dessus des caisses apparaissent automatiquement si DecentHolograms, FancyHolograms ou CMI est installé sur le serveur — le plugin les prendra en charge lui-même. S'il n'y en a pas, il n'y aura tout simplement pas d'hologrammes. Les messages aux joueurs peuvent être envoyés soit dans le chat soit dans l'action bar — selon la façon dont le serveur est configuré. La journalisation des actions avec les clés et les caisses est activée séparément pour la console et pour le fichier ; les journaux de fichiers sont archivés dans un zip lors du redémarrage.

Chaque caisse est configurée dans son propre fichier. Outre le type d'animation et la liste des prix, on y définit l'apparence de la clé physique, le texte de l'hologramme au-dessus du bloc, la taille et le design de la fenêtre de prévisualisation, les sons pendant le défilement et à la fin, ainsi que la possibilité de relancer (reroll) le prix si le résultat n'est pas satisfaisant.

Conclusion

CrazyCrates ajoute des systèmes d'animation à la fois pour les boutiques de don et la progression du jeu en survie. Le système de probabilité basé sur le poids est plus pratique que les pourcentages lors de modifications actives — il n'est pas nécessaire de recalculer toute la liste à chaque fois.

Pour les serveurs PvP et survie avec un système de don, CrazyCrates est un choix pratique. Pour un serveur simple où une seule caisse sans animations est nécessaire, QuickCrate et une configuration minimale suffiront.