New: RPGM maths for duration & direction of --target
' - +'New: Saving throw mods & prompts for --target commands
' - +'New: --target multi to target status changes for multiple tokens
' - +'New: --target-nosave and --target-save to deny/force GM confirm
' - +'New: --nosave on/off configures --target-nosave behaviour
' + +'New for v5.056: --state-extract & --state-load support campaign copying
' + +'New for v5.055: RPGM maths for duration & direction of --target
' + +'New for v5.055: Saving throw mods & prompts for --target commands
' + +'New for v5.055: --target multi to target status changes for multiple tokens
' + +'New for v5.055: --target-nosave and --target-save to deny/force GM confirm
' + +'New for v5.055: --nosave on/off configures --target-nosave behaviour
' +'RoundMaster is an API for the Roll20 RPG-DS. Its purpose is to extend the functionality of the Turn Tracker capability already built in to Roll20. It is one of several other similar APIs available on the platform that support the Turn Tracker and manage token and character statuses related to the passing of time: the USP of this one is the full richness of its functionality and the degree of user testing that has occurred over a 12 month period.
' +'RoundMaster is based on the much older TrackerJacker API, and many thanks to Ken L. for creating TrackerJacker. However, roundMaster is a considerable fix and extension to TrackerJacker, suited to many different applications in many different RPG scenarios. RoundMaster is also the first release as part of the wider RPGMaster series of APIs for Roll20, composed of RoundMaster, CommandMaster, InitiativeMaster, AttackMaster, MagicMaster and MoneyMaster - other than RoundMaster (which is generic) these initially support only the AD&D2e RPG.
' +'Note: For some aspects of the APIs to work, the ChatSetAttr API and the Tokenmod API, both from the Roll20 Script Library, must be loaded. It is also highly recommended to load all the other RPGMaster series APIs listed above. This will provide the most immersive game-support environment
' @@ -873,6 +875,8 @@ var RoundMaster = (function() { +'--deltargetstatus tokenID|status(es) / ALLWorks the same as removetargetstatus command, except that it does not run any effect macros.
' +'!rounds --movestatus' +'
For each of the selected tokens in turn, searches for tokens in the whole campaign with the same name and representing the same character sheet, and moves all existing statuses and markers from all the found tokens to the selected token (removing any duplicates). This supports Players moving from one Roll20 map to another and, indeed, roundMaster detects page changes and automatically runs this command for all tokens on the new page controlled by the Players who have moved to the new page.
' + +'!rounds --state-extract' + +'
' + +'!rounds --state-load [RPGM/ALL/API-Name][|API-Name2|API-Name3|...]
New for v5.056: These commands extract the current Roll20 state variable for the current campaign to a character sheet called "StatusMule", ready to be copied or transmogrified to a new (identical) campaign, and then provide the ability to load all or part of the state variable into the copy campaign. This provides support for Roll20 upgrades, such as JumpGate.
' + +'The --state-extract command does not take any arguments, and extracts the whole Roll20 state variable for the current campaign in JSON text form to the "State" ability on the character sheet "StatusMule".
' + +'The --state-load command takes one text argument, which can be:
' + +'| RPGM | Loads only the parts of the state variable relevant to the currently installed RPGMaster Mods - including RoundMaster |
|---|---|
| ALL | Loads the whole state variable for all installed Mods (See Note below) |
| API-names | Loads the state variables for the named API/Mod(s). Additional names can be separated with pipes "|" (See note below). |
Note: Individual API / Mod names are case sensitive (except for RPGM API names, which are checked & corrected automatically). No guarantee is given for the validity or effect of loading non-RPGM API / Mod state variables. You should only load non-RPGM state variables to a copy of a campaign you are prepared to loose if the load does not work properly.
' +'!rounds --disptokenstatus [tokenID]' +'
Shows the statuses on the specified token to the DM using the same display format as used in the Turn Announcement.
' +'!rounds --dancer [INHAND/REBUILD]|tokenID|weapon|[plusChange]|[duration]' diff --git a/RoundMaster/RoundMaster.js b/RoundMaster/RoundMaster.js index 6e4ed8c6a7..d4454d1833 100644 --- a/RoundMaster/RoundMaster.js +++ b/RoundMaster/RoundMaster.js @@ -127,14 +127,15 @@ API_Meta.RoundMaster={offset:Number.MAX_SAFE_INTEGER,lineCount:-1}; * "duration" and "direction" as well as save mods. Addition of '#' to RPGM maths to * represent number of creatures targeted with a --target multi. Fix support of ^^duration^^ * tag in effects. + * v5.056 22/06/2024 Added --state-extract & --state-load functions to support migration to JumpGate **/ var RoundMaster = (function() { 'use strict'; - var version = 5.055, + var version = 5.056, author = 'Ken L. & RED', pending = null; - const lastUpdate = 1717750563; + const lastUpdate = 1719059275; var RW_StateEnum = Object.freeze({ ACTIVE: 0, @@ -794,18 +795,19 @@ var RoundMaster = (function() { var handouts = Object.freeze({ RoundMaster_Help: {name:'RoundMaster Help', - version:1.13, + version:1.14, avatar:'https://s3.amazonaws.com/files.d20.io/images/257656656/ckSHhNht7v3u60CRKonRTg/thumb.png?1638050703', bio:'
New: RPGM maths for duration & direction of --target
' - +'New: Saving throw mods & prompts for --target commands
' - +'New: --target multi to target status changes for multiple tokens
' - +'New: --target-nosave and --target-save to deny/force GM confirm
' - +'New: --nosave on/off configures --target-nosave behaviour
' + +'New for v5.056: --state-extract & --state-load support campaign copying
' + +'New for v5.055: RPGM maths for duration & direction of --target
' + +'New for v5.055: Saving throw mods & prompts for --target commands
' + +'New for v5.055: --target multi to target status changes for multiple tokens
' + +'New for v5.055: --target-nosave and --target-save to deny/force GM confirm
' + +'New for v5.055: --nosave on/off configures --target-nosave behaviour
' +'RoundMaster is an API for the Roll20 RPG-DS. Its purpose is to extend the functionality of the Turn Tracker capability already built in to Roll20. It is one of several other similar APIs available on the platform that support the Turn Tracker and manage token and character statuses related to the passing of time: the USP of this one is the full richness of its functionality and the degree of user testing that has occurred over a 12 month period.
' +'RoundMaster is based on the much older TrackerJacker API, and many thanks to Ken L. for creating TrackerJacker. However, roundMaster is a considerable fix and extension to TrackerJacker, suited to many different applications in many different RPG scenarios. RoundMaster is also the first release as part of the wider RPGMaster series of APIs for Roll20, composed of RoundMaster, CommandMaster, InitiativeMaster, AttackMaster, MagicMaster and MoneyMaster - other than RoundMaster (which is generic) these initially support only the AD&D2e RPG.
' +'Note: For some aspects of the APIs to work, the ChatSetAttr API and the Tokenmod API, both from the Roll20 Script Library, must be loaded. It is also highly recommended to load all the other RPGMaster series APIs listed above. This will provide the most immersive game-support environment
' @@ -873,6 +875,8 @@ var RoundMaster = (function() { +'--deltargetstatus tokenID|status(es) / ALLWorks the same as removetargetstatus command, except that it does not run any effect macros.
' +'!rounds --movestatus' +'
For each of the selected tokens in turn, searches for tokens in the whole campaign with the same name and representing the same character sheet, and moves all existing statuses and markers from all the found tokens to the selected token (removing any duplicates). This supports Players moving from one Roll20 map to another and, indeed, roundMaster detects page changes and automatically runs this command for all tokens on the new page controlled by the Players who have moved to the new page.
' + +'!rounds --state-extract' + +'
' + +'!rounds --state-load [RPGM/ALL/API-Name][|API-Name2|API-Name3|...]
New for v5.056: These commands extract the current Roll20 state variable for the current campaign to a character sheet called "StatusMule", ready to be copied or transmogrified to a new (identical) campaign, and then provide the ability to load all or part of the state variable into the copy campaign. This provides support for Roll20 upgrades, such as JumpGate.
' + +'The --state-extract command does not take any arguments, and extracts the whole Roll20 state variable for the current campaign in JSON text form to the "State" ability on the character sheet "StatusMule".
' + +'The --state-load command takes one text argument, which can be:
' + +'| RPGM | Loads only the parts of the state variable relevant to the currently installed RPGMaster Mods - including RoundMaster |
|---|---|
| ALL | Loads the whole state variable for all installed Mods (See Note below) |
| API-names | Loads the state variables for the named API/Mod(s). Additional names can be separated with pipes "|" (See note below). |
Note: Individual API / Mod names are case sensitive (except for RPGM API names, which are checked & corrected automatically). No guarantee is given for the validity or effect of loading non-RPGM API / Mod state variables. You should only load non-RPGM state variables to a copy of a campaign you are prepared to loose if the load does not work properly.
' +'!rounds --disptokenstatus [tokenID]' +'
Shows the statuses on the specified token to the DM using the same display format as used in the Turn Announcement.
' +'!rounds --dancer [INHAND/REBUILD]|tokenID|weapon|[plusChange]|[duration]'