StarFlutuantes

Itens, cabecas e particulas flutuando no ar, criados dentro do jogo por menu — sem editar arquivo nenhum. Um jar unico da 1.8 a 1.21: material, particula e som sao traduzidos entre as versoes, e o que so existe nas mais novas passa por uma camada de compatibilidade.

Como se cria um flutuante

1. /starflutuantes criar <nome> abre o menu e voce escolhe entre particulas, item ou cabeca.
2. Escolhe o que vai aparecer: pela lista de sugestoes ou pelo botao Digitar, que aceita qualquer particula, material ou cabeca.
3. Escolhe a animacao, escreve o holograma e ajusta o lado e o tamanho.
4. Clica em Criar e recebe a varinha: clique direito num bloco cola no ar do lado clicado, batendo num bloco cola em cima dele, e clique direito no ar cola tres blocos a frente.
5. Assim que encosta, o menu de edicao abre sozinho.

Os tres tipos

• Particulas — sugestoes prontas (fogo, coracao, magia, nota, encantamento, fumaca, agua, neve, lava, fogos, portal...) ou o nome digitado. Quantidade, intervalo, espalhamento e velocidade ajustaveis no menu, clique a clique.
• Item — qualquer item do jogo, escolhido na lista, digitado (CHEST, DIAMOND_SWORD, GOLD_BLOCK) ou copiado do que voce tem na mao.
• Cabeca — cabecas do proprio jogo (creeper, esqueleto, wither, zumbi, dragao), a cabeca de qualquer jogador pelo nick, a sua propria, ou textura customizada por hash, link ou base64.

Animacoes

• Parada — fica exatamente onde foi colocada
• Flutuando — sobe e desce devagar, no mesmo lugar
• Girando — gira no proprio eixo
• Flutuando e girando — as duas coisas ao mesmo tempo

A velocidade do giro, a altura e o ritmo da subida ficam no config, valendo para o servidor inteiro.

Holograma

Item e cabeca podem ter texto flutuando junto:

• Quantas linhas voce quiser, escritas pelo chat, sem mexer em arquivo
• Reescrever, apagar e trocar linhas de lugar com um clique
• Subir e descer o texto separado do flutuante
• Cores com &a, &e e hex &#FF00AA nas versoes 1.16+
• PlaceholderAPI nas linhas, atualizado sozinho — e so as linhas com % sao reescritas, e so quando tem alguem por perto

Nao precisa de nenhum plugin de holograma instalado: o texto e feito pelo proprio StarFlutuantes.

Clique que executa comando

Todo flutuante de item ou cabeca pode virar um botao:

• Modo clique esquerdo, clique direito ou ambos
• Uma lista de comandos por lado — no modo "ambos", o lado que voce nao preencher usa a lista do outro, entao "os dois cliques fazem a mesma coisa" nao exige digitar duas vezes
• Quem executa: o jogador, o console ou o jogador com OP emprestado (devolvido mesmo se o comando falhar)
• Prefixos por linha: console:, jogador:, op:, mensagem:, titulo:, actionbar:, som:
• {jogador} vira o nick de quem clicou
• Permissao e espera entre cliques por flutuante
• Botao "Testar em mim" para conferir antes de soltar para os jogadores

O editor

/starflutuantes editor lista todos num menu; /starflutuantes editar <nome> abre um direto. De la voce:

• Troca o item, a cabeca ou a particula
• Troca a animacao
• Escreve e reordena as linhas do holograma
• Escolhe o lado principal numa rosa dos ventos: quatro lados e quatro diagonais, mais o "olhar para mim"
• Sobe e desce o flutuante de 0,1 em 0,1 (ou 0,5 com SHIFT)
• Troca o tamanho (pequeno ou normal)
• Configura o clique
• Liga e desliga sem apagar
• Traz o flutuante ate voce, ou se teleporta ate ele
• Remove, com tela de confirmacao

Feito para nao dar problema

• Nao precisa de plugin de holograma nem de nenhuma dependencia: item, cabeca e texto sao feitos pelo proprio plugin
• Os suportes sao invulneraveis: bater neles nunca quebra nem derruba o item, e ninguem consegue tirar o item do lugar
• Suporte que sobrou de um restart ou de um servidor que caiu e limpado sozinho — o arquivo e a unica verdade, entao nao aparece flutuante duplicado
• Flutuante em pedaco de mundo descarregado nao custa nada: some do mundo e volta sozinho quando o pedaco abre
• Mundo de Multiverse e afins: o flutuante espera o mundo carregar em vez de sumir do arquivo
• Particula so e enviada quando tem jogador por perto
• Uma unica tarefa cuida de todos os flutuantes do servidor
• A gravacao do arquivo sai da thread principal, numa fila propria — nada de travar o servidor a cada clique no editor

Personalizacao

• Velocidade do giro, altura e ritmo da subida, altura do item e do texto — tudo no config.yml
• Listas de sugestoes de particula, item e cabeca do menu, editaveis e sem limite
• Aparencia da varinha (material, nome e lore)
• Sons de clique, de criado e de erro
• Limite de flutuantes por servidor, quando voce quiser segurar a mao da staff
• Todas as mensagens em mensagens.yml; mensagem vazia simplesmente nao e enviada
• Nome e aliases do comando trocaveis em comandos.yml

Onde isso costuma ser usado

Vitrine de loja no spawn, placas de portal para outros mundos, botao de kit e de menu, marcadores de evento, decoracao de lobby, indicacao de NPC e de arena, aviso de vip.

Requisitos

Spigot, Paper ou Purpur da 1.8 a 1.21. PlaceholderAPI e opcional, so para os placeholders no texto do holograma.