41 lines
2.2 KiB
C++
41 lines
2.2 KiB
C++
#pragma once
|
||
|
||
#include "external/fkyaml_node.hpp"
|
||
#include "game/entities/hazard.hpp"
|
||
|
||
// Forat al sòl: hazard estàtic de 16×16 que NO bloqueja el pas però
|
||
// detecta quan el jugador hi cau a sobre. Característiques:
|
||
// - `collides_=false` + `triggers_on_overlap_=true`: rep `onPlayerContact`
|
||
// pel bucle de `EntityManager::checkPlayerCollisions` sense bloquejar
|
||
// el moviment del jugador.
|
||
// - `height_=0`: el filtre per altura del bucle (`jump_z > height`) NO
|
||
// s'activa amb height a zero, així que el bucle de contacte SÍ crida
|
||
// `onPlayerContact` també per a jugadors AIRBORNE. Qui rebutja els
|
||
// estats distints de GROUNDED (saltant, caient, HURT, DYING...) és el
|
||
// guard explícit dins de `Hole::onPlayerContact`. El filtre d'altura
|
||
// és una optimització ortogonal del bucle, no la defensa principal.
|
||
// - Damage 0: el contacte no publica `player_hit`. En lloc d'això,
|
||
// `onPlayerContact` invoca `Player::enterHoleFall`, que transiciona
|
||
// el jugador a AIRBORNE amb subestat `falling_through_hole_`.
|
||
// - Verificació amb hit-box interna: `onPlayerContact` re-verifica
|
||
// l'overlap amb `Player::getHitBox()` (8×8 centrada al sprite),
|
||
// així només es dispara quan el centre del jugador entra al tile.
|
||
// - Z-order: `is_floor_decal_=true` (heretat) — `Entity::getFeetY()`
|
||
// retorna sentinel mínim, així el forat es pinta abans que qualsevol
|
||
// actor i les momies passen per davant. L'efecte "el sòl es traga el
|
||
// jugador" no es fa amb Y-sort: el `Player::render` aplica un clip
|
||
// rect mentre `falling_through_hole_=true` que retalla el sprite per
|
||
// sota de la base del tile del forat.
|
||
class Hole : public StaticHazard {
|
||
public:
|
||
explicit Hole(const fkyaml::node& yaml);
|
||
|
||
// No publica `player_hit`. En el seu lloc, dispara
|
||
// `Player::enterHoleFall(center_x, center_y, floor_y)` perquè el
|
||
// jugador armi el clip rect a la Y de la base del forat.
|
||
void onPlayerContact(Player* player) override;
|
||
};
|
||
|
||
// TODO(hole-feature): afegir reset de `falling_through_hole_` i `hole_clip_bottom_y_` a `Player::disable()` per simetria.
|
||
// TODO(hole-feature): afegir tests dedicats del comportament de la mòmia amb forats (no requereixen Player real).
|