-"description": "# PinTool\\n\\nPinTool is a GM-only Roll20 API script for creating, inspecting, converting, and managing **map pins** at scale. It can convert older token-based note workflows into Roll20’s newer map pin system, allowing structured handouts and pins to stay in sync.\\n\\n---\\n\\n## Core Capabilities\\n\\n- Bulk modification of map pin properties.\\n- Precise targeting of selected pins, all pins on a page, or explicit pin IDs.\\n- Conversion of legacy token notes into structured handouts.\\n- Automatic placement of map pins from handout headers (player and GM).\\n- Optional chat display of images referenced in notes.\\n- **Pin Library (`--library`)** lets GMs Keep a library of pin styles for quick application.\\n\\n**Base Command:** `!pintool` opens a control panel for commonly used editing controls. Add primary commands afterward to access specific functions.\\n\\n`!pintool --help` creates a handout with full documentation.\\n\\n---\\n\\n## Primary Commands\\n\\n- `--set` — Update one or more properties across many pins at once.\\n- `--convert` — Extract data from tokens representing the same character and build or update a handout.\\n- `--place` — Create or replace pins based on handout headers, linking directly to those sections.\\n- `--purge` — Remove related tokens or pins in bulk.\\n- `--library` — Open the Pin Library to copy preset pin styles to selected pins.\\n- `--transform` — Apply transformations to pins, e.g., auto-generating icon text from titles.\\n- `--help` — Display the full PinTool help panel.\\n\\n---\\n\\n## Highlights\\n\\n- Pins created via `--place` link directly to specific headers in Notes or GM Notes.\\n- Existing pins are replaced in-place, preserving their positions.\\n- Conversion supports header levels, blockquotes, code blocks, and inline image links.\\n- Visibility, scale, links, and sync state can all be controlled programmatically.\\n- Pin customization modes allow you to quickly switch the pin image between icons, text icons, or images.\\n\\nDesigned for GMs who want more automated control over pin placement, appearance, and management.",
0 commit comments