Build a GameCreating Pacific Wings

Appendix B — Message Map

Pacific Wings is built on messages (Custom Events): one piece of the game announces something, and the pieces that care listen. This map shows every message in the game: who sends it, who it goes to, and who hears it. A message must be spelled exactly the same where it is sent and where it is heard; this is the place to check.

Two ways to send. Trigger Custom Event goes to everyone who listens (a broadcast). Trigger Custom Event on Object goes to one Object only; in this game almost always the sender’s own Object, so that one Logic can tell the next Logic on the same Object that its part is done.

B.1 Chains to Follow

Read each line left to right: a message, the Logic (in bold) that hears it and sends the next message, and at the end the Logic that hears the last one.

  • noMoreHealth → Shot Down → enemyShotDown → Score → shotDownScored → Kill Chain
  • noMoreHealth → Shot Down → shotDown → Drops Pickups
  • commandBomberShotDown → Score → commandBomberScored → Rounds → roundOver → Pause → resumeMission → Pause
  • milestoneReached → Stages → stageReached → Reinforcements
  • movedAhead → Drift Sideways → startDrifting → Drift Sideways

B.2 All Messages, in the Order the Build Adds Them

Message Sent by Goes to Heard by Chapter
enemyShotDown Shot Down (on Enemy Fighter, Enemy Ace, Heavy Bomber) everyone who listens Score (on Game Rules) 3
noMoreHealth the engine its own Object only Shot Down (on Enemy Fighter, Enemy Ace, Heavy Bomber) 3
fighterLost Lost on Hit (on Fighter) everyone who listens Planes (on Game Rules); Weapon Level (on Game Rules) 4
startReturnFlight Return Flight (on Fighter); Planes (on Game Rules) its own Object only; the Object it just created Return Flight (on Fighter) 4
playAgain the Mission Failed Menu button; the Mission Complete Menu button everyone who listens Play Again (on Game Rules) 5
resumeMission Pause (on Game Rules); the Pause Menu button its own Object only; everyone who listens Pause (on Game Rules) 5
startMission the Start Menu button everyone who listens Mission Start (on Game Rules); Best Score (on Game Rules) 5
weaveTurn Weave (on Enemy Ace, Heavy Bomber, Command Bomber) its own Object only Weave (on Enemy Ace, Heavy Bomber, Command Bomber) 6
commandBomberApproaching Stages (on Game Rules) everyone who listens Reinforcements (on Squadron); Supply Drops (on Game Rules) 7
milestoneReached Report Milestone (on Milestone) everyone who listens Stages (on Game Rules) 7
movedAhead Move Ahead When Passed (on Aircraft Carrier, Tropical Atoll, Coral Reef, Cloud Bank) its own Object only Drift Sideways (on Cloud Bank) 7
stageReached Stages (on Game Rules) everyone who listens Reinforcements (on Squadron) 7
startDrifting Drift Sideways (on Cloud Bank) its own Object only Drift Sideways (on Cloud Bank) 7
repairCrateCollected Collected by Fighter (on Repair Crate) everyone who listens Score (on Game Rules); Planes (on Game Rules) 8
shotDown Shot Down (on Enemy Fighter, Enemy Ace, Heavy Bomber) its own Object only Drops Pickups (on Enemy Fighter, Enemy Ace, Heavy Bomber) 8
wingCannonsCollected Collected by Fighter (on Wing Cannons) everyone who listens Score (on Game Rules); Weapon Level (on Game Rules) 8
shotDownScored Score (on Game Rules) its own Object only Kill Chain (on Game Rules) 9
changeMeter Command Bomber Hits (on Command Bomber) its own Object only Meter with Thresholds (on Command Bomber) 11
commandBomberHit Command Bomber Hits (on Command Bomber) everyone who listens Score (on Game Rules); Show Command Bomber Health (on Command Bomber Health Bar) 11
commandBomberShotDown Command Bomber Health (on Command Bomber) everyone who listens Score (on Game Rules) 11
phaseStarted Command Bomber Arrival (on Command Bomber); Command Bomber Health (on Command Bomber) its own Object only Command Bomber Guns (on Command Bomber); Command Bomber Aimed Volleys (on Command Bomber); Command Bomber Flak (on Command Bomber) 11
commandBomberScored Score (on Game Rules) its own Object only Rounds (on Game Rules) 12
roundOver Rounds (on Game Rules) everyone who listens Lost on Hit (on Fighter); Pause (on Game Rules) 12

From here on, each message has a list of its own, under the chapter that adds it. The name in quotes is the Mode that sends or hears it. An Event with only one Mode has it under its Logic Component’s name.

B.3 Chapter 3: The First Enemies

B.3.1 enemyShotDown

  • Sent by Shot Down (on Enemy Fighter, Enemy Ace, Heavy Bomber), in “Shot Down”, to everyone who listens.
  • Heard by Score (on Game Rules): “Add the Points”.

B.3.2 noMoreHealth

  • Sent by the engine: No More Health runs when the Object’s health field reaches 0.
  • Heard by Shot Down (on Enemy Fighter, Enemy Ace, Heavy Bomber): “Shot Down”.

B.4 Chapter 4: Enemy Fire and Lost Planes

B.4.1 fighterLost

  • Sent by Lost on Hit (on Fighter), in “Lost”, to everyone who listens.
  • Heard by Planes (on Game Rules): “Plane Lost”.
  • Heard by Weapon Level (on Game Rules): “Lower”.

B.4.2 startReturnFlight

  • Sent by Return Flight (on Fighter), in “Hand Over”, to its own Object only.
  • Sent by Planes (on Game Rules), in “Launch a Reserve”, to the Object it just created.
  • Heard by Return Flight (on Fighter): “Fly In”.

B.5 Chapter 5: Title, Pause and Play Again

B.5.1 playAgain

  • Sent by the Mission Failed Menu button, when chosen, to everyone who listens.
  • Sent by the Mission Complete Menu button, when chosen, to everyone who listens.
  • Heard by Play Again (on Game Rules): “Restart”.

B.5.2 resumeMission

  • Sent by Pause (on Game Rules), in “Round Over”, to its own Object only.
  • Sent by the Pause Menu button, when chosen, to everyone who listens.
  • Heard by Pause (on Game Rules): “Resume”.

B.5.3 startMission

  • Sent by the Start Menu button, when chosen, to everyone who listens.
  • Heard by Mission Start (on Game Rules): “Start the Mission”.
  • Heard by Best Score (on Game Rules): “Hide the Best Score”.

B.6 Chapter 6: Aces and Heavy Bombers

B.6.1 weaveTurn

  • Sent by Weave (on Enemy Ace, Heavy Bomber, Command Bomber), in “Start Weaving”, to its own Object only.
  • Sent by Weave (on Enemy Ace, Heavy Bomber, Command Bomber), in “Turn”, to its own Object only.
  • Heard by Weave (on Enemy Ace, Heavy Bomber, Command Bomber): “Turn to the Other Side”.

B.7 Chapter 7: The Route

B.7.1 commandBomberApproaching

  • Sent by Stages (on Game Rules), in “Command Bomber Near”, to everyone who listens.
  • Heard by Reinforcements (on Squadron): “Stop Sending”.
  • Heard by Supply Drops (on Game Rules): “Stop Supplies”.

B.7.2 milestoneReached

  • Sent by Report Milestone (on Milestone), in “Tell Game Rules”, to everyone who listens.
  • Heard by Stages (on Game Rules): “Next Stage”.

B.7.3 movedAhead

  • Sent by Move Ahead When Passed (on Aircraft Carrier, Tropical Atoll, Coral Reef, Cloud Bank), in “Move Ahead”, to its own Object only.
  • Heard by Drift Sideways (on Cloud Bank): “Start Again”.

B.7.4 stageReached

  • Sent by Stages (on Game Rules), in “Stage 1”, to everyone who listens.
  • Sent by Stages (on Game Rules), in “Next Stage”, to everyone who listens.
  • Heard by Reinforcements (on Squadron): “Start Sending”.

B.7.5 startDrifting

  • Sent by Drift Sideways (on Cloud Bank), in “Start”, to its own Object only.
  • Sent by Drift Sideways (on Cloud Bank), in “Start Again”, to its own Object only.
  • Heard by Drift Sideways (on Cloud Bank): “Head for the Farther Side”.

B.8 Chapter 8: Pickups and Weapon Levels

B.8.1 repairCrateCollected

  • Sent by Collected by Fighter (on Repair Crate), in “Collected”, to everyone who listens.
  • Heard by Score (on Game Rules): “Add the Pickup Points”.
  • Heard by Planes (on Game Rules): “One More Plane”.

B.8.2 shotDown

  • Sent by Shot Down (on Enemy Fighter, Enemy Ace, Heavy Bomber), in “Shot Down”, to its own Object only.
  • Heard by Drops Pickups (on Enemy Fighter, Enemy Ace, Heavy Bomber): “Maybe Drop a Pickup”.

B.8.3 wingCannonsCollected

  • Sent by Collected by Fighter (on Wing Cannons), in “Collected”, to everyone who listens.
  • Heard by Score (on Game Rules): “Add the Pickup Points”.
  • Heard by Weapon Level (on Game Rules): “Raise”.

B.9 Chapter 9: Kill Chain

B.9.1 shotDownScored

  • Sent by Score (on Game Rules), in “Add the Points”, to its own Object only.
  • Heard by Kill Chain (on Game Rules): “Extend the Chain”.

B.10 Chapter 11: The Command Bomber

B.10.1 changeMeter

  • Sent by Command Bomber Hits (on Command Bomber), in “Take a Hit”, to its own Object only.
  • Heard by Meter with Thresholds (on Command Bomber): “Meter with Thresholds”.

B.10.2 commandBomberHit

  • Sent by Command Bomber Hits (on Command Bomber), in “Take a Hit”, to everyone who listens.
  • Heard by Score (on Game Rules): “Add the Points”.
  • Heard by Show Command Bomber Health (on Command Bomber Health Bar): “Match the Health”.

B.10.3 commandBomberShotDown

  • Sent by Command Bomber Health (on Command Bomber), in “Shot Down”, to everyone who listens.
  • Heard by Score (on Game Rules): “Add the Points”.

B.10.4 phaseStarted

  • Sent by Command Bomber Arrival (on Command Bomber), in “Arrive”, to its own Object only.
  • Sent by Command Bomber Health (on Command Bomber), in “Next Phase”, to its own Object only.
  • Heard by Command Bomber Guns (on Command Bomber): “Arm the Guns”.
  • Heard by Command Bomber Aimed Volleys (on Command Bomber): “Arm the Volleys”.
  • Heard by Command Bomber Flak (on Command Bomber): “Arm the Flak”.

B.11 Chapter 12: Rounds and Mission Complete

B.11.1 commandBomberScored

  • Sent by Score (on Game Rules), in “Add the Points”, to its own Object only.
  • Heard by Rounds (on Game Rules): “Round Won”.

B.11.2 roundOver

  • Sent by Rounds (on Game Rules), in “Round Won”, to everyone who listens.
  • Sent by Rounds (on Game Rules), in “Next Round”, to everyone who listens.
  • Heard by Lost on Hit (on Fighter): “Safe When the Round Is Over”.
  • Heard by Pause (on Game Rules): “Round Over”.

B.12 Game State Changes (Sent by the Engine)

Set Game State makes the engine send Game State Changed to everyone who listens.

  • Planes sets Mission Failed in “Plane Lost”.
  • Mission Start sets Playing in “Start the Mission”.
  • Rounds sets Mission Complete in “Round Won”.
  • Heard by: Score, Best Score, Show at Game State, Show the Flight HUD.