Plugin Minecraft SkBee

🔌 Sobre o SkBee

SkBee é um addon para Skript que amplia a linguagem Skript com um amplo conjunto de elementos que expõem partes internas do servidor e recursos modernos do Minecraft para quem cria scripts. Ele fornece sintaxes e utilitários para trabalhar com NBT, componentes de texto avançados, scoreboards, receitas, dados de blocos, estruturas, criação de mundos e regiões/limites simples — permitindo que administradores de servidor implementem mecânicas complexas usando Skript em vez de Java.

🎯 Objetivo

O objetivo principal do SkBee é dar aos usuários do Skript acesso direto a recursos das APIs do servidor Bukkit/Paper e às partes internas do Minecraft que, de outra forma, são difíceis ou impossíveis de obter com o Skript padrão. Ele foi pensado para donos de servidor e criadores de scripts que precisam de controle mais preciso sobre itens, entidades, formatação de texto, manipulação de mundos e tratamento de estruturas dentro de scripts Skript.

⚙️ Recursos

• Elementos NBT: obter/definir o NBT de itens, blocos com entidade (tile entities) e entidades (observado como disponível para versões mais antigas até 1.8.8+ quando suportado).
• FastBoards: uma implementação de scoreboard projetada para reduzir o tremor visual (disponível em versões mais novas do Minecraft quando suportado).
• Receitas: adicionar receitas personalizadas e remover receitas vanilla (recursos observados como disponíveis a partir de versões mais recentes, por exemplo 1.13+ para as APIs de receitas).
• BlockData: acesso simplificado de obter/definir dados de bloco para estados de bloco modernos (disponível nas versões suportadas).
• Estruturas: salvar e colar estruturas vanilla do Minecraft usando o sistema de estruturas do jogo.
• TextComponents: criar e manipular mensagens no estilo JSON/TextComponent com eventos de passar o mouse e clicar, além de suporte a item no hover.
• WorldCreator: criar mundos personalizados com opções configuráveis expostas ao Skript.
• Bounds: criar limites/regiões simples, semelhantes a proteção leve de região, para uso no Skript.
• GameEvents: integrar-se ao sistema GameEvent do Minecraft (usado por sensores de skulk e mecânicas relacionadas).

🧩 Para quem é

• Administradores de servidor que usam Skript e precisam de acesso mais profundo à API sem escrever plugins em Java.
• Desenvolvedores de Skript criando GUIs avançadas, itens personalizados, mensagens estruturadas ou ferramentas de mundo/estrutura.
• Servidores Survival, SMP e jogos personalizados que dependem de Skript para mecânicas de gameplay e querem ampliar a funcionalidade.

🏗️ Exemplos de uso

• Um criador de scripts lê e modifica o NBT de itens para implementar comportamento e atributos personalizados dentro do Skript.
• Um admin cria receitas de crafting personalizadas e remove receitas vanilla indesejadas usando a sintaxe do Skript.
• Designers salvam e colam estruturas pré-fabricadas durante a geração do mundo ou em ferramentas de construção no jogo.
• Sistemas de chat ou GUI que precisam de componentes de texto JSON com ações de hover/clique e pré-visualização de itens.

⚙️ Instalação

📥 Configuração

• Baixe o plugin SkBee .jar de uma fonte oficial e coloque-o no diretório plugins/ do servidor junto com o Skript.
• Reinicie o servidor para que o Skript e seus addons carreguem corretamente.
• Verifique os logs do console do servidor para confirmar que o SkBee carregou com sucesso e que detectou a versão instalada do Skript.

📦 Dependências

• Skript (SkBee é um addon para Skript; versões recentes do SkBee exigem versões recentes do Skript — confira as notas de versão do plugin para saber exatamente quais versões do Skript são necessárias).

🧠 Notas técnicas

• O SkBee é mantido como um projeto de código aberto sob a licença GPL-3.0.
• Recursos diferentes podem depender da versão: alguns elementos (por exemplo, manipulação de NBT) têm notas de compatibilidade para versões mais antigas do Minecraft (a documentação original cita disponibilidade a partir de 1.8.8+ para alguns recursos e 1.13+ para outros).
• O SkBee fornece JavaDocs e uma wiki para as sintaxes; consulte essas referências ao escrever arquivos Skript que usam recursos do SkBee.
• O SkBee busca suportar versões recentes do Skript e do Minecraft; as versões específicas exigidas de Skript ou Minecraft variam conforme a versão do SkBee — verifique as notas de versão da build que você baixar.

🤝 Quando este plugin é útil

Se você usa o Skript como sistema de scripts do seu servidor e precisa de acesso a NBT, mensagens de texto estruturadas, receitas personalizadas, salvamento/colagem de estruturas ou ferramentas simples de criação de regiões e mundos sem escrever Java, o SkBee oferece um amplo conjunto de sintaxes e utilitários confirmados para expandir o que você pode implementar apenas com Skript.