Upgrading
Upgrading and coming from other games
Stay on version 1 and move from another colour-card game.
Within version 1
Both /element/define and the legacy /element-define register the same native tag. Numeric element sizes preserve their match meaning; use points when combining a target score with display size.
Moving from another colour-card game
Keep physical card ids, house rules and match target separate. A copied visual card is not enough to construct a legal native move. Select classic or party rules explicitly, read moves through the engine, and let its challenge, stacking and last-card-call rules decide the next state.
Changes and the embed guide
The changelog records version changes. The embed guide remains the full attributes/events contract.