Important
Ce projet a été remplacé et n'est plus en cours d'élaboration. Son successeur direct est Lönn. Si vous envisagez d'installer Ahorn, veuillez plutôt utiliser Lönn.
Rejoignez-nous sur Discord ! (nous sommes en #map_making sur le serveur Discord "Mt. Celeste Climbing Association")
Ahorn est un créateur et éditeur de niveaux visuels pour le jeu Celeste. Il permet d'éditer des fichiers binaires de cartes, d'en créer de nouveaux, d'ajouter des pièces et de remplir les pièces avec tout ce que votre cœur désire (à condition que ce que votre cœur désire soit possible dans les domaines du jeu). Les binaires de cartes générés peuvent être chargés dans le jeu stock ou en utilisant Everest. Pour une utilisation sans Everest, vous pouvez remplacer une carte dans Content/Maps (n'oubliez pas les sauvegardes), sinon vous pouvez la placer dans Mods/ avec Everest et utiliser le chargement de chapitre personnalisé. L'utilisation d'Everest permet également d'autres fonctionnalités comme le rechargement instantané de la carte en utilisant F5 ou la téléportation dans une certaine pièce du jeu en cliquant dessus dans Ahorn.
Le programme en est encore à ses débuts, certaines choses manquent encore et il est en cours de développement actif. Si vous repérez quelque chose qui manque, il sera probablement ajouté dans un avenir proche. Si vous repérez un bug ou si le programme plante, veuillez le signaler.
Ahorn est basé sur Maple, un mince wrapper autour du format binaire de carte Celeste qui vous permet de générer des cartes à l'aide de Julia.
Ce projet est un créateur de cartes et un éditeur de niveaux non officiel, il s'agit simplement d'un projet de fan visant à aider au développement de cartes jusqu'à ce que quelque chose d'officiel soit disponible. Aucun de ce code n'est développé par ou connecté à l'équipe de développement de Celeste.
Si vous utilisez déjà Olympus pour jouer à Celeste modifié, vous pouvez également l'utiliser pour installer Ahorn pour vous. Cliquez simplement sur le bouton « Ahorn » dans le menu principal et suivez le guide.
Cette méthode d'installation ne fonctionne que sous Windows et peut être légèrement plus simple que la méthode multiplateforme. Téléchargez le fichier batch d'installation et d'exécution ahorn.bat (cliquez avec le bouton droit sur le lien et appuyez sur "Enregistrer sous...") et exécutez-le dans n'importe quel dossier. Le fichier installera Julia, configurera Ahorn (si nécessaire), puis le lancera. Tous les fichiers téléchargés seront temporairement placés dans le dossier dans lequel le fichier a été exécuté. Suivez simplement ses instructions.
Exécuter à nouveau ahorn.bat une fois l’installation terminée démarrera Ahorn.
Tout d’abord, installez Julia si ce n’est pas déjà fait. Vous aurez besoin de Julia 1.3 ou version ultérieure.
Le moyen le plus simple d'installer Ahorn serait de télécharger le programme d'installation install_ahorn.jl (cliquez avec le bouton droit sur le lien et appuyez sur "Enregistrer sous...") et de l'exécuter avec Julia dans le terminal. Suivez simplement ses instructions. Ahorn et Maple sont installés à l'aide du système Pkg de Julia. Le programme d'installation téléchargera et installera également les dépendances requises, alors prenez un verre de jus pendant que vous attendez.
~$ Julia install_ahorn.jl
Lors du premier lancement du programme, Ahorn vous demandera de sélectionner le répertoire de votre installation celeste. Il faut que Celeste soit installé pour pouvoir en extraire les textures, puisque nous ne les incluons pas dans le programme.
Le fichier de configuration se trouve dans %localappdata%/Ahorn sous Windows, sinon dans ~/.config/Ahorn .
Ahorn et Maple peuvent être mis à jour depuis Ahorn, via Help->Check for Updates , ou comme n'importe quel package Julia utilisant Pkg.update() . Pour désinstaller Ahorn, exécutez rm Ahorn puis gc dans le Julia Package REPL activé sur %localappdata%/Ahorn/env sous Windows ou ~/.config/Ahorn/env sinon.
Les actions possibles dans Ahorn sont répertoriées à droite, il suffit d'en sélectionner une pour l'utiliser. Maintenez le clic droit pour vous déplacer sur la carte. Le clic gauche est votre principal moyen de placer un objet ou de sélectionner quelque chose. Des outils comme un rectangle ou une ligne nécessitent de maintenir le clic gauche tout en se déplaçant sur l'écran. Faites défiler pour zoomer.
Dans n'importe quel menu, vous pouvez survoler le nom d'une option ou d'un champ pour afficher une info-bulle détaillée expliquant sa signification et son utilisation.
Ahorn prend en charge quelques raccourcis clavier et fonctionnalités spéciales de souris, et d'autres sont à venir. La liste suivante n’est peut-être pas exhaustive.
Ctrl + N : Nouvelle carte
Ctrl + S : Enregistrer la carte
Ctrl + Maj + S : Enregistrer la carte sous...
Ctrl + T : Nouvelle salle
Ctrl + Maj + T : Configurer la salle actuelle
Alt + Flèches : Déplacer la pièce
Alt + Suppr : Supprimer la pièce
Faites un clic droit et faites glisser : déplacez-vous sur la carte
Ctrl + M : fenêtre de métadonnées
Ctrl + Maj + Alt + S : ouvrir la fenêtre des paramètres
Ctrl + Z : Annuler l'action
Ctrl + Maj + Z : Rétablir l'action
Ctrl + F : Focus sur le champ de recherche
Retour dans le champ de recherche : Quitter et effacer le champ de recherche
Échapper dans le champ de recherche : Quitter le champ de recherche
Molette de défilement : Zoom
Ctrl + ➕ (plus) : zoomer
Ctrl + ➖ (moins) : effectuer un zoom arrière
Double-cliquez sur le nom du matériau dans les outils : basculer vers les favoris
Double clic gauche sur l'aperçu dans la fenêtre stylegrounds : basculer l'aperçu
Ctrl + touche numérique, rangée 0-9 : raccourcis pour sélectionner les outils
Clic gauche : placer un objet
Maintenir Ctrl + clic gauche : utilisez 1 comme taille de pas au lieu de 8 pour des placements plus précis
Clic droit : ouvrir les propriétés de l'objet sous le curseur
Clic gauche et glisser : Ajustez la taille des objets redimensionnables lors du placement
Clic du milieu : cloner l'objet sous le curseur
Q, E : Réduire/agrandir la largeur sur l'autocollant
A, D : rétrécir/augmenter la hauteur sur l'autocollant
L, R : faire pivoter les objets pris en charge dans le sens inverse des aiguilles d'une montre/dans le sens des aiguilles d'une montre
V, H : retourner les objets pris en charge verticalement/horizontalement
Clic gauche et glisser : sélectionner des objets
Maj + Clic gauche et glisser : Ajouter à la sélection actuelle
Sélection par clic droit : ouvrir les propriétés du ou des objets sélectionnés
Maintenir le bouton gauche de la souris sur la sélection : faites glisser les objets sélectionnés
Double clic gauche : sélectionnez tous les objets similaires
Ctrl + Double clic gauche : Sélectionne tous les objets similaires mais plus stricts
Touches fléchées : déplacer les objets sélectionnés
Q, E : Réduire/augmenter la largeur sur les entités/déclencheurs sélectionnés
A, D : Réduire/augmenter la hauteur sur les entités/déclencheurs sélectionnés
Maintenir Ctrl + l'une des options ci-dessus : utilisez 1 comme taille de pas au lieu de 8 pour un contrôle plus précis
L, R : faire pivoter les objets pris en charge dans le sens inverse des aiguilles d'une montre/dans le sens des aiguilles d'une montre
V, H : retourner les objets pris en charge verticalement/horizontalement
Maj + V / Maj + H : retourner la zone sélectionnée verticalement/horizontalement
N ou ➕ (plus) sur l'entité/le déclencheur : ajouter le nœud de départ à l'entité/au déclencheur
N ou ➕ (plus) sur le nœud : ajouter un nœud à l'entité/au déclencheur après le nœud sélectionné
Supprimer : Supprimer les objets sélectionnés
Retour ou Échap : Effacer la sélection
Ctrl + C : Copier la sélection
Ctrl + X : Couper la sélection
Ctrl + V : Coller la sélection
Clic gauche : Placer le pinceau
Clic gauche et glisser : faire glisser le pinceau
Clic du milieu : changer le matériau en tuile sous le curseur
L, R : Faites pivoter la brosse supportée dans le sens inverse des aiguilles d'une montre/dans le sens des aiguilles d'une montre.
Avec Everest installé et Celeste exécuté en mode débogage, il en prend en charge d'autres :
Ctrl + Alt + Clic gauche sur une pièce d'Ahorn : Téléportation vers cette pièce dans le jeu
Si vous envisagez sérieusement de créer des cartes, il est fortement recommandé d'utiliser Everest pour les fonctionnalités F5 (forcer le rechargement de la carte) et F6 (ouvrir l'éditeur de carte pour la carte actuelle).
Si vous avez des questions, posez-les-nous sur #map_making sur Discord afin que nous puissions l'ajouter à ce fichier README. Merci de votre intérêt pour la création de cartes pour Celeste !
Fenêtre principale d'Ahorn
Gros plan d'une pièce, avec une rangée de Crystal Spinners sélectionnée
Quand pourrai-je placer [entité/décalcomanie/déclencheur/autre chose dans celeste] ?
Chaque fois que nous l'ajoutons. Celeste a beaucoup de choses pour lesquelles la prise en charge doit être ajoutée individuellement. Cela prend du temps, alors soyez patient. Cependant, si davantage de personnes se plaignent du manque d’un élément particulier, nous pourrions l’ajouter plus tôt.
Pourquoi tant de choses dans le programme portent-elles des noms étranges ?
La plupart de ces noms sont des noms utilisés en interne par le jeu, alors blâmez les développeurs. La plupart d’entre eux n’ont pas de noms officiels, mais nous pourrions rendre les noms en Ahorn un peu plus descriptifs plus tard.
Est-il sécuritaire de réenregistrer les cartes du jeu de base Celeste ?
Non. Si quelque chose n’est pas visible dans Ahorn, il est toujours présent dans les données et sera enregistré avec. Cependant, Maple n'est actuellement toujours pas en mesure de sauvegarder 100 % des cartes originales, seulement environ 99 %. Comme toujours, faites des sauvegardes.
Comment effectuer des transitions de pièce ?
Un joueur peut se déplacer d'une pièce à l'autre si les pièces sont directement adjacentes et qu'il y a au moins un point d'apparition (entité du joueur) dans chaque pièce.
Alors, j'ai fait une carte. Et maintenant ? Comment puis-je le charger ?
Bien que vous puissiez charger des cartes sans cela, il est fortement recommandé d'installer Everest. Une fois Everest installé, placez votre binaire de carte dans Mods/ dans votre répertoire d'installation Celeste. Il devrait désormais être accessible depuis le jeu.
Quelque chose est cassé !
Ce n'est pas une question, mais veuillez signaler tout bug que vous trouvez !
Que ferez-vous une fois que le créateur de cartes officiel sera disponible ?
Chaque fois que cela se produit, nous pourrions continuer comme avant ; il se pourrait bien que l’éditeur officiel ne soit pas aussi puissant qu’Ahorn tente de l’être. Cela pourrait ne jamais exister. Nous verrons.
Pourquoi écris-tu ça dans Julia ?
"parce que c'est juste arrivé" ~ @Cruor
Parce que c'est plus rapide que la plupart des autres langues, parce que c'est un plaisir d'écrire et parce que nous le voulions.
Copyright (c) Vexatos et Cruor. Tous droits réservés. Reportez-vous à LICENSE.md.
