# VASSAL Reference Manual

Home > Module> Game Piece Palette > Game Piece > Send to Location

## Send to Location

Adds a command that moves a piece directly to another location.

Command Name the menu text in the piece's right-click menu.

Keyboard command The keyboard shortcut for the command

Send Back Command Name The menu text for an "undo" command to return the piece to its original location.

Send Back Keyboard Command The keyboard shortcut for the "undo" command

Destination

Location on Selected Map | An (x,y) position on a specific map, optionally offset as described below;
Zone on Selected Map | The center of a Zone on a map, optionally offset as described below;
Region on Selected Map | The named Region on a map, optionally offset as described below;
Another counter selected by properties | The location of the counter selected by the property match specified, optionally offset as described below
Grid Location on Selected Map | A named location on a map using the appropriate grid numbering. No additional offset is available at this time, as it is intended that this be an offset in grid units instead of pixels, which is not yet implemented.

Map An Expression specifying the Map Window name that the piece will be sent to. If unspecified, then the piece's current map is used. Use the Select button to select a Map Window currently defined in the module.

Board An Expression specifying name of the board that the piece will be sent to. Positions below are relative to the board's position. If no board is specified, positions are relative to the Map Window. Use the Select button to select a Board currently defined in the module.

Zone Name An Expression specifying the Zone name that the piece will be sent to.

Region Name An Expression specifying the Region name that the piece will be sent to.

Grid Location The Grid Location that the piece will be sent to.

Property Match A Property Match Expression that selects a counter that the piece will be sent to.

X position An Expression specifying the horizontal position of the destination point in pixels.

Y position An Expression specifying the vertical position of the destination point in pixels.

Additional offset The value of these two Expressions will be multiplied together and added to the position specified above to give the final destination position for the piece.

EXAMPLE:
A game may require that damaged units are returned to a Damaged pool for repairs. Different boxes in the pool represent the amount of time before the unit is fully repaired. A game piece may be given a 'Send to Location trait with name 'Send to Damaged Pool' and command CTRL-P and position corresponding to the first box of the pool, with an additional offset, determined by the level of a Layer representing the damage, to place it in the appropriate box in the pool