promotional bannermobile promotional banner

HyLens

HyLens is a lightweight HUD mod that displays information about blocks, creatures, crops, resources, and recommended tools as you explore Hytale.
Back to Files

HyLens-1.0.0.jar

File nameHyLens-1.0.0.jar
Uploader
mestridemestride
Uploaded
Oct 25, 2026
Downloads
16
Size
450.7 KB
File ID
9324338
Type
R
Release
Supported game versions
  • 0.8

What's new

HyLens — Changelog

1.0.0 — Primeira versão estável

  • Consolida as funcionalidades testadas nas versões 0.11.0 a 0.17.0: identificação de blocos, criaturas e NPCs; recomendações de ferramentas; crescimento/colheita; irrigação/adubação; famílias de madeira e recursos.
  • Mantém a HUD personalizável por jogador (posição, tamanho, fundo, alcance, dados visíveis e modo compacto), com configurações persistentes e idiomas português/inglês.
  • Preserva os tratamentos de falhas, o cache de metadados e a suavização de transições introduzidos na 0.16.0 e na 0.17.0.
  • Padroniza as versões do manifesto e Maven, o nome do JAR e as instruções de instalação/publicação.
  • Acrescenta verificações de metadados de release, compatibilidade de preferências e recursos incluídos no pacote.
  • Compatibilidade pretendida: Hytale 0.8+; compilação referenciada na API 0.8.0-pre.2.1. Como a API do Hytale pode mudar, novas atualizações precisam ser verificadas antes de declarar compatibilidade confirmada.
  • Não muda o formato das preferências armazenadas nem redefine escolhas feitas nas versões anteriores.

0.17.0 — Robustez, diagnósticos e transições (para testes)

  • Trata falhas pontuais de leitura da mira sem encerrar o ciclo de atualização do jogador nem deixar exceções de leitura propagarem para o agendador.
  • Isola consultas opcionais de criaturas, estágio das plantações, irrigação, adubação, ferramenta equipada e metadados de blocos. Se um detalhe falhar, tenta manter o nome/ícone e as demais informações.
  • Registra avisos no log do servidor com contexto da operação e stack trace. Repetições da mesma falha são limitadas a um aviso por minuto e resumidas no aviso seguinte, evitando inundar o console a cada 150 ms.
  • Suaviza a saída da HUD: uma única atualização sem alvo mantém o painel, ocultando somente após duas leituras seguidas sem resultado (cerca de 300 ms). Novos blocos/criaturas continuam aparecendo imediatamente.
  • Protege o início e o reagendamento dos ciclos nas transições de mundo e no encerramento da sessão, sem introduzir dependência de novas APIs.
  • Mantém compatibilidade das preferências, HUDs, idiomas, comandos e modo compacto da 0.16.0. Adiciona testes de regressão para a suavização e para os avisos limitados por frequência.
  • Não captura falhas internas do cliente do jogo: erros de markup/protocolo ainda devem ser validados em uma instalação real do Hytale.

0.16.0 — Otimização de desempenho (para testes)

  • Introduz um cache compartilhado de metadados por tipo de bloco: nome/ícone, categoria de ferramenta, família de madeira, coleta e definição da plantação. A consulta aos assets ocorre uma vez para cada ID de bloco observado, independentemente de quantas vezes o jogador o mire.
  • A definição de plantação passa a reutilizar o ID de cultivo e o item produzido, evitando buscas de expressão regular e asset em cada leitura.
  • Mantém fora do cache os dados que mudam: estágio de crescimento, maturidade, irrigação, adubação e ferramenta atualmente equipada.
  • Adiciona um token por sessão/jogador para impedir que dois eventos PlayerReady iniciem ciclos simultâneos de leitura da mira.
  • Encerra o reagendamento quando a referência do jogador fica inválida e permite continuar na thread do novo mundo após uma mudança de mundo.
  • Mantém o intervalo de leitura da mira em 150 ms, sem mudanças visuais ou de preferências. Inclui testes para cache, concorrência de sessões e regressões existentes.
  • Importante: a redução de trabalho por ciclo é esperada pelo desenho do cache, mas o ganho real de FPS/CPU ainda depende de medição no jogo.

0.15.2 — Hotfix do menu Informações (para testes)

  • Corrige desconexão ao abrir Informações, causada pelo comando #ToolsButton.Enabled (propriedade não reconhecida no cliente do Hytale).
  • Usa um arquivo de interface alternativo quando o modo compacto está ativo: os cinco controles pausados são textos acinzentados e não clicáveis.
  • Ao desativar o compacto, os botões originais retornam com seus valores previamente salvos. Nenhuma preferência precisa ser redefinida.
  • Acrescenta teste de regressão para os dois layouts da aba Informações.

0.15.1 — Identidade de desenvolvedor (para testes)

  • Renomeia os pacotes Java principais e de testes para br.com.mestride.hylens, respeitando a identidade de desenvolvedor Mestride.
  • Atualiza o groupId do Maven e os campos Group e Main do manifesto.
  • Não altera a HUD, as opções nem a lógica de identificação da 0.15.0.
  • Atenção à migração: alterar o Group modifica a identidade do plugin; dependendo de como o Hytale associa diretórios de dados ao identificador, as preferências anteriores podem estar no diretório antigo. Faça cópia de segurança das configurações antes de substituir a instalação.

0.15.0 — Refinamento do modo compacto (para testes)

  • Ao ativar o modo compacto, os cinco controles incompatíveis ficam acinzentados e desabilitados no menu: ferramentas, crescimento, solo, madeira e recursos. Seus botões indicam Pausado / Paused.
  • As configurações anteriores continuam salvas, mesmo quando uma opção estava desligada antes do compacto. Elas voltam a ficar disponíveis nos respectivos estados ao desativá-lo.
  • As opções de ícones, identificação de criaturas, HUD, idioma, posicionamento, tamanho, transparência e alcance continuam utilizáveis.
  • Comandos de detalhes também respeitam o bloqueio e explicam como desativar o compacto, sem alterar ou gravar preferências acidentalmente.
  • Inclui testes de regressão para cliques bloqueados, preferências restauradas, compatibilidade com versões anteriores e recursos visuais da interface.

0.14.0 — Personalização avançada (para testes)

  • Divide /hylens menu em duas abas: Aparência e Informações.
  • Oferece quatro níveis de fundo: original (87%), médio (67%), leve (40%) ou transparente. O nível é aplicado ao painel em qualquer tamanho.
  • Permite ajustar o alcance do raycast para 4, 6, 8 ou 12 blocos, tanto para blocos quanto para criaturas/NPCs.
  • Adiciona opções independentes para solo, tipos de madeira e dados de coleta, antes controlados em conjunto com outros detalhes.
  • Oferece modo compacto: somente o nome e o ícone, sem dicas nem linhas de crescimento, solo, madeira ou coleta. Os nomes/ícones de culturas maduras continuam corretos.
  • Disponibiliza comandos equivalentes para todas as novas opções.
  • Mantém traduções português/inglês, logo integrada e preferências 0.13.0, usando padrões compatíveis quando não existirem as novas chaves. Quem tinha desativado plantações anteriormente também mantém o solo oculto na migração.

0.13.0 — Português/English + ícone no jogo (para testes)

  • Adiciona preferência de idioma (pt/en) por jogador, com seleção no menu visual e pelo comando /hylens idioma pt|en.
  • Traduz menu, status de crescimento/colheita, solo, ferramentas, tipos de madeira, detalhes de coleta e mensagens do comando; nomes de itens e criaturas continuam utilizando a tradução nativa do Hytale.
  • Compatível com configurações antigas: jogadores sem chave language permanecem em português, e outras opções não são modificadas.
  • Inclui a logo original de 256×256 pixels em icon-256.png, na raiz do JAR, para ser usada como miniatura na tela de mods do Hytale.
  • Mantém a Agricultura 2.0 e o visual da HUD de versões anteriores.

0.12.0 — Agricultura 2.0 (para testes)

  • Mostra o estado da irrigação e adubação do solo arado.
  • Usa os componentes reais TilledSoilBlock e o relógio do mundo para identificar água externa e prazo de rega.
  • Consulta o solo imediatamente abaixo da plantação e também funciona ao apontar diretamente para a terra arada.
  • Reaproveita o layout atual e respeita a configuração Plantações.
  • Preserva preferências, identificação de recursos, madeira e criaturas.

0.11.0 — Informações adicionais

  • Identifica famílias de madeira e recursos de coleta explicitamente declarados nos metadados dos blocos.
  • Mantém a HUD compacta e oculta informações indisponíveis.

0.10.1 — Correção do menu visual

  • Corrige o carregamento do menu .ui ao entrar no mundo.

0.10.0 — Menu de configurações

  • Introduz ajustes visuais dentro do jogo, mantendo preferências por jogador.

This mod has no additional files