From RPTools Wiki
Jump to navigation Jump to search

 This article is a stub, you can help the RPTools Wiki project by contributing content to expand this article.

transferPitVBL() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.12
Directly transfers Pit VBL from token to the Pit VBL layer if true; otherwise, it transfers from the Pit VBL layer to the token's Pit VBL.


transferPitVBL(direction, delete)
transferPitVBL(direction, id)
transferPitVBL(direction, delete, id)

This function can be used to transfer token Pit VBL to normal Pit VBL, or vice versa. Token VBL moves with the token, can be set under the VBL tab on the Token Editor Dialog, and is colored YELLOW. Normal VBL is static, can be created with the VBL drawing tools, or with the use of the VBL functions, and is colored BLUE.


  • direction - This value can be:
    • 0 transfer normal (blue) Pit VBL to token (yellow) Pit VBL
    • 1 transfer token (yellow) Pit VBL to normal (blue) Pit VBL
  • delete - Defines if the transferred Pit VBL is deleted from the source.
  • id - OPTIONAL: The token id of the token being acted upon. Defaults to the Current Token.


Example: Transfer Pit VBL from Token to Map
[h: transferPitVBL(1, "Dragon")]
[h: transferPitVBL(0)]

Example: Transfer Pit VBL from Map to current Token

[h: transferPitVBL(0)]

Example: Clear Pit VBL from Token after transfer

[h: transferPitVBL(1, 1)]

See Also