Roger's Additional Metric Ruler Labels
For everyone that uses the metric system in the real world and wants to know the metric distances without changing the underlying game system. Or do you want to add your own custom measurement conversions? Or maybe travel times?
GM:
A 20 feet wide gorge lies ahead of your party. What do you do?
You are asking yourself:
20 feet ... is this wide? Should i try jumping across it?
This module will help you to better understand distances.
It adds additional labels for the metric measurements to your ruler. It is not changing any systems etc. It only applies an additional label to the UI.
NEW --- NEW --- NEW
You can now add your Customizable Measurement Conversions and Travel times if you want :) Have fun! Compatability with V12!!!
V12 - Compatability
The latest version is compatible with V12. If you find problems with future subversions of V12, then please let me know. Please note that Release 1.1.0 and above are not compatible with foundry versions below V9 :)(They might work with earlier versions than V9 but its not officially supported)
Table of Contents
- The following units are supported:
- Example feet to meters
- Example miles to kilometers
- Works with FoundryVTT's MeasureTemplates
- Customizable Conversions
- Travel times
- Support for other packages
- Installation
- Compatibility
- Dependencies
- Planned
- Feedback
- Changelog
The following units are supported
- ft, ft. and feet will get converted to meters (5 ft -> 1,5 m)
- mi, mi., and miles will be converted to kilometers (1 mile -> 1,61 km)
Example feet to meters
Example miles to kilometers
Works with FoundryVTT's MeasureTemplates
Customizable Conversions
You can now add your own custom conversion with custom labels, etc. Just go to the settings and add all the information for your own conversion. The module has the concept of a small and a big measurement unit. For example feet and miles. Or meters and kilometers. That way you can support normal maps, as well as bigger travelmaps. Fill in the original labels, so that the module can find the measurements, that it should convert with your custom factor. That way you will receive your own custom measurement with a label of your choice.
Your players then can decide if they want to see the built-in metric conversion for feet and miles or your custom one, or just BOTH :). If you want to get rid of the original foundry measurements, then there is an option too. I hope this helps all the people that have some different szenarios than imperial to metric.
Travel times
You can now add travel times to the ruler. Just go to the settings and add all the information for your own conversion. You will need to define the label that the module should look for (e.g. miles) and then the distances for that measuring unit that your group would travel on a slow, normal and fast travel speed. You can also define if you want to display the travel times in days, hours or whatever you want.
To save some space you can also toggle on the option to only show the total travel time on the last segment of a ruler, instead of both the total and the travel time to this segment from the previous one.
Support for other packages
DragRuler
This module supports the DragRuler module from Stäbchenfisch as well as the drag measurement from the PF2E system, and modules that built up on this. It should work with modules like EasyRegions or PF2e Drag Measurement Action Icon You can enable/disable the labels in the settings.
Installation
To install, follow these instructions:
- Inside Foundry, select the "Add-on Modules" tab in the Configuration and Setup menu.
- Click the Install Module button and enter the following URL: https://github.com/roger92/metric-ruler-labels/releases/latest/download/module.json or search for Metric Ruler Labels in the search.
- Click Install and wait for installation to complete.
Compatibility
Works with V9 + V10 + V11
Dependencies
- libWrapper from ruipin https://foundryvtt.com/packages/lib-wrapper/
Also thanks to ruipin for the libWrapper and Stäbchenfisch for the DragRuler module :)
Planned
Feel free to recommend enhancements.
- Maybe better support for elevation ruler if my users see a need there :)
Feedback
If you find a bug or have any feedback for me just add an issue in the issuetracker. Thx alot and i hope this module helps you in your game :)
Changelog
v3.3.1
- Cleanup of manifest.json to remove a warning because of deprecated/unknown field
v3.3.0
- Changed the way the labels are converted, so that it should work with more different variations out of the box.
v3.2.2
- Setting for Drag Ruler support is now a dropdown
v3.2.1
- Compatibility for PF2e Token Drag Ruler (and build in Drag Ruler of the pathfinder system)
- Italian Language Support (Thx to GregoryWarn)
- Fixed warning for unsupported manifest field
v3.2.0
- V12 Compatibility
v3.1.9
- Just removed some console logs :)
v3.1.8
- Fix for Measurement Templates on V11
v3.1.7
- Fix for incompatibility dialog
v3.1.6
- Compatibility with V11
v3.1.5
- Fix for elevation ruler. Now displays metric conversions on drag ruler if elevation ruler is active.
v3.1.2
- Fixed bugs with disappearing labels, when dragruler is active and foundryLabels are disabled
v3.1.1
- Added option to only show the total travel time on the last ruler segment
v3.1.0
- Travel time label customizable
- Fixed bug where travel time did not display on ruler segments
- Fixed bug where settings for conversions where available to players
v3.0.2
- New Travel time ruler option
- Bugfix for gridless maps
v2.1.3
- Small Bugfix
v2.1.2
- DragRuler (By Stäbchenfisch) V10 Support
- Support for moving of Measurement Templates
- Smaller Bugfixes
v2.1.0
- V10 Support
v2.0.1
- Fixed German localization bug
v2.0.0
- Added Support for custom conversions
v1.1.0
- Added support for V9
- Fixed MeasureTemplates support that didn't work anymore in V9
v1.0.0
- Added support for FoundryVTT's MeasureTemplates
v0.9.1
- Added support for the DragRuler module by Stäbchenfisch ( you can activate/deactivate metric labels for this module in the settings)
- All segments of the ruler now have metric labels
- Added german localization
- Added a dialog if dependency is missing
- Removed libRuler as a dependency (yay ... less dependencies are always better \(°0°)/ )
v0.9.0
- First release with the conversions for miles and feet for the ruler tool.