Difference between revisions of "Script:Dice in the Vineyard"
From Roll20 Wiki
(→Syntax) |
|||
| Line 51: | Line 51: | ||
* '''count''': Requires the name of the character whose chips are to be counted. | * '''count''': Requires the name of the character whose chips are to be counted. | ||
* '''setimage''': Requires the chip value whose image is to be set. If a URL is passed in as a second argument, it will be used; otherwise, the currently selected token's image will be used.}} | * '''setimage''': Requires the chip value whose image is to be set. If a URL is passed in as a second argument, it will be used; otherwise, the currently selected token's image will be used.}} | ||
| + | {{param description bottom}} | ||
=== Changelog === | === Changelog === | ||
{{changelog version|0.1|2015-04-09|* Initial release}} | {{changelog version|0.1|2015-04-09|* Initial release}} | ||
Revision as of 02:23, 17 April 2015
Version: 0.1
Last Modified: 2015-04-09
Code: DiceInTheVineyard
Dependencies: None
Conflicts: None
Dice in the Vineyard is a dice tracker for Dogs in the Vineyard. It creates poker-chip-styled tokens for each roll and stacks them on the tabletop in areas set aside for each character. During play, players can spend roll tokens, roll in additional tokens, and request chip counts for any character in play.
It is recommended that this script be used in conjunction with the CommandShell module, which will improve output formatting and command discovery.
Using Dice in the Vineyard
Before using Dice in the Vineyard, it is recommended that image URLs be set for each chip value. These can be set in the script in the DEFAULT_URLS dictionary or within the game via the setimage subcommand (described below). For best results, use a PNG with transparency, so that chips will stack appropriately. You may wish to set the CHIP_HEIGHT parameter, which defines the height, in pixels, of the side of the chip (i.e. additional chips will be placed this many pixels above the chip beneath them in order to create a stacking effect). Any chip without a specific image set will use GENERIC_URL and will use a status icon to display its value.
Each character to be tracked must have space allocated on the tabletop for its chips. This can be accomplished via the add subcommand, which will allocate an area starting at the specified square and extending six squares right and four squares down (this can be altered by changing the values of BOX_WIDTH and BOX_HEIGHT, but should always be at least two wide and a multiple of two tall, and should have a total area of at least 24 squares). A 2x2 area in the top left will be reserved for the character token and for chip tokens to be played; ten 1x2 areas will be used for stacking chips of each value 1-10.
Syntax
!ditv <subcommand> [parameters]
Formally:
S→ ditvsubcommand
subcommand→ help
subcommand→ add string integer integeroptional color
subcommand→ remove string
subcommand→ clear string
subcommand→ roll string string
subcommand→ count string
subcommand→ setimage string string
subcommand→ images
optional color→ ε
optional color→ string
| Parameter | Values |
|---|---|
| subcommand | The !ditv command provides the following subcommands:
|
| parameters | Some subcommands require additional parameters:
|
Changelog
v0.1 (2015-04-09)
- Initial release
