Bidmaron
July 8th, 2018, 02:04
Generators Extension
Overview
This Extension expands upon the Fantasy Grounds built-in Tables capabilities, including advanced formatting, limited natural-language constructors, and synchronous subtable rolls.
Documentation
The current version of the documentation is at this post (https://www.fantasygrounds.com/forums/showthread.php?44643-Generators-Extension&p=396439&viewfull=1#post396439) of this thread.
Version
See this post (https://www.fantasygrounds.com/forums/showthread.php?44643-Generators-Extension&p=396442&viewfull=1#post396442) for a record of version features
0.1 - Initial Creation
The current version offers these features:
Solves the asynchronous roll problem where multiple nested subtables would cause unpredictable results.
* Tables can now do everything that story templates can do, including formatting of text within the constraints of FG text handling capabilities.
* Includes the first version of natural language engine that can (semi)intelligently add an 'a' or 'an' article before a random item (e.g. 'a blue horse' vs. 'an orange horse') and pluralize multiple instances of an item (e.g. "4 horses" "1 horse" "2 swords" "1 sword")
* You can control whether to cardinalize numerals (e.g. "4 horses" or "four horses") that the generator randomly rolls.
* Adds the ability to invoke a random table or even chain table invocations (e.g. "The character is [a] [race] [<race>-sex]" will roll the sex on a customized race table, so if the xenomorph race has a third sex (or female dwarf adventurers are very rare, e.g.), it can handle that.
* You can add common processing necessary before a table row in a 'foreword' to your table.
* You can add common processing after a roll in an 'afterword' to your table.
* You can use serial lists with commas (or any other punctuation) intelligently separating a variable number of items (and even include or omit the 'oxford' comma before the conjunction)
* You can pack out blank space before or after a subtable roll, which is useful for name generators.
* You can control the number of times a table rolls and even make the iterations random (e.g. a bolt case can hold d6 bolts randomly rolled on a bolt table)
* The /rollon command now supports options to return a specific table row or to use a test mode that will return every row of the table as if they had been rolled.
* You can import and/or export a generator (or table) or your entire library of generators/tables without the complexity of making a module.
* Original tables feature is completely intact and separate, so the extension won't break anything you may have (like Trenloe's card extension).
Known Issues and Bug Listing
See this post (https://www.fantasygrounds.com/forums/showthread.php?44643-Generators-Extension&p=396440&viewfull=1#post396440) for a record of known issues and reported bugs
Feature Requests
See this post (https://www.fantasygrounds.com/forums/showthread.php?44643-Generators-Extension&p=396441&viewfull=1#post396441) for a list of planned features in the next revision, as well as requested features and my intentions regarding those requests.
Rulesets
This Extension works with:
CoreRPG Rulset v3.3.5+ and rulesets derived therefrom.
Dependencies
This Extension has no dependencies.
Downloading The Extension
Download at the end of this post.
Loading The Extension
This extension is loaded exactly like all other Fantasy Grounds Extensions - by first copying the .ext file to the Extensions under the Fantasy Grounds folder and then re-starting Fantasy Grounds. If the extension is compatible with the currently installed version of a given ruleset it will be displayed in the extensions list for that ruleset and can be loaded by clicking on the checkbox next to the extensions name.
If the Extension has large red 'X' next to its name in the extension list then the extension or an extension that this one is dependent upon is not compatible with the chosen Ruleset. Make sure that you have downloaded and installed the latest copy of this extension.
When Fantasy Grounds Updates
After a Fantasy Grounds version update you should verify that all extensions (not just this one) have been either updated themselves or verified by the Extension author that they work with the new version of Fantasy Grounds. If you have any issues with Fantasy Grounds after an update then it is best to disable all Extensions and then re-enable them one by one until the issue re-appears.
Thanks to Dulux-Oz for the general format of this extension posting.
Overview
This Extension expands upon the Fantasy Grounds built-in Tables capabilities, including advanced formatting, limited natural-language constructors, and synchronous subtable rolls.
Documentation
The current version of the documentation is at this post (https://www.fantasygrounds.com/forums/showthread.php?44643-Generators-Extension&p=396439&viewfull=1#post396439) of this thread.
Version
See this post (https://www.fantasygrounds.com/forums/showthread.php?44643-Generators-Extension&p=396442&viewfull=1#post396442) for a record of version features
0.1 - Initial Creation
The current version offers these features:
Solves the asynchronous roll problem where multiple nested subtables would cause unpredictable results.
* Tables can now do everything that story templates can do, including formatting of text within the constraints of FG text handling capabilities.
* Includes the first version of natural language engine that can (semi)intelligently add an 'a' or 'an' article before a random item (e.g. 'a blue horse' vs. 'an orange horse') and pluralize multiple instances of an item (e.g. "4 horses" "1 horse" "2 swords" "1 sword")
* You can control whether to cardinalize numerals (e.g. "4 horses" or "four horses") that the generator randomly rolls.
* Adds the ability to invoke a random table or even chain table invocations (e.g. "The character is [a] [race] [<race>-sex]" will roll the sex on a customized race table, so if the xenomorph race has a third sex (or female dwarf adventurers are very rare, e.g.), it can handle that.
* You can add common processing necessary before a table row in a 'foreword' to your table.
* You can add common processing after a roll in an 'afterword' to your table.
* You can use serial lists with commas (or any other punctuation) intelligently separating a variable number of items (and even include or omit the 'oxford' comma before the conjunction)
* You can pack out blank space before or after a subtable roll, which is useful for name generators.
* You can control the number of times a table rolls and even make the iterations random (e.g. a bolt case can hold d6 bolts randomly rolled on a bolt table)
* The /rollon command now supports options to return a specific table row or to use a test mode that will return every row of the table as if they had been rolled.
* You can import and/or export a generator (or table) or your entire library of generators/tables without the complexity of making a module.
* Original tables feature is completely intact and separate, so the extension won't break anything you may have (like Trenloe's card extension).
Known Issues and Bug Listing
See this post (https://www.fantasygrounds.com/forums/showthread.php?44643-Generators-Extension&p=396440&viewfull=1#post396440) for a record of known issues and reported bugs
Feature Requests
See this post (https://www.fantasygrounds.com/forums/showthread.php?44643-Generators-Extension&p=396441&viewfull=1#post396441) for a list of planned features in the next revision, as well as requested features and my intentions regarding those requests.
Rulesets
This Extension works with:
CoreRPG Rulset v3.3.5+ and rulesets derived therefrom.
Dependencies
This Extension has no dependencies.
Downloading The Extension
Download at the end of this post.
Loading The Extension
This extension is loaded exactly like all other Fantasy Grounds Extensions - by first copying the .ext file to the Extensions under the Fantasy Grounds folder and then re-starting Fantasy Grounds. If the extension is compatible with the currently installed version of a given ruleset it will be displayed in the extensions list for that ruleset and can be loaded by clicking on the checkbox next to the extensions name.
If the Extension has large red 'X' next to its name in the extension list then the extension or an extension that this one is dependent upon is not compatible with the chosen Ruleset. Make sure that you have downloaded and installed the latest copy of this extension.
When Fantasy Grounds Updates
After a Fantasy Grounds version update you should verify that all extensions (not just this one) have been either updated themselves or verified by the Extension author that they work with the new version of Fantasy Grounds. If you have any issues with Fantasy Grounds after an update then it is best to disable all Extensions and then re-enable them one by one until the issue re-appears.
Thanks to Dulux-Oz for the general format of this extension posting.