Atom20

简介:

添加按钮来运行 Roll20 角色的宏并在 Google 表格上同步其属性。几乎适用于任何 TTRPG 系统！

此 Chrome 扩展程序将按钮添加到 Google Sheets 上的角色表中，因此您可以滚动宏并在 Roll20 中跟踪角色的属性！这几乎可以让你玩任何 TTRPG 系统！

词汇表
-宏：p确定的文本，当您单击Google表格上的按钮时，Atom20会将其发布到Roll20聊天中。
-属性：这些是一组值（当前值和最大值），由诸如“hp”之类的名称标识，然后可以显示在 Roll20 中的令牌上。

设置
Atom20 不会执行任何操作，除非您 A) 同时打开 Roll20 和 Google Sheets，并且 B) Google Sheets padsheet 中有一个名为“Atom20”的工作表。
这个特殊的工作表用于告诉扩展程序在哪里可以找到角色的属性，以及在工作表上设置哪些宏。
可以在这里找到一个工作示例：https://docs.google.com/spadsheets/d/1lqRLrOac2209-_Yt1RwX2X4cwTO17hgfjYKZNIwn4Xk/edit?usp=sharing
首先将名为“Atom20”的工作表复制粘贴到您自己的填充表上。请注意，如果配置表被隐藏，扩展程序将停止工作，直到它再次可见。

1) 设置要观看的表
在“Atom20”工作表的顶部，您会发现两个单元格：“字符表名称”和“字符名称”。
“字符表名称”单元格告诉扩展程序要观看哪些表。如果您当前所在的工作表未被观看，则扩展程序不会执行任何操作。该扩展程序无法查看名为“Atom20”的工作表。
“角色名称”单元格告诉扩展程序您的角色在 Roll20 上的名称：这是其属性将由扩展程序更新的角色。

1b) 设置多个观看表
如果您希望 Atom20 观看多张表，例如您打算使用该扩展来构建包含许多不同类型敌人的统计块的动物寓言，您可以在“角色表名称”和“角色表名称”中使用关键字名称”单元格：
在“字符表名称”中，您可以使用关键字“包括”或“排除”将某些表列入白名单或黑名单，后跟冒号，然后是必须包含在手表中或从手表中排除的表列表，被逗号隔开。例如：“excludes:Index”将监视除名为“Index”和“Atom20”的工作表之外的所有工作表。
在“角色名称”中，您可以输入一个星号（“*”）来代替角色的名称。如果这样做，扩展程序将在 Roll20 上查找名称与您当前所在工作表名称相同的字符。

2）设置属性
左侧的属性表告诉扩展程序要监视哪些单元格。单元格中所做的任何更改都将反映在 Roll20 上的角色表中。
注1：Roll20上的角色表必须声明属性，否则无法更新。
注意 2：更改仅以一种方式进行，并且更新 Roll20 上的属性不会反映在 Google 表格上。

3) 设置宏
右侧的宏表告诉扩展程序将按钮放置在字符表中的位置。如果您单击已声明为宏的单元格，相应的文本将发布在 Roll20 的聊天中。
注意：如果您设置 Atom20 监视多个工作表，您可能希望将部分宏文本设置在监视工作表本身而不是“Atom20”工作表上。这可以通过使用字符串模板来实现。例如，如果宏的文本是“Hello, ${F12}”，并且正在观看的工作表在单元格 F12 中有“World”，则该宏将在 Roll20 上发布“Hello, World”。

例子
您可以在下面找到 Atom20 的示例用例：
-字符表：https://docs.google.com/spadsheets/d/1lqRLrOac2209-_Yt1RwX2X4cwTO17hgfjYKZNIwn4Xk/edit#gid=0
- 寓言：https://docs.google.com/spadsheets/d/1ARw_AZhM7qhN416YJpM3pCX5uUPS3CqWqS1RTu-AWfY/edit?usp=sharing

要使用这些示例，请转到“文件”=>“制作副本”。您不会被授予对面向公众的文件的编辑权限。