EDITOR DA WEB  •  GITHUB  •  DOCUMENTAÇÃO  •  DISCORD

Visão geral - o que o Gloss faz

Gloss é um conjunto geral de hologramas e exibição de UI. É um plugin que substitui a maioria dos seus outros plugins, como MOTDs, placares, lista de jogadores, emojis e mais.

• Hologramas Texto flutuante baseado em TextDisplay com renderização de placeholders por jogador, arquivos JSON carregáveis em tempo real, renderização de texto para arte em bloco e gerenciamento completo de comandos.

• Menus holográficos UI clicável no mundo com botões, alternâncias, navegação de páginas, animações de hover e ícones desenhados a partir de itens, blocos, entidades, cabeças de jogadores, imagens ou plugins de itens personalizados.

• Painéis de mundo Menus persistentes ancorados no mundo que você pode posicionar, girar, escalar, alinhar e até anexar a um jogador.

• Previews de contêiner Olhe para um baú, forno, suporte de poções, funil ou dez outros contêineres e um cartão holográfico renderiza seu conteúdo ao vivo.

• Quedas reais Itens caídos se tornam modelos de exibição aterrados, rolando com rótulos flutuantes, física real opcional (quicar, flutuação) e uma camada de animação programável.

• Placar Barra lateral definida em JSON com padrões primários/mundo, placares com permissão e padrões por grupo.

• Lista de jogadores Cabeçalho/rodapé configurável e nomes de lista de jogadores por grupo.

• Emoji :emoji: e acionar substituição no chat com conclusão de tab e permissões por emoji com 71 pré-construídos, você pode facilmente adicionar mais.

• Bolas de chat Mensagens flutuam acima da cabeça do falante, empilham e voam para longe à medida que expiram, com estilos por mundo e por grupo.

• Indicadores de dano Números de dano e cura flutuantes com movimento balístico, medidos a partir de deltas de saúde aplicados.

• Animações Animações de texto baseadas em quadros utilizáveis em qualquer holograma, linha de placar ou lista de jogadores via |animation.<id>|.

• MOTD MOTD da lista de servidores randomizada e filtrada por cor (desligada por padrão).

Tudo é totalmente configurável no Gloss e você tem o Editor da Web para facilmente visualizar suas mudanças com dezenas de saídas randomizadas para ajudá-lo a escolher algo que funcione para você. Todas as mudanças de configuração são carregadas em tempo real assim que o arquivo é salvo ou mudanças são enviadas do Editor da Web para seu servidor.

Editor da Web - crie menus e painéis no seu navegador

Confira o Editor da Web para criar facilmente seus menus em: gloss.volmitsoftware.com. Você organiza menus, painéis, scripts de animação de queda, previews de contêiner visualmente e muito mais, com uma visualização ao vivo.

Sincronização ao vivo bidirecional Execute \/gloss menu edit <menu> ou \/gloss panel web <panel> e o Gloss lhe entrega um link clicável que abre o documento no editor. Publique do navegador e o servidor puxa a mudança em segundos, valida e escreve através de uma transação atômica com um backup automático do que estava lá antes.

\/gloss sync list       Sessões de editor ativas
\/gloss sync status     Estado de relay e sessão
\/gloss sync pull       Poll o relay agora
\/gloss sync revoke     Mate uma sessão imediatamente

Seus itens personalizados, no editor \/gloss items export escreve custom-items.json para que o editor possa navegar por todos os ItemsAdder, Oraxen, Nexo, MMOItems, Slimefun e mais no seu servidor enquanto você constrói.

As sessões são protegidas As sessões de sincronização expiram (60 minutos por padrão), têm limite de tamanho e detectam conflitos de revisão para que dois editores não possam sobrescrever silenciosamente um ao outro.

Tudo que o editor escreve é JSON simples na pasta de plugins. Você sempre pode editar os arquivos manualmente ou através da visualização dividida pelo editor da web.

Comandos e permissões

O comando principal é \/gloss. Aliases \/gl, \/glo, \/gg

Aliases adicionais: \/hologram, \/holo, \/h, \/board, \/sb, \/bd

\/gloss status                                  Mostra tudo que está carregado.

\/hologram create|delete|list|info              Gerencia hologramas
\/hologram addline|setline|removeline|clear
\/hologram move|movehere|tp|orient              Posição e orientação
\/hologram rendertext                           Rasteriza texto em linhas de arte em bloco

\/board create|delete|title                     Gerencia barras laterais
\/board addline|setline|removeline
\/board show|hide|primary|permission|reset

\/gloss menu list|create|open|edit|builder|new|copy
\/gloss menu addrow|insertrow|setrow|removerow|offsetrow|seticon|style|image

\/gloss panel create|delete|list|near|info|rename|copy
\/gloss panel move|here|tp|rotate|scale|align|follow|unfollow
\/gloss panel ranges|visibility|permissions|edit|web|save|cancel

\/gloss preview list|reset|dump                 Documentos de preview de contêiner
\/gloss item status|export                      Provedores de itens personalizados \/ exportação de editor
\/gloss sync list|status|revoke|pull            Sessões de sincronização de editor
\/gloss import preview|apply|holoui|legacy
\/gloss emoji list|reset                        Clique em um emoji para inseri-lo no chat
\/gloss animations list|reset
\/gloss bubbles style|reset                     Escolha seu estilo pessoal de bolha
\/gloss tablist reset  \/gloss motd reset  \/gloss drops reset

Executar \/gloss por conta própria abre um menu de ajuda paginado com hover e clique. As entradas da lista são clicáveis, clique em um holograma para teleportar-se até ele, clique em um emoji para inseri-lo. A conclusão de tab funciona em todos os lugares.

Permissões seguem a árvore de comandos. Tudo está sob gloss.* (padrão: op):

gloss.*                    Pai de cada nó abaixo. Concede o plugin inteiro.
gloss.admin                Reiniciar subcomandos: emoji, animações, bolhas, lista de jogadores, motd, quedas

gloss.holograms            Pai dos cinco nós de holograma. Acesso base a \/hologram
gloss.holograms.create     Criar hologramas e adicionar linhas
gloss.holograms.edit       Editar linhas, renomear, renderizar texto
gloss.holograms.delete     Deletar hologramas
gloss.holograms.move       Mover, mover aqui, orientar
gloss.holograms.teleport   Teleportar para um holograma

gloss.boards               Pai dos cinco nós de barra lateral. Acesso base a \/board
gloss.boards.create        Criar barras laterais
gloss.boards.edit          Título, adicionar linha, definir linha, remover linha
gloss.boards.delete        Deletar barras laterais
gloss.boards.show          Mostrar uma barra lateral para você ou outros
gloss.boards.hide          Ocultar uma barra lateral

gloss.menus                Pai dos oito nós de menu. Acesso base a \/gloss menu
gloss.menus.list           Listar documentos de menu
gloss.menus.open           Abrir um menu
gloss.menus.close          Fechar um menu aberto
gloss.menus.move           Reposicionar um menu aberto
gloss.menus.back           Navegar na pilha de páginas
gloss.menus.create         Criar novos documentos de menu
gloss.menus.edit           Editar linhas, ícones, estilos, imagens
gloss.menus.builder        O construtor de menus no jogo

gloss.panels               Pai dos nós de painel. Criar, mover, girar, escalar, alinhar, seguir

gloss.panels.editweb       Abrir um painel no editor da web (\/gloss panel web)

gloss.preview              Ver previews de contêiner e ajustar sua escala
gloss.sync                 Gerenciar sessões de sincronização do editor da web (listar, status, puxar, revogar)
gloss.import               Pai dos nós de importação. Pré-visualizações de execução (\/gloss import preview)
gloss.import.apply         Aplicar realmente uma importação

gloss.emoji.use            Usar emoji no chat                      padrão: true
gloss.bubbles.send         Seu chat é renderizado como bolhas           padrão: true
gloss.indicators.show      Ver indicadores de dano e cura         padrão: true
gloss.chat.color           Usar códigos de cor no chat                padrão: op
gloss.bubbles.style        Escolha um estilo pessoal de bolha           padrão: op

Cada nó é padrão: op a menos que marcado de outra forma. Conceder um pai (gloss.menus) concede seus filhos; os três nós voltados para o jogador estão ativados para todos por padrão.

Configuração

Tudo no Gloss é configurável e todas as opções são carregadas em tempo real ao salvar, sem necessidade de recarregar suas mudanças.

# Configuração - gloss
# Este arquivo é canonizado ao carregar; comentários e novas chaves podem ser atualizados automaticamente.
#
# Configuração de tempo de execução do Gloss. Cada botão é emitido com um comentário,
# valores fora de seu intervalo documentado são ajustados ao carregar,
# e edições são recarregadas em tempo real enquanto o servidor está em execução.

# Imprime a tela de boas-vindas do Gloss durante a inicialização.
splashScreen = true
# Envia métricas de uso anônimas do bStats.
metrics = true

# Configurações para Recursos.
[features]
# Habilita o motor de holograma.
holograms = true
# Habilita barras laterais de placar.
boards = true
# Habilita cabeçalho/rodapé da lista de jogadores e gerenciamento de nomes.
tablist = true
# Habilita substituição de emoji no chat e conteúdo.
emoji = true
# Habilita animações de texto.
animations = true
# Habilita bolhas de chat acima dos jogadores.
chatBubbles = true
# Habilita indicadores de dano e cura flutuantes.
damageIndicators = true
# Habilita nomes personalizados em pilhas de itens caídos.
drops = true
# Substitui a renderização de itens caídos padrão por modelos de exibição aterrados,
# rolando e rótulos apoiados em exibição.
realDrops = true
# Habilita menus holográficos.
menus = true
# Habilita painéis ancorados no mundo.
panels = true
# Habilita previews de contêiner com olhar.
previews = true
# Habilita o MOTD personalizado da lista de servidores.
motd = false

# Configurações para Hotload.
[hotload]
# Ticks entre polls de arquivos assistidos para recarregamento em tempo real. Ajustado para 1..200.
watchIntervalTicks = 5

# Configurações para Hologramas.
[holograms]
# Distância vertical em blocos entre linhas de holograma empilhadas. Ajustado para 0.05..2.0.
stackDistance = 0.26
# Ticks entre atualizações de texto de holograma. Ajustado para 1..200.
updateIntervalTicks = 10
# Distância em blocos na qual hologramas se tornam visíveis. Ajustado para 4..128.
viewRange = 48.0
# Renderiza placeholders completos, funções e expressões
# por jogador visualizador em vez de uma vez globalmente.
perViewerPlaceholders = true
# Ticks entre atualizações de hologramas temporários. Ajustado para 1..20.
temporaryUpdateIntervalTicks = 2
# Usa interpolação de exibição do lado do cliente para mover hologramas temporários,
# voltando para teletransportes quando a API do servidor não a possui.
interpolatedMotion = true
# Aciona linhas de hologramas animados rápidos a partir de uma thread assíncrona dedicada em vez do atualizador de ticks.
highFrequencyAnimations = true
# Máximo de quadros por segundo que a thread de animação de alta frequência visa. Ajustado para 1..240.
maxAnimationFps = 120
# Pacotes de texto de animação por segundo permitidos para cada público de
# exibição animada; grandes públicos degradam a taxa de quadros proporcionalmente. Ajustado para 100..1000000.
animationPacketBudget = 20000
# Largura máxima em caracteres para arte de texto renderizada. Ajustado para 8..128.
textArtMaxWidth = 48

# Configurações para Barras Laterais.
[boards]
# Ticks entre atualizações de placar. Ajustado para 1..200.
updateIntervalTicks = 20

# Configurações para Lista de Jogadores.
[tablist]
# Ticks entre atualizações da lista de jogadores. Ajustado para 1..400.
updateIntervalTicks = 40

# Configurações para Grupos.
[groups]
# Resolve grupos de jogadores através do Vault quando instalado.
useVault = true

# Configurações para Emoji.
[emoji]
# Requer uma permissão por emoji em vez da permissão global de emoji.
emojiSpecificPermissions = false
# Oferece gatilhos de emoji na conclusão de tab do chat.
tabComplete = true

# Configurações para Texto.
[text]
# Resolve placeholders do PlaceholderAPI em texto renderizado.
placeholders = true
# Resolve expressões |function| em texto renderizado.
functions = true

# Configurações para Chat.
[chat]
# Traduz códigos de cor no chat dos jogadores para jogadores permitidos.
color = true

# Configurações para Bolhas de Chat.
[chatBubbles]
# Nomes de pastas do mundo onde bolhas de chat nunca aparecem.
blacklistWorlds = []

# Configurações para Indicadores de Dano.
[damageIndicators]
# Força lateral aleatória aplicada a indicadores gerados. Ajustado para 0.0..2.0.
randomThrowForce = 0.08
# Força inicial para cima aplicada a indicadores gerados. Ajustado para 0.0..2.0.
initialUpForce = 0.13
# Força da gravidade aplicada a indicadores a cada tick. Ajustado para 0.0..1.0.
gravityFactor = 0.0093
# Máximo de indicadores gerados por segundo antes que novos sejam descartados. Ajustado para 1..1000.
maxPerSecond = 40
# Milissegundos que um indicador permanece vivo. Ajustado para 250..30000.
maxMsAlive = 3000
# Prefixo de código de cor aplicado a números de dano.
damagePrefix = "&c&l"
# Prefixo de código de cor aplicado a números de cura.
healPrefix = "&a&l"
# Casas decimais mostradas em números de indicadores. Ajustado para 0..2.
decimals = 0
# Mostra indicadores de cura além de indicadores de dano.
showHeals = true

# Configurações para Quedas.
[drops]
# Formato de nome para pilhas de itens caídos; {count} e {type} são substituídos.
nameFormat = "&7{count}x {type}"
# Formato de nome para pacotes caídos que carregam pilhas; {total}
# e {contents} são substituídos. Pacotes vazios usam nameFormat.
bundleFormat = "&7Pacote &8(&7{total} itens&8): &7{contents}"
# Entradas de conteúdo de pacotes listadas antes do restante colapsar em um sufixo +N mais. Ajustado para 1..10.
bundleEntryLimit = 3
# Usa um rótulo de TextoDisplay vertical para pacotes enquanto realDrops está habilitado.
bundleVerticalLabels = true
# Formato de cabeçalho para rótulos de pacotes verticais; {total} é substituído.
bundleHeaderFormat = "&ePacote &8(&e{total} itens&8)"
# Formato de entrada para rótulos de pacotes verticais; {count} e {type} são substituídos.
bundleEntryFormat = "&7- &f{count}x {type}"
# Formato de resto para rótulos de pacotes verticais; {remaining} é substituído por
# a contagem de material oculta.
bundleMoreFormat = "&8+{remaining} mais"
# Deixa nomes personalizados que outros plugins já definiram em itens caídos intactos.
preserveCustomNames = true
# Usa o nome de exibição de um item de seu meta de item como {type} em vez do nome do material.
useItemDisplayNames = true

# Configurações para Comandos.
[commands]
# Reproduz sons de feedback quando a saída do comando é entregue.
sounds = true

# Configurações para Depuração.
[debug]
# Renderiza contornos de depuração de hitbox de menu para todas as sessões.
hitbox = false
# Renderiza marcadores de depuração de posição de menu para todas as sessões.
position = false
# Registra estatísticas do loop do animador de alta frequência a cada 10 segundos.
animator = false

# Configurações para Editor.
[editor]
# URL base do editor da web hospedado; deve ser um link http(s) simples ou o padrão é usado.
builderUrl = "https://gloss.volmitsoftware.com"

# Configurações para Sincronização.
[editor.sync]
# Habilita sessões de sincronização de editor ao vivo através do relay.
enabled = true
# URL do endpoint do relay; deve ser https (ou http de loopback) terminando em \/v2 ou o padrão é usado.
endpoint = "https://sync.gloss.volmitsoftware.com/v2"
# Token de criação de sessão de sincronização de editor de 22..128 caracteres de A-Z, a-z,
# 0-9, _ e -; qualquer outra coisa é tratada como vazia.
createToken = ""
# Minutos que uma sessão de sincronização de editor permanece ativa. Ajustado para 5..1440.
sessionMinutes = 60
# Segundos entre polls de relay durante uma sessão ativa. Ajustado para 1..60.
pollSeconds = 3
# Tamanho máximo do projeto de sincronização de editor em mebibytes. Ajustado para 1..32.
maxProjectMiB = 8

# Configurações para Preview.
[preview]
# Distância em blocos que o raycast de olhar alcança para previews de contêiner. Ajustado para 1.0..24.0.
lookDistance = 10.0
# Escala de renderização base de previews de contêiner. Ajustado para 0.25..4.0.
scale = 0.65

# Configurações para Menus.
[menus]
# Multiplicador de escala de renderização global para menus e painéis holográficos. Ajustado para 0.25..4.0.
uiScale = 1.0

# Configurações para Itens.
[items]
# Habilita ícones de itens personalizados resolvidos através de plugins de itens instalados.
customItems = true
# Lista de permissão de provedores de itens por provedor ou nome de plugin; uma lista vazia permite todos os provedores.
customItemProviders = []

# Configurações para Integração.
[integration]
# Ticks entre amostras das métricas que outros plugins Volmit publicam para
# |metric.<key>| e variáveis de preview. Ajustado para 1..200.
sampleIntervalTicks = 20

Idiomas 17 idiomas estão traduzidos do padrão em inglês para escolher.

Para mudar, defina language em plugins/Gloss/language.yml

locale: en_US

de_DE    Alemão (Alemanha)
es_ES    Espanhol (Espanha)
fi_FI    Finlandês (Finlândia)
fr_FR    Francês (França)
he_IL    Hebraico (Israel)
it_IT    Italiano (Itália)
ja-JP    Japonês (Japão)
ko_KR    Coreano (Coreia do Sul)
lt_LT    Lituano (Lituânia)
nl_NL    Holandês (Países Baixos)
pl_PL    Polonês (Polônia)
pt_PT    Português (Portugal)
ru_RU    Russo (Rússia)
tr_TR    Turco (Turquia)
vi_VI    Vietnamita (Vietnã)
zh_CN    Chinês (Simplificado)
zh_TW    Chinês (Tradicional)

Menus e UI Clicáveis

Menus são criados e gerenciados com o \/gloss menu comando e os arquivos são armazenados em plugins/Gloss/menus

• Componentes Botões, alternâncias e decorações, cada um com sua própria hitbox.

• Ícones Texto, imagens, imagens animadas, itens, blocos, entidades, cabeças de jogadores ou qualquer item de um plugin de itens personalizados (provedor detectado automaticamente).

• Ações Executar um comando, tocar um som, enviar uma mensagem, teleportar ou navegar pelo menu com páginas (empurrar, substituir, voltar, casa, fechar).

• Gatilhos de clique Esquerda, direita, shift-esquerda, shift-direita.

• Animação de hover Com curvas de suavização e duração configurável.

• Comportamentos lockPosition, followPlayer, maxDistance, closeOnDeath, closeOnTeleport.

Painéis são menus ancorados no mundo: posicione, gire (yaw, pitch, roll) e escale-os, use ~coordenadas relativas, alinhe um painel a outro, defina intervalos de visualização e interação, restrinja a visibilidade por permissões ou faça um painel seguir um jogador com rotação fixa, yaw ou total.

Previews de Contêiner

Previews de contêiner totalmente configuráveis. Você pode pressionar shift duas vezes para salvar o tamanho do contêiner, ou segurar shift + scroll wheel para definir o tamanho do contêiner (Role para baixo até 0% para desligá-lo, configurações persistentes por jogador).

Existem quatorze tipos de contêiner pré-definidos: baú, baú do fim, forno, suporte de poções, funil, dispensador, caldeirão, colmeia, toca-discos, estante talhada, prateleira, vagão, cartão de contêiner bloqueado e caixas shulker.

Cartões mostram valores ao vivo do progresso de cozimento e combustível do forno, tempo de preparo, XP acumulada, ocupação e muito mais. Modifique facilmente os presets ou crie os seus com o Editor da Web.

WorldGuard Verificações de acesso restrito ao contêiner para garantir que os jogadores não possam bisbilhotar contêineres que não têm permissão.

Física e script de quedas reais

Itens caídos se tornam mais realistas, eles podem rolar pelo ar, pousar em uma face de descanso e se acomodar, brilhar e muito mais.

Você pode modificar essas configurações em plugins/Gloss/real-drops/default.json ou modificá-las com nosso Editor da Web.

• limites Cadência de atualização, visuais por pilha, um orçamento de entidade por chunk.

• movimento Velocidade de rotação, rotação por eixo, mudanças de direção impulsionadas por quique, amortecimento de rotação submersa, rolagem no chão.

• aterrissagem NATURAL, PLANO ou ERGUIDO, com inclinação, yaw aleatório e atração de face.

• rótulos Deslocamento, escala, alcance de visualização, modo de cartaz, cor de fundo.

• física Física real de entidade: multiplicador de gravidade, quique, flutuação na água e arrasto. Isso move o item real, não apenas a imagem.

• script Uma camada de expressão que anima o visual: deslocamento, rotação, escala, brilho e visibilidade por eixo, com variáveis como t, fase, impactoVelocidade, emÁgua, luzBloqueada e um aleatório estável por item.

• animação Clipes de keyframe tipados acionados por estado (SPAWN, IMPACT, BOUNCE, ENTER_FLUID, SETTLE...) com modos de suavização e mistura.

Bolhas de chat, indicadores de dano, emoji motd, lista de jogadores e animações

Bolhas de chat O chat flutua acima da cabeça dos jogadores, empilha e voa para longe à medida que expira. Os estilos suportam movimento baseado em expressões (translação, escala, rotação, opacidade), quebra de palavras, um brilho ao aparecer, hideOwn, listas negras por mundo e seleção por mundo e grupo do Vault com prioridades. Jogadores com permissão escolhem um estilo pessoal via \/gloss bubbles style.

Indicadores de dano Números de dano e cura flutuantes com movimento balístico que é realista.

Emojis 71 emojis padrão com :name: e acionam o tipo de substituição <3 e se torna um coração. Conclusão de tab no chat, permissões por emoji opcionais, e \/gloss emoji as entradas da lista inserem no chat ao clicar.

Animações Animações de texto baseadas em quadros com reprodução ascendente, descendente ou ping-pong e intervalo por quadro. Use-as em qualquer linha renderizada como |animation.rainbow|.

MOTD Personalize seu MOTD para alternar entre múltiplos MOTDs ou mantê-lo um design estático.

Lista de jogadores A lista de jogadores suporta todos os aspectos do Gloss, personalize-a como desejar!

Placeholders e expressões

Cada linha renderizada de hologramas, placares, lista de jogadores, bolhas, previews suporta expressões limitadas {{ ... }} com valores nativos de player.* e server.* (nome, ping, saúde, nível, online, maxPlayers, tps).

PlaceholderAPI é opcional e totalmente suportado com os seguintes placeholders do Gloss disponíveis:

%gloss_available%            Mostra se o Gloss está disponível
%gloss_menu.open%            Mostra se o menu está aberto
%gloss_menu.id%              Mostra o ID do menu atual

A biblioteca de expressões é compartilhada entre hologramas, bolhas, previews e quedas: clamp, lerp, smoothstep, sin, cos, rgb, mix, palette, bar, select e mais, além de cor como #FFAA55 e um conjunto completo de operadores com ternários.

API do Desenvolvedor

O Gloss tem uma API disponível na qual você pode se conectar, consulte nossa documentação para mais informações.

GlossAPI api = GlossAPI.get();
api.open(myPlugin, player, "shop/main");            \/\/ abre um menu
api.createHologram("welcome", location);            \/\/ gerencia hologramas
api.createTemporaryHologram("popup", loc, 3000);    \/\/ holograma temporário
api.filter(player, raw);                            \/\/ executa qualquer string pelo pipeline de texto
api.setBoard(player, "arena");  api.setTab(player, header, footer);

Além de um construtor de menus fluente (botões, decorações, ícones de texto, item, bloco, entidade, imagem ou imagem animada), manipuladores de clique com gatilhos e razões para fechar, um ponto de extensão PreviewStateProvider para alimentar suas próprias variáveis em cartões de preview de contêiner, e três eventos: GlossMenuOpenEvent, GlossMenuClickEvent, GlossContainerPreviewAccessEvent.

Compatibilidade - runtimes e Java

O Gloss suporta Paper, Purpur, Leaf, Folia, Canvas e Spigot no Java 25 para Minecraft 26.x+

Integrações opcionais PlaceholderAPI, Vault, WorldGuard e dez provedores de itens personalizados - CraftEngine, ItemsAdder, Oraxen, Nexo, MMOItems, ExecutableItems, EcoItems, Slimefun, MythicMobs, HeadDatabase. Provedores são detectados automaticamente e podem ser conectados/desconectados com seu plugin.

Imagens & Mídia