XMLGameEngine

XMLGameEngine is a VGDL (video game description language) and an engine for running games completely contained within an XML file.

View the Project on GitHub beefviper/XMLGameEngine

Notes for AI coding agents

Gotchas that are easy to get wrong. How the engine works is the reference; why, and the backlog, is the design index. Rules and layout: AGENTS.md.

The repository

Values and variables

Objects, states and scenes

Frames and touches

Cells and boards

Spawning

Looks and pictures

Caches

Each rests on something that never changes while a game runs: FrameRules::partners and mazeGrid; tryGetObject’s answers and matching; game_expr::compiled; isShown, kept until stageChanged(). Anything new that changes the state stack, a scene or an object’s owner calls stageChanged().

xgetest "[.speed]" prints every game’s load and frame times to compare builds.

Loading

Tests

Backends and build

Generator

xgegui

Docs

Privacy

This repository is public. Nothing personal from a chat export goes in it: no health, identity, contact or business details, no conversation titles, and no names beyond the beefviper handle in the code headers. Design files call the owner “the author”.