Importante
Este projeto foi substituído e não está mais sendo trabalhado. Seu sucessor direto é Lönn. Se você está pensando em instalar o Ahorn, use o Lönn.
Junte-se a nós no Discord! (estamos em #map_making no servidor Discord "Mt. Celeste Climbing Association")
Ahorn é um criador e editor de níveis visuais para o jogo Celeste. Ele permite editar binários de mapas, criar novos, adicionar salas e preencher as salas com o que seu coração desejar (desde que o que seu coração deseja seja possível dentro dos domínios do jogo). Os binários de mapas gerados podem ser carregados no jogo padrão ou usando o Everest. Para uso sem o Everest, você pode substituir um mapa em Content/Maps (lembre-se dos backups), caso contrário, você pode colocá-lo em Mods/ com Everest e usar o carregamento de capítulo personalizado. Usar o Everest também permite outros recursos, como recarregar instantaneamente o mapa usando F5 ou teletransportar-se para uma determinada sala do jogo clicando nela em Ahorn.
O programa ainda está em um estado inicial, ainda faltam algumas coisas e está em desenvolvimento ativo. Se você detectar algo que está faltando, provavelmente será adicionado em um futuro próximo. Se você detectar um bug ou o programa travar, informe-o.
Ahorn é baseado no Maple, um wrapper fino em torno do formato binário do mapa Celeste que permite gerar mapas usando Julia.
Este projeto é um criador de mapas e editor de níveis não oficial, é apenas um projeto de fãs com o objetivo de auxiliar no desenvolvimento de mapas até que algo oficial esteja disponível. Nenhum deste código é desenvolvido ou conectado à equipe de desenvolvimento da Celeste.
Se você já usa o Olympus para jogar Celeste modificada, também pode usá-lo para instalar o Ahorn para você. Basta clicar no botão que diz “Ahorn” no menu principal e seguir o guia lá.
Este método de instalação funciona apenas no Windows e pode ser um pouco mais fácil do que o método multiplataforma. Baixe o arquivo em lote do instalador e do executor ahorn.bat (clique com o botão direito no link e pressione "Salvar como...") e execute-o em qualquer pasta. O arquivo irá instalar Julia, configurar o Ahorn (se necessário) e então iniciá-lo. Todos os arquivos baixados serão colocados temporariamente na pasta em que o arquivo foi executado. Basta seguir as instruções.
Executar ahorn.bat novamente após a conclusão da instalação iniciará o Ahorn.
Primeiro, instale o Julia, caso ainda não o tenha feito. Você precisará do Julia 1.3 ou posterior.
A maneira mais fácil de instalar o Ahorn seria baixar o instalador install_ahorn.jl (clique com o botão direito no link e pressione "Salvar como...") e execute-o com Julia no terminal. Basta seguir suas instruções. Ahorn e Maple são instalados usando o sistema Pkg de Julia. O instalador também baixará e instalará as dependências necessárias, então pegue um copo de suco enquanto espera.
~$ julia install_ahorn.jl
Ao iniciar o programa pela primeira vez, Ahorn solicitará que você selecione o diretório de instalação do seu celeste. É necessário que o Celeste esteja instalado para poder extrair texturas dele, já que não as incluímos no programa.
O arquivo de configuração pode ser encontrado em %localappdata%/Ahorn no Windows, caso contrário, em ~/.config/Ahorn .
Ahorn e Maple podem ser atualizados de dentro do Ahorn, via Help->Check for Updates , ou como qualquer pacote Julia usando Pkg.update() . Para desinstalar o Ahorn, execute rm Ahorn e depois gc no pacote Julia REPL ativado para %localappdata%/Ahorn/env no Windows ou ~/.config/Ahorn/env caso contrário.
As ações possíveis no Ahorn estão listadas à direita, basta selecionar uma para utilizá-la. Segure o botão direito para mover-se pelo mapa. O clique esquerdo é a principal forma de posicionar um objeto ou selecionar algo. Ferramentas como retângulo ou linha exigem que você mantenha pressionado o botão esquerdo enquanto se move pela tela. Role para ampliar.
Em qualquer menu, você pode passar o mouse sobre o nome de uma opção ou campo para obter uma dica detalhada explicando seu significado e uso.
Ahorn suporta alguns atalhos de teclado e funcionalidades especiais de mouse, com mais por vir. A lista a seguir pode não ser abrangente.
Ctrl + N: Novo mapa
Ctrl + S: Salvar mapa
Ctrl + Shift + S: Salvar mapa como...
Ctrl + T: Nova sala
Ctrl + Shift + T: configura a sala atual
Alt + teclas de seta: Mover sala
Alt + Delete: Excluir sala
Clique com o botão direito e arraste: mova-se pelo mapa
Ctrl + M: janela de metadados
Ctrl + Shift + Alt + S: abre a janela de configurações
Ctrl + Z: Desfazer ação
Ctrl + Shift + Z: Refazer ação
Ctrl + F: Campo de pesquisa em foco
Retornar no campo de pesquisa: Sair e limpar o campo de pesquisa
Escape no campo de pesquisa: Sai do campo de pesquisa
Roda de rolagem: Zoom
Ctrl + ➕ (mais): Ampliar
Ctrl + ➖ (menos): Diminuir zoom
Clique duas vezes com o botão esquerdo no nome do material nas ferramentas: Alternar favorito
Visualização do duplo clique com o botão esquerdo na janela stylegrounds: Alternar visualização
Ctrl + tecla numérica linha 0-9: Atalhos para selecionar ferramentas
Clique esquerdo: Colocar objeto
Segurando Ctrl + clique esquerdo: use 1 como tamanho do passo em vez de 8 para posicionamentos mais refinados
Clique com o botão direito: abre as propriedades do objeto sob o cursor
Clique com o botão esquerdo e arraste: ajuste o tamanho dos objetos redimensionáveis ao posicionar
Clique com o meio: clonar objeto sob o cursor
Q, E: Diminuir/aumentar largura no decalque
A, D: Diminuir/aumentar a altura no decalque
L, R: Girar objetos suportados no sentido anti-horário/horário
V, H: Virar objetos suportados verticalmente/horizontalmente
Clique com o botão esquerdo e arraste: selecione objetos
Shift + clique esquerdo e arraste: Adicionar à seleção atual
Seleção com clique direito: abre as propriedades do(s) objeto(s) selecionado(s)
Mantendo o botão esquerdo do mouse sobre a seleção: arraste os objetos selecionados
Clique duplo com o botão esquerdo: selecione todos os objetos semelhantes
Ctrl + Clique duplo com o botão esquerdo: Selecione todos os objetos semelhantes, mas mais rigorosos
Teclas de seta: Mover objetos selecionados
Q, E: Diminuir/aumentar largura em entidades/gatilhos selecionados
A, D: Diminuir/aumentar a altura em entidades/gatilhos selecionados
Segurando Ctrl + qualquer uma das opções acima: use 1 como tamanho do passo em vez de 8 para um controle mais refinado
L, R: Girar objetos suportados no sentido anti-horário/horário
V, H: Virar objetos suportados verticalmente/horizontalmente
Shift + V / Shift + H: Virar a área selecionada verticalmente/horizontalmente
N ou ➕ (mais) na entidade/gatilho: Adicione o nó inicial à entidade/gatilho
N ou ➕ (mais) no nó: adiciona nó à entidade/gatilho após o nó selecionado
Excluir: Excluir objeto(s) selecionado(s)
Retorno ou Fuga: Limpar seleção
Ctrl + C: Copiar seleção
Ctrl + X: Cortar seleção
Ctrl + V: Colar seleção
Clique esquerdo: Colocar pincel
Clique com o botão esquerdo e arraste: arraste o pincel
Clique com o botão do meio: Altere o material para o bloco sob o cursor
L, R: Gire a escova suportada no sentido anti-horário/horário
Com o Everest instalado e o Celeste rodando em modo de depuração, ele suporta mais alguns:
Ctrl + Alt + Clique esquerdo em uma sala em Ahorn: teletransporte-se para aquela sala no jogo
Se você leva a sério a criação de mapas, é altamente recomendável usar o Everest para os recursos F5 (forçar recarregamento do mapa) e F6 (editor de mapa aberto para o mapa atual).
Se você tiver alguma dúvida, pergunte-nos em #map_making no Discord para que possamos adicioná-la a este arquivo README. Obrigado por estar interessado em fazer mapas para Celeste!
Janela principal do Ahorn
Close de uma sala, com uma fileira de Crystal Spinners selecionados
Quando poderei colocar [entidade/decalque/gatilho/outra coisa em celeste]?
Sempre que o adicionamos. Celeste tem muitas coisas que precisam ser adicionadas individualmente. Isso leva tempo, então seja paciente. No entanto, se mais pessoas reclamarem da falta de uma determinada coisa, poderemos adicioná-la mais cedo.
Por que tantas coisas no programa têm nomes estranhos?
A maioria desses são nomes usados internamente pelo jogo, então culpe os desenvolvedores. A maioria deles não tem nomes oficiais, mas podemos tornar os nomes em Ahorn um pouco mais descritivos mais tarde.
É seguro salvar novamente os mapas do jogo Celeste básico?
Não. Se algo não estiver visível no Ahorn, ainda estará lá nos dados e será salvo junto com ele. No entanto, o Maple ainda não consegue salvar 100% dos mapas originais, apenas cerca de 99%. Como sempre, faça backups.
Como faço transições de sala?
Um jogador é capaz de se mover de uma sala para outra se as salas forem diretamente adjacentes e houver pelo menos um ponto de spawn (entidade do jogador) em cada sala.
Então, fiz um mapa. E agora? Como faço para carregá-lo?
Embora você possa carregar mapas sem, é altamente recomendável instalar o Everest. Depois que o Everest estiver instalado, coloque o binário do seu mapa em Mods/ no diretório de instalação do Celeste. Agora deve estar acessível dentro do jogo.
Algo está quebrado!
Isso não é uma pergunta, mas por favor reporte qualquer bug que encontrar!
O que você fará quando o criador de mapas oficial for lançado?
Sempre que isso acontecer, poderemos continuar como antes; pode ser que o editor oficial não seja tão poderoso quanto Ahorn tenta ser. Talvez nunca exista. Veremos.
Por que você está escrevendo isso em Julia?
"porque simplesmente aconteceu" ~ @Cruor
Porque é mais rápido que a maioria dos outros idiomas, porque é um prazer escrever e porque queríamos fazê-lo.
Direitos autorais (c) Vexatos e Cruor. Todos os direitos reservados. Consulte LICENSE.md.
