Market Design Commands Reference

Market Game design commands create coherent sets of Variables, output assignments, formulas, and Results content. They are shortcuts over the same canonical structures available in Data model, Gameplay, and Page editing.

The commands modify the current unsaved Design. Review the generated content and use Save changes to store it.

Trade Total Results

Add Trade total Results creates a public numeric per-player Variable named Total trade amount, initialized to zero.

For every Market Player Type account, it adds a transaction output that increments the Variable by the transaction quantity. It then adds a total-traded-quantity table to the participant Results Page. If Results does not exist, the command creates it and assigns all current Player Types as Active.

Use this command when Results should report cumulative traded quantity per participant.

Final Portfolio Summary

Add Final portfolio summary snapshots each participant's final:

• Cash,
• endowment for every Market Asset.

It creates or reuses compatible per-player Variables for the current session and for all started run sessions. Market finalization outputs write the snapshots before Results.

The command adds:

• a Final portfolio table to participant Results using current-session values,
• a corresponding table to Moderator results using all-session values.

Asset presentation precision is used for the corresponding portfolio column when configured; otherwise the default is two decimal places.

Performance Summary

Add performance summary creates one named performance metric.

The dialog asks for:

• Label: the participant-facing metric name,
• Source: an existing scalar numeric per-player Variable or Formula.

When Formula is chosen, Continue opens the Formula editor. The command evaluates the metric at Market finalization and creates current-session and all-session projections when compatible Variables cannot be reused.

It adds:

• a participant Results table introduced by Your performance:,
• a Moderator results table introduced by Player performance:.

Several performance summaries may coexist because each label and expression receives its own generated feature identity.

Generated Feature States

Each command records provenance on the elements it owns. The command area summarizes the resulting feature as:

• Added: all expected generated elements are present and unchanged.
• Modified: at least one owned element has been edited.
• Needs repair: provenance remains, but required generated elements are missing or incomplete.

Repair is offered for deterministic built-in sets where the application can restore missing artifacts, currently Trade total Results and Final portfolio summary. A performance summary has author-selected input, so an incomplete one may need to be removed and created again.

Removing A Generated Feature

The Trash command removes elements owned by that specific generated feature:

• generated Variables,
• generated output assignments,
• generated Page blocks,
• generated Pages or Stages when they become empty and were created by the same command.

Compatible pre-existing Variables reused by the command and unrelated manually authored content are retained. Removal changes only the current draft until it is saved.

Conflicts And Manual Editing

A command refuses to overwrite an incompatible definition that already uses one of its stable names or identities. Resolve the conflict deliberately rather than renaming arbitrary technical IDs.

Generated content remains editable. Manual changes move the feature to Modified; deleting only part of it can produce Needs repair. Use Find usages and inspect the generated provenance before changing a Variable shared with other content.