Configurar Lichii: instalação, chaves, firmware e saves
Antes de começarFaça backup dos seus saves antes de testar qualquer compilação experimental. O Lichii recebe atualizações constantes, e a equipe do README recomenda a todos os testadores manter uma cópia prévia.
A configuração do emulador Lichii Switch 2 leva seis passos: baixar o pacote certo no GitHub, descompactar, adicionar suas chaves e firmware, conferir se a pasta de dados existente é reconhecida e iniciar o jogo. Nenhum download inclui jogos, chaves ou firmware, que devem ser obtidos do seu próprio console e jogos. A lista de verificação do The abaixo salva seu progresso neste navegador para que você possa retomá-la após reiniciar ou atualizar os drivers.
6Passos de configuração
4Pacotes oficiais para desktop
2.39Versão mínima da glibc no Linux
15Versão mínima do macOS no Apple Silicon
Checklist de configuração
0 / 6 passos concluídos
01
Baixe exclusivamente do GitHub
Abra a página do Releases em github.com/zortos293/Lichii e selecione o pacote da build 117 indicado para o seu sistema. O Windows utiliza zip; o Linux, AppImage ou tar.gz; e Macs com Apple Silicon, dmg ou zip. O pacote The PGO é a alternativa recomendada.
Windows x86_64 · Linux x86_64 ou aarch64 · macOS arm64
Por que isso importaO lichii.org e sites parecidos não têm ligação com o projeto. A issue #545 relata um zip desse site executando node.exe a partir de %TEMP%.
Os pacotes para Windows são zips portáteis: extraia todo o conteúdo para uma pasta comum e execute o lichii.exe ou eden-cli.exe pelo terminal. No Linux, dê permissão de execução ao AppImage com chmod +x ou descompacte o tar.gz e execute ./lichii. No Mac, abra o dmg e arraste lichii.app para a pasta Aplicativos.
AppImage: glibc 2.39+ · tar.gz: Qt 6 do sistema · macOS 15+, não autenticado
Por que isso importaExecutar o lichii.exe direto de dentro do zip sem extrair impede o carregamento das bibliotecas necessárias.
O Lichii não inclui chaves de descriptografia. Ao iniciar sem elas, o log exibirá: Decryption keys are missing: NCA, NSP and XCI games need them. Use as chaves do seu próprio console; não disponibilizamos chaves nem links para download aqui.
Keys extraídas do seu próprio hardware
Por que isso importaSem as chaves, a lista de jogos fica vazia ou os jogos não abrem, aparentando um crash que na verdade não ocorreu.
Sem firmware, o registro exibe Installed firmware: No firmware available. Instale o firmware extraído do seu próprio console. Vários jogos exigem o firmware para fontes compartilhadas e arquivos do sistema; além disso, os relatórios de bug no repositório exigem a versão do firmware ao lado da versão do jogo.
Firmware do seu próprio console
Por que isso importaA falta de fontes e arquivos de sistema do firmware causa textos quebrados e falhas que não acontecem em uma instalação completa.
O Lichii continua usando as pastas de dados e chaves de configuração existentes do Eden e do Eglantine, sem nunca apagar ou mover saves, configurações ou cache de shaders. Copie essa pasta para um local seguro antes de abrir uma nova versão. O menu File > Open Lichii Folders abre o diretório diretamente.
Espaço em disco para uma cópia dos seus saves
Por que isso importaCompilações experimentais ainda podem corromper saves. Manter uma cópia de A fora das pastas do emulador é a única forma segura de restauração.
Inicie o Lichii, adicione sua pasta de jogos ou use File > Load File e execute o jogo. A primeira inicialização no The compila shaders, causando engasgos nos minutos iniciais. Se algo falhar, o log fica salvo em File > Open Lichii Folders > Log Folder > eden_log.txt.
Dump original obtido legalmente do seu jogo
Por que isso importaAnexar o eden_log.txt e o número da compilação é essencial para que o relatório de erro possa ser investigado.
Extraia o zip e execute o lichii.exe. O zip de The PGO é compilado com perfil ThinLTO otimizado para Ocarina of Time. O Windows soma 122.388 dos downloads da build 117.
Linux
O The AppImage requer glibc 2.39 ou superior: Ubuntu 24.04, Fedora 40, Debian 13 ou Arch. Distribuições mais antigas devem usar o tar.gz com as bibliotecas Qt 6 do sistema. Há pacotes para x86_64 e aarch64.
macOS
Apenas Apple Silicon no macOS 15 ou posterior. O aplicativo no The não é notarizado, portanto o macOS impede a primeira execução até que você o autorize nas Preferências do System em Privacidade e Segurança.
downloads da Build 117 por plataforma. Android não possui pacote oficial.
Atualizando para uma versão mais recente
01
Use o atualizador
A partir da versão 75, o atualizador integrado verifica lançamentos do Lichii no GitHub e escolhe o pacote certo para o seu sistema (#82).
02
Ou substitua a pasta
Baixe o novo pacote e extraia-o sobre uma pasta nova. Seus dados salvos permanecem no diretório de dados, não na pasta do programa.
03
Copie os dados salvos novamente
Faça um backup novo antes de mudar para uma versão nova, especialmente quando as notas da versão mencionarem alterações nos salvamentos ou no sistema de arquivos.
Perguntas frequentes
O Lichii inclui chaves, firmware ou jogos?
Não. O The README declara expressamente que jogos, chaves e firmware não são fornecidos, devendo ser utilizados apenas arquivos e títulos obtidos por meios legítimos. Ao iniciar pela primeira vez sem eles, o Lichii registrará nos logs a ausência de chaves de descriptografia e de firmware instalado.
Onde o Lichii guarda meus dados salvos?
Nos diretórios de dados existentes do Eden e do Eglantine, que o Lichii continua usando junto com suas chaves de configuração. Ele nunca move nem exclui salvamentos, configurações ou caches de shaders. File > Open Lichii Folders abre esse local para você copiar antes de testar uma nova versão.
Preciso configurar tudo de novo a cada nova versão?
Não. Chaves, firmware, configurações e dados salvos ficam no diretório de dados, portanto uma nova versão os reconhece automaticamente. A partir da versão 75, o atualizador integrado pode baixar o pacote correto do GitHub para você. De qualquer forma, faça backup dos salvamentos antes de cada atualização.
Por que meu Mac se recusa a abrir o Lichii?
A compilação para The macOS não é notarizada; por isso, o Gatekeeper impede a primeira inicialização. Autorize-a nas Preferências do System em Privacidade e Segurança. É necessário também contar com Apple Silicon Mac no macOS 15 ou posterior; Macs com processador Intel não contam com compilação oficial.
