Engine (tiles, collisions, entities, sound, menus, network), skeleton, Pong and Breakout, Docker-only CLI bin/jumphp, FrankenPHP web server, AGENTS.md guide. Co-Authored-By: Claude Opus 5.5 <[email protected]>
3.9 KiB
Tiles et collisions
Charger une carte
| Source | Appel | Pour |
|---|---|---|
Tiled (.tmj) |
TiledJsonLoader::load($config->path('assets/maps/n1.tmj')) |
les vrais niveaux |
| Lignes de texte | ArrayLoader::fromRows([...], legend: ['#' => 1], objects: ['P' => 'start']) |
prototypes, tests, niveaux générés |
| Octets bruts | BinaryLoader::load($fichier, $l, $h, $tw, $th, $image, $colonnes, $solidite, $formes) |
niveaux extraits de vieux jeux |
Tiled : conventions
- Carte orthogonale, non infinie, enregistrée en JSON (
.tmj). Tilesets intégrés ou.tsj, une image par tileset (pas de « collection of images »). Données de calques en CSV ou base64 (zlib / gzip). - Calque de collision : nommé
collision, ou propriété booléennecollision, sinon le premier. Il peut être invisible (case « visible » décochée). - Forme d'une tuile : propriété de tuile
collision(chaîne) =full·none·oneway(traversable par dessous) ·slope:0,16(hauteur en pixels au bord gauche, au bord droit) ·heights:0,1,2,...(une hauteur par colonne) ·oneway-slope:.... Ou dessiner des rectangles / polygones dans l'éditeur de collision de Tiled. Sans rien : pleine. - Calque au premier plan (devant les entités) : propriété booléenne
foreground. - Objets : calques d'objets →
$map->objects(type = « Class » / « Type » de Tiled). Points de départ :$map->object('start'). Instanciation :EntityManager::register('coin', Coin::class)puisspawnFromMap($map). - Propriétés de tuiles (
hazard,coin...) :$map->tileProperty($gid, 'hazard'), et l'événementtouchdeCollisionSystem. - Tuiles animées, retournées (flip), calques image avec parallaxe : gérés.
Masques (CollisionMask)
Chaque gid du calque de collision a un masque : full(), none(), oneWay(), heights([...]),
slope($w, $h, $de, $a), fromRows(['#...', ...]) (forme quelconque). ->oneWay : bloque seulement
une entité qui tombe dessus par au-dessus. isSolid($x, $y) (coordonnées locales), topAt($x).
Déplacement (CollisionSystem::move($entite, $carte, $dt))
- Avance pixel par pixel, en X puis en Y ; pas de traversée possible à vitesse raisonnable.
- Murs : vitesse X annulée, collée au pixel près (
hitLeft/hitRight). - Marches et pentes : au sol, une marche jusqu'à
$maxStepUppixels (4) est gravie ; en descente la collision « colle » au sol jusqu'à$snapDownpixels (6). - Sol / plafond : vitesse Y annulée, position entière.
- Plateformes (mobiles ou non) :
setPlatformProvider(fn () => [[x, y, width, height, vx, vy, oneWay], ...]), l'entité posée dessus est transportée. - Bords : gauche / droite de la carte = murs (
$solidEdges), sortie par le bas = événementfell. - Contacts : événement
touchpour chaque tuile avec propriétés recouverte (calque de collision +$touchLayers), et la tuile sous les pieds (_grounddans les propriétés).
L'entité doit utiliser le trait TileCollision pour recevoir onGround, onCeiling, onWallLeft,
onWallRight, groundGid. Ne pas intégrer la vitesse deux fois : avec move(), ne pas appeler
Entity::update() (qui ajoute aussi vx * dt), voir skeleton/src/Entity/Player.php.
Pour des objets rapides, un pas fixe (FixedStep(120)). Entre entités : Aabb::intersects,
Aabb::overlap (vecteur de sortie), Aabb::sweep (instant d'impact).
Dessin (TileMapRenderer)
renderBackground() (calques image puis calques de tuiles non foreground), les entités, puis
renderForeground(). Seules les tuiles visibles sont dessinées. Un tileset sans image (ArrayLoader sans
tileset) est dessiné en blocs de couleur ($tiles->placeholder). Le nom de texture d'un tileset est
tileset:<chemin de l'image> : on peut la fournir soi-même (createTextureFromGd('tileset:...'), voir le
squelette).