Lib:Elevation 1.0rc-1

Lib:Elevation 1.0rc-1 requires MapTool 1.11.0+!

Highlights of this release: Bugfixes and MapTool 1.12+ Compatibility!

Add Elevation to your MapTool encounters! This release candidate gives you tools to add key elevations to your maps, simulating vertical environments in MapTool. Use for flying effects or and multi-level maps. Check out the built-in user guide, read it online at the RPTools Wiki page, or watch an Introductory YouTube video.

Lib:Elevation has no dependencies. To best demonstrate the features, the demo campaign includes additional libraries that are not at all needed. Lib:SimpleDoors is good to go for your games, be aware that Lib:EventTokens conflicts with Bag of Tricks and other libraries which use the onTokenMove event.

To get the most out of the library, first try the demo campaign and poke around. Use the overlay to add, change, and edit elevations. The GM panel macros can also change map and token elevations on the sample maps. Experiment with creating new maps of your own. As mentioned, the demo campaign's additional libraries are purely for either development assistance or to help showcase the Elevation library - they are entirely separate libraries not needed to use Lib:Elevation.

Once you are ready to use this on your own campaign, you should add a few things to get the most out of this library:

• Add States:
  • A GM-Only isElevationToken state. Make it a GM-only state that shades the token in ~25% opaque bright blue, I recommend making it only appear on mouseover.
  • Public isAbove and isBelow states. I like to use the Triangle (up arrow) and Yield (down arrow) grid shapes.
• Add the Elevation property to your campaign. I like to make it visible on the stat sheet (this is a default property in new campaigns).
• The overlay has most everything you need, but you can optionally drag (or export/import) the GM macro sets into your GM panel. Read the tooltips, they are very informative!

Note that by default, fog of war cleared on one level will clear it for all levels. This isn't good for indoor maps - for indoor maps, use the 'Map Options' dialog to enable the Fog Hack and set the fadedSightType to 1 (turns of sight for tokens at other elevations) or a custom sight type such as 'Blind' to switch those tokens to when not on the current elevation.

To update from beta versions, simply delete the library and import the new version. No campaign-specific data is saved on the library itself. The overlay should detect a new version and shut down, prompting you to reload the campaign or run onCampaignLoad to refresh the library.

Changes in 1.0rc-1

After a nearly a year and a half off, Lib:Elevation has received some vital updates to function properly on MapTool 1.12! While mostly a bugfix release, I have added some new convenience features to accommodate other UI that might occupy the lower-right of the screen and allow off-canvas moves of elevation linked tokens. While this won't help most players, an intrepid GM can design some cool effects by grouping off-canvas tokens with macros - think multi-elevation vehicles like ships or mechs!

• New Feature: New overlayMarginLR_GM and overlayMarginLR_PC campaign-level options let you optionally set a right-hand margin for the lower-right UI controls form GMs or Players respectively. Closes #20.
• New Feature: New relativeLinkedPositioning option allows you to move elevation-linked tokens and the relative change in position will be preserved. Defaults to 0, which is current behavior - X/Y is saved on linked tokens and reloaded for safety. Closes #23.
• Improvement: For clarity, the 'Map Options' button label changes to 'Lib Defaults' when on the map containing Lib:Elevation, and new campaign-level options can only be set on this map.
• Bugfix: Updated loadElevationLayer macro for MapTool 1.12.0 compatibility. Fixes #22.
• Bugfix: Updated setMapOption macro for MapTool 1.12.0 compatibility. Fixes #18 and #19.
• Bugfix: Updated getElevationLayers and chooseElevation macros to improve negative elevation listing. The functions now use json.sort to work around RPTools/maptool#3878. Fixes #17.
• Bugfix: Updated addElevationDialog to use the updated JavaScript functions, restoring the ability to create new elevations without blocking layers. Fixes #21.
• Tweak: Slight updates to the user guide to reflect macro changes and improve copy.
• Tweak: Changed useInitiativeEvent option to a checkbox from a text field.
• Tweak: Updated option dialog copy slightly to remove unneccesary punctuation before added colons.

Lib:Elevation 1.0b8

Lib:Elevation 1.0b8 requires MapTool 1.11.0+!

Highlights of this release: Added Pit/Hill VBL and Dynamic Theme Colors!

Add Elevation to your MapTool encounters! This beta release gives you tools to add key elevations to your maps, simulating vertical environments in MapTool. Use for flying effects or and multi-level maps. Check out the built-in user guide, read it online at the RPTools Wiki page, or watch an Introductory YouTube video.

Lib:Elevation has no dependencies. To best demonstrate the features, the demo campaign includes additional libraries that are not at all needed. Lib:SimpleDoors is good to go for your games, be aware that Lib:EventTokens conflicts with Bag of Tricks and other libraries which use the onTokenMove event.

To get the most out of the library, first try the demo campaign and poke around. Use the overlay to add, change, and edit elevations. The GM panel macros can also change map and token elevations on the sample maps. Experiment with creating new maps of your own. As mentioned, the demo campaign's additional libraries are purely for either development assistance or to help showcase the Elevation library - they are entirely separate libraries not needed to use Lib:Elevation.

Once you are ready to use this on your own campaign, you should add a few things to get the most out of this library:

• Add States:
  • A GM-Only isElevationToken state. Make it a GM-only state that shades the token in ~25% opaque bright blue, I recommend making it only appear on mouseover.
  • Public isAbove and isBelow states. I like to use the Triangle (up arrow) and Yield (down arrow) grid shapes.
• Add the Elevation property to your campaign. I like to make it visible on the stat sheet (this is a default property in new campaigns).
• The overlay has most everything you need, but you can optionally drag (or export/import) the GM macro sets into your GM panel. Read the tooltips, they are very informative!

Note that by default, fog of war cleared on one level will clear it for all levels. This isn't good for indoor maps - for indoor maps, use the 'Map Options' dialog to enable the Fog Hack and set the fadedSightType to 1 (turns of sight for tokens at other elevations) or a custom sight type such as 'Blind' to switch those tokens to when not on the current elevation.

To update from prior beta versions, simply delete the library and import the new version. No campaign-specific data is saved on the library itself. The overlay should detect a new version and shut down, prompting you to reload the campaign or run onCampaignLoad to refresh the library.

Changes in 1.0b8

This release supports new VBL types and theme color features included in MapTool 1.11.0. There are also significant improvements to linking, unlinking tokens to and from elevations and quality of life improvements to how selected token data is displayed in the lower-right info area.

• New Feature: Added support for Pit and Hill visual blocking layers, which were added in MapTool 1.11.0.
• New Feature: The user interface overlay now draws colors based on the current MapTool theme thanks to the new getInfo("theme") feature added in MapTool 1.11.0.
• Improvement: When multiple tokens are selected, the token info (second) line of the info overlay now shows a list of elevations the tokens are on and the number of tokens instead of only the 'first' selected token.
• Improvement: When any elevation linked tokens are selected, the additional data (top) line of the info overlay now shows a list of any linked elevations in the selected. Note that this list contains all linked elevations for any elevation token in the whole selection, so be aware when selecting multiple tokens that you won't know if all or some of the selected tokens are linked to a listed elevation.
• Improvement: Elevation tokens no longer have their states recalculated on every elevation load to save on performance and reduce errors.
• Improvement: Elevation user interface overlay now attempts to detect a version mismatch when updating and shuts itself off with an alert in chat.
• Bugfix: Fixed a regression where map names which are numbers or include certain characters such as ' and $ were not loading elevation features. This also was causing an error where elevations for tokens were sometimes being incorrectly reset.
• Bugfix: Linking and unlinking elevation tokens should now correctly update the token's appearance and state without having to refresh the elevation.
• Bugfix: Height factors with an absolute value less than 1 now default to 2. This replaces regressed functionality where the default value use to be 2.
• Tweak: Overlay CSS is now cached at runtime and fetched via JavaScript.
• Tweak: Deleted some macros deprecated by JavaScript implementations.
• Tweak: Corrected some spelling errors throughout library.

Lib:Elevation 1.0b7

Lib:Elevation 1.0b7 requires MapTool 1.10.3+!

Add Elevation to your MapTool encounters! This beta release gives you tools to add key elevations to your maps, simulating vertical environments in MapTool. Use for flying effects or and multi-level maps. Check out the built-in user guide, read it online at the RPTools Wiki page, or watch an Introductory YouTube video.

Lib:Elevation has no dependencies. To best demonstrate the features, the demo campaign includes additional libraries that are not at all needed. Lib:SimpleDoors is good to go for your games, be aware that Lib:EventTokens conflicts with Bag of Tricks and other libraries which use the onTokenMove event.

To get the most out of the library, first try the demo campaign and poke around. Use the overlay to add, change, and edit elevations. The GM panel macros can also change map and token elevations on the sample maps. Experiment with creating new maps of your own. As mentioned, the demo campaign's additional libraries are purely for either development assistance or to help showcase the Elevation library - they are entirely separate libraries not needed to use Lib:Elevation.

Once you are ready to use this on your own campaign, you should add a few things to get the most out of this library:

• Add States:
  • A GM-Only isElevationToken state. Make it a GM-only state that shades the token in ~25% opaque bright blue, I recommend making it only appear on mouseover.
  • Public isAbove and isBelow states. I like to use the Triangle (up arrow) and Yield (down arrow) grid shapes.
• Add the Elevation property to your campaign. I like to make it visible on the stat sheet (this is a default property in new campaigns).
• The overlay has most everything you need, but you can optionally drag (or export/import) the GM macro sets into your GM panel. Read the tooltips, they are very informative!

Note that by default, fog of war cleared on one level will clear it for all levels. This isn't good for indoor maps - for indoor maps, use the 'Map Options' dialog to enable the Fog Hack and set the fadedSightType to 1 (turns of sight for tokens at other elevations) or a custom sight type such as 'Blind' to switch those tokens to when not on the current elevation.

To update from prior beta versions, simply delete the library and import the new version. No campaign-specific data is saved on the library itself.

Changes in 1.0b7

Along with some bugfixes, this version focused on refactoring more functionality into JavaScript, yielding further performance improvements. Switching tokens in 1.0b5 took around 1.5 seconds to switch elevations. Now, it takes less than half a second.

• Improvement: Significant further refactoring under the hood, rebuilding how map data and option settings in JavaScript. These changes continue to bring significant performance gains.
• Bugfix: Properly allow URI Access during onCampaignLoad so it does not need to be manually set.
• Bugfix: Correctly display single elevations in the UI overlay without a dropdown arrow.
• Bugfix: Removed deselection/reselection feature which cause some issues with switching elevation with multiple tokens selected.
• Tweak: Updated color coding of macro buttons and added some utility functions exposing configuration and runtime values.

Lib:Elevation 1.0b6

Lib:Elevation 1.0b6 requires MapTool 1.10.3!

Add Elevation to your MapTool encounters! This beta release gives you tools to add key elevations to your maps, simulating vertical environments in MapTool. Use for flying effects or and multi-level maps. Check out the built-in user guide, read it online at the RPTools Wiki page, or watch an Introductory YouTube video.

To get the most out of the library, first try the demo campaign and poke around. Use the GM panel to change elevations on the sample map, experiment with creating new maps of your own. The demo campaign also includes additional libraries, Lib:SimpleDoors and Lib:EventTokens, which help showcase the Elevation library - but are entirely separate libraries not needed to use Lib:Elevation.

Once you are ready to use this on your own campaign, you should add a few things to get the most out of this library:

• Add States:
  • A GM-Only isElevationToken state. Make it a GM-only state that shades the token in ~25% opaque bright blue, I recommend making it only appear on mouseover.
  • Public isAbove and isBelow states. I like to use the Triangle (up arrow) and Yield (down arrow) grid shapes.
• Add the Elevation property to your campaign. I like to make it visible on the stat sheet (this is a default property in new campaigns).
• The overlay has most everything you need, but you can optionally drag (or export/import) the GM macro sets into your GM panel. Read the tooltips, they are very informative!

Note that by default, fog of war cleared on one level will clear it for all levels. This isn't good for indoor maps - for indoor maps, use the 'Map Options' dialog to enable the Fog Hack and set the fadedSightType to 1 (turns of sight for tokens at other elevations) or a custom sight type such as 'Blind' to switch those tokens to when not on the current elevation.

Changes in 1.0b6

This release brings two new options and the foundation for a new JavaScript backend implementation, one gameplay related and the other performance related. Overall, switching elevations is greatly improved, sped up by 50% or more on the sample campaign.

For unknown reasons, GMs should not have a token impersonated when switching elevations. This greatly improves switching performance.

• New Feature: New 'sightFilter' option allows you to constrain sight fading to some tokens.
  • The default setting is '0' which fades sight for any token not on the current elevation.
  • Setting to '1' filters out tokens above the current elevation (e.g. flying tokens will always have sight).
  • Setting to '2' filters out tokens below the current elevation (e.g. ground-level tokens will always have sight).
• New Feature: New 'strictAppearance' options lets you choose whether to store complex information (rotation, size, and more) for elevation-linked tokens on the map.
  • By default the setting is unchecked, and only the token's position will be explicitly stored. This default is a new option which greatly improves performance.
  • Checking this option will additionally store: layer, draw order, height, width, size, facing, opacity, visibility to players, shape, and layout. This setting will protect elevation-linked tokens from accidental changes when they are hidden off screen, such as by macros, and lets an elevation token appear differently when linked to different elevations.
• Improvement: Replaced all configuration getter functions and some others with JavaScript and laid groundwork under the hood to begin migrating Lib:Elevation towards a mainly JavaScript backend, which will greatly increase performance. You can now edit configuration values, such as which property represents "Elevation" in your campaign, in configuration.js.
• Improvement: Now deselects/reselects current selection when switching elevation, as selection and impersonation on the GM client for some reason greatly slows down elevation switching. Between this change, the new strictAppearance default, and new JavaScript functions, elevation switching times in have been cut in half. Impersonating a token on the GM client still slows down elevation, so GMs should avoid having a token impersonated when switching elevations.
• Bugfix: Check for external macro access before checking for updates and alert user if needed.
• Tweak: Removed bold text from Map Options input to work around Java's high DPI display issues.
• Tweak: Removed punctuation at end of Map Options dialog descriptions so they didn't double up with the inserted colon.

Lib:Elevation 1.0b5

Add Elevation to your MapTool encounters! This beta release gives you tools to add key elevations to your maps, simulating vertical environments in MapTool. Use for flying effects or and multi-level maps. Check out the built-in user guide, read it online at the RPTools Wiki page, or watch an Introductory YouTube video.

To get the most out of the library, first try the demo campaign and poke around. Use the GM panel to change elevations on the sample map, experiment with creating new maps of your own. The demo campaign also includes additional libraries, Lib:SimpleDoors and Lib:EventTokens, which help showcase the Elevation library - but are entirely separate libraries not needed to use Lib:Elevation.

Once you are ready to use this on your own campaign, you should add a few things to get the most out of this library:

• Add States:
  • A GM-Only isElevationToken state. Make it a GM-only state that shades the token in ~25% opaque bright blue, I recommend making it only appear on mouseover.
  • Public isAbove and isBelow states. I like to use the Triangle (up arrow) and Yield (down arrow) grid shapes.
• Add the Elevation property to your campaign. I like to make it visible on the stat sheet (this is a default property in new campaigns).
• The overlay has most everything you need, but you can optionally drag (or export/import) the GM macro sets into your GM panel. Read the tooltips, they are very informative!

Note that by default, fog of war cleared on one level will clear it for all levels. This isn't good for indoor maps - for indoor maps, use the 'Map Options' dialog to enable the Fog Hack and set the fadedSightType to 1 (turns of sight for tokens at other elevations) or a custom sight type such as 'Blind' to switch those tokens to when not on the current elevation.

Changes in 1.0b5

• New Feature: Automatic Update Notifications have been added. On campaign load, the latest release from GitHub will be checked and if a new version has been added you will get an alert with a download link and the release notes you can read right in MapTool. Downloading and replacing the library is still a manual process.
• Bugfix: Properly respect 'useFogHack' option instead of always restoring fogs on elevation switch.
• Tweak: Re-implemented Fog Hack to be simpler and only reside on switchElevation.

Lib:Elevation 1.0b4

Add Elevation to your MapTool encounters! This is the beta release gives you tools to add key elevations to your maps, simulating vertical environments in MapTool. This can be used for flying effects or even multi-level buildings. Check out the built-in user guide, or read it online at the RPTools Wiki page, or watch an Introductory YouTube video.

To get the most out of the library, first try the demo campaign and poke around. Use the GM panel to change elevations on the sample map, experiment with creating new maps of your own. The demo campaign also includes two additional librarys, Lib:SimpleDoors and Lib:EventTokens, which help showcase the Elevation library - but are entirely separate libraries not needed to use Lib:Elevation.

Once you are ready to use this on your own campaign, you should add a few things to get the most out of this library:

• Add States:
  • A GM-Only isElevationToken state. Make it a GM-only state that shades the token in ~25% opaque bright blue, I recommend making it only appear on mouseover.
  • Public isAbove and isBelow states. I like to use the Triangle (up arrow) and Yield (down arrow) grid shapes.
• Add the Elevation property to your campaign. I like to make it visible on the stat sheet (this is a default property in new campaigns).
• The overlay has most everything you need, but you can optionally drag (or export/import) the GM macro sets into your GM panel. Read the tooltips, they are very informative!

Additionally, note that by default fog of war cleared on one level will clear it for all levels, which isn't good for indoor maps - for indoor maps, you want to use the 'Map Options' dialog to enable the Fog Hack and set the fadedSightType to 1 (turns of sight for tokens at other elevations) or a custom sight type to switch those tokens to when not on the current elevation.

Changes in 1.0b4

• Bugfix: 1.0b3 introduced some regressions and failed to actually fix switching key elevations when a linked token was deleted. Refactored elevation object getting throughout library to properly filter deleted tokens.
• Improvement: Switch to Token (Token ↑↓) overlay button no longer shows when no token is selected or no elevations are defined.
• Tweak: Correct some id HTML attributes in loadOverlay
• Tweak: Corrected non-breaking errors in switchElevation method

Changes in 1.0b3

Note: This version introduced some regressions and didn't fix what it intended to, please us b4+.

• New Feature: New 'Only Follow Players" option allows you to prevent the map from switching to a new elevation when moving non-owned tokens up or down. This is good for moving NPCs without having to reload the map. Note that tokens owned by the GM or by All also count to automatically switch the elevation.
• Bugfix: Filter deleted tokens in getElevationTokens method to prevent error in calling functions. This fixes an error where deleting elevation tokens would prevent switching elevations on a map.
• Bugfix: Moving tokens to the current elevation now correctly refreshes the token states.
• Tweak: getElevationToken method now returns a JSON Array rather than a string list
• Tweak: Disabled elevation change buttons now show the current elevation instead of "At Top" or "At Bottom".

Lib:Elevation 1.0b3

This version didn't actually fix what it intended to. Please download 1.0b4+

Add Elevation to your MapTool encounters! This is the beta release gives you tools to add key elevations to your maps, simulating vertical environments in MapTool. This can be used for flying effects or even multi-level buildings. Check out the built-in user guide, or read it online at the RPTools Wiki page, or watch an Introductory YouTube video.

To get the most out of the library, first try the demo campaign and poke around. Use the GM panel to change elevations on the sample map, experiment with creating new maps of your own. The demo campaign also includes two additional librarys, Lib:SimpleDoors and Lib:EventTokens, which help showcase the Elevation library - but are entirely separate libraries not needed to use Lib:Elevation.

Once you are ready to use this on your own campaign, you should add a few things to get the most out of this library:

• Add States:
  • A GM-Only isElevationToken state. Make it a GM-only state that shades the token in ~25% opaque bright blue, I recommend making it only appear on mouseover.
  • Public isAbove and isBelow states. I like to use the Triangle (up arrow) and Yield (down arrow) grid shapes.
• Add the Elevation property to your campaign. I like to make it visible on the stat sheet (this is a default property in new campaigns).
• The overlay has most everything you need, but you can optionally drag (or export/import) the GM macro sets into your GM panel. Read the tooltips, they are very informative!

Additionally, note that by default fog of war cleared on one level will clear it for all levels, which isn't good for indoor maps - for indoor maps, you want to use the 'Map Options' dialog to enable the Fog Hack and set the fadedSightType to 1 (turns of sight for tokens at other elevations) or a custom sight type to switch those tokens to when not on the current elevation.

Changes in 1.0b3

• New Feature: New 'Only Follow Players" option allows you to prevent the map from switching to a new elevation when moving non-owned tokens up or down. This is good for moving NPCs without having to reload the map. Note that tokens owned by the GM or by All also count to automatically switch the elevation.
• Bugfix: Filter deleted tokens in getElevationTokens method to prevent error in calling functions. This fixes an error where deleting elevation tokens would prevent switching elevations on a map.
• Bugfix: Moving tokens to the current elevation now correctly refreshes the token states.
• Tweak: getElevationToken method now returns a JSON Array rather than a string list
• Tweak: Disabled elevation change buttons now show the current elevation instead of "At Top" or "At Bottom".

To download this busted version without getting the whole 1.0b3 repository, please go to the main repository → Old Version → Lib_Elevation 1.0b3

Lib:Elevation 1.0b2

Add Elevation to your MapTool encounters! This is the beta release gives you tools to add key elevations to your maps, simulating vertical environments in MapTool. This can be used for flying effects or even multi-level buildings. Check out the built-in user guide, or read it online at the RPTools Wiki page, or watch an Introductory YouTube video.

To get the most out of the library, first try the demo campaign and poke around. Use the GM panel to change elevations on the sample map, experiment with creating new maps of your own. The demo campaign also includes two additional librarys, Lib:SimpleDoors and Lib:EventTokens, which help showcase the Elevation library - but are entirely separate libraries not needed to use Lib:Elevation.

Once you are ready to use this on your own campaign, you should add a few things to get the most out of this library:

• Add States:
  • A GM-Only isElevationToken state. Make it a GM-only state that shades the token in ~25% opaque bright blue, I recommend making it only appear on mouseover.
  • Public isAbove and isBelow states. I like to use the Triangle (up arrow) and Yield (down arrow) grid shapes.
• Add the Elevation property to your campaign. I like to make it visible on the stat sheet (this is a default property in new campaigns).
• The overlay has most everything you need, but you can optionally drag (or export/import) the GM macro sets into your GM panel. Read the tooltips, they are very informative!

Additionally, note that by default fog of war cleared on one level will clear it for all levels, which isn't good for indoor maps - for indoor maps, you want to use the 'Map Options' dialog to enable the Fog Hack and set the fadedSightType to 1 (turns of sight for tokens at other elevations) or a custom sight type to switch those tokens to when not on the current elevation.

Changes in 1.0b2

• Bugfix: The elevation selector now works on MacOS (and hopefully Linux).
• Bugfix: Linking tokens to non-current elevations can no longer wipe out tokens on the destination key elevation.
• Improvement: Better organized the overlay buttons, added a disabled button state, and made sure all the elevation editing buttons were available even when no token was selected.
• Tweak: Ensured that both the 'step up' and 'step down' overlay buttons remain visible when a token is selected for consistent positioning.
• Tweak: Fixed overlay 'step down' button tooltip text.
• Tweak: Relabeled 'Pck Tkn Elev' to 'Set Elevation'

Lib:Elevation 1.0b

Add Elevation to your MapTool encounters! This is the beta release gives you tools to add key elevations to your maps, simulating vertical environments in MapTool. This can be used for flying effects or even multi-level buildings. Check out the built-in user guide, or read it online at the RPTools Wiki page, or watch an Introductory YouTube video.

To get the most out of the library, first try the demo campaign and poke around. Use the GM panel to change elevations on the sample map, experiment with creating new maps of your own. The demo campaign also includes two additional librarys, Lib:SimpleDoors and Lib:EventTokens, which help showcase the Elevation library - but are entirely separate libraries not needed to use Lib:Elevation.

Once you are ready to use this on your own campaign, you should add a few things to get the most out of this library:

• Add States:
  • A GM-Only isElevationToken state. Make it a GM-only state that shades the token in ~25% opaque bright blue, I recommend making it only appear on mouseover.
  • Public isAbove and isBelow states. I like to use the Triangle (up arrow) and Yield (down arrow) grid shapes.
• Add the Elevation property to your campaign. I like to make it visible on the stat sheet (this is a default property in new campaigns).
• The overlay has most everything you need, but you can optionally drag (or export/import) the GM macro sets into your GM panel. Read the tooltips, they are very informative!

Additionally, note that by default fog of war cleared on one level will clear it for all levels, which isn't good for indoor maps - for indoor maps, you want to use the 'Map Options' dialog to enable the Fog Hack and set the fadedSightType to 1 (turns of sight for tokens at other elevations) or a custom sight type to switch those tokens to when not on the current elevation.

Changes in 1.0b

• Initial beta release. Other changes are updates from 1.0a6
• Improvement: The library token itself now contains no campaign-specific data that needs to be preserved. 'getLibOption' and 'setLibOption' now grab the values from the map on which the library token resides. This means that there is no need to import any data at all when updating Lib:Elevation, you can simply delete the old token and drop in the updated one.
• Improvement: Map Option dialog is no longer tabbed, and specifies that you are editing default values when on the map containing the Lib:Elevation library token.
• Tweak: Clarify User Guide to specify that users never need to manually create a Map Elevation Data token (#2).
• Tweak: Create new Map Elevation Data tokens on the Hidden layer instead of the Background layer (Side effect of #2).
• Tweak: Removed some now obsolete functions: setLibData, getLibData, setLibDataObj, getLibDataObj, deleteLibDataObj
• Tweak: Refactored layer height logic to be more flexible.
• Tweak: The library version number is now additionally reflected in Lib:Elevation's GM Name field.
• Bugfix: Token fade (states/opacity for tokens on different elevations) no recalculates when adding an elevation. When map building, turning off Fog of War is advised to maintain clear vision of the map when adding elevations without having to first move a token to the elevation, then revealing vision (#6).

Lib:Elevation 1.0a6

Add Elevations to your MapTool Maps! This alpha release gives you tools to add verticality to your maps in MapTool. This can be used for flying effects or even multi-level buildings. Check out the built-in user guide, or read it online at the RPTools Wiki page.

To get the most out of the library, first try the demo campaign and poke around. Use the GM panel to change elevations on the sample map, experiment with creating new maps of your own.

Once you are ready to use this on your own campaign, you should add a few things to get the most out of this library:

• Add a GM-Only isElevationToken state. Make it a GM-only state that shades the token in ~25% opaque bright blue, I recommend making it only appear on mouseover.
• Add public isAbove and isBelow states. I like to use the Triangle (up arrow) and Yield (down arrow) grid shapes.
• Add the Elevation property to your campaign. I like to make it visible on the stat sheet.
• Optionally drag (or export/import) the GM macro sets into your GM panel. Read tooltips, they are very informative!
• For indoor maps, you want to use the 'Map Options' dialog to enable the Fog Hack and set the fadedSightType to 1 or a custom property. Normally fog of war cleared on one level will clear it for all levels, which isn't good for indoor maps - the demo campaign enables this by default on some maps. It isn't recommended for outdoor environments.

Changes in 1.0a6

1.0a6 brings significant tuning and corrections, and is likely the final alpha release before a slightly broader beta release.

Bonus! New Lib:EventTokens library in the demo campaign enables easy stairs up/down elevations!

• Added check and options to land tokens at correct elevations when pasted/dragged/copied onto a different map.
• Replaced 'Set Elevation' overlay buttons to context sensitive up/down buttons, which should be more useful and intuitive.
• Corrected onInitiativeChange event to use safe library methods for getting elevation and added option to disable it per-map.
• Improved reload elevation logic to better maintain and update state display.
• Refactored default layer height code to make the setting more explicit and useful.