L'éditeur ALIS

L'éditeur ALIS est un écran du moteur lui-même : on y ouvre les scripts d'un jeu Silmarils écrits dans le langage source ALIS (language.md), on les modifie, on les compile, puis on joue le jeu avec. Il fonctionne partout où le moteur tourne : dans le navigateur (le playground JumPHP), sur le bureau, sans rien installer de plus.

L'ouvrir

À l'écran d'accueil, chaque jeu dont on a les sources propose une ligne <JEU> - ALIS EDITOR (pour Robinson's Requiem : ROBINSON'S REQUIEM (PC CD) - ALIS EDITOR). Les sources sont celles produites par le décompilateur (tools/lang/decompile.php) : dans le navigateur, elles sont téléchargées à la demande (fichiers privés lazy/<jeu>/<script>.als), comme les films.

Les deux écrans

La liste des scripts. Le script principal (main) d'abord, puis les autres par ordre alphabétique ; un point ● et la mention modifié signalent ceux que tu as changés. On choisit au clavier (flèches, Page préc./suiv., ou les premières lettres du nom tapées à la suite) ou à la souris (un clic sélectionne, un second ouvre). Entrée ouvre, Échap (ou le bouton ← Menu en haut à gauche) revient au menu du moteur.

Le texte d'un script, au format 90 (le langage humain : mots français, variables nommées et déclarées, si … alors … finsi, voir language.md), en ALIS BASIC (le script tel que les développeurs de Silmarils l'écrivaient vraisemblablement sur Atari ST, à la manière du GFA BASIC) ou au format machine : F2 passe de l'un à l'autre. Numéros de ligne, coloration du langage (étiquettes, instructions, mots de contrôle, variables, nombres, chaînes, commentaires, en-tête), ligne courante surlignée, sélection, défilement à la molette. La barre du haut donne le jeu, le script (un • tant qu'il n'est pas enregistré) et la position du curseur ; celle du bas, les messages (erreurs de compilation comprises) et les raccourcis.

Les raccourcis

TouchesEffet
Ctrl+Scompile le script ; s'il est juste, il est enregistré
F5enregistre et lance le jeu (édition « ALIS sources ») ; F10 en jeu revient à l'éditeur, sur le même script
F6la même chose avec l'édition HD
F2format 90 (le langage humain, par défaut) → ALIS BASIC → format machine → format 90 : le même script
Ctrl+F, F3, Maj+F3chercher (sans tenir compte des majuscules), suivant, précédent
Ctrl+Galler à une ligne (120) ou à une étiquette (L0049)
Ctrl+Z, Ctrl+Y (ou Ctrl+Maj+Z)annuler, rétablir
Ctrl+C, Ctrl+X, Ctrl+Vcopier, couper, coller (le presse-papiers du système)
Ctrl+Atout sélectionner
Tab, Maj+Tabindenter, désindenter (les lignes sélectionnées, ou 4 espaces au curseur)
flèches, Origine, Fin, Page préc./suiv.déplacer le curseur ; avec Maj : sélectionner ; avec Ctrl : par mot, début / fin du script
Ctrl+Rrevenir au script original (ta version est effacée)
F1l'aide
Échapdésélectionne, puis revient à la liste
bouton ← Retour (en haut à gauche)à la souris ou au doigt, sans clavier : du texte à la liste, de la liste au menu (si le script n'est pas enregistré, un premier clic prévient)

Entrée garde l'indentation de la ligne (un niveau de plus après une {) ; une } tapée seule sur sa ligne recule d'un niveau.

Compiler, enregistrer, jouer

Ctrl+S passe le texte au compilateur du moteur (App\Alis\Lang\Assembler, le même que celui qui charge les scripts en jeu). Une erreur surligne sa ligne en rouge, y place le curseur et s'affiche en bas (Erreur : line 13: unknown statement frobnicate) : rien n'est enregistré tant que le script ne compile pas.

Un script juste est gardé dans tes fichiers (le dossier var/ du jeu ; dans le navigateur, la base IndexedDB de la page) sous le nom alis-src-<jeu>-<script>.als. Le jeu original n'est pas touché : ce sont les éditions « ALIS sources » et « HD » qui compilent ta version à la place de l'originale (sys_source_io() dans fn/sys.php). Un script identique à l'original n'est pas gardé. Ctrl+R efface ta version.

Exemple : dans flags, l'écran du choix de la langue, remplace putnat 108, 0, 137, 5 + vb[0x52], 1 par putnat 108, 0, 177, 5 + vb[0x52], 1, F5 : le drapeau français n'est plus à la même place.

Pour aller plus loin

L'éditeur ALIS ouvert sur le script flags de Robinson's Requiem, une erreur de compilation surlignée

▶ Jouer