CODING · 20 MIN

Scorpion Engine (Game Engine)

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

Guide Complet pour Amiga


Table des matières

  1. Qu’est-ce que Scorpion Engine ?
  2. Démarrage rapide
  3. Tutoriel complet – Faire son premier jeu (MonkeyLad)
    1. Leçon 1 – Premier projet
    2. Leçon 2 – Premier panel
    3. Leçon 3 – Premier code
    4. Leçon 4 – Première palette
    5. Leçon 5 – Premier tileset
    6. Leçon 6 – Premier niveau
    7. Leçon 7 – Première animation
    8. Leçon 8 – Premier acteur
  4. Mécaniques de gameplay avancées
    1. Contrôles : joystick, clavier, multi-joueur
    2. Types de mouvement des acteurs
    3. Système de collisions complet
    4. Attaques, projectiles et combat
    5. Caméra et scrolling
    6. Événements de map et téléporteurs
    7. Audio – musique et effets sonores
  5. Référence Codeblocks
    1. Cycle de vie du moteur (Lifecycle)
    2. Commandes disponibles (Autodocs)
    3. Variables et constantes internes
    4. Expressions – opérateurs et types
  6. Glossaire
  7. Optimisations Amiga
  8. Ressources et liens

1. Qu’est-ce que Scorpion Engine ?

Scorpion Engine est un moteur de jeu et outil de création ciblant nativement les systèmes rétro Motorola 68000 : Amiga OCS/ECS/AGA, Mega Drive et Neo Geo. Il fonctionne comme une machine virtuelle 68K — similaire à SCUMM (LucasArts), SCI (Sierra) ou le moteur d’Another World, mais avec un vrai processeur 68K virtuel pour des performances maximales.

Les deux composants

L’éditeur Programme Windows 64 bits (Unity). Interface visuelle, menus déroulants, aucune syntaxe à mémoriser. Le runtime Blitz Basic + assembleur 68K. Mode interleaved Amiga pour blits ultra-rapides. Compatible Amiga 500 standard (512 Ko Chip + 512 Ko Fast).

Trois principes fondamentaux

  1. Performance : comparable à du C/ASM. Interleaved Amiga. PerformanceTester intégré.
  2. Flexibilité : platformers, shmups, puzzles, racers, VN, aventures… tout est possible via les codeblocks.
  3. Facilité : Tiled pour les maps, PNG indexé pour les sprites, WAV/MP3/OGG pour le son.

2. Démarrage rapide

Indispensables

Optionnels

  • Graphismes PNG indexé : Aseprite, ProMotion NG, Paint Shop Pro, Deluxe Paint
  • Audio : Audacity (WAV/OGG) ; ProTracker/MilkyTracker (modules .mod pour Amiga)
  • Démos communautaires : Télécharger

3. Tutoriel complet – MonkeyLad

Platformer inspiré d’Alex Kidd in Miracle World, graphismes de Surt (OpenGameArt).

Leçon 1 – Premier projet

  1. Créez un dossier MonkeyLad.
  2. Ouvrez le Scorpion Editor → New Scorpion Project.
  3. Sauvegardez project.sproject dans ce dossier.
  4. Optionnel : cliquez “Platform – Amiga OCS” (haut droite) pour changer de cible.
Scorpion Editor - Nouveau projet
L’éditeur Scorpion après création du projet.

Leçon 2 – Premier panel

Les panels = images statiques : écrans titre, game over, HUD, menus, dialogues, parallaxe…

  1. Créez le dossier Panels.
  2. Sauvegardez cette image dans ce dossier :
    Titre MonkeyLad
  3. Scorpion Editor → onglet Panels → + → sélectionnez l’image → sauvez sous titlescreen.panel.
  4. Amiga : passez de “5 / 32 colors” à 4 / 16 colors.
Panel titre dans l'editeur
Le panel titre chargé dans l’éditeur.

Leçon 3 – Premier code

Les codeblocks = séquences d’instructions configurées via menus déroulants (pas de syntaxe).

  1. Onglet Code → codeblock startup → + → catégorie Display → commande Panel → sélectionnez titlescreen.
1 Load and display titlescreen (unload level)
  1. Onglet Project → Run in WINUAE.
WinUAE avec Scorpion Engine
Premier projet dans WinUAE.

Leçon 4 – Première palette

Les panels PNG possèdent leur palette. Acteurs et niveaux partagent une palette centrale de projet.

  1. Sauvegardez cette image dans le dossier projet en écrasant amiga_ocs.palette.png :
    Palette
Nouvelle palette dans l'editeur
La nouvelle palette visible dans l’éditeur.

Leçon 5 – Premier tileset

  1. Créez le dossier Maps et sauvez cette image :
    Tileset
  2. Onglet Maps → + (tilesets) → sélectionnez l’image → sauvez tileset.tileset.tsx.
Tileset dans l'editeur
Premier tileset chargé.

Définir les tuiles solides

  1. Cliquez Edit Tileset (ouvre Tiled). Sélectionnez les tuiles solides → cochez IsSolid → sauvez → fermez.
Tuiles solides dans Tiled
Configuration des tuiles solides dans Tiled.

Leçon 6 – Premier niveau

  1. Onglet Maps → + (Maps) → sélectionnez le tileset → sauvez level01.
  2. Cliquez Edit Map → peignez votre niveau dans Tiled → sauvez → fermez.
Niveau dans Tiled
Le premier niveau peint dans Tiled.

Relier le niveau au démarrage

  1. Onglet Code → ligne 1 du startup → cochez Wait for Fire Button.
  2. + → catégorie Level → commande Level → sélectionnez level01.
1 Load and display panel titlescreen then wait for fire hit (unload level)
2 Load Level level01 (Auto Fade In)
Niveau dans WinUAE
Le niveau visible dans WinUAE.

Leçon 7 – Première animation

  1. Créez animations/player. Sauvez ces 4 frames : FichierApercu walk_1.pngwalk 1 walk_2.pngwalk 2 walk_3.pngwalk 3 walk_4.pngwalk 4
  2. Onglet Animations → + → sauvez monkeylad_walk_r.animstrip. Le suffixe _r est crucial : Scorpion génère automatiquement la version _l.
  3. Ajoutez les 4 images comme frames. Alignez chaque frame : X-8, Y-24 (ligne de sol).
Animation de marche
Animation de marche configurée.

Leçon 8 – Premier acteur

Animations supplémentaires

CheminContenu
animations/player/monkeylad_idle_r.animstrip1 frame au repos
animations/player/monkeylad_jump_r.animstrip1 frame de saut

Création

  1. Créez le dossier actors.
  2. Onglet Actors → + → animation monkeylad_idle_l → sauvez monkeylad.actor.
  3. Alignez les pieds avec le bas du damier (origin x=8, y=16).
  4. Cochez Show collbox → ajustez → cochez Player.
Configuration de l'acteur
L’acteur avec sa boîte de collision.

Contrôles et physique

Volet droit → CPU → sélectionnez Control Platform Maryo.

DirectionAnimation
Haut-Droite / Bas-Droite / Haut-Gauchemonkeylad_jump_r (ou _l)
Droitemonkeylad_walk_r
Gauchemonkeylad_walk_l
Bas-Gauchemonkeylad_jump_l
Paramètre physiqueValeur
Jump Speed4
Max Fall Speed4
Left / Right Speed2
Jump Boost0.1
Gravity0.2

Croix rouge = hauteur max saut (bouton maintenu). Croix verte = hauteur min (pression courte).

Parametres physiques
Paramètres de contrôle et de physique.

Placement dans la carte et test

  1. Onglet Maps → level01 → Edit Map → calque actors + tileset actors → placez le joueur → sauvez.
Acteur place dans Tiled
L’acteur placé dans le niveau dans Tiled.
MonkeyLad jouable
MonkeyLad jouable dans WinUAE. Félicitations !

4. Mécaniques de gameplay avancées

4.1 Contrôles : joystick, clavier, multi-joueur

Architecture

Les joysticks sont lus lors du Vertical Blank (50 Hz PAL / 60 Hz NTSC). Jusqu’à 4 contrôleurs simultanés sont supportés.

JoueurPort AmigaVariables de base
1Port joystickControl0_X/Y, Control0Fire, Control0Jump
2Port sourisControl1_X/Y, Control1Fire, Control1Jump
3—Control2_X/Y, Control2Fire, Control2Jump
4—Control3_X/Y, Control3Fire, Control3Jump

Les contrôleurs 3 et 4 ne supportent PAS les joysticks à 2 boutons.

États des boutons

ConstanteValeurDescription
Button_None0Non pressé
Button_Hit1Vient d’être pressé (front montant, 1 seule frame)
Button_Down-1Maintenu enfoncé
if Control0Fire == Button_Hit
    // Action unique à la pression
end condition

if Control0Jump == Button_Down
    // Action maintenue
end condition

Bits des boutons avancés (Amiga joystick + CD32)

Accessibles via Control0_Buttons (maintenu) et Control0_HitButtons (front montant) avec BITTST :

ConstanteBitDescription
Joy_Up0Joystick Haut
Joy_Down1Joystick Bas
Joy_Left2Joystick Gauche
Joy_Right3Joystick Droite
Amiga_Fire1 = CD32_Red4Fire 1 / CD32 Rouge
Amiga_Fire2 = CD32_Blue5Fire 2 / CD32 Bleu
Amiga_Fire3 = CD32_Play7Fire 3 / CD32 Play
CD32_Reverse8CD32 Épaule gauche
CD32_Forward9CD32 Épaule droite
CD32_Green10CD32 Vert
CD32_Yellow11CD32 Jaune
Flag_LockMovement14Mouvement verrouillé
Flag_AutoFire15Autofire activé

Clavier et souris

  • KeyboardRawCode : raw keycode de la dernière touche pressée (Amiga).
  • Control0_MouseX/Y : position souris sur le port joystick.
  • Control1_MouseX/Y : position souris sur le port souris.
  • actor_controlmousex/y : position souris pour l’acteur courant.

Variables de contrôle de l’acteur courant

VariableDescription
actor_controlxDirection X du stick (-1, 0, 1)
actor_controlyDirection Y du stick
actor_controlfireÉtat du bouton Fire
actor_controljumpÉtat du bouton Jump
actor_controlbuttonsTous les boutons (maintenu)
actor_controlhitbuttonsTous les boutons (front montant)
actor_controllerNuméro du contrôleur assigné

Commandes de contrôle en codeblocks (catégorie Controls)

CommandeDescription
Attack/Move ControlsChanger le bouton d’attaque et son comportement
Boost / Boost AccelerationVitesse max et accélération d’un acteur contrôlé
Control ModeNombre et type de contrôleurs actifs
Jump ControlsBouton de saut et son comportement
Set ControllerAssigner un contrôleur spécifique à un acteur
Set as PlayerDésigner l’acteur courant comme PLAYER pour un contrôleur

4.2 Types de mouvement des acteurs

Modes contrôlés (joueur)

Type CPUDescription
Control Platform MaryoPlatformer avec saut variable (hauteur = durée du bouton). Très réactif, recommandé.
Control PlatformPlatformer classique, saut fixe.
Control 8-wayDéplacement libre dans les 8 directions (shmup, top-down).
Control 4-wayDéplacement en 4 directions.
Control CarConduite avec accélération/décélération.

Modes CPU (ennemis et PNJ)

Type CPUDescription
CPU PatrolVa-et-vient. Fait demi-tour à la collision ou au bord.
CPU PathSuit un chemin prédéfini (Map Path dans Tiled).
CPU Pursue PlayerPoursuit le joueur activement.
CPU StaticNe bouge pas (tourelles, décors).
CPU GravitySoumis à la gravité, sans contrôle.

Constantes de direction de mouvement

ConstanteVal.ConstanteVal.
Move_Up17Move_UpLeft16
Move_Right21Move_UpRight18
Move_Down23Move_DownLeft22
Move_Left19Move_DownRight24
move_atplayer48stop_moving-3
resume_moving31reset_movement-1
jump_movement-2look_atplayer32

Constantes d’orientation (Look)

Look_Up=1  Look_Right=5  Look_Down=7  Look_Left=3
Look_UpRight=2  Look_UpLeft=0  Look_DownRight=8  Look_DownLeft=6

Constantes de strafe (déplacement sans changer d’orientation)

Strafe_Up=81  Strafe_Right=85  Strafe_Down=87  Strafe_Left=83
Strafe_UpRight=82  Strafe_UpLeft=80  Strafe_DownRight=88  Strafe_DownLeft=86

Variables de mouvement de l’acteur

VariableDescription
actor_x / actor_yPosition en pixels
actor_xspeed / actor_yspeedVitesse courante
actor_xfacingOrientation X : -1=Gauche, 0=Centre, 1=Droite
actor_yfacingOrientation Y : -1=Haut, 0=Centre, 1=Bas
actor_lookdirDirection de regard courante
actor_ismovingEn mouvement ?
actor_isonplatformType de plateforme courante (voir tableau)
actor_rotationRotation en degrés (0-359)

Types de plateforme

ConstanteVal.Description
IsOnPlatform_False0En l’air
IsOnPlatform_Flat-1Sur tuile ou block plat
IsOnPlatform_Slope1Sur une pente
IsOnPlatform_PlatformActor2Sur un acteur Moving Platform
// Recommandé pour détecter TOUTES les plateformes :
if actor_isonplatform not zero
    // Sol detecté (plat, pente, ou plateforme mobile)
end condition

Commandes de mouvement en codeblocks

CommandeDescription
DirectionDéfinir la direction de regard ou de mouvement
SpeedDéfinir la vitesse exacte
PushPousser l’acteur d’un montant sur N frames
PositionTéléporter l’acteur
jump_actorFaire sauter l’acteur par code
flipxmoveInverser la direction X
flipymoveInverser la direction Y
Freeze / UnfreezeGéler/dégéler (mouvement, collisions, animations)

Plateformes mobiles

Cochez Moving Platform sur un acteur pour qu’il porte les autres acteurs (ascenseurs, plateformes flottantes, véhicules). L’acteur porté doit avoir Can Ride Platforms coché.


4.3 Système de collisions

Collisions avec les tuiles

Les tuiles IsSolid bloquent automatiquement les acteurs. Les tuiles Platform ne bloquent que par le dessus (traversables par en dessous). Rien à coder pour les collisions sol/mur/plafond de base.

Propriétés des tuiles

ConstanteBitDescription
TileBit_Solid0Tuile solide
TileBit_Platform1Plateforme (traversable par dessous)
TileBit_AIBlock2Bloque les IA
TileBit_HasAnimation4Possède une animation
TileBit_HasForeground5Possède un foreground
TileBit_HasBlock7Possède un block
TileMask_Occupied0x83Masque : block/solid/platform présent

La variable Handle_Collision permet, dans un événement personnalisé, de forcer ou ignorer la gestion d’une collision tuile.

Collisions entre acteurs – Règles fondamentales

  1. Un acteur Player peut entrer en collision avec des acteurs non-joueurs.
  2. Un acteur Projectile peut entrer en collision avec des acteurs non-joueurs (y compris d’autres projectiles).

Les collisions sont détectées via les collboxes. Les événements disponibles :

ÉvénementDéclenchement
OnCollideContact avec un autre acteur
OnHitTouché par un projectile ou une attaque
OnPlatformLandedAtterrissage sur une plateforme
OnSpawnActeur venant d’être créé
OnTimerMinuteur expiré
OnLeaveScreenSortie de l’écran (par direction)
OnDestroyActeur détruit

Précision des collisions

La variable globale FastSloppyCollisions contrôle le compromis vitesse/précision :

ValeurMode
0Pixel perfect (lent)
1Moyen
2Rapide (imprecis)

Les attaques melee sont toujours pixel-perfect, indépendamment de ce réglage.

Block Collider

Un acteur avec Block Collider coché peut déclencher des événements spéciaux contre les blocks (ex : détruire un block destructible). Joueurs et projectiles sont block colliders par défaut.

Attaques melee

Les attaques melee gèrent les hitboxes qui changent frame par frame (utiles pour les jeux de combat). Plus coûteux en performance que les collisions normales. Chaque frame d’animation peut déclencher un événement melee. Le variant hurt box définit où l’acteur peut être touché. La variable MeleeTag = tag de la dernière attaque. La variable HurtTag = tag de la dernière hurt box.

Retour visuel de collision : modes de rendu

ConstanteEffet visuel
RenderMode_DefaultNormal
RenderMode_BlinkClignotant
RenderMode_FlashFlash
RenderMode_HighlightSurbrillance
RenderMode_InvertCouleurs inversées
RenderMode_OffInvisible (logique active)
RenderMode_ShadowAffiché en ombre
// Exemple : invincibilité temporaire 60 frames après une touche
// Dans OnHit :
actor_rendermode = RenderMode_Blink
Yield (60)
actor_rendermode = RenderMode_Default

4.4 Attaques, projectiles et combat

Is Attacker

Un acteur avec Is Attacker peut déclencher une animation d’attaque ou tirer un projectile. Un CPU attaque automatiquement ; un Player n’attaque que sur pression du bouton Fire.

Tir d’un projectile

// Commande Shoot (catégorie Actor) :
Shoot monkeylad_bullet

// Configurer le projectile via le préfixe new_ :
new_Direction = Move_Right
new_xspeed = 4
new_yspeed = 0

Le projectile doit avoir Projectile coché pour blesser les ennemis. Ne cochez PAS Projectile sur les balles ennemies sauf pour le monster infighting.

Spawn et destruction

// Catégorie Level :
Spawn Actor (my_actor, x, y)

// Enfant (catégorie Actor) :
Child Spawn (child_actor)

// Après un spawn, configurer via new_ :
new_x = actor_x
new_y = actor_y - 16

// Destruction :
destroy_actor
destroy_all_actors
destroy_child_actors

Constantes d’animation utiles pour le combat

ConstanteValeurDescription
Trigger_AttackAnimation-1Déclencher l’animation d’attaque
Trigger_CancelAnimation-2Annuler l’animation courante
Trigger_AttackSound-10Déclencher le son d’attaque
Trigger_JumpSound-20Déclencher le son de saut

Flags d’animation

ConstanteBitDescription
AnimFlag_PreventMovement0Bloque le mouvement pendant cette frame
AnimFlag_PreventCollision1Pas de collision
AnimFlag_HideChildren2Cache les acteurs enfants
AnimFlag_PreventAttack3Interdit l’attaque
AnimFlag_AutoFlipLeft4Auto-flip gauche
AnimFlag_AutoFlipRight5Auto-flip droite

4.5 Caméra et scrolling

VariableDescription
Camera_X / Camera_YPosition de la caméra (lect./écrit.)
Camera_XMin/XMaxLimites horizontales
Camera_YMin/YMaxLimites verticales
Camera_BoxLeft/Right/Up/DownMarge avant scroll
MaxCameraFollowPixels max/frame de mouvement caméra
Scroll_Speed_X/YVitesse d’auto-scroll
Shake_Camera_X/YShake caméra (décalage niveau)
Shake_Sprite_X/YShake sprites
Lookahead_Left/Right/Up/DownVitesse de lookahead

Commandes de caméra

CommandeDescription
Camera BoundsLimites gauche/droite/haut/bas
Camera BoxZone de confort avant scroll
Camera FollowMode de suivi du joueur
Camera PositionTéléporter la caméra
Camera ScrollVitesse d’auto-scroll X/Y
flipscreenCaméra se cale sur l’écran du joueur (snap)
flipscreen_smoothScroll doux vers l’écran du joueur
Parallax Pointer / ScrollContrôle du défilement parallaxe

4.6 Événements de map et téléporteurs

Map Events

Rectangles placés dans Tiled (calque Object Layer) qui déclenchent un codeblock quand le joueur entre, interagit (Fire), reste dans, ou sort de la zone. La variable EventTag contient le tag du dernier événement.

Téléporteurs

Un Map Event peut être un téléporteur vers n’importe quel endroit du même ou d’un autre niveau :

Teleport to (nom_du_teleporteur)
// ou
Teleport = "nom_du_teleporteur"

Map Templates

Placement d’acteurs à des coordonnées pixel précises (non limitées aux multiples de 16), avec pré-configuration de actor_var1…actor_var6 et des événements OnSpawn/OnTimer.

Map Paths

Polygones dans Tiled suivis par les acteurs CPU Path. Le début du chemin doit être sur la tuile de l’acteur. La variable actor_node indique le nœud courant.


4.7 Audio

Formats

  • Effets sonores : WAV, MP3, OGG (toutes plateformes) + IFF 8SVX (Amiga)
  • Musique Amiga : modules ProTracker (.mod, .p61) via driver PTPlayer

Commandes audio

CommandeDescription
MusicCharger et jouer une chanson
Music Pause / ResumePause/reprise
Music VolumeVolume musique (0-256)
Music PositionSauter à un pattern
Auto Fade MusicFading auto avec l’écran
SoundDéclencher un effet sonore
Sound VolumeVolume effets (0-256)
Set Music ChannelsRéserver des canaux pour la musique

Variables : Music, MusicVol, MusicPos, SoundVol, AutoFadeMusic.


5. Référence Codeblocks

5.1 Cycle de vie du moteur

Render Cycle (chaque frame, même en pause)

  1. Lecture des contrôleurs
  2. Mise à jour panels haut/bas
  3. Mise à jour panel principal (si chargé)
  4. Fin si aucun niveau actif
  5. Attente VBlank si en avance
  6. Rendu tuiles (Amiga)
  7. Cycle acteurs : repositionnement + rendu BOB/Sprites
  8. Redessiner foreground tiles chevauchant les acteurs (Amiga)

Play Cycle (jeu non pausé, niveau chargé)

  1. Commandes projet
  2. Événements ontimer du niveau
  3. Gestion talkpad
  4. Auto-scroll
  5. Spawn des acteurs proches de la caméra
  6. Pour chaque acteur : code attaque → collisions blocks/événements (joueur) → ontimer → push → code mouvement → plateforme mobile → animation
  7. Traitement des collisions acteur↔acteur
  8. Traitement des attaques melee
  9. Re-tri ZBuffer
  10. Déplacement caméra → animations tuiles/blocks → parallaxe

Vertical Blank Amiga (50 Hz PAL)

  1. Lecture joysticks (CD32)
  2. Flip panels vers front buffer
  3. Interpolation sprites/scroll (jeux 25 Hz)
  4. Régénération copper lists si nécessaire
  5. Scroll bitmap du niveau
  6. Rendu hardware sprites
  7. Fade palette
  8. Finalisation copper lists

5.2 Commandes disponibles

Catégorie Actor (acteur courant ; aussi disponible pour player_, projectile_, new_)

CommandeDescription
AnimationDéclencher une animation
Camera FollowForcer la caméra à suivre cet acteur
Child SpawnSpawner un enfant
DirectionDéfinir la direction
Freeze / UnfreezeGéler/dégéler
Look At PointRegarder vers un point du niveau
MeleeDéclencher une hitbox melee
OriginChanger la position relative (parent)
PositionTéléporter
PushPousser sur N frames
Render ModeMode de rendu
Schedule EventCodeblock après N frames
SeparateSéparer deux acteurs qui se chevauchent
Set as PlayerChanger PLAYER vers cet acteur
Set ControllerAssigner un contrôleur
ShootTirer un acteur
SpeedVitesse exacte
TypeChanger le type
YieldSuite dans N frames
Z OrderOrdre Z de rendu

Catégorie Base

CommandeDescription
CommentCommentaire (sans action)
GosubAller à un codeblock/label, retourner au Return
GotoSauter à un codeblock/label
InlineInsérer un codeblock entier ici (plus rapide que Gosub)
LabelDéfinir un point de saut
ReturnRetourner au jeu ou au dernier Gosub
Roll DiceNombre aléatoire
Set VariableModifier une variable
WaitGeler le jeu N frames
Yield On LevelContinuer après N frames (OnTimer niveau)
QuitQuitter vers AmigaDOS

Catégorie Conditional

CommandeDescription
ConditionIF standard
Else IfIF alternatif (si précédent faux)
ElseSinon
End ConditionFermer le bloc conditionnel
For Each ActorItérer sur tous les acteurs d’un type
ForBoucle avec variable
WhileBoucle while

Catégorie Level

CommandeDescription
LevelCharger un niveau
Spawn ActorSpawner un acteur
Block Get / Set / Find / CountManipulation des blocks
Block Get by PixelBlock en coordonnées pixels
Block SpawnSpawner un acteur sur un block
BackgroundRemplacer le fond
Teleport toTéléporter
Tile Properties Get / SetPropriétés d’une tuile

Catégorie Maths

CommandeDescription
AbsoluteValeur absolue
AngleRotation d’une valeur par une direction
ATan2Direction 0-359° depuis X et Y
Distance (Exact)Distance directe (lent)
Distance (Manhattan)Distance Manhattan (rapide)
Square RootRacine carrée

Catégorie Palette

CommandeDescription
Fade In / OutFondu depuis/vers le noir
Fade TimeDurée du fondu en frames
Color Set / Read / Write / ResetManipulation directe des couleurs
Palette Set / ReadPlage de couleurs depuis un PNG
Palette SwapChanger l’index d’une couleur dans une animation

Catégorie Data (sauvegarde)

CommandeDescription
Data Load / SaveCharger/sauver des variables sur disque. Vérifier Success.
String Clear / Replace / Set CharacterManipulation de chaînes

Codeblocks internes les plus utiles

CodeblockDescription
destroy_actorDétruire l’acteur courant
destroy_all_actorsDétruire tous les acteurs
destroy_child_actorsDétruire les enfants
jump_actorFaire sauter l’acteur
flipxmove / flipymove / flipxymoveInverser direction X, Y, ou XY
freeze_actor / unfreeze_actorGéler/dégéler
restart_this_levelRedémarrer le niveau
load_next_levelCharger le niveau suivant
pausePause jeu
fadein / fadeoutFondu
flipscreen / flipscreen_smoothSnap/scroll caméra
snap_to_screenForcer l’acteur dans les limites
wrap_screen_left/right/top/bottomRebondir sur les bords
waitforfiredown / waitforfirehit / waitforfireupAttendre état Fire
waitforframesAttendre N frames
anim_force_left / anim_force_rightForcer l’animation dans un sens
block_coll_force / block_coll_passthruForcer/ignorer collision block
do_teleportDéclencher un téléport

5.3 Variables internes essentielles

Variables globales

VariableDescription
LevelNiveau chargé
Camera_X/YPosition caméra
MapWidth/HeightDimensions niveau (pixels)
MapWidthTiles/HeightTilesDimensions niveau (tuiles)
Actor_CountNombre d’acteurs actifs
FastSloppyCollisions0=précis 1=moyen 2=rapide
FadeTimeDurée fondu (frames)
IsNTSC / IsAGA / IsFloppyType de machine
ProcessorCPU détecté (M68000, M68020…)
ChipRam / OtherRamMémoire disponible (octets)
Block_X/YPointeur block courant (coord. tuile)
Block_TypeType block sous Block_X/Y
EventTagTag dernier événement map
MeleeTag / HurtTagTags attaque/hurt box
OptionOption sélectionnée dans un menu panel
DiceDé (SET=plage, GET=valeur)
XRes / YResRésolution d’écran
TileMaskMasque AND pour arrondir en tuiles (0xFFF0)
True / False-1 / 0
Handle_CollisionForcer/ignorer une collision tuile

Variables de l’acteur courant (préfixées actor_, player_, projectile_, new_)

VariableDescription
actor_x/yPosition
actor_xspeed/yspeedVitesse
actor_xfacing/yfacingOrientation (-1, 0, 1)
actor_lookdirDirection de regard
actor_animationAnimation courante
actor_animationtagTag animation courante
actor_animationflagsFlags animation
actor_frameFrame courante
actor_isonplatformType plateforme sous l’acteur
actor_ismovingEn mouvement ?
actor_rendermodeMode de rendu
actor_timerFrames avant expiration timer/yield
actor_attackdelayFrames avant prochaine attaque
actor_tag / actor_typeTag/type courant
actor_uniqueidID unique
actor_var1…actor_var66 variables génériques libres
actor_var12f / actor_var12lFraction/Long utilisant var1+var2
actor_rotationRotation 0-359°
actor_controlx/yDirection joystick (-1, 0, 1)
actor_controlfire/jumpÉtat boutons Fire/Jump
actor_controlbuttons/hitbuttonsTous boutons
actor_controllerContrôleur assigné

5.4 Expressions

Opérateurs

Op.DescriptionExemple
+ - * /Arithmétique5 + 5 = 10
%Modulo26 % 5 = 1
&AND bit-à-bit3 & 1 = 1
|OR bit-à-bit3 | 1 = 3
^XOR bit-à-bit3 ^ 1 = 2
>>Décalage droite (/ puissance de 2)256 >> 4 = 16
<<Décalage gauche (* puissance de 2)16 << 4 = 256

Types de données

TypeTaillePlageUsage typique
Byte1 octet-128 à 127Données compactes dans les tableaux
Word2 octets-32 768 à 32 767Défaut – la plupart des variables
Long4 octets±2 147 483 648Scores élevés, grandes valeurs
Fraction4 octets-32 768.0 à 32 767.0Positions sub-pixel (<1 px/frame)

Points clés

  • Pas d’ordre des opérations ! Tout est évalué de gauche à droite. 5 + 5 * 5 = 10 * 5 = 50 !! ATTENTION !! Réarrangeant : 5 * 5 + 5 = 30 Ou : 5 + (5 * 5) = 30 (parenthèses supportées depuis 2025, légèrement plus lent)
  • Toutes les variables sont signées (débordement possible).
  • Expressions entières par défaut : ajoutez .0 ou . après le nom de variable pour une fraction.
  • Tableaux zero-indexed : MyArray[0] = premier élément.
  • Look Up Tables : fichier texte une valeur par ligne, lecture seule, ne compte pas dans la mémoire des codeblocks Amiga.

6. Glossaire

Actor (Acteur) Objet de jeu : anime, se déplace, entre en collision. Sous-types : Attacker, Block Collider, Moving Platform, Player, Projectile. Animation Séquence de frames avec événements par frame (sons, melee, tirs). Le suffixe _r déclenche la génération automatique du miroir _l. Block Tuile dynamique échangeable au runtime. Plus performant qu’un acteur. Peut être animé, penté ou destructible. Codeblock Séquence de commandes compilées en ASM 68K. Configurées via menus déroulants. Map / Level Zone de gameplay en tuiles 16×16. Peut contenir Events, Paths, Templates. Map Event Zone rectangulaire déclenchant des codeblocks (entrée, interaction, séjour, sortie). Peut être téléporteur. Panel Image statique ou interactive (titre, game over, HUD, menu, dialogue, parallaxe). Eléments dynamiques : Bar, Counter, Digits, Text, Options, Talkpad. Recyclage Mise en veille d’acteurs hors caméra. Types : Always, Never, Trash, Default. Tag Catégorie logique. Un seul par élément. Testable dans des conditions pour grouper des acteurs, animations ou blocks. Tile / Tileset Tuile statique 16×16. Le tileset contient toutes les tuiles + leur configuration (solidité, pente…). Yield Attente non-bloquante sur N frames. Remplace le yield précédent si déclenché à nouveau.


7. Optimisations Amiga

Acteurs

  • Activez Ghost Thru Walls (Fast) pour les objets sans collision mur.
  • Minimisez la collbox (1×1) pour les balles traversant les murs.
  • Désactivez Projectile si l’objet ne blesse pas les ennemis.
  • Désactivez Block Collider si pas d’effet spécial blocks.
  • Objets détruits en sortant : mode recyclage Trash.
  • Ne mettez Never que si l’acteur doit être actif éloigné de la caméra.
  • Acteur statique 16×16 ? Utilisez un Block.
  • Utilisez On Platform Landed plutôt qu’un événement collision bas.

Animations

  • Animation 1 frame fixe : délai = 0 (infini).
  • Si les couleurs entrent dans la plage sprite : Auto Sprite ou Only Sprite.
  • Désactivez Render Clearing pour les objets immobiles.
  • Rendu sans masque (maskless) pour les objets de fond simples.
  • Règle fondamentale Amiga : largeur non-multiple de 16 = aussi lent que le multiple supérieur.
    17 px de large = deux fois plus lent que 16 px !

Code (Codeblocks)

  • Inline plutôt que Gosub pour les performances critiques.
  • En fin de OnTimer : goto ou inline plutôt que gosub.
  • Tags d’animation dans les conditions : actor_animationtag == myanim plutôt que tester _l et _r séparément.
  • not zero plutôt que == true pour les plateformes.
  • Else If plutôt qu’une série de If.
  • Décalages binaires : << 1 = ×2, >> 1 = ÷2.
  • & et | bitwise pour les conditions multiples.

Réglages projet Amiga

  • Palette 16 couleurs / 4 bitplanes – optimal. Les couleurs 16-31 restent disponibles via sprites.
  • Couleur index 0 = noir (simplifie la copper list).
  • Résolution d’écran minimale pour économiser le DMA.
  • Désactivez Smooth Scrolling sur jeux purement verticaux ou statiques.
  • Read CD32 buttons uniquement si utilisé.
  • Buffer size : minimum tolérable (augmentez si glitches de bord).

AGA uniquement

  • Sprites plus grands et plus nombreux.
  • Fetch Mode au maximum (plus rapide, mais limitations de résolution).

8. Ressources et liens

Documentation officielle

Téléchargements

Communauté


Guide compilé depuis le Wiki officiel Scorpion Engine. Dernière mise à jour source : 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