| name | games-core |
| description | Game engine core — fixed-timestep loop, scene manager, asset loader, input handling. Nền tảng cho mọi thể loại game H5. |
games-core — Game Engine Core
Fixed-Timestep Game Loop (không lag, không giật)
Fixed-timestep 60 FPS loop với accumulator, clamp dt chống spiral of death, cho phép fixedUpdate + render riêng.
Xem: templates/game-engine.ts
Scene Manager (zero memory leak)
Quản lý scene lifecycle: add, switch (destroy cũ → init mới), update, destroyAll.
Xem: templates/scene-manager.ts
Asset Loader (parallel + retry)
Load image/audio/json/glb với cache + retry 2 lần + preload với progress callback.
Xem: templates/asset-loader.ts
Entity State Machine (chống bug state)
FSM với 6 state (idle/run/jump/attack/hurt/die), transition rules, auto timeout, lock mechanism.
Xem: templates/fsm.ts
Input Manager (unified keyboard + touch)
Unified keyboard + mouse + touch, justPressed tracking, clearFrame() gọi cuối mỗi frame.
Xem: templates/input-manager.ts
Kết hợp
const engine = new GameEngine();
const scenes = new SceneManager();
const input = new InputManager();
const assets = new AssetLoader();
const fsm = new FSM();
engine.fixedUpdate = (dt) => {
scenes.update(dt, 0);
fsm.update(dt);
};
engine.start();
Anti-Rationalization
| Excuse | Reality |
|---|
| "Fixed timestep không cần, requestAnimationFrame đủ" | FPS khác nhau → physics không đồng nhất |
| "Scene manager viết tay" | Memory leak khi switch scene không destroy |
| "FSM over-engineering" | State bug = animation sai, input sai |
Red Flags
- dt không clamp → spiral of death
- Scene switch không destroy cũ
- FSM không có transition guard
Verification
