Atom20

Add buttons to run your Roll20 character's macros and sync its attributes on Google Sheets. Works with virtually any TTRPG system!

Atom20 là gì?

Atom20 là một tiện ích mở rộng Chrome được phát triển bởi trekiros, và tính năng chính của nó là "Add buttons to run your Roll20 character's macros and sync its attributes on Google Sheets. Works with virtually any TTRPG system!".

Ảnh Chụp Màn Hình của Tiện Ích Mở Rộng

Tải xuống tệp CRX của tiện ích mở rộng Atom20

Tải xuống các tệp mở rộng Atom20 dưới định dạng crx, cài đặt các tiện ích mở rộng Chrome bằng tay trong trình duyệt hoặc chia sẻ các tệp crx với bạn bè để dễ dàng cài đặt các tiện ích mở rộng Chrome.

Hướng Dẫn Sử Dụng Tiện Ích Mở Rộng

                        This chrome extension adds buttons to your character sheet on Google Sheets, so you can roll macros and track your character's attributes in Roll20! This lets you play virtually any TTRPG system!

GLOSSARY
-Macros: a pre-determined text, which Atom20 will post to the Roll20 chat when you click a button on Google Sheets.
-Attributes: these are a set of values (a current value and a max value), identified by a name such as "hp", which can then be displayed on a token in Roll20.

SETUP
Atom20 does not do anything unless you A) have both Roll20 and Google Sheets open, and B) the Google Sheets spreadsheet has a sheet named "Atom20" in it.
This special sheet is used to tell the extension where to find your character's attributes, and which macros to set up on the sheet.
A working example can be found here: https://docs.google.com/spreadsheets/d/1lqRLrOac2209-_Yt1RwX2X4cwTO17hgfjYKZNIwn4Xk/edit?usp=sharing 
Start by copy-pasting the sheet named "Atom20" onto your own spreadsheet. Note that if the configuration sheet is hidden, the extension stops working until it is visible again.

1) Setting up which sheet to watch
At the top of the "Atom20" sheet, you will find two cells: "character sheet name" and "character name". 
The "character sheet name" cell tells the extension which sheets to watch. If you are currently on a sheet which is not being watched, the extension does not do anything. The extension cannot watch the sheet named "Atom20".
The "character name" cell tells the extension what name your character has on Roll20: this is the character whose attributes will be updated by the extension.

1b) Setting up more than one sheet to watch
If you wish for Atom20 to watch more than one sheet, for example if you intend to use the extension to build a bestiary with the stat blocks of many different types of enemies, you can use keywords in the "character sheet name" & "character name" cells:
In "character sheet name", you can whitelist or blacklist certain sheets, by using the keywords "include" or "exclude", followed by a colon, and then followed by the list of sheets which must be included or excluded from the watch, separated by commas. For example: "excludes:Index" will watch every sheet except the ones named "Index" and "Atom20".
In "character name", you can input a single asterisk ("*") in place of the character's name. If you do, the extension will look for a character on Roll20 whose name is the same as the name of the sheet that you are on at the moment.

2) Setting up attributes
The attributes table on the left tells the extension which cells to watch. Any change made in the cells will be reflected in your character's sheet on Roll20.
Note 1: the character sheet on Roll20 must have the attributes declared, or they cannot be updated.
Note 2: changes only go one way, and updating an attribute on Roll20 will not be reflected on Google Sheets.

3) Setting up macros
The macros table on the right tells the extension where to put buttons in your character sheet. If you click a cell which has been declared to be a macro, the corresponding text will be posted on Roll20's chat.
Note: if you set up Atom20 watch more than one sheet, you might want part of the macro's text to be set up on the watched sheet itself rather than on the "Atom20" sheet. This is possible through the use of string templates. For example, if a macro's text is "Hello, ${F12}", and the sheet being watched has "World" in cell F12, then the macro will post "Hello, World" on Roll20.

EXAMPLES
Below, you can find example use-cases for Atom20:
-Character sheet: https://docs.google.com/spreadsheets/d/1lqRLrOac2209-_Yt1RwX2X4cwTO17hgfjYKZNIwn4Xk/edit#gid=0
-Bestiary: https://docs.google.com/spreadsheets/d/1ARw_AZhM7qhN416YJpM3pCX5uUPS3CqWqS1RTu-AWfY/edit?usp=sharing

To use those examples, go to "File" => "Make a Copy". You will not be granted edit permission on the public-facing files.                    

Thông Tin Cơ Bản về Tiện Ích Mở Rộng

Tên Atom20 Atom20
ID bgnbdhlpicccdnhhpihcpccejngaionp
URL Chính Thức https://chromewebstore.google.com/detail/atom20/bgnbdhlpicccdnhhpihcpccejngaionp
Mô tả Add buttons to run your Roll20 character's macros and sync its attributes on Google Sheets. Works with virtually any TTRPG system!
Kích Thước Tệp 180 KB
Số Lần Cài Đặt 34
Phiên Bản Hiện Tại 1.1
Cập Nhật Lần Cuối 2024-02-13
Ngày Phát Hành 2021-10-10
Nhà Phát Triển trekiros
Email [email protected]
Loại Thanh Toán free
Trang Web Mở Rộng https://github.com/Trekiros/Atom20
URL Trang Trợ Giúp https://github.com/Trekiros/Atom20/issues
URL Trang Chính Sách Bảo Mật https://www.flarefall.com/privacy-policy
Ngôn Ngữ Được Hỗ Trợ en-US
manifest.json
{
    "update_url": "https:\/\/clients2.google.com\/service\/update2\/crx",
    "name": "Atom20",
    "version": "1.1",
    "description": "Add buttons to run your Roll20 character's macros and sync its attributes on Google Sheets. Works with virtually any TTRPG system!",
    "permissions": [
        "tabs",
        "identity"
    ],
    "host_permissions": [
        "https:\/\/app.roll20.net\/editor\/",
        "https:\/\/docs.google.com\/spreadsheets\/d\/*"
    ],
    "action": {
        "default_icon": {
            "16": "images\/icon\/icon16.png",
            "24": "images\/icon\/icon24.png",
            "32": "images\/icon\/icon32.png",
            "48": "images\/icon\/icon48.png",
            "64": "images\/icon\/icon64.png",
            "128": "images\/icon\/icon128.png",
            "256": "images\/icon\/icon256.png"
        }
    },
    "content_scripts": [
        {
            "js": [
                "chrome-content.js"
            ],
            "matches": [
                "https:\/\/docs.google.com\/spreadsheets\/d\/*",
                "https:\/\/app.roll20.net\/editor\/"
            ]
        }
    ],
    "background": {
        "service_worker": "chrome-background.js",
        "type": "module"
    },
    "web_accessible_resources": [
        {
            "resources": [
                "src\/*"
            ],
            "matches": [
                ""
            ]
        }
    ],
    "key": "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAif2PIq3ip14mXIwGUchBmY5TaUDrZp6X+c3zLOpK+GWQAPsl5eOAjNsJX6tbT2Y03COPvqUvM\/hZcA7tbipEg16lSJ2YchAZ9yuIj+acKs+IynE2RWLZRu5xmCN0SqhI0aQrnYJItQU9r+KzdXp8VPm+BRjdfAXRFAMSg4B9yog0bNafQOzo8Pi+Sv2Y0Qtt9rL5cBfZKGpZHONT+SYKMfwTIGf\/rInm1WYezlkZa2L1cmUUYNjXq5z0nQtjeEM0Ic+XBAGqsKw9uXTWrigramgb3uepDBIPsKnrnGMPLtgbFAe0kcpB8F3vx3tyKlg9j6A\/Xa0TL4W6cugXf3z+ZwIDAQAB",
    "oauth2": {
        "client_id": "642932630026-mt1ksqfrlgulc7hjlu8trci7ee8o65dj.apps.googleusercontent.com",
        "scopes": [
            "https:\/\/www.googleapis.com\/auth\/spreadsheets.readonly"
        ]
    },
    "manifest_version": 3
}