Character Vault
Any Concept / Any System
Your System Come To Life
Roll20 for Android
Streamlined for your Tablet
Roll20 for iPad
Streamlined for your Tablet

Personal tools

Dungeon Connect API

From Roll20 Wiki

Jump to: navigation, search


Dungeon Connect: "Line Segemtent" Map Making

Dungeon Connect emulates some common features found in drawing tools; such as creating line segments between “points” where the points can be moved or added to change the overall shape and dimensions of the drawing. This allows for a map making experience that is somewhat like drawing a map in an image editing program.

There are lots of limitations since we don’t have canvas select at this time; still Dungeon Connect is a flexible and forgiving API solution to map making on Roll20.

GM Layer

The Dungeon Connect API is designed so the map can be created and edit from the "GM layer." This reduces the need to switch between layer during the process of map creation.

Read more on layers here: Layers

Menu Overview

Dungeon Connect Menu.
Dungeon Connect Menu.
  1. Direct Placement of Doors/stairs: Indented line Will place a door/stair tile near the center of that map that can be moved and placed from the GM layer.
  2. Cancel Fill Area: Removes any "Paint Cans" used to fill map areas (saves selection-delete or useful if you have several flaoting around you want to dismiss.
  3. Fill Area: Creates a "Paint Can" used to fill map areas. "Paint Can" is created near the center of the map.
  4. Merge Points: Two selected "end points" segments will be merged into one. Menu button or "nudge rotation" triggered.
  5. Connect Points: Two selected "end points" segments will have a connection path add to join them. Menu button or "nudge rotation" triggered.
  6. Add Branch to a Point: A selected "end point" will have a branch segement added to it. Menu button or "nudge rotation" triggered.
  7. Add a Point to a Segement: A selected "middle marker" will be removed and replaced with an "end point." Splitting one segment into two. Menu button or "nudge rotation" triggered.
  8. Add A Segement: Adds a new segment near the center of the map.
  9. More Commands: Clicking provides more menu options or toggles back to the main menu.
  10. Toggle API "On" or "Off:" This turns off most of the API functions.
  11. Get Help: In game link to this Wiki page.
  12. Clear Map: Removes all "Dungeon Connect" generated images and paths.
  13. Change Texture: Allows for multiple tile packs to be used with the API script.

Split the Party & Player's Bookmark

Recommend using the party split feature to select the page you wish to edit.
Avoid this!! Easy mistake is you (GM) being a page different from your party split avatar.

This script leverages the "Split the Party" and "Player's Bookmark" to determine the active page for editing.

Its is prefered that controlling GM drag-and-drop the "Player Avatar" to the page they which to map with Dungeon Connect. All changes by the API will be applied to that page.

If the controlling GM has not done this, the Player's Bookmark will act as the active page.

Caution: Easy mistake is you (GM) being a page different from your party split avatar (notice the BLUE border.)

PageToolbar SplitThePartyExample.gif

See Page Toolbar for more information.