Difference between revisions of "Feature: Table Importer/Exporter"

From 5etools Community Wiki
Jump to: navigation, search
m
m (Related Features)
 
(2 intermediate revisions by the same user not shown)
Line 17: Line 17:
 
::*The right hand pane will then show the following...
 
::*The right hand pane will then show the following...
  
[[File: |center|noframes|600px]]
+
<br/>
 +
 
 +
==='''Requirements'''===
 +
:File Format: The feature uses [https://app.roll20.net/forum/post/1144568/script-tableexport-a-script-for-exporting-and-importing-rollable-tables-between-accounts The Aaron's TableExport API script's format] .
 +
 
 +
!import-table -- <table_name>
 +
 
 +
: as the first line to define the table's name, and then
 +
 
 +
!import-table --<'''table_name'''> --<'''table_item'''> --<'''weight'''> --<'''image_URL'''>
 +
 
 +
:Where[[File:Import_Table_-_Sample_Table_Definitions.png|thumb]]
  
<br/>
+
::*'''table_name = '''is The Name of the table
 +
 
 +
::*'''table_item   '''= is a line entry on that table
 +
 
 +
::*'''weight          '''= is the number of times this entry effectively occurs on the table. In a table in which the total of all items' weight equals 100, an entry with a weight of 25 would equal a 25% chance.
 +
 
 +
::*Image_URL  = The address for the Image. 
 +
 
 +
 
 +
 
 +
Example: A table named Sample-Mood-Ring.
 +
!import-table '''--'''Sample-Mood-Ring''' '''--show
 +
!import-table-item --Sample-Mood-Ring --[Black] Stressed --1 --
 +
!import-table-item --Sample-Mood-Ring --[Red] Fear --1 --
 +
!import-table-item --Sample-Mood-Ring --[Yellow] Nervous --1 --
 +
!import-table-item --Sample-Mood-Ring --[Green] Romance --2 --
 +
!import-table-item --Sample-Mood-Ring --[Blue] Normal --10 --
 +
!import-table-item --Sample-Mood-Ring --[Lapis] Relaxed --5 --
 +
!import-table-item --Sample-Mood-Ring --[Navy] Calm --3 --
 +
!import-table-item --Sample-Mood-Ring --[Purple] Cool --4 --
 +
!import-table-item --Sample-Mood-Ring --[Pink] Lovable --7 --
 +
!import-table-item --Sample-Mood-Ring --[Orange] Passion --2 --
 +
 
 +
 
 +
 
 +
<table Item Names></table>
 +
 
 +
 
 +
<br/>  
 +
----
  
 
=== Feature Support===
 
=== Feature Support===
Line 47: Line 87:
 
==='''Related Features'''===
 
==='''Related Features'''===
 
----
 
----
:*[[]]
 
:*[[]]
 
 
:*[[Feature: R20es Config|R20es Config]]
 
:*[[Feature: R20es Config|R20es Config]]
  

Latest revision as of 11:06, 10 November 2019

PLEASE NOTE: Roll20 Enhancement Suite (aka VTT es/ R20es), is not part of BetteR20 or 5eTools. However; as BetteR20 requires VTT es/R20es, this Wiki covers its content to (HOPEFULLY) prevent BetteR20 users from requesting help on BetteR20 issues on the VTTes/R20es Discord server or other platforms (Reddit/Roll20.net Forum, etc).


framless
v1.15.15

tcenter

Table Importer/Exporter

Dm.png


Instructions(What it does)


R20es Configuration (How to make it do 'stuff')

In Roll20, click the sidetoolbar's R20Settings.PNG, and if VTTes/R20es is loaded properly (see Installation Guide) you will see the buttons for R20es Tools and R20es Settings.
  • Click upon R20es Settings and then select the feature's name.
  • The right hand pane will then show the following...


Requirements

File Format: The feature uses The Aaron's TableExport API script's format .
!import-table -- <table_name>
as the first line to define the table's name, and then
!import-table --<table_name> --<table_item> --<weight> --<image_URL>
Where
Import Table - Sample Table Definitions.png
  • table_name = is The Name of the table
  • table_item   = is a line entry on that table
  • weight          = is the number of times this entry effectively occurs on the table. In a table in which the total of all items' weight equals 100, an entry with a weight of 25 would equal a 25% chance.
  • Image_URL  = The address for the Image. 


Example: A table named Sample-Mood-Ring.

!import-table --Sample-Mood-Ring --show
!import-table-item --Sample-Mood-Ring --[Black] Stressed --1 -- 
!import-table-item --Sample-Mood-Ring --[Red] Fear --1 -- 
!import-table-item --Sample-Mood-Ring --[Yellow] Nervous --1 -- 
!import-table-item --Sample-Mood-Ring --[Green] Romance --2 -- 
!import-table-item --Sample-Mood-Ring --[Blue] Normal --10 -- 
!import-table-item --Sample-Mood-Ring --[Lapis] Relaxed --5 -- 
!import-table-item --Sample-Mood-Ring --[Navy] Calm --3 -- 
!import-table-item --Sample-Mood-Ring --[Purple] Cool --4 -- 
!import-table-item --Sample-Mood-Ring --[Pink] Lovable --7 -- 
!import-table-item --Sample-Mood-Ring --[Orange] Passion --2 --





Feature Support


Known Issues/Limitations

Looks like its perfect... (Did we miss anything?)


FAQ

Nothing's here (Do you have any suggestions?)
Best Practices

None as yet (Do you have any suggestions?)



Related Features



Did that answer your question(s)?

If not please check the under section Feature Support Known Isseus/Limitations or visit the Known Issues page for further guidance, or go to the Discord community and leave a comment in the issues channel.

If you enjoy the project, please follow this link to see how you can contribute and help make it even better.


PLEASE NOTE: Roll20 Enhancement Suite (aka VTT es/ R20es), is not part of BetteR20 or 5eTools. However; as BetteR20 requires VTT es/R20es, this Wiki covers its content to (HOPEFULLY) prevent BetteR20 users from requesting help on BetteR20 issues on the VTTes/R20es Discord server or other platforms (Reddit/Roll20.net Forum, etc).