Contest Exchange Builder - Complete Guide

1. What This Game Trains

• Fast callsign copy under contest timing pressure.
• Structured exchange entry with contest-specific CALL, RST, zone, serial, and section fields.
• Selective repeat usage with penalties, like real AGN decisions.
• Rate + accuracy balance instead of pure speed-only drills.

2. Exchange Profiles

• CQ WW: RST + CQ zone, for example DL2ABC 5NN 14 TU.
• CQ WPX: RST + progressive serial, beginning with 001.
• IARU HF: RST + ITU zone for non-HQ stations. HQ and official-station abbreviations are intentionally outside this profile.
• Combined Serial + Section: a focused two-token training drill, not a claim to reproduce one named contest.

3. Data Integrity

• Callsigns are drawn from data/callsigns.txt only.
• CQ and ITU zone metadata are resolved with data/cty.dat prefix logic.
• Optional overrides can be defined in data/callsign_overrides.csv.
• If cty.dat is missing, use refresh-cty-dat.php.

6. Keyboard Flow

• Enter in CALL moves to RST.
• Enter in RST moves to the active contest token.
• Enter in the final required field submits the exchange.
• Space AGN ALL, C AGN CALL, Z AGN TOKEN.

Audio Conditions

QRN sets the band-noise floor, QSB controls fading, and QRM adds overlapping callers at different pitches and speeds. Pitch, volume, and keying waveform are shared with Morse Runner, Rufz, and Pileup Hunter; WPM and contest difficulty remain module-specific.

7. Scoring Logic

Scoring is server-authoritative and combines:

• Field correctness (CALL has highest importance).
• Response speed bonus.
• Difficulty multiplier (WPM + QRN/QSB/QRM).
• Streak multiplier for sustained clean copy.
• AGN penalties per replay.