{
    "name": "Eclipse Phase Alternate Companion Script",
    "script": "ep-script.js",
    "version": "1.0.2",
    "previousversions": ["1.0.1", "1.0.2"],
    "description": "Eclipse Phase 1E Companion Script\r\n=================================\r\n\r\nThis is a companion script to the [Eclipse Phase 1E sheet](https:\/\/github.com\/Bathtor\/EPSheet) for use with the API on [Roll20](http:\/\/roll20.net). The vast majority of its features will not work with any other sheet and no such support is planned\/considered.\r\n\r\n**Note**: If you are using this script with Roll20's 1-Click install, be aware that sometimes inconsistent updates between the sheet and the script can leave things not working, and you have little to no control over this (and neither have I, really). If you want a more reliable experience, install both sheet and script manually instead of using Roll20's automatic systems.\r\n\r\nContents\r\n--------\r\n<!-- run `doctoc README.md --maxlevel 4` to update this file -->\r\n<!-- START doctoc generated TOC please keep comment here to allow auto update -->\r\n<!-- DON'T EDIT THIS SECTION, INSTEAD RE-RUN doctoc TO UPDATE -->\r\n\r\n\r\n- [Command Overview](#command-overview)\r\n- [Installation](#installation)\r\n  - [Prerequisites](#prerequisites)\r\n  - [Installation](#installation-1)\r\n    - [EPCompendium](#epcompendium)\r\n    - [Updating](#updating)\r\n- [Command Descriptions](#command-descriptions)\r\n  - [Battle Manager](#battle-manager)\r\n    - [Usage](#usage)\r\n    - [Recommended Macros](#recommended-macros)\r\n  - [Character Cleaner](#character-cleaner)\r\n    - [Usage](#usage-1)\r\n    - [Recommended Macros](#recommended-macros-1)\r\n  - [Character Tools](#character-tools)\r\n    - [Usage](#usage-2)\r\n    - [Recommended Macros](#recommended-macros-2)\r\n  - [GM Tools](#gm-tools)\r\n    - [Usage](#usage-3)\r\n    - [Recommended Macros](#recommended-macros-3)\r\n  - [Group Rolls](#group-rolls)\r\n    - [Usage](#usage-4)\r\n    - [Recommended Macros](#recommended-macros-4)\r\n  - [Special Rolls](#special-rolls)\r\n    - [Usage](#usage-5)\r\n    - [Recommended Macros](#recommended-macros-5)\r\n  - [Token Setup](#token-setup)\r\n    - [Usage](#usage-6)\r\n    - [Recommended Macros](#recommended-macros-6)\r\n  - [Compendium](#compendium)\r\n    - [Usage](#usage-7)\r\n    - [Recommended Macros](#recommended-macros-7)\r\n\r\n<!-- END doctoc generated TOC please keep comment here to allow auto update -->\r\n\r\nCommand Overview\r\n----------------\r\nIn this section we give a quick overview over all available commands. They describe in detail in later individual sections.\r\n\r\n**Note**: You can always run `!<cmd> --help` in Roll20 chat to get a quick description of the options available for each `<cmd>`.\r\n\r\n\r\n- **Battle Manager** (`!epbattleman`) manages Action Turns and Action Phases based on character speed, as well as rerolls iniative for everyone at the beginning of a new turn automatically.\r\n- **Character Cleaner** (`!epclean`) resets or empties certain sections on the character sheet, in order to automate backups, or egocasts.\r\n- **Character Tools** (`!epchar`) applies damage, wounds, stress, and traumas automatically, taking armour into account as appropriate.\r\n- **GM Tools** (`!epgmtools`) can be configured to show skills for a whole party, in order to easily roll Perception checks, for example.\r\n- **Group Rolls** (`!epgroup-roll`) can be used to roll EP specific common rolls like *Fray\/2*, *Initiative*, or simply an arbitrary skill check, for a group of selected tokens.\r\n- **Special Rolls** (`!epspecialroll`) is a script that manages rolling common EP rolls, without involving a character sheet. Convenient for the improvising GM, who doesn't have an NPC ready to import, but still needs it to shoot something, for example.\r\n- **Token Setup** (`!eptoken`) generate token abilities for skills, *Fray\/2*, or *Initiative*.\r\n- **Compendium** manages data from the [Eclipse Phase Compendium](https:\/\/github.com\/Bathtor\/EPCompendium):\r\n\t- *Data* (`!epcompendium-data`) manages search, lookups, and display of compendium data to the chat.\r\n\t- *Export* (`!epcompendium-export`) can export custom morphs in a Compendium-compatible format, so they can be imported into other character sheets.\r\n\t- *Import* (`!epcompendium-import`) manages character, trait, morph, and item imports.\r\n\r\nInstallation\r\n------------\r\n\r\n### Prerequisites\r\n\r\n- You must be a **Pro** subscriber of Roll20 to use API scripts in general, and this script in particular.\r\n- You'll need a recent version of the [Eclipse Phase 1E sheet](https:\/\/github.com\/Bathtor\/EPSheet). I'll try to be clear in the documentation, which script version works with which sheet version, but generally the latest release of each should always work together. And if you picked the wrong versions, it should complain and not break anything.\r\n\r\n### Installation\r\n\r\n- Open the **raw** text of the latest release of the script. At the time of writing that is [v1.0.2](https:\/\/github.com\/Bathtor\/EPSheet\/releases\/download\/script-v1.0.2\/ep-script.js).\r\n- Copy *all* the text -- **Ctrl+A** followed by **Ctrl+C** (**Cmd+A**, **Cmd+C** on a Mac)\r\n- Go to the API Script page for your Roll20 campaign\r\n- Paste the text into a new script, or override an older version if updating. Don't forget to give it a sensible name, e.g. `epscript.js`!\r\n- Save the script\r\n- Leave the Roll20 API Script page open, and open up your campaign view in a different tab\/window. That should cause your sandbox to spin up. If no errors are reported, you should be good to go.\r\n\r\n#### EPCompendium\r\nIf you would like access to the EPCompendium-related features, you must also install the data script for the compendium. Follow the same procedure as above for the latest release of the EPCompendium, [v6.0.0](https:\/\/github.com\/Bathtor\/EPCompendium\/releases\/tag\/v6.0.0) at the time of writing. Each Compendium release also contains a number of macros prepared to use with the script that you can just c&p into your campaign.\r\n\r\n**Note** that there's a load time dependency between the compendium script and the companion script, so make sure that the compendium script's tab is to the right of the companion script's.\r\n\r\n#### Updating\r\nIf you need to update one of the script installed above, simply follow the same instructions as for a normal installation. Do make sure, that you always override old script versions, and never have two versions running in parallel!\r\n\r\nCommand Descriptions\r\n--------------------\r\n\r\n### Battle Manager\r\n**Command**: `!epbattleman`\r\n\r\nThe EP Battle Manager deals with EP's hierarchical combat timing structure based on *Action Turns* and *Action Phases* in Roll20's Turn Order mechanism. Each *Action Turn* begins by rolling iniative. Then every participant may take perform actions in the iniative order in the first *Action Phase*. For participants with `speed > 1` more *Action Phases* are added using the same initiative order, until no participant is left with `speed` greater than the current *Action Phase* number. Then the process starts over with rolling of new iniative and starting a new *Action Turn*.\r\n\r\n#### Usage\r\n1. Add tokens to the *Turn Order* in any manner you prefer.\r\n2. Run `!epbattleman --start` to inialise the Battle Manager. This will sort the *Turn Order* and create marker entries for *Action Phase* and *Action Turn* boundaries. These have the form `|Round x|Phase y|`. *From now on, do NOT use any of the Roll20 Turn Order functions anymore, as they will interfere the Battle Manager's state!*\r\n3. Proceed from character to character using `!epbattleman --next`. Characters without sufficient `speed` for the next *Action Phase* whill be dropped from the *Turn Order* as you go, but they are stored internally by the Battle Manager and will be added again at the beginning of the next *Action Turn*. At the beginning of the next *Action Turn* the Battle Manager will automatically roll new *Initiative* for all Tokens that have a Character Sheet associated with them.\r\n4. Once the battle is over, run `!epbattleman --end` to clear the Battle Manager's state. It will also tell you how long the battle took in realtime, as well as the number of rounds and phases.\r\n\r\nIf you need to **add** or **remove** charaters during an ongoing battle, you *must* use the the commands `!epbattleman --add` or `!epbattleman --drop` respectively. Using any other mechanism will pollute the Battle Managers internal state and you will see some strange behaviour.\r\n\r\nIf you accidentally use the normal `Next` button or manually add or remove tokens from an ongoing battle, the script will output a warning message to the chat. This warning message also contains a `reset` button, which you can use to invoke `!epbattleman --reset`, thereby undoing your inconsistency-introducing change.\r\n\r\n#### Recommended Macros\r\n\r\n- **BStart**: `!epbattleman --start`\r\n- **BNext**: `!epbattleman --next`\r\n- **BEnd**: `!epbattleman --end`\r\n- **BAdd**: `!epbattleman --add`\r\n- **BDrop**: `!epbattleman --drop`\r\n\r\n*In [Roll20 ES](https:\/\/github.com\/SSStormy\/roll20-enhancement-suite) Format*:\r\n```json\r\n{\r\n    \"schema_version\": 2,\r\n    \"macros\": [\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epbattleman --start\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"BStart\",\r\n                \"visibleto\": \"\"\r\n            },\r\n            \"macrobar\": {\r\n                \"color\": null,\r\n                \"name\": null\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epbattleman --next\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"BNext\",\r\n                \"visibleto\": \"\"\r\n            },\r\n            \"macrobar\": {\r\n                \"color\": null,\r\n                \"name\": null\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epbattleman --end\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"BEnd\",\r\n                \"visibleto\": \"\"\r\n            },\r\n            \"macrobar\": {\r\n                \"color\": null,\r\n                \"name\": null\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epbattleman --add\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"BAdd\",\r\n                \"visibleto\": \"\"\r\n            },\r\n            \"macrobar\": {\r\n                \"color\": null,\r\n                \"name\": null\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epbattleman --drop\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"BDrop\",\r\n                \"visibleto\": \"\"\r\n            },\r\n            \"macrobar\": {\r\n                \"color\": null,\r\n                \"name\": null\r\n            }\r\n        }\r\n    ]\r\n}\r\n```\r\n\r\n### Character Cleaner\r\n**Command**: `!epclean`\r\n\r\nThe Character Cleaner removes or resets sections of a Character Sheet that are not taken along during the **Egocast** or **Backup** procedure. This includes *Active Morph*, *Gear* (except *Software*), and *Armour* totals, as well as *Damage* and *Wounds*. *Egocast* and *Backup* behave similar in every way, except that during a backup the Character Sheet is renamed in order to differentiate it from the \"live\" sheet. You *should*, thus, run the *backup* command on a **copy** of the \"live\" sheet!\r\n\r\n#### Usage\r\n\r\n##### Egocast\r\n1. Select a token representing the *target* Character Sheet.\r\n2. Run `!epclean --egocast`.\r\n\r\n##### Backup\r\n1. Create a copy of the *target* Character Sheet.\r\n2. Drag the copy onto a map to get a token for it. *(Double check that the token actually points to the new sheet, not the old one!)*\r\n3. Select that token.\r\n4. Run `!epclean --backup`.\r\n5. Delete the token from the map and archive the backup sheet.\r\n\r\nOptionally, you can also change the **prefix** the *backup* commands adds to the sheet name. To do so, invoke the backup command like `!epclean --backup --prefix <some prefix>` instead.\r\n\r\nAs an alternative to using the UI for duplicating the sheet, the following API script (found on [Roll20 Forums](https:\/\/app.roll20.net\/forum\/post\/5687127\/duplicate-character-sheet-plus-linked-token-script\/?pageforid=5687407)) also works, and has the advantage that it properly relinks the token to the new sheet. Invoke it with `!dup-char-by-token`.\r\n```javascript\r\non('ready',()=>{\r\n    const simpleObj = (o)=>JSON.parse(JSON.stringify(o));\r\n    const getCleanImgsrc = (imgsrc) => {\r\n        let parts = imgsrc.match(\/(.*\\\/images\\\/.*)(thumb|med|original|max)([^?]*)(\\?[^?]+)?$\/);\r\n        if(parts) {\r\n            return parts[1]+'thumb'+parts[3]+(parts[4]?parts[4]:`?${Math.round(Math.random()*9999999)}`);\r\n        }\r\n        return;\r\n    };\r\n    const resetAttrs = {\"damage\": 0, \"wounds\": 0};\r\n    const duplicateCharacter = (o) => {\r\n        let c = simpleObj(o.character);\r\n        let oldCid = o.character.id;\r\n        delete c.id;\r\n        c.name=`(COPY) ${c.name}`;\r\n        c.avatar=getCleanImgsrc(c.avatar)||'';\r\n\r\n        let newC = createObj('character',c);\r\n        \r\n        _.each(findObjs({type:'attribute',characterid:oldCid}),(a)=>{\r\n            let sa = simpleObj(a);\r\n            delete sa.id;\r\n            delete sa._type;\r\n            delete sa._characterid;\r\n            sa.characterid = newC.id;\r\n            if (sa.name in resetAttrs) {\r\n                sa.current = resetAttrs[sa.name];\r\n            }\r\n            createObj('attribute',sa);\r\n        });\r\n        _.each(findObjs({type:'ability',characterid:oldCid}),(a)=>{\r\n            let sa = simpleObj(a);\r\n            delete sa.id;\r\n            delete sa._type;\r\n            delete sa._characterid;\r\n            sa.characterid = newC.id;\r\n            createObj('ability',sa);\r\n        });\r\n        let oldBar1 = o.token.get('bar1_link');\r\n        \/\/log(\"Bar1 \" + oldBar1);\r\n        let oldBar2 = o.token.get('bar2_link');\r\n        \/\/log(\"Bar2 \" + oldBar2);\r\n        let oldBar3 = o.token.get('bar3_link');\r\n        \/\/log(\"Bar3 \" + oldBar3);\r\n        let findNewAttr = (oldBar) => {\r\n            if (oldBar != undefined) {\r\n                if (oldBar.startsWith(\"sheetattr\")) {\r\n                    return oldBar; \/\/ somehow this works in Roll20\r\n                } else {\r\n                    let barAttr = getObj('attribute', oldBar);\r\n                    let name = barAttr.get('name');\r\n                    let r = findObjs({type: 'attribute', characterid: newC.id, name: name});\r\n                    if (r != undefined && r.length != 0) {\r\n                        let id = r[0].id;\r\n                        return id;\r\n                    } else {\r\n                        log(\"Could not find attribute \"+name+\" in char \" + newC.id);\r\n                        return undefined;\r\n                    }\r\n                }\r\n            } else {\r\n                log(\"Original attribute was undefined!\");\r\n                return undefined;\r\n            }\r\n        };\r\n        let newBar1 = findNewAttr(oldBar1);\r\n        let newBar2 = findNewAttr(oldBar2);\r\n        let newBar3 = findNewAttr(oldBar3);       \r\n        o.token.set('represents',newC.id);\r\n        o.token.set('bar1_link', newBar1);\r\n        o.token.set('bar2_link', newBar2);\r\n        o.token.set('bar3_link', newBar3);        \r\n        setDefaultTokenForCharacter(newC,o.token);\r\n        o.token.set('represents',oldCid);\r\n        o.token.set('bar1_link', oldBar1);\r\n        o.token.set('bar2_link', oldBar2);\r\n        o.token.set('bar3_link', oldBar3);\r\n    };\r\n\r\n    on('chat:message',(msg)=>{\r\n        if('api'===msg.type && playerIsGM(msg.playerid) && \/^!dup-char-by-token\\b\/.test(msg.content)){\r\n            if(msg.selected){\r\n                _.chain(msg.selected)\r\n                    .map((o)=>getObj('graphic',o._id))\r\n                    .reject(_.isUndefined)\r\n                    .map(o=>({token: o, character: getObj('character',o.get('represents'))}))\r\n                    .reject(o=>_.isUndefined(o.character))\r\n                    .tap(o=>{\r\n                        if(!o.length){\r\n                            sendChat('',`\/w gm <div style=\"color: #993333;font-weight:bold;\">Please select one or more tokens which represent characters.<\/div>`);\r\n                        } else {\r\n                            sendChat('',`\/w gm <div style=\"color: #993333;font-weight:bold;\">Duplicating: ${o.map((obj)=>obj.character.get('name')).join(', ')}<\/div>`);\r\n                        }\r\n                    })\r\n                    .each(duplicateCharacter);\r\n            } else {\r\n                sendChat('',`\/w gm <div style=\"color: #993333;font-weight:bold;\">Please select one or more tokens.<\/div>`);\r\n            }\r\n        }\r\n    });\r\n});\r\n```\r\n\r\n#### Recommended Macros\r\n\r\n- **Copy**: `!dup-char-by-token`\r\n- **Backup**: `!epclean --backup --prefix ?{Prefix}`\r\n- **Egocast**: `!epclean --egocast`\r\n\r\n*In [Roll20 ES](https:\/\/github.com\/SSStormy\/roll20-enhancement-suite) Format*:\r\n```json\r\n{\r\n    \"schema_version\": 2,\r\n    \"macros\": [\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!dup-char-by-token\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"Copy\",\r\n                \"visibleto\": \"\"\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epclean --backup --prefix ?{Prefix}\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"Backup\",\r\n                \"visibleto\": \"\"\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epclean --egocast\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"Egocast\",\r\n                \"visibleto\": \"\"\r\n            }\r\n        }\r\n    ]\r\n}\r\n```\r\n\r\n### Character Tools\r\n**Command**: `!epchar`\r\n\r\nThe Character Tools script deals with *Damage* (DV) and *Stress* (SV) application. It automaticaly applies wounds and traumas, and reduces DV by armour taking *Armour Penetration* (AP) into account. It also outputs information on whether or not a character needs to roll to resist knockdown or unconsciouness, if the morph is bleeding out, if new derangements are acquired, and so on.\r\n\r\n#### Usage\r\n\r\n##### Damage\r\n1. Select the token you want to apply damage to.\r\n2. Determine DV (`<DV>`), applicable armour if any (`<Armour>` from *Kinetic*, *Energy*, *Untyped*, e.g. Psi Damage, *None*, e.g. a critical success), and AP if any (`<AP>`).\r\n3. Run `!epchar --damage <DV> --armour <Armour> --ap <AP>` or, if you want only the GM to see the output, `!epchar --damage <DV> --armour <Armour> --ap <AP> --output GM`, replacing the variables as determined in step 2.\r\n4. Sometimes the response of the script will tell you to roll something else, based on the result of damage application. In that case you should do so, by clicking the provided roll-button.\r\n\r\n##### Stress\r\n1. Select the token you want to apply stress to.\r\n2. Determine SV (`<SV>`).\r\n3. Run `!epchar --stress <SV>` or, if you want only the GM to see the output, `!epchar --stress <SV> --output GM`, replacing the variables as determined in step 2.\r\n4. Sometimes the response of the script will tell you to pick new derangements or upgrade existing ones, as well as roll something else, all which you should do.\r\n\r\n#### Recommended Macros\r\n\r\n- **DV**: `!epchar --damage ?{DV} --armour ?{Apply Armour|None|Energy|Kinetic|Untyped} --ap ?{AP|0}`\r\n- **GMDV**: `!epchar --damage ?{DV} --armour ?{Apply Armour|None|Energy|Kinetic|Untyped}  --ap ?{AP|0} --output GM`\r\n- **SV**: `!epchar --stress ?{SV}`\r\n\r\n*In [Roll20 ES](https:\/\/github.com\/SSStormy\/roll20-enhancement-suite) Format*:\r\n```json\r\n{\r\n    \"schema_version\": 2,\r\n    \"macros\": [\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epchar --damage ?{DV} --armour ?{Apply Armour|None|Energy|Kinetic|Untyped} --ap ?{AP|0}\",\r\n                \"istokenaction\": true,\r\n                \"name\": \"DV\",\r\n                \"visibleto\": \"all\"\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epchar --stress ?{SV}\",\r\n                \"istokenaction\": true,\r\n                \"name\": \"SV\",\r\n                \"visibleto\": \"all\"\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epchar --damage ?{DV} --armour ?{Apply Armour|None|Energy|Kinetic|Untyped}  --ap ?{AP|0} --output GM\",\r\n                \"istokenaction\": true,\r\n                \"name\": \"GMDV\",\r\n                \"visibleto\": \"\"\r\n            }\r\n        }\r\n    ]\r\n}\r\n```\r\n\r\n### GM Tools\r\n**Command**: `!epgmtools`\r\n\r\nA very simple command that collects information about skill values of a set of characters and sends them to the GM in sorted order. While in more static games like D&D simple bookkeeping would be sufficient to keep track of common skills like Perception, in EP those values are affected by traumas and wounds. Thus is can be convenient to get a quick snapshot of the state of your party with respect to certain skills. Particularly Perception and Kinesics are good candidates for this as they could be used in a \"passive\" manner without the players necessarily knowing about a failed check.\r\n\r\n#### Usage\r\n\r\n##### On Tokens\r\n1. Select all relevant tokens (e.g., all player tokens).\r\n2. Run `!epgmtools --best-mod --skill-name <SkillName>`, replacing `<SkillName>` with `Perception` or `Kinesics, for example.`\r\n\r\n##### By Name\r\nSee macro below.\r\nYou can also specify character ids instead of names as trailing arguments, but it's not quite as convenient, perhaps.\r\n\r\n#### Recommended Macros\r\n\r\n- **CharSkill**: `!epgmtools --best-mod --skill-name ?{Skill Name|Perception|Kinesics}` and append one instance of `--char-name <CharName>` for each player character in your group with name `<CharName>`\r\n\r\n### Group Rolls\r\n**Command**: `!epgroup-roll`\r\n\r\nThe Group Rolls scripts enables rolling basic EP rolls like *Fray\/2* or *Initiative*, as well as arbitrary *Active Skills*, for a group of selected token. For all rolls, a modifier to the roll must also be specified.\r\n\r\n#### Usage\r\n\r\n##### Fray\/2\r\n1. Select all relevant tokens.\r\n2. Run `!epgmtools --fray-halved --mod <Mod>`, with `<Mod>` the GM's modifier on the roll.\r\n\r\n##### Skill\r\n1. Select all relevant tokens.\r\n2. Run `!epgmtools --skill <SkillName> --mod <Mod>`, with `<SkillName>` the name of the skill to roll, `<Mod>` the GM's modifier on the roll.\r\n\r\n##### Initiative\r\n1. Select all relevant tokens.\r\n2. Run `!epgmtools --ini`.\r\n\r\nRolled results go to the tracker automatically.\r\n\r\n\r\n#### Recommended Macros\r\n\r\n- **GroupIni**: `!epgroup-roll --ini`\r\n- **GroupFray\/2**: `!epgroup-roll --fray-halved --mod ?{Mod|0}`\r\n- **GroupSkill**: `!epgroup-roll --skill ?{Skill|Fray} --mod ?{Mod|0}`\r\n\r\n*In [Roll20 ES](https:\/\/github.com\/SSStormy\/roll20-enhancement-suite) Format*:\r\n```json\r\n{\r\n    \"schema_version\": 2,\r\n    \"macros\": [\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epgroup-roll --ini\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"GroupIni\",\r\n                \"visibleto\": \"\"\r\n            },\r\n            \"macrobar\": {\r\n                \"color\": null,\r\n                \"name\": null\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epgroup-roll --fray-halved --mod ?{Mod|0}\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"GroupFray\/2\",\r\n                \"visibleto\": \"\"\r\n            },\r\n            \"macrobar\": {\r\n                \"color\": null,\r\n                \"name\": null\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epgroup-roll --skill ?{Skill|Fray} --mod ?{Mod|0}\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"GroupSkill\",\r\n                \"visibleto\": \"\"\r\n            },\r\n            \"macrobar\": {\r\n                \"color\": null,\r\n                \"name\": null\r\n            }\r\n        }\r\n    ]\r\n}\r\n```\r\n\r\n### Special Rolls\r\n**Command**: `!epspecialroll`\r\n\r\nThe Special Rolls script allows EP *Success* or *Damage* rolls, without involving a character sheet. While this is mostly meant for being used via buttons generated from *EPCompendium* output, one could also create macros for custom weapons or custom rolls, for example.\r\n\r\n#### Usage\r\n\r\n##### Success\r\nThe Success template has the form\r\n```text\r\n<Character>\r\n-----------\r\n<Label>\r\n    <SubLabel>\r\n1d100 vs <Target>\r\n[Result]\r\n```\r\n\r\nTo generate a Success template from the Special Rolls script, run `!epspecialrolls --success --target <Target>`, picking `<Target>` to be the target number including any modifiers.\r\n\r\nWhile `<Character>` is always \"API\" when generated from this script, you may specify both `--label <Label>` and `--sublabel <SubLabel>` arbitrarily when invoking it. If no values are given, the subtitle will read \"Success Roll\".\r\n\r\n\r\n##### Damage\r\nThe Damage template has the form\r\n```text\r\n<Character>\r\n-----------\r\n<Label>\r\n    <SubLabel>\r\nInflicts: [DmgFormula] DV <DamageType>\r\n<AP> AP or ignore if critical success\r\n```\r\nwhere `[DamageFormula]` is `<DamageDice>d10\/<DamageDiv> + DamageConst`.\r\n\r\nTo generate a Damage template from the Special Rolls script, run `!epspecialrolls --damage --damage-dice <DamageDice> --damage-div <DamageDiv> --damage-const <DamageConst> --damage-type <DamageType> --ap <AP>`. The allowed values for `<DamageType>` are \"Kinetic\" and \"Energy\", and it will default to \"Unspecified\". `<AP>` simply takes the *Armour Penetration* value as expected.\r\n\r\nSimilar to above, while `<Character>` is always \"API\" when generated from this script, you may specify `--label <Label>` arbitrarily when invoking it. If no values are given, the subtitle will read \"Damage Roll\". Values for `--sublabel` are ignored in the Damage variant.\r\n\r\n#### Recommended Macros\r\nNone, just use the *EPCompendium* buttons.\r\n\r\n\r\n### Token Setup\r\n**Command**: `!eptoken`\r\n\r\nThe Token Setup script manages EP-related token abilities. It can generate these abilities for *Initiative*, *Fray\/2*, and any skill.\r\nIt can also be used to clear the existing token abilities.\r\n\r\n#### Usage\r\n\r\n##### Setup\r\n1. Select all relevant tokens.\r\n2. Run `!eptoken --ini`, to add an *Initiative* token ability.\r\nOr run `!eptoken --fray`, to add an *Fray* token ability.\r\nOr run `!eptoken --fray-halved`, to add an *Fray\/2* token ability.\r\nOr run `!eptoken --skill <SkillName>`, to add an `<SkillName>` token ability.\r\nOr run a combination of the above, for example `!eptoken --ini --fray`.\r\n\r\nNormally, the script does not override existing token abilities. This behaviour can be changed by specifiying `--force`.\r\n\r\n##### Cleanup\r\n1. Select all relevant tokens.\r\n2. Run `!eptoken --clear`, to delete all token abilities.\r\n\r\n#### Recommended Macros\r\n\r\n- **TokenActions**: `!eptoken --fray --fray-halved --ini`\r\n- **TokenSkill**: `!eptoken --skill ?{Skill|Perception}`\r\n\r\nIf you are using *The Aaron*'s [TokenMod](https:\/\/github.com\/shdwjk\/Roll20API\/blob\/master\/TokenMod\/TokenMod.js) script (as you should ;), I also recommend\r\n**TokenSetup**: `!token-mod --on showname --set bar1_link|death_rating bar2_link|wounds bar3_link|damage`\r\n\r\n*Note that in EP you should always link tokens to sheets, as otherwise you can't keep track of wounds and traumas, which affect subsequent rolls.*\r\n\r\n*In [Roll20 ES](https:\/\/github.com\/SSStormy\/roll20-enhancement-suite) Format*:\r\n```json\r\n{\r\n    \"schema_version\": 2,\r\n    \"macros\": [\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!eptoken --fray --fray-halved --ini\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"TokenActions\",\r\n                \"visibleto\": \"\"\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!token-mod --on showname --set bar1_link|death_rating bar2_link|wounds bar3_link|damage\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"TokenSetup\",\r\n                \"visibleto\": \"\"\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!eptoken --skill ?{Skill|Perception}\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"TokenSkill\",\r\n                \"visibleto\": \"all\"\r\n            }\r\n        }\r\n    ]\r\n}\r\n```\r\n\r\n### Compendium\r\n**Commands**: `!epcompendium-data`, `!epcompendium-export`, `!epcompendium-import`\r\n\r\nThe three Compendium scripts handle the [Eclipse Phase Compendium](https:\/\/github.com\/Bathtor\/EPCompendium) data (formats). For them to be of any use you must have some compendium data installed. Follow the instructions in the [Installation](#installation) section for the official data and\/or feel free to add your own, for example by forking the compendium and generating your own data files.\r\n\r\nThe Data and Import script are typically used together, to first find some item in the compendium and then either simply display information about it, or import it into a character sheet.\r\n\r\nThe Export script doesn't interact with the compendium itself much, but uses the same data format. It can be used to export an item (currently only morphs) from a character sheet into a textual representation. The text always gets put into the **API Text Exchange** field on the **Options** tab in the Character sheet. *Note* that this field is only visible if the *Use API Script?* option under **Sheet Settings** is checked. There are two primary uses for this export feature. One is to simply move a custom item from one character to another. The other is use it to enrich the compendium with custom items for a campaign without having to go through the [Eclipse Phase Compendium](https:\/\/github.com\/Bathtor\/EPCompendium) code itself.\r\n\r\n#### Usage\r\n\r\n##### Search\r\nSay you are looking for an item where you vaguely know the name contains `<NAME>`, for example every pistol contains the term `Pistol`. To get a listing in the chat of all these items, ranked by \"match quality\", run:\r\n```text\r\n!epcompendium-data --search <NAME> --name-only --rank\r\n```\r\n\r\nIf you want to search only a single category, for example *weapons*, replace `--search` with the name of the category, e.g. `--weapons Pistol`. Within a category you can also ask for a random entry via `*`, e.g. `--weapons *` will return a random weapon.\r\n\r\nWhenever you use the `--name-only` option, the output will be a list of item names followed by two symbols: Clicking on the `?` will pull up detailed info about the item (the same info you would get without the `--name-only` option). Clicking on the `\u293A` will import the item into the character sheets of all currently selected tokens. The import option is also available on the detailed view.\r\n\r\n##### Multi-Search\r\nYou can also search for more than one item at a time, and produce a list of best matches. To so for search terms `<TERM1>`, `<TERM2>`, `<TERM3>` run:\r\n```text\r\n!epcompendium-data --multi-search -- <TERM1>,<TERM2>,<TERM3>`\r\n```\r\nThe output will have the format `<TERM> -> <BEST RESULT>`, if at least one result was found.\r\nThis feature is used by the EP Sheet to create a quick list of morph *Enhancements*, for example.\r\n\r\n##### Import\r\nThere are multiple ways to import data into character sheets associated with selected tokens. The basic command is something like:\r\n```text\r\n!epcompendium-import --<CATEGORY> <EXACT NAME>\r\n```\r\nSince typing this out for every item would be pretty error prone and tedious, the following alternative methods are recommended instead:\r\n\r\n1. Use the import (`\u293A`) buttons on search output as described above.\r\n2. Use the macros generated with every [EP Compendium Release](https:\/\/github.com\/Bathtor\/EPCompendium\/releases).\r\n3. To import a custom item from the **API Text Exchange** field use `!epcompendium-import --from-sheet` instead. You don't have to specify the item category in this case, as the format used for this is self-describing. This, however, also means that you can't simply c&p things between the Compendium Script and the **API Text Exchange** field. However, the export and import formats match.\r\n\r\n##### Export\r\nCurrently, the script only supports exporting the currently active morph instance.\r\n\r\n1. Select all relevant tokens. (They must have an active morph!)\r\n2. Run `!epcompendium-export --morph`.\r\n3. Go to the **API Text Exchange** field on the **Options** tab in the Character sheet and c&p the text there to where you need it, e.g. another sheet where you want to import this morph model.\r\n\r\n#### Recommended Macros\r\n\r\n- **Search**: `!epcompendium-data --search ?{Search for} --name-only --rank`\r\n- **SheetImport**: `!epcompendium-import --from-sheet`\r\n- **SheetExport**: `!epcompendium-export --morph`\r\n- **RandomDerangement**: `!epcompendium-import --derangement * --duration [[floor(1d10\/2)]]`\r\n\r\nPlus all the macros generated for each [EP Compendium Release](https:\/\/github.com\/Bathtor\/EPCompendium\/releases).\r\n\r\n*In [Roll20 ES](https:\/\/github.com\/SSStormy\/roll20-enhancement-suite) Format*:\r\n```json\r\n{\r\n    \"schema_version\": 2,\r\n    \"macros\": [\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epcompendium-data --search ?{Search for} --name-only --rank\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"Search\",\r\n                \"visibleto\": \"all\"\r\n            },\r\n            \"macrobar\": {\r\n                \"color\": null,\r\n                \"name\": null\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epcompendium-import --from-sheet\",\r\n                \"istokenaction\": true,\r\n                \"name\": \"SheetImport\",\r\n                \"visibleto\": \"all\"\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epcompendium-import --derangement * --duration [[floor(1d10\/2)]]\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"RandomDerangement\",\r\n                \"visibleto\": \"\"\r\n            }\r\n        },\r\n        {\r\n            \"attributes\": {\r\n                \"action\": \"!epcompendium-export --morph\",\r\n                \"istokenaction\": false,\r\n                \"name\": \"SheetExport\",\r\n                \"visibleto\": \"\"\r\n            }\r\n        }\r\n    ]\r\n}\r\n```\r\n",
    "authors": "Lars Kroll (Lars K. on Roll20)",
    "roll20userid": "726160",
    "useroptions": [],
    "dependencies": [],
    "modifies": {
        "token.*": "read,write",
        "character.*": "read,write",
        "attribute.*": "read,write"
    },
    "conflicts": []
}