Luminus

Userscript para o Habblet Hotel
Painel flutuante com ferramentas de player, logs, visual, links e mute local.

Identificação · Instalação · Operação · Funcionamento · API · Atualizações · Suporte

Identificação

O Luminus é um userscript. Ele roda no navegador junto com o Habblet Hotel.

O Luminus adiciona um painel flutuante e utilitários de uso diário no hotel. Você não instala um programa no PC. Você usa o Tampermonkey (ou um gerenciador de userscripts compatível).

Item	Valor
Nome	Luminus
Tipo	Userscript (Tampermonkey)
Alvo	`https://www.habblet.city/hotel*`
Build de uso	`luminus.user.js` (produção)

Requisito: conta no Habblet e extensão Tampermonkey (Chrome, Edge, Brave, Firefox ou similar).

AVISO: O Luminus não é oficial e não é afiliado ao Habblet. Use por sua conta e risco. Respeite as regras do hotel.

Instalação

1. Instale o Tampermonkey

Navegador	Link
Chrome / Brave / Edge	Chrome Web Store
Firefox	Firefox Add-ons

Instale a extensão.
Confirme o ícone do Tampermonkey na barra do navegador.
Ative Allow user scripts (Permitir scripts de usuário) na extensão do navegador (não no dashboard do Tampermonkey).
1. Clique com o botão direito no ícone do Tampermonkey na barra do navegador
  ou abra a página de extensões do navegador (ex.: brave://extensions/, chrome://extensions/, edge://extensions/).
2. Clique em Manage extension (Gerenciar extensão)
  ou, na página de extensões, em Details (Detalhes) do Tampermonkey.
3. Ligue Allow user scripts / Permitir scripts de usuário.
4. Em vários navegadores (Chrome, Brave, Edge e afins) essa opção é obrigatória para o script rodar.
5. Detalhes oficiais: FAQ do Tampermonkey — Q209.

CUIDADO: Sem Allow user scripts ativo na página da extensão, o Luminus pode instalar e ainda assim não executar no hotel.

2. Instale o Luminus

Opção A — GitHub (recomendada)

Abra a última release.
Baixe ou abra o luminus.user.js da release.
Se o repositório publicar o arquivo no branch main, você também pode usar o Raw de dist/luminus.user.js quando existir.
O Tampermonkey abre a tela de instalação.
Clique em Instalar.

Opção B — arquivo local

Baixe o luminus.user.js da release.
Abra o dashboard do Tampermonkey.
Use Utilitários → Importar (ou arraste o arquivo).
Confirme a instalação.

3. Abra o hotel

Acesse https://www.habblet.city/hotel.
Entre na sua conta.
O Luminus inicia com a página (@run-at document-start).
Abra o painel pelo ícone na interface ou pelo menu do Tampermonkey.

NOTA: Se nada aparecer:

Confirme que o script está ativado no Tampermonkey.
Confirme que Allow User Scripts está ligado (veja o passo 3 da instalação da extensão e o FAQ Q209).
Confira se o @match inclui habblet.city/hotel.

Operação

Como usar

Entre no hotel com o Luminus ativo.
Abra o painel e escolha a aba.
Ajuste as preferências. Elas ficam no navegador (localStorage / armazenamento do Tampermonkey).
Links salvos e mutes manuais permanecem entre sessões.
Mutar geral não permanece após F5 nem após troca de quarto.

Painel flutuante

Janela arrastável com abas:

Aba	Função
Player	Avatar, mute, copiar visual, spam click
Logs	Chat, amigos e quarto; webhooks e histórico local
Visual	Vidro na UI, rádio, guarda-roupa
Links	Histórico de links de missões e perfis

Builds de desenvolvimento podem mostrar abas Packets e Debug quando o modo dev está ligado.

Player

Função	Descrição
Anti-Idle	Reage quando o servidor marca você como ausente
Anti-Caminhar	Bloqueia o envio de caminhadas
Anti-Girar	Impede mudanças de direção enviadas pelo cliente
Anti-Digitando	Não envia o indicador de digitação
Bloquear clique	Impede cliques acidentais em outros jogadores; Ctrl + clique libera
Ctrl + setas	Gira o avatar com o teclado
Copiar visual	Copia a figura de outro nick para o seu avatar
Spam click	Clique automático em um alvo (nick travável)
Mutar geral	Silencia o chat local do quarto no seu cliente
↳ Whitelist	Nicks que o mute geral não silencia
↳ Esconder avatares	Oculta sprites dos mutados (não afeta você)
↳ Mutes manuais	Calar ou ouvir por pessoa; permanecem entre sessões
↳ Mute geral	Não permanece em reload nem em troca de quarto
Calar / Ouvir Habblet	Atalhos no menu nativo e no infostand

NOTA: Mute geral e vários bloqueios de ação são locais. Eles não banem ninguém no servidor.

Logs

Função	Descrição
Chat log	Cliques e sussurros para webhook Discord opcional
Friend log	Amigos online e mudança de quarto
Room monitor	Quem entrou ou saiu e o tempo no quarto
Nicks monitorados	Lista dedicada e atalhos
Janela de logs	Histórico local por tipo

Visual

Função	Descrição
Interface em vidro	Efeito glass por área da UI
Rádio	Mostra ou oculta o player de rádio da página
Guarda-roupa	Layout horizontal ou empilhado

Links

Função	Descrição
Histórico	Guarda links de missões e perfis que você abre
Favoritos	Marca links importantes
Busca e filtros	Por gênero e texto
Vários links / duplicados	Organização por conta e URL
Bloqueados / Não abertos	Filtros de organização
Abrir perfil	Atalho de perfil a partir do nick

Chat e UI do hotel

Função	Descrição
Respeitos agrupados	Respeitos empilhados numa bolha com contador
Ícones no menu	Link, olho e bloqueado no infostand e no menu por nome
Remoção de anúncios	Tenta remover blocos de ads invasivos da página

Dicas

Coloque amigos na whitelist do mute geral se você sempre quer ouvi-los.
Use spam click com nick travado para evitar troca acidental de alvo.
Webhooks de log são opcionais. Só enviam dados se você configurar a URL.

Arquivos de build

Arquivo	Uso
`dist/luminus.user.js`	Produção — uso diário
`dist/luminus-dev.user.js`	Desenvolvimento (menu de debug e extras)

Para contribuir com código, veja CONTRIBUTING.md.

Princípio de funcionamento

Visão geral em alto nível.

  Página do Habblet
        │
        ▼
  Tampermonkey injeta luminus.user.js (document-start)
        │
        ├─► intercepta WebSocket (mensagens do hotel)
        │         │
        │         ▼
        │   PacketBridge
        │     • decodifica pacotes binários
        │     • normaliza headers (offset de sessão)
        │     • parsers → estado do quarto e de você
        │     • handlers (mute local, logs, UI, …)
        │
        ├─► window.Luminus  (API no console)
        │
        └─► UI React (painel, logs, links)

Fluxo

O script sobe antes do cliente do hotel e envolve o WebSocket.
Cada frame binário de entrada ou saída passa pelo PacketBridge.
O Habblet usa headers de fio com offset de sessão. O Luminus descobre o offset e usa headers lógicos no código.
Pacotes importantes têm parser (entrada) ou composer (saída). Falha de parse é isolada.
O estado do quarto (avatares, você, móveis) alimenta as funções.
O painel grava preferências no navegador. As funções principais não dependem de servidor do Luminus.

O que o Luminus não é

Não é um client alternativo do hotel.
Não grava senha e não substitui o login do Habblet.
Não aplica ban ou punição no servidor do hotel.

API `window.Luminus`

Com o hotel aberto e o script ativo, o console do navegador expõe a API:

Área	Exemplos
Identidade	`Luminus.myself`
Quarto	`Luminus.room`
Envio	`Luminus.send(composer)` — prefira composers tipados
Eventos	`Luminus.onIncoming(header, fn)`, `onOutgoing`, `onPacket`
Bloqueio	`Luminus.blockIncoming` / `blockOutgoing`
Figura	`Luminus.setFigure(gender, figure)`
Mute	`Luminus.muteAll?.setEnabled(true)`
Debug	`Luminus.debug.setEnabled(true)`, `toggleDevMode()`
Composers	`Luminus.composers.RoomUnitWalk`, `UserIgnore`, etc.

NOTA: Não envie headers numéricos soltos se existir composer. Headers de sessão mudam. O código usa headers lógicos após o offset.

Atualizações

Acompanhe as Releases.
Baixe o novo luminus.user.js ou abra o Raw e reinstale.
O Tampermonkey pergunta se deseja atualizar.
Se @updateURL / @downloadURL apontarem para a release, o Tampermonkey pode oferecer atualização automática.

Versão: badge de release no topo desta página, ou campo @version no cabeçalho do userscript.

Suporte

Canal	Link
Discord	Entrar no servidor
Issues	GitHub Issues
Releases	github.com/iIlusion/luminus/releases

Aviso

O Luminus é um projeto da comunidade. Ele não é oficial e não é afiliado ao Habblet Hotel.

Use por sua conta e risco. Respeite as regras do hotel.

Licença

Consulte o repositório para a licença do código. Contribuições usam os mesmos termos, salvo indicação em contrário.

Documentação para desenvolvimento

Documento	Público
`CONTRIBUTING.md`	Pessoas que contribuem com código
`AGENTS.md`	Agentes de código (automação)

Name		Name	Last commit message	Last commit date
assets/catalog-thumbs/v1		assets/catalog-thumbs/v1
src		src
.gitignore		.gitignore
AGENTS.md		AGENTS.md
CHANGELOG_DISCORD.md		CHANGELOG_DISCORD.md
CONTRIBUTING.md		CONTRIBUTING.md
README.md		README.md
luminus-logo.png		luminus-logo.png
luminus-logo.svg		luminus-logo.svg
package-lock.json		package-lock.json
package.json		package.json
tsconfig.json		tsconfig.json
vite.config.ts		vite.config.ts

Navigation Menu

Repository files navigation

Luminus

Identificação

Instalação

1. Instale o Tampermonkey

2. Instale o Luminus

3. Abra o hotel

Operação

Como usar

Painel flutuante

Player

Logs

Visual

Links

Chat e UI do hotel

Dicas

Arquivos de build

Princípio de funcionamento

Fluxo

O que o Luminus não é

API `window.Luminus`

Atualizações

Suporte

Aviso

Licença

Documentação para desenvolvimento

About

Releases

Packages

Contributors

Languages

Latest commit

History

Folders and files

Repository files navigation

Luminus

Identificação

Instalação

1. Instale o Tampermonkey

2. Instale o Luminus

3. Abra o hotel

Operação

Como usar

Painel flutuante

Player

Logs

Visual

Links

Chat e UI do hotel

Dicas

Arquivos de build

Princípio de funcionamento

Fluxo

O que o Luminus não é

API window.Luminus

Atualizações

Suporte

Aviso

Licença

Documentação para desenvolvimento

About

Resources

Contributing

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages

API `window.Luminus`