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

Personal tools

Difference between revisions of "Script:Dungeon Utils"

From Roll20 Wiki

Jump to: navigation, search
(Overview)
(warn it's outdated)
 
(2 intermediate revisions by 2 users not shown)
Line 4: Line 4:
 
|version=1.0
 
|version=1.0
 
|lastmodified=2016-03-01}}
 
|lastmodified=2016-03-01}}
{{stub}}
 
 
  
 
===Overview===
 
===Overview===
 +
{{notebox| See '''[[API:Script Index]]''' for currently available APIs, this one have been removed from the API Library}}
  
 
This script contains useful commands for quickly editing dungeons.
 
This script contains useful commands for quickly editing dungeons.
[[File:Https://s3.amazonaws.com/files.d20.io/images/16792831/AlcmRHXC8MeZczjnRCTYLA/med.png?1456883454]]
+
[https://s3.amazonaws.com/files.d20.io/images/16792831/AlcmRHXC8MeZczjnRCTYLA/med.png?1456883454 Https://s3.amazonaws.com/files.d20.io/images/16792831/AlcmRHXC8MeZczjnRCTYLA/med.png?1456883454]
  
 +
__TOC__
 
===Commands===
 
===Commands===
  
Line 48: Line 48:
 
===Changelog===
 
===Changelog===
 
{{changelog version|1.0|2016-03-01|* Release}}
 
{{changelog version|1.0|2016-03-01|* Release}}
 +
[[Category:Discontinued API Scripts]]

Latest revision as of 19:37, 20 September 2021

API ScriptAuthor: Alex B.
Version: 1.0
Last Modified: 2016-03-01
Code: DungeonUtils
Dependencies: None
Conflicts: None

[edit] Overview


This script contains useful commands for quickly editing dungeons. Https://s3.amazonaws.com/files.d20.io/images/16792831/AlcmRHXC8MeZczjnRCTYLA/med.png?1456883454

Contents

[edit] Commands

!du paper [<floor=thumbnail-path>] [<stride=Number>]
Covers the map/background layer of the current player-active page with the given image.
!du dungeon [<wall=thumbnail-path>] [<floor=thumbnail-path>] [<stride=Number>]
Randomly generates a dungeon on the map/background layer of the current player-active page. Includes dynamic lighting
!du clear
Deletes all dynamic lighting and all images added by this plugin

[edit] Usage

[edit] Configuration

Configuration is not required to use this module. However, setting default images can make things quicker. Refer to the comments at the top of the code for how to configure the 4 default variables.

[edit] Using images

If the script requires an image, it needs the URL of a thumbnail. To get this, first find an image in the Marketplace and favorite it. Then, find the image in your Art Library, right-click the image and select "Copy image address." This URL can be pasted into commands. (Note: If you do not get the URL from your Art Library, it will not work).

[edit] Examples

[edit] Grass Paper!

  1. Move the "Players" ribbon to an empty page
  2. Get an image URL from your Art Library
  3. Type the following command into the game chat:
    !du paper f=URL s=WIDTH
    Replace URL with a Roll20 thumbnail, and replace WIDTH with the width of the image in tiles. E.g.:
    !du paper f=https://s3.amazonaws.com/files.d20.io/images/7186/thumb.jpg?1336392023 s=3

[edit] Random Dungeon Generation

  1. Move the "Players" ribbon to an empty page
  2. Enter the following command:
    !du dungeon f=URL w=URL s=WIDTH
    where f is a floor image from your Art Library and and w is your wall image. This may take a while; very large maps are not recommended.
  3. (Optional) Enable dynamic lighting

[edit] Backlog

  • Add a feature for replacing images with other images
  • Make a more efficient dungeon generation algorithm

[edit] Changelog

v1.0 (2016-03-01)

  • Release