CrazyCrates — um plugin para adicionar caixas personalizadas e baús de recompensas no Minecraft

CrazyCrates — um plugin para adicionar caixas personalizadas e baús de recompensas no Minecraft

O CrazyCrates permite adicionar caixas (crates) a um servidor de Minecraft. Cada caixa é um bloco no mundo ou uma posição em um menu que o jogador abre com uma chave para receber um prêmio aleatório. O plugin oferece 11 tipos diferentes de animações, dois tipos de chaves — físicas (itens no inventário) e virtuais (armazenadas no banco de dados) — e um sistema de chances baseado em peso em vez de porcentagens. É distribuído gratuitamente. 

Menu principal /crates com caixas exibidas como itens no inventário 

Tipos de Caixas 

Cada caixa no servidor é um arquivo .yml separado na pasta crates/. O arquivo tem um parâmetro CrateType, que determina a animação de abertura.

Na primeira inicialização, o plugin gera 6 exemplos prontos para uso que cobrem 5 tipos confirmados. Você pode abrir qualquer um deles para um teste sem chave com o comando /crazycrates forceopen <nome_do_arquivo> <nickname>.

Todas as caixas básicas disponíveis 

Scroll - no inventário aparece uma fita horizontal de itens, que rola, desacelera gradualmente e para no item vencedor no meio. Esse tipo é usado por dois exemplos — CrateExample.yml e AdvancedExample.yml.

Execução do CrateExample — uma fita horizontal de itens rola e para no vencedor

Cosmic — vários prêmios aparecem no inventário para escolher. O jogador clica no que quer levar. Se nada for selecionado em 10 segundos, o plugin emite um prêmio automaticamente. Casino — uma caixa com níveis (tiers). A animação primeiro determina o nível e, depois, dentro dele, o prêmio específico. 

QuadCrate — ao abrir, quatro blocos físicos de caixa aparecem ao redor do jogador no mundo. O jogador se aproxima de cada um e os abre um a um — cada um dá um prêmio separado. 

Wonder — uma janela com o inventário completo aparece, da qual os itens desaparecem gradualmente; o que sobrar será o prêmio.

Chaves

Cada caixa usa sua própria chave. Uma chave física — é um item comum com aparência, nome e descrição (lore) personalizados, que o jogador mantém no inventário. Uma chave virtual não ocupa espaço — é armazenada no banco de dados do plugin e vinculada à conta do jogador.

Por padrão, um bloco físico de caixa aceita ambos os tipos. O comportamento pode ser alterado no config.yml separadamente para cada combinação.

Se o inventário do jogador estiver cheio ao receber uma chave, o plugin a converte em virtual ou a joga no chão — dependendo das configurações. Tentar abrir uma caixa sem chave empurrará o jogador para trás.

Administradores podem dar e tirar chaves mesmo de jogadores offline, distribuir uma chave para todos os jogadores online de uma só vez através de um único comando, ou dar uma chave aleatória de todas as caixas disponíveis. Jogadores com a permissão adequada podem transferir suas chaves virtuais para outros.

Chave física de uma caixa — um item com descrição personalizada

Sistema de chances 

A probabilidade de cada prêmio não é determinada por porcentagens, mas por peso — o parâmetro Weight no arquivo da caixa. Quanto maior o valor do peso, mais frequentemente o prêmio sai; quanto menor, menos frequentemente.

O intervalo máximo é a soma de todos os pesos na caixa. Se três prêmios tiverem pesos de 10, 15 e 25, o intervalo é 50. A chance do primeiro é de 20%, do segundo — 30%, e do terceiro — 50%.

A vantagem dessa abordagem em relação às porcentagens: não há necessidade de se certificar de que a soma não exceda 100. Você pode simplesmente definir valores relativos e adicionar novos prêmios sem recalcular o resto.

Comandos

O comando principal do plugin é /crazycrates, com os apelidos /crates e /cc. Os jogadores só têm acesso a /keys (ver suas chaves) e /crates (abrir o menu).

Comandos de administrador:

• /crazycrates give e /crazycrates take — dar ou tirar a chave de um jogador específico, mesmo offline.

• /crazycrates giveall — distribuir uma chave a todos os jogadores online simultaneamente.

• /crazycrates forceopen — abrir uma caixa para um jogador gratuitamente, sem chave.

• /crazycrates editor — modo de colocação de caixas no mundo: você aponta para um bloco e vincula uma caixa a ele.

• /crazycrates debug — receber todos os prêmios da caixa de uma vez para testar as configurações.

• /crazycrates mass-open — abertura em massa de um número especificado de caixas de uma só vez.

• /crazycrates reload — recarregar todas as configurações sem reiniciar o servidor.

• /crazycrates migrate — importar caixas de outros plugins ou converter formatos de arquivo legados.

As permissões são divididas em três wildcards: crazycrates.players.* para jogadores, crazycrates.admin.* para admins, crazycrates.schematic.* para trabalhar com schematics. Um jogador pode ser excluído de uma distribuição em massa /giveall por meio de uma permissão separada.

Configurações

Todos os arquivos do plugin estão na pasta plugins/CrazyCrates/. O principal é config.yml, onde as configurações globais do servidor estão concentradas. As caixas são armazenadas na subpasta crates/ — cada uma em um arquivo separado. A pasta examples/ contém exemplos dos desenvolvedores, mas você não deve editá-los: ela é completamente substituída em cada /crazycrates reload. Todos os textos das mensagens são movidos para messages.yml e editados separadamente.

No config.yml, você deve prestar atenção a algumas coisas. Os hologramas acima das caixas aparecem automaticamente se o DecentHolograms, FancyHolograms ou CMI estiver instalado no servidor — o plugin irá detectá-los por si só. Se não houver nenhum, simplesmente não haverá hologramas. As mensagens aos jogadores podem ser enviadas para o chat ou para a action bar — dependendo de como o servidor está configurado. O registro de ações com chaves e caixas é ativado separadamente para o console e para o arquivo; os logs de arquivos são compactados em zip na reinicialização.

Cada caixa é configurada em seu próprio arquivo. Além do tipo de animação e da lista de prêmios, define-se a aparência da chave física, o texto do holograma acima do bloco, o tamanho e o design da janela de pré-visualização, os sons durante a rolagem e após a conclusão, e a possibilidade de sortear novamente (reroll) o prêmio se o resultado não foi satisfatório.

Conclusão

O CrazyCrates adiciona sistemas de animação tanto para lojas de doações quanto para a progressão do jogo em sobrevivência. O sistema de chances baseado em peso é mais conveniente que as porcentagens na edição ativa — não há necessidade de recalcular a lista inteira sempre.

Para servidores PvP e de sobrevivência com um sistema de doações, o CrazyCrates é uma opção conveniente. Para um servidor simples onde é necessária uma caixa sem animações, o QuickCrate e uma configuração mínima serão suficientes.