EDITOR WEB • GITHUB • DOCUMENTAÇÃO • DISCORD

Visão geral - o que o Gloss faz

Gloss é um conjunto geral de exibição de Hologramas e UI. É um plugin que substitui a maioria dos seus outros plugins, como MOTDs, Placar, Lista de Tab, Emojis e mais.

• Hologramas Texto flutuante baseado em TextDisplay com renderização de placeholder por jogador, arquivos JSON carregáveis, 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 jogador, imagens ou plugins de itens personalizados.

• Painéis do mundo Menus persistentes ancorados ao mundo que você pode posicionar, girar, escalar, alinhar e até mesmo 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 tornam-se modelos de exibição aterrados e giratórios com etiquetas flutuantes, física real opcional (quicar, flutuação) e uma camada de animação programável.

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

• Lista de Tab Nomes da lista de jogadores configuráveis de cabeçalho/rodapé e por grupo.

• Emoji :emoji: e acione a 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-se e voam embora à 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 tab 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 Web para visualizar facilmente suas alterações com dezenas de saídas randomizadas para ajudá-lo a escolher algo que funcione para você. Todas as alterações de configuração são carregadas assim que o arquivo é salvo ou as alterações são enviadas do Editor Web para o seu servidor.

Editor web - crie menus e painéis no seu navegador

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

Sincronização ao vivo bidirecional Execute /gloss menu edit <menu> ou /gloss panel web <panel> e o Gloss lhe fornece um link clicável que abre o documento no editor. Publique do navegador e o servidor puxa a alteração 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 retransmissão e sessão
/gloss sync pull       Consulte a retransmissão 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 um ao outro silenciosamente.

Tudo que o editor escreve é JSON simples na pasta de seus plugins. Você pode sempre editar os arquivos manualmente ou através da visualização dividida pelo editor 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              Gerenciar hologramas
/hologram addline|setline|removeline|clear
/hologram move|movehere|tp|orient              Posição e orientação
/hologram rendertext                             Rasterizar texto em linhas de arte em bloco

/board create|delete|title                       Gerenciar sidebars
/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 pré-visualização de contêiner
/gloss item status|export                        Provedores de itens personalizados / exportação do editor
/gloss sync list|status|revoke|pull              Sessões de sincronização do 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 de bolha pessoal
/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                 Redefinir subcomandos: emoji, animações, bolhas, lista de tab, motd, quedas

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

gloss.boards                Pai dos cinco nós de placar. Acesso básico a /board
gloss.boards.create         Criar sidebars
gloss.boards.edit           Título, adicionar linha, definir linha, remover linha
gloss.boards.delete         Excluir sidebars
gloss.boards.show           Mostrar um placar para você ou outros
gloss.boards.hide           Ocultar um placar

gloss.menus                Pai dos oito nós de menu. Acesso básico 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 web (/gloss panel web)

gloss.preview               Veja pré-visualizações de contêiner e ajuste sua escala
gloss.sync                 Gerenciar sessões de sincronização do editor (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 renderiza como bolhas               padrão: true
gloss.indicators.show      Veja 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 de bolha pessoal              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 ao salvar, sem necessidade de recarregar suas alterações.

# 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 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 mecanismo de holograma.
holograms = true
# Habilita sidebars de placar.
boards = true
# Habilita gerenciamento de cabeçalho/rodapé e nomes de lista de tab.
tablist = true
# Habilita substituição de emoji no chat e conteúdo.
emoji = true
# Habilita animações de texto.
animações = 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 vanilla por modelos de exibição aterrados,
# giratórios e etiquetas de exibição.
realDrops = true
# Habilita menus holográficos.
menus = true
# Habilita painéis ancorados ao mundo.
panels = true
# Habilita pré-visualizações de contêiner.
previews = true
# Habilita o MOTD personalizado da lista de servidores.
motd = false

# Configurações para Hotload.
[hotload]
# Ticks entre polls de arquivos observados para recarregamento a quente. 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 tokens de placeholder, função e expressão completos
# 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
# Conduz linhas de holograma animadas rápidas 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 em 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 Placas.
[boards]
# Ticks entre atualizações de placar. Ajustado para 1..200.
updateIntervalTicks = 20

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

# Configurações para Grupos.
[groups]
# Resolve grupos de jogadores através do Vault quando está 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 do jogador 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 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 ativo. 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 nos números dos indicadores. Ajustado para 0..2.
decimals = 0
# Mostra indicadores de cura além dos 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. 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 sua 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 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 da retransmissão.
enabled = true
# URL do ponto final da retransmissão; 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 retransmissão 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 retransmissão 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 Pré-visualização.
[preview]
# Distância em blocos que o raio de olhar alcança para pré-visualizações de contêiner. Ajustado para 1.0..24.0.
lookDistance = 10.0
# Escala de renderização base de pré-visualizações 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 pré-visualização. 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ável

Menus são criados e gerenciados com o comando /gloss menu 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 jogador ou qualquer item de um plugin de item personalizado (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, iniciar, fechar).

• Gatilhos de clique Esquerdo, direito, shift-esquerdo, shift-direito.

• 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 visã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.

Pré-visualizações de Contêiner

Pré-visualizações 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 trancado e caixas shulker.

Os cartões mostram valores ao vivo do progresso de cozimento e combustível do forno, tempo de preparo, XP acumulado, ocupação e muito mais. Modifique facilmente os presets ou crie os seus com o Editor 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 tornam-se mais realistas, eles podem girar 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 Web.

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

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

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

• etiquetas Deslocamento, escala, alcance de visã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, luzBloco e um aleatório estável por item.

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

Bolas de chat, indicadores de dano, motd emoji, lista de tab e animações

Bolas de chat O chat flutua acima da cabeça dos jogadores, empilha e voa embora à medida que expira. Os estilos suportam movimento baseado em expressões (translação, escala, rotação, opacidade), quebra de palavras, um brilho ao nascer, hideOwn, listas negras de 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-os em qualquer linha renderizada como |animation.rainbow|.

MOTD Personalize seu MOTD para alternar entre vários MOTDs ou mantê-lo um design estático.

Lista de Tab A lista de tab suporta todos os aspectos do Gloss, personalize-a ao seu gosto!

Placeholders e expressões

Cada linha renderizada hologramas, placares, lista de tab, bolhas, pré-visualizações suporta expressões limitadas {{ ... }} com valores nativos 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, pré-visualizações 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");           // abrir um menu
api.createHologram("welcome", location);          // gerenciar hologramas
api.createTemporaryHologram("popup", loc, 3000); // holograma temporário
api.filter(player, raw);                            // executar 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 de fechamento, um ponto de extensão PreviewStateProvider para alimentar suas próprias variáveis em cartões de pré-visualização de contêiner, e três eventos: GlossMenuOpenEvent, GlossMenuClickEvent, GlossContainerPreviewAccessEvent.

Compatibilidade - tempos de execução 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 conectados/desconectados a quente com seu plugin.

Imagens & Mídia