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)
(tagged as "discontinued API")
 
(One intermediate revision by one user not shown)
Line 4: Line 4:
 
|version=1.0
 
|version=1.0
 
|lastmodified=2016-03-01}}
 
|lastmodified=2016-03-01}}
{{stub}}
 
 
  
 
===Overview===
 
===Overview===
  
 
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]
  
 
===Commands===
 
===Commands===
Line 48: Line 46:
 
===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 12:56, 17 June 2020

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

Contents

[edit] Overview

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

[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