VASSAL Reference Manual
Deck Send Key Command
This Deck Sub-Component adds an action that sends cards from this Deck to another Deck
The Send action can be initiated by a right-click menu action, or by a Global Hotkey sent from another Vassal trait or component.
To add a Deck Send Key Command to one of your Decks, use the Editor’s configuration window to navigate to the [Deck] entry for the Deck you want to add it to. Right-click on the [Deck] entry and select Add Deck Send Key Command.
Deck Send Key Commands can also be placed in a component Folder created under the Deck.
When initiated, Cards will be sent one by one from the top of this Deck to the top of the target Deck. Options are available to limit which and how many cards are sent and to which Deck.
A basic command to send the entire contents of the Deck to the AP Discard Deck on receipt of the DiscardAllAP Hotkey.
A more complex example that sends all cards with a value of "Action" in the Type property to the Deck whose name is stored in the DestinationDeck Global Property. The Command is initiated by a right-click menu command and reported to the Chat window.
A fully featured example that sends a maximum of 4 cards with a value of "Action" in the Type property to the Deck whose name is stored in the DestinationDeck Global Property, but stops sending if a card with a Type of Interrupt is seen. The Interrupt card is not sent to the target Deck. This command can be initiated by either the F7 Keystroke Hotkey, or a right-click menu command. The action is reported and includes the number of cards sent.