CODING · 23 MIN

Scorpion Engines (Instructions)

Scorpion Engine est un moteur de jeu et un outil de création qui supporte nativement plusieurs systèmes de jeux rétro populaires basés sur le processeur Motorola 68000

Référence complète des commandes (instructions)

Source : Wiki officiel – Autodocs

Ce document couvre l’intégralité des commandes, codeblocks internes, constantes et variables internes du moteur Scorpion Engine. Toutes les commandes sont configurées via les menus déroulants de l’éditeur — aucune syntaxe à mémoriser.


Table des matières

  1. Commandes – Actor
  2. Commandes – Audio
  3. Commandes – Base
  4. Commandes – Conditional
  5. Commandes – Controls
  6. Commandes – Data
  7. Commandes – Dialogue
  8. Commandes – Display
  9. Commandes – Level
  10. Commandes – Maths
  11. Commandes – Palette
  12. Déclarations – Variables & Constantes
  13. Codeblocks internes
  14. Constantes internes
    1. vm constants
    2. vm constants animationflags
    3. vm constants audiodriver
    4. vm constants controlbits
    5. vm constants hardware
    6. vm constants look directions
    7. vm constants notes (périodes musicales)
    8. vm constants rendermodes
    9. vm constants tile properties
  15. Variables internes
    1. Variables d’acteur
    2. Variables générales

1. Commandes – Actor

Commandes agissant sur l’acteur courant. Les mêmes commandes sont disponibles avec les préfixes Actor, Projectile, Player et New.

CommandeDescription
AnimationDéclencher une animation sur l’entité
Camera FollowForcer la caméra à suivre cet acteur spécifique
Child SpawnSpawner un enfant de cet acteur (pour spawner un nouvel acteur indépendant, utiliser la catégorie Level)
DirectionDéfinir la direction de regard ou de mouvement de cette entité
FreezeGéler ou dégéler l’acteur — empêche mouvement, collision et animations
Look At PointRegarder vers un point spécifique du niveau
MeleeDéclencher manuellement une boîte d’attaque melee
OriginModifier la position relative de l’entité (liée au parent)
PositionModifier la position de l’entité
PushPousser cette entité d’un certain montant sur un nombre de frames
Render ClearingActiver ou désactiver le clearing du rendu d’un acteur
Render ModeDéfinir le mode de rendu de cette entité
Schedule EventDéclencher un codeblock sur cette entité après un nombre de frames
SeparateSi en chevauchement, séparer d’un autre acteur pour qu’ils ne se superposent plus
Set as NEWDésigner cet acteur, ou le parent de l’acteur, comme NEW
Set as PlayerChanger PLAYER pour pointer vers celui qui possède un contrôleur spécifique
Set ControllerSurcharger le contrôleur joystick de l’acteur
ShootTirer un acteur
Spawn ActorRaccourci vers Level → Spawn Actor
SpeedDéfinir la vitesse exacte de cette entité
TypeModifier le type de l’entité
YieldExécuter le code suivant après un nombre de frames
Z OrderModifier la position Z de rendu de l’acteur

2. Commandes – Audio

Commandes agissant sur le son et la musique.

CommandeDescription
Auto Fade MusicDéfinir si la musique fonde avec l’écran
Music PauseMettre la lecture musicale en pause
Music PositionDéfinir la position de pattern d’une chanson
Music ResumeReprendre la musique là où elle s’est arrêtée
Music VolumeDéfinir le volume de la musique (0–256)
MusicCharger et jouer une chanson
Play CD MusicLire ou stopper la musique CD (ou ADPCM-B sur Neo Geo)
Set Music ChannelsRéserver des canaux spécifiquement pour la musique
Sound VolumeDéfinir le volume des effets sonores (0–256)
SoundDéclencher un effet sonore

3. Commandes – Base

Commandes pour les opérations basiques et générales.

CommandeDescription
AdvancedFonctions internes du moteur. À utiliser uniquement si vous savez ce que vous faites !
CommentAucune action — utilisé uniquement pour commenter les codeblocks
ExecuteExécuter une commande AmigaDOS (utiliser avec précaution)
GosubAller à un autre codeblock ou label, retourner ici quand Return est appelé
GotoAller à un autre codeblock ou label
InlineInsérer un codeblock entier à cette ligne (plus rapide que Gosub, pas de Return)
LabelDéfinir un point à l’intérieur d’un codeblock pour les commandes Goto ou Gosub
Pop from stackDépiler une valeur dans une variable (AVANCÉ)
Push to stackEmpiler une valeur (AVANCÉ)
QuitQuitter vers AmigaDOS ou Workbench (valeur autre que 0 = afficher code d’erreur)
ReturnRetourner au jeu (ou au dernier Gosub)
Roll DiceGénérer un nombre aléatoire en simulant un jet de dé
Schedule EventDéclencher un codeblock sur ce niveau après un nombre de frames
Set VariableModifier la valeur d’une variable
WaitGeler le jeu pendant un nombre de frames
Yield On LevelContinuer ce codeblock après un nombre de frames, via le OnTimer du niveau

Différence Gosub / Inline / Goto

  • Gosub : appel avec retour — exécute l’autre codeblock, puis revient à la ligne suivante. Légèrement plus lent (utilise la pile).
  • Inline : copie-colle le contenu du codeblock cible directement ici, sans appel de pile. Plus rapide, mais alourdit la taille du codeblock compilé.
  • Goto : saut inconditionnel sans retour.
  • Yield : pause non-bloquante — le jeu continue de tourner, le code reprend N frames plus tard.
  • Wait : pause bloquante — le jeu est gelé pendant N frames. Utile pour les cut-scenes ou intros.

4. Commandes – Conditional

Commandes pour les conditions et boucles.

CommandeDescription
ConditionInstruction IF standard
Else IfInstruction IF qui ne s’exécute que si l’IF précédent était faux
ElseSi l’instruction IF précédente était fausse, exécuter ceci
End ConditionFermer le dernier bloc conditionnel ouvert
For Each ActorExécuter un codeblock sur chaque acteur d’un type (ou tous les acteurs)
ForBoucle avec variable de compteur
WhileBoucle tant que la condition IF est vraie

Conseil de performance : utilisez Else If plutôt qu’une série de If indépendants. Dès qu’une branche Else If est vraie, les suivantes sont ignorées.


5. Commandes – Controls

Commandes agissant sur les contrôleurs.

CommandeDescription
Attack/Move ControlsModifier le bouton d’attaque/déplacement et ses paramètres de comportement
Boost AccelerationBooster l’accélération d’un acteur contrôlé
BoostBooster la vitesse maximale d’un acteur contrôlé
Control ModeModifier le nombre et le type de contrôleurs actifs
Jump ControlsModifier le bouton de saut et ses paramètres de comportement

6. Commandes – Data

Commandes agissant sur les données (chargement et sauvegarde).

CommandeDescription
Data LoadCharger des variables depuis le disque. Vérifier la variable Success pour le résultat.
Data SaveSauvegarder des variables sur le disque. Vérifier la variable Success pour le résultat.
String ClearEffacer une chaîne de caractères entière
String ReplaceRemplacer une chaîne entière par une autre
String Set CharacterModifier un caractère d’une chaîne à un index donné (code ASCII)

7. Commandes – Dialogue

Commandes pour l’affichage de texte.

CommandeDescription
ChoiceConfigurer une option de dialogue pour le joueur
PrintImprimer du texte dans un panel
Speak DelayDéfinir le délai avant que chaque caractère soit affiché
SpeakAfficher une ligne de dialogue dans le talkpad

8. Commandes – Display

Commandes agissant sur la résolution, l’écran et les panels.

CommandeDescription
Blink TimeDéfinir le Blinking Time pour les modes RenderMode_Blink etc.
Camera BoundsModifier les limites Gauche / Droite / Haut / Bas de la caméra
Camera BoxModifier la distance du joueur par rapport au centre de caméra
Camera FollowModifier comment la caméra suit le joueur
Camera PositionModifier la position de la caméra
Camera ScrollDéfinir la vitesse d’auto-scroll de la caméra en X et Y
Column ScrollAVANCÉ — Mega Drive uniquement. Nécessite la commande Set Screen.
Configure ScreenDéfinir la résolution Y, la fréquence, le mode de wrap d’écran, etc.
Panel BottomModifier le panel du bas
Panel SpecialModifier le panel 32X ou le Sprite Panel Amiga
Panel TopModifier le panel du haut
PanelModifier le panel sur l’affichage principal
Parallax PointerDéfinir la variable qui contrôle le parallaxe (défaut : Camera_X)
Parallax ScrollDéfinir manuellement le décalage d’une tranche du parallaxe
TalkpadDéfinir le talkpad (nécessaire pour la commande Say)

9. Commandes – Level

Commandes pour charger ou modifier le niveau courant.

CommandeDescription
Asset BundleCharger ou décharger un bundle d’assets (AVANCÉ)
BackgroundRemplacer le fond courant par un autre
Block CountCompter le nombre de blocks d’un type dans le niveau
Block FindTrouver le prochain block d’un type, met à jour block_x / block_y si trouvé
Block Get by PixelObtenir le block aux coordonnées pixel
Block GetObtenir le block aux coordonnées tuiles
Block SetModifier le block à une position spécifique
Block SpawnSpawner un acteur sur un block
LevelCharger et lancer un nouveau niveau
Spawn ActorSpawner un acteur dans le niveau
Teleport toTéléporter vers un téléporteur configuré dans n’importe quelle map
Tile Properties GetObtenir les propriétés de tuile aux coordonnées tuiles
Tile Properties SetDéfinir les propriétés d’une tuile

10. Commandes – Maths

Commandes pour les calculs mathématiques.

CommandeDescription
AbsoluteConvertir une expression, si négative, en positive (valeur absolue)
AngleFaire pivoter une valeur selon une direction, et placer le résultat dans deux expressions
ATan2Obtenir une direction 0–359° depuis X et Y
Distance (Exact – Slow)Calculer la distance directe entre deux points (précis, lent)
Distance (Manhattan – Fast)Calculer la distance Manhattan entre deux points (rapide, moins précis)
Square RootCalculer la racine carrée d’une expression

11. Commandes – Palette

Commandes pour les fades et la manipulation de palette.

CommandeDescription
Color ReadCharger la couleur originale d’un index de palette dans RED, GREEN, BLUE
Color ResetRéinitialiser la couleur d’un index de palette à sa valeur d’origine
Color SetModifier la couleur d’un index de palette
Color WriteSauvegarder une nouvelle couleur depuis RED, GREEN, BLUE dans la palette
Fade InFaire apparaître l’écran depuis le noir
Fade OutFaire disparaître l’écran vers le noir
Fade TimeDéfinir le nombre de frames pour un fondu complet
Palette ReadLire une seule couleur depuis un PNG dans RED, GREEN et BLUE
Palette SetDéfinir une plage de couleurs depuis un PNG
Palette SwapModifier l’index d’une couleur sur toutes les frames d’une animation

12. Déclarations – Variables & Constantes

Déclarations de valeurs variables et constantes dans les codeblocks.

TypeDescription
AliasAjouter un nom alternatif pour une autre variable (ex. : actor_health = actor_var1)
ArrayRéserver de la mémoire vide. Le champ Valeur contient la longueur.
ConstantNombre non modifiable. Le champ Valeur contient le nombre hard-codé.
Hardware RegisterAVANCÉ. Lire ou écrire directement le matériel (peek/poke).
LookUpTableTableau lisant depuis un fichier texte (une constante par ligne). Lecture seule. Ne compte pas dans la mémoire des codeblocks Amiga.
StringEnsemble de caractères ASCII. Le champ Valeur contient la valeur initiale (la longueur ne peut pas être modifiée après déclaration).
VariableNombre modifiable. Le champ Valeur contient la valeur par défaut.

Types de données disponibles

TypeTailleMinMaxPerformanceUsage
Byte1 octet−128127BonDonnées compactes dans les tableaux
Word2 octets−32 76832 767BonDéfaut recommandé — plupart des variables
Long4 octets−2 147 483 6482 147 483 647MoyenScores élevés, grandes valeurs
Fraction4 octets−32 768.032 767.0LentPositions sub-pixel (vitesse < 1 px/frame). Virgule fixe 16:16.

Note : Byte n’économise pas de mémoire face à Word pour les variables simples (adresses arrondie aux nombres pairs sur 68000). Il est utile uniquement dans les tableaux et LUT pour une allocation contigüe.

Look Up Tables – clés constantes

Les LUT peuvent être indexées par des constantes définies :

// Fichier level_target_scores.txt :
level01 = 100
level02 = 200
level03 = 350

// Dans un codeblock :
if score >= level_target_scores[level]
    // Objectif de score atteint pour ce niveau !
end condition

Les LUT fonctionnent aussi avec des tags d’acteurs, d’animations, etc.


13. Codeblocks internes

Codeblocks prédéfinis disponibles dans l’éditeur via Gosub, Goto ou Inline. Utiliser Inline pour les performances optimales.

CodeblockDescription
anim_force_leftForcer l’acteur à jouer le côté gauche de l’animation auto-flip courante
anim_force_rightForcer l’acteur à jouer le côté droit de l’animation auto-flip courante
block_coll_forceForcer l’acteur à entrer en collision avec un block. Valide uniquement dans les événements de collision block.
block_coll_passthruForcer l’acteur à traverser un block. Valide uniquement dans les événements de collision block.
block_countÀ utiliser avec la commande Level → Block Count
block_findÀ utiliser avec la commande Level → Block Find
check_talkpadVérifie qu’un talkpad valide est chargé avant d’afficher du texte
debug_breakpointPoint d’arrêt déclenché manuellement (sans effet hors du mode debug)
destroy_actorDétruire l’acteur courant
destroy_all_actorsDétruire tous les acteurs
destroy_all_blocksDétruire tous les blocks
destroy_blockDétruire le block courant
destroy_child_actorsDétruire tous les acteurs enfants
do_teleportDéclencher un téléport
fadeinFondu depuis le noir
fadeoutFondu vers le noir
flipscreenLa caméra se cale instantanément sur l’écran du joueur
flipscreen_smoothLa caméra scrolle doucement vers l’écran du joueur
flipxmoveInverser la direction X de l’acteur
flipxymoveInverser les directions X et Y de l’acteur
flipymoveInverser la direction Y de l’acteur
freeze_actorGéler le mouvement et la logique de l’acteur (le OnTimer reste actif)
jump_actorFaire sauter l’acteur
load_next_levelCharger le niveau suivant (alphabétiquement). Boucle au premier niveau après le dernier.
pauseMettre le jeu en pause jusqu’à ce que le joueur le reprenne
quitQuitter le jeu sans message d’erreur
restart_this_levelRedémarrer le niveau courant
returnRetourner au jeu ou au dernier Gosub
set_ntscSur certains modèles d’Amiga, forcer le mode NTSC ou non
snap_to_screenForcer l’acteur dans les limites de l’écran
unfreeze_actorDégéler l’acteur courant
waitforfiredownAttendre que le joueur maintienne Fire
waitforfirehitAttendre que le joueur appuie et relâche Fire
waitforfireupAttendre que le joueur relâche Fire
waitforframesAttendre un nombre de frames
wrap_screen_bottomFaire apparaître l’acteur en haut quand il sort par le bas
wrap_screen_leftFaire apparaître l’acteur à droite quand il sort par la gauche
wrap_screen_rightFaire apparaître l’acteur à gauche quand il sort par la droite
wrap_screen_topFaire apparaître l’acteur en bas quand il sort par le haut

14. Constantes internes

14.1 vm constants

ConstanteDescriptionValeur
AGARequiredAGA requis pour ce projet ?false
Button_DownBouton maintenu enfoncé (ex. : if control1_fire = button_down)−1
Button_HitBouton venant d’être pressé (front montant, 1 frame)1
Button_NoneBouton non pressé0
DownConstante caméra bas8
FalseFaux0
Frame_AdjustVitesse de sortie / vitesse logique1
IsOnPlatform_FalsePas sur de plateforme0
IsOnPlatform_FlatSur une tuile ou block plat−1
IsOnPlatform_PlatformActorSur un acteur plateforme2
IsOnPlatform_SlopeSur une pente1
IsTestingLevelMode test de niveau en cours ?0
LastLevelConstante pour le dernier niveau du jeu0
LeftConstante caméra gauche1
Logic_SpeedLa vitesse logique du projet0
NoneAucun. Peut servir à décharger des niveaux, etc.0
RightConstante caméra droite2
Speed_AdjustVitesse logique / vitesse de sortie1
Target_SpeedLa fréquence de sortie (framerate) du projet0
TileMaskOpération AND pour arrondir aux coordonnées tuile (ex. : actor_x & TileMask)0xFFF0
Trigger_AttackAnimationDéfinir actor_animation sur cette valeur pour déclencher l’anim d’attaque−1
Trigger_AttackSoundDéfinir actor_sound sur cette valeur pour déclencher le son d’attaque−10
Trigger_CancelAnimationAnnuler l’animation courante−2
Trigger_CancelSound0Annuler l’effet sonore priorité 0 (Mega Drive uniquement)0
Trigger_CancelSound1Annuler l’effet sonore priorité 1 (Mega Drive uniquement)−1
Trigger_CancelSound2Annuler l’effet sonore priorité 2 (Mega Drive uniquement)−2
Trigger_JumpSoundDéclencher le son de saut de l’acteur−20
TrueVrai−1
UpConstante caméra haut4
XResLargeur d’écran (fixée à la compilation)256
YResMaxRésolution Y maximale de la zone de jeu256

14.2 vm constants animationflags

Bits de la variable actor_animationflags. Tester avec BITTST.

ConstanteDescriptionBit
AnimFlag_PreventMovementL’acteur ne peut pas se déplacer pendant cette animation0
AnimFlag_PreventCollisionPas de collision pendant cette animation1
AnimFlag_HideChildrenCacher les acteurs enfants2
AnimFlag_PreventAttackL’acteur ne peut pas attaquer3
AnimFlag_AutoFlipLeftAuto-flip vers la gauche4
AnimFlag_AutoFlipRightAuto-flip vers la droite5

14.3 vm constants audiodriver

ConstanteDescriptionValeur
audiodriverDriver audio de ce build0
audiodriver_mdsdrvDriver audio Mega Drive MDSDRV2
audiodriver_naPas de driver audio0
audiodriver_ptplayerDriver audio Amiga PTPlayer (modules ProTracker)1
audiodriver_xgmDriver audio Mega Drive XGM3

14.4 vm constants controlbits

Bits utilisés avec BITTST sur les variables Control0_Buttons / Control0_HitButtons (et idem pour Control1, 2, 3, 4, ainsi que actor_controlbuttons / actor_controlhitbuttons).

ConstanteDescriptionBit
Joy_UpJoystick Haut (toutes plateformes)0
Joy_DownJoystick Bas (toutes plateformes)1
Joy_LeftJoystick Gauche (toutes plateformes)2
Joy_RightJoystick Droite (toutes plateformes)3
Amiga_Fire1 = CD32_RedFire 1 / CD32 Rouge4
Amiga_Fire2 = CD32_BlueFire 2 / CD32 Bleu5
Amiga_Fire3 = CD32_PlayFire 3 / CD32 Play (bouton du milieu)7
CD32_ReverseCD32 Épaule gauche (L)8
CD32_ForwardCD32 Épaule droite (R)9
CD32_GreenCD32 Vert10
CD32_YellowCD32 Jaune11
MegaDrive_BMega Drive Bouton B4
MegaDrive_CMega Drive Bouton C5
MegaDrive_AMega Drive Bouton A6
MegaDrive_StartMega Drive Start7
MegaDrive_ZMega Drive Bouton Z8
MegaDrive_YMega Drive Bouton Y9
MegaDrive_XMega Drive Bouton X10
MegaDrive_ModeMega Drive Mode11
NeoGeo_ANeo Geo Bouton A4
NeoGeo_BNeo Geo Bouton B5
NeoGeo_CNeo Geo Bouton C6
NeoGeo_DNeo Geo Bouton D7
NeoGeo_StartNeo Geo Start8
NeoGeo_SelectNeo Geo Select9
Pico_RedSega Pico Rouge4
Pico_PenSega Pico Stylet7
Flag_LockMovementBit de verrouillage du mouvement activé14
Flag_AutoFireBit d’autofire activé15
Mask_TrueButtonsMasque bit pour les vrais boutons (sans les directions)0x0ff0

14.5 vm constants hardware

Valeurs retournées par la variable Processor et ROM.

ConstanteDescriptionValeur
M68000Processeur 68000 de base0
M68010Processeur 68010 (Amiga uniquement)1
M68020Processeur 68020 (Amiga uniquement)2
M68030Processeur 68030 (Amiga uniquement)3
M68040Processeur 68040 (Amiga uniquement)4
M68060Processeur 68060 (Amiga uniquement)5
M68080Processeur 68080 Vampire (Amiga uniquement)6
KS_1_2ROM Amiga Kickstart 1.233
KS_1_3ROM Amiga Kickstart 1.334
KS_2_0ROM Amiga Kickstart 2.036
KS_3_0ROM Amiga Kickstart 3.039

14.6 vm constants look directions

Constantes pour la commande Direction et la variable actor_lookdir. Les préfixes désignent trois modes distincts :

  • Look_* : Orientation visuelle uniquement (le sprite regarde dans cette direction, sans bouger)
  • Move_* : Mouvement dans cette direction (et orientation visuelle alignée)
  • Strafe_* : Déplacement dans cette direction sans changer l’orientation visuelle
ConstanteValeurConstanteValeur
Look_UpLeft0Move_UpLeft16
Look_Up1Move_Up17
Look_UpRight2Move_UpRight18
Look_Left3Move_Left19
Look_Center4 (ne pas utiliser)Move_Center20 (ne pas utiliser)
Look_Right5Move_Right21
Look_DownLeft6Move_DownLeft22
Look_Down7Move_Down23
Look_DownRight8Move_DownRight24
Constante StrafeVal.Constante StrafeVal.
Strafe_UpLeft80Strafe_UpRight82
Strafe_Up81Strafe_Left83
Strafe_Center84 (ne pas utiliser)Strafe_Right85
Strafe_DownLeft86Strafe_Down87
Strafe_DownRight88  

Constantes spéciales de direction

ConstanteValeurDescription
look_atplayer32Orienter le sprite vers le joueur
move_atplayer48Se déplacer directement vers le joueur
resume_moving31Reprendre le mouvement (si arrêté)
stop_moving−3Arrêter tout mouvement
reset_movement−1Réinitialiser le mouvement (comme au spawn)
jump_movement−2Sauter directement vers le haut

Masques de direction (pour tests bitwise)

ConstanteValeurDescription
LookMask_Up7L’acteur regarde dans n’importe quelle direction vers le haut
LookMask_Down448L’acteur regarde dans n’importe quelle direction vers le bas
LookMask_Left73L’acteur regarde dans n’importe quelle direction vers la gauche
LookMask_Right292L’acteur regarde dans n’importe quelle direction vers la droite

14.7 vm constants notes (périodes musicales)

Périodes ProTracker pour les notes musicales. Utilisées dans les effets sonores programmatiques. La période est la valeur matérielle Amiga (plus la valeur est basse, plus la note est haute).

ConstantePériodeConstantePériodeConstantePériode
Note_C1856Note_C2428Note_C3214
Note_C#1808Note_C#2404Note_C#3202
Note_D1762Note_D2381Note_D3190
Note_D#1720Note_D#2360Note_D#3180
Note_E1678Note_E2339Note_E3170
Note_F1640Note_F2320Note_F3160
Note_F#1604Note_F#2302Note_F#3151
Note_G1570Note_G2285Note_G3143
Note_G#1538Note_G#2269Note_G#3135
Note_A1508Note_A2254Note_A3127
Note_A#1480Note_A#2240Note_A#3120
Note_B1453Note_B2226Note_B3113

14.8 vm constants rendermodes

Valeurs pour la variable actor_rendermode et la commande Render Mode.

ConstanteDescriptionValeur
RenderMode_DefaultRendu normal0
RenderMode_OffRendu désactivé (invisible mais logique active)1
RenderMode_BlinkClignotant2
RenderMode_HighlightSurbrillance (Amiga) / Palette +1 (Mega Drive)3
RenderMode_FlashFlash continu4
RenderMode_ShadowAffiché avec ombre5
RenderMode_ShadowFlashOmbre avec flash6
RenderMode_InvertCouleurs inversées7
RenderMode_InvertFlashInversé avec flash8
RenderMode_BlinkAlternativeClignotement alternatif10
RenderMode_ParentUtiliser le mode de rendu du parent11
RenderMode_PaletteLine1Palette + 1 ligne3
RenderMode_PaletteLine1FlashPalette + 1 ligne + flash4
RenderMode_PaletteLine2Palette + 2 lignes5
RenderMode_PaletteLine2FlashPalette + 2 lignes + flash6
RenderMode_PaletteLine3Palette + 3 lignes7
RenderMode_PaletteLine3FlashPalette + 3 lignes + flash8

14.9 vm constants tile properties

Bits utilisés avec BITTST sur la variable Tile_Properties et les résultats de Tile Properties Get.

ConstanteDescriptionBit / Valeur
TileBit_SolidCette tuile est-elle solide ?0
TileBit_PlatformCette tuile est-elle une plateforme ?1
TileBit_AIBlockCette tuile possède-t-elle le flag “AI Block” ?2
TileBit_SpareCette tuile possède-t-elle le bit spare ?3
TileBit_HasAnimationCette tuile possède-t-elle une animation ?4
TileBit_HasForegroundCette tuile possède-t-elle un foreground ?5
TileBit_Spare2Cette tuile possède-t-elle un block avec une pente ?6
TileBit_HasBlockCette tuile possède-t-elle un block ?7
TileMask_OccupiedMasque : tuile possède un block, est solide ou est une plateforme0x83

15. Variables internes

15.1 Variables d’acteur

Valides pour les préfixes actor_, player_, projectile_ et new_. Par exemple, actor_x, player_x, new_x désignent la même variable selon le contexte d’exécution.

VariableDescription
actor_animationAnimation courante
actor_animationflagsFlags de l’animation courante
actor_animationtagTag de l’animation courante
actor_attackdelayDélai en frames avant de pouvoir attaquer à nouveau
actor_controlattackcontrolsConfiguration du bouton d’attaque
actor_controlboostdownBoost de contrôle vers le bas
actor_controlboostdownaccelAccélération du boost vers le bas
actor_controlboostleftBoost de contrôle vers la gauche
actor_controlboostleftaccelAccélération du boost vers la gauche
actor_controlboostrightBoost de contrôle vers la droite
actor_controlboostrightaccelAccélération du boost vers la droite
actor_controlboostupBoost de contrôle vers le haut
actor_controlboostupaccelAccélération du boost vers le haut
actor_controlbuttonsÉtat des boutons — tous y compris étendus (maintenu)
actor_controlfireÉtat du bouton Fire
actor_controlhitbuttonsÉtat des boutons — fronts montants uniquement
actor_controljumpÉtat du bouton Jump
actor_controljumpcontrolsConfiguration du bouton de saut
actor_controllerNuméro du contrôleur assigné
actor_controlmousexPosition X de la souris (écran)
actor_controlmouseyPosition Y de la souris (écran)
actor_controlxDirection X du contrôle (−1, 0, 1)
actor_controlyDirection Y du contrôle
actor_defaultvar1–actor_defaultvar6Valeurs par défaut des variables génériques (configurées dans l’éditeur)
actor_frameFrame d’animation courante
actor_framedelayDélai avant la prochaine frame d’animation
actor_ismovingL’acteur est-il en train de bouger ?
actor_isonplatformType de plateforme sous l’acteur (voir constantes IsOnPlatform_*)
actor_lookdirDirection de regard courante
actor_nodeNœud de chemin courant (ou frame de pattern)
actor_origin_xPosition X d’origine (relative au parent)
actor_origin_yPosition Y d’origine (relative au parent)
actor_rendermodeMode de rendu courant
actor_rotationRotation de l’acteur (0–359 degrés)
actor_shrink_xRéduction de la largeur (X shrink)
actor_shrink_yRéduction de la hauteur (Y shrink)
actor_spawneridID unique du spawner / parent de l’acteur
actor_tagTag de catégorie
actor_timerFrames avant expiration du OnTimer ou Yield
actor_typeType courant de l’acteur
actor_uniqueidID unique de l’acteur
actor_var1–actor_var6Variables génériques (6 mots libres pour usage du développeur)
actor_var12fVariable fraction utilisant var1 + var2 (16:16 virgule fixe)
actor_var12lVariable long utilisant var1 + var2 (32 bits)
actor_var34fVariable fraction utilisant var3 + var4
actor_var34lVariable long utilisant var3 + var4
actor_var56fVariable fraction utilisant var5 + var6
actor_var56lVariable long utilisant var5 + var6
actor_xPosition X en pixels
actor_xfacingOrientation X : −1=Gauche, 0=Milieu, 1=Droite
actor_xspeedVitesse en X
actor_yPosition Y en pixels
actor_yfacingOrientation Y : −1=Haut, 0=Milieu, 1=Bas
actor_yspeedVitesse en Y
actor_zOrdre Z de rendu

15.2 Variables générales

VariableDescription
Actor_CountNombre d’acteurs actifs
AGAFModeFetchmode AGA courant
AutoFadeMusicFading automatique de la musique sur fade in/out
AutonumGénère des IDs uniques pour chaque acteur spawné
BackgroundFond de niveau chargé (lecture / écriture)
BackgroundZTout sprite (non Mega Drive) avec Z inférieur à cette valeur est dessiné avant les tuiles
BlinkTimeFréquence de basculement des états blink/flash
Block_CollisionForcer (true) ou ignorer (false) une collision de block
Block_TagTag du block sous Block_X / Block_Y (lecture seule)
Block_TypeType du block sous Block_X / Block_Y (lecture / écriture)
Block_XPointeur de block sur la coordonnée tuile X
Block_YPointeur de block sur la coordonnée tuile Y
BlockTimeFréquence de rafraîchissement des blocks animés
BlueValeur bleue de la palette
BreakpointDéclencher un breakpoint si activé (rien en dehors du mode debug)
BrightnessUtilisé pour les fades
Camera_BoxDownBas de la boîte de caméra (marge avant scroll)
Camera_BoxLeftGauche de la boîte de caméra
Camera_BoxRightDroite de la boîte de caméra
Camera_BoxUpHaut de la boîte de caméra
Camera_FollowÉtat du suivi de caméra (lecture / écriture)
Camera_XPosition X courante de la caméra
Camera_XMaxPosition X maximum de la caméra
Camera_XMinPosition X minimum de la caméra
Camera_YPosition Y courante de la caméra
Camera_YMaxPosition Y maximum de la caméra
Camera_YMinPosition Y minimum de la caméra
CameraTargetXDécalage X cible de la caméra
CameraTargetYDécalage Y cible de la caméra
CDTracksNombre de pistes CD détectées (CDTV / CD32)
ChipRamChip RAM disponible en octets
Control0_ButtonsJoueur 1 — état de tous les boutons (maintenu)
Control0_HitButtonsJoueur 1 — fronts montants de tous les boutons
Control0_MouseXJoueur 1 — Position X de la souris
Control0_MouseYJoueur 1 — Position Y de la souris
Control0_XJoueur 1 — Axe X du joystick (port joy)
Control0_YJoueur 1 — Axe Y du joystick
Control0AttackControlsJoueur 1 — Configuration bouton d’attaque
Control0BoostDown–Control0BoostUpAccelJoueur 1 — 8 variables de boost (valeurs directionnelles)
Control0FireJoueur 1 — État du bouton Fire
Control0JumpJoueur 1 — État du bouton Jump
Control0JumpControlsJoueur 1 — Configuration du saut
Control1_* à Control4_*Identique pour les joueurs 2, 3, 4. Note : Control2 = port souris. Control3/4 : saut à 2 boutons non supporté.
ControlModeRéglage du mode de contrôle
DiceSET = générer un aléatoire 1..N. GET = dernière valeur générée.
DisplayDirtyUne opération VBlank (flip, DMA…) est en attente
DrawClipBottomAugmenter pour simuler un foreground qui coupe le bas du niveau
EventTagTag du dernier événement map déclenché
FadeTimeDurée du fondu en frames
FastSloppyCollisions0 = précis/lent — 1 = moyen — 2 = rapide/imprécis
ForceFadeOutForcer un fade in ou out
ForegroundZTout sprite avec Z inférieur à cette valeur est dessiné derrière les foreground tiles
Frame_CountDownDécrémenté 50/60 fois par seconde indépendamment du CPU
Frame_WaitNombre de frames à sauter par frame (pour réduire le framerate)
GreenValeur verte de la palette
Handle_CollisionSi une collision tuile est gérée après un événement personnalisé
HighColor24 bits sur AGA Amiga. Highlight/Shadow sur Mega Drive.
HurtTagTag de la dernière hurt box déclenchée
IsAGAVrai si la machine est AGA
IsFloppyCompilé pour trackdisk
IsNTSCVrai si la machine est NTSC
KeyboardRawCodeRaw keycode de la dernière touche pressée (Amiga)
LevelNiveau actuellement chargé (lecture / écriture)
LoadedSi le chargement a réussi
Lookahead_Down/Left/Right/UpVitesse de lookahead de la caméra par direction
MapHeightHauteur du niveau courant en pixels
MapHeightTilesHauteur du niveau courant en tuiles
MapWidthLargeur du niveau courant en pixels
MapWidthTilesLargeur du niveau courant en tuiles
Math_X, Math_X2, Math_Y, Math_Y2Réservés aux fonctions mathématiques
MaxCameraFollowPixels maximum que la caméra peut parcourir par frame
MaxSlopeStepPixels max qu’un acteur en pente peut descendre sans tomber
MeleeTagTag de l’attaque melee en cours
MusicMusique actuellement jouée (lecture / écriture)
MusicChannelsNombre de canaux réservés pour la musique
MusicMaskMasque réservé pour la musique
MusicPosSauter à un pattern spécifique
MusicVolVolume de la musique courante (0–256)
NewValueRegistre de données spécial
OptionOption actuellement sélectionnée dans un panel menu
OptionMoveCooldownFrames avant que l’option change si le joystick est maintenu
OptionsEnabledLes options sont-elles affichées ?
OtherRamAutre RAM disponible en octets (Amiga uniquement)
PanelPanel plein écran chargé (lecture / écriture)
Panel_BottomPanel du bas chargé
Panel_SpecialPanel spécial chargé
Panel_TalkpadPanel talkpad chargé
Panel_TopPanel du haut chargé
ProcessorProcesseur détecté (constantes M68000…M68080)
RecycleDistanceDistance de la caméra à partir de laquelle les acteurs sont recyclés
RedValeur rouge de la palette
ROMVersion de la ROM (constantes KS_*)
SavedSi la sauvegarde a réussi
ScreenTopHaut de l’écran de jeu. Augmenter pour réserver de l’espace au-dessus.
Scroll_Speed_XVitesse d’auto-scroll en X
Scroll_Speed_YVitesse d’auto-scroll en Y
Seed1–Seed4Graines aléatoires (4 variables)
Shake_Camera_XDécalage du niveau depuis sa position normale (shake caméra X)
Shake_Camera_YDécalage du niveau (shake caméra Y)
Shake_Sprite_XDécalage des sprites (shake sprites X)
Shake_Sprite_YDécalage des sprites (shake sprites Y)
ShowTalkpadAfficher ou masquer le talkpad
SoundVolVolume des effets sonores (0–256)
SpawnArea_HeightBas de la zone de spawn
SpawnArea_WidthDroite de la zone de spawn
SpawnArea_XGauche de la zone de spawn
SpawnArea_YHaut de la zone de spawn
StringLengthRéservé pour les chaînes talkpad en mémoire
SuccessRésultat de la dernière opération de sauvegarde/chargement
Talkpad_TextDelayNombre de frames entre chaque caractère affiché
TeleportDéfinir sur un téléporteur nommé pour téléporter (fonctionne entre niveaux)
Tile_PropertiesPropriétés de la tuile sous Block_X / Block_Y (lecture seule)
WaitDéfinir pour mettre Scorpion en pause pendant N frames
YResRésolution Y de la zone de jeu (max 256)

Document compilé depuis https://github.com/earok/scorpion-editor-demos/wiki/Autodocs. Dernière mise à jour de la source : 1er décembre 2025.

Commentaires

Laisser un commentaire

Votre adresse e-mail ne sera pas publiée. Les champs obligatoires sont indiqués avec *

*** PRESS ANY KEY TO JOIN ***

Adhésion ouverte à tous.

Sans condition d'âge, de lieu ni de niveau. Les rencontres ont lieu dans le Grand Sud-Ouest, la discussion continue en ligne toute l'année.

🌙 ☀️ THEME