DokuWiki

You've loaded an old revision of the document! If you save it, you will create a new version with this data.

====== randomtables Plugin ======

---- plugin ----
description: Define and roll on entries from Random Tables
author     : omerida 
email      : oscar@oscarm.org 
type       : syntax
lastupdate : 2023-07-19y
compatible : 2023-04-04 "Jack Jackrum"
depends    : sqlite
tags       : rpg, tables

downloadurl: https://github.com/omerida/dokuwiki-randomtables/archive/refs/heads/latest.zip
bugtracker : https://github.com/omerida/dokuwiki-randomtables/issues
sourcerepo : https://github.com/omerida/dokuwiki-randomtables

----

===== Installation =====

:!: **External requirements:** This plugin requires the following additional components that must be installed separately: 
  * [[plugin:sqlite|sqlite Plugin]]
  * PHP 8.0+

Install the plugin using the [[plugin:plugin|Plugin Manager]] and the download URL above, which points to latest version of the plugin. Refer to [[:Plugins]] on how to install plugins manually.

===== Examples/Usage =====

This plugin allows you to define a random table like the ones you may see in your favorite RPG books. When rendered, it adds a button and well to pick an entry.

===== Syntax =====

A simple table:

<code>
  <RANDOMTABLE card_suit>
  1 Hearts
  2 Spades
  3 Clubs
  4 Diamonds
  </RANDOMTABLE>
</code>

You can also embed the roll button on separate pages.

Any entry in your table can also include one or more results from other tables with the following syntax. You can also make a table with a single result to pick from.

<code>
<RANDOMTABLE card>
**Decription:** {{roll on:card_face}} **Diversion:** {{roll on:card_suit}}
</RANDOMTABLE>
</code>

Now, you can also add a Select element to pick a table to roll on. Each new line can be a table identifier, or a table identifier and more readable label to show users.

===== Development =====

I developed this plugin on a PHP 8 based install and don't have any plans to support earlier versions of PHP.

=== Change Log ===

* **2022-11-23**
    * Initial release

===== Discussion =====

Please use the GitHub issue queue.

Please fill all the letters into the box to prove you're human. Q F B᠎ I Q Please keep this field empty:

Edit summary

Note: By editing this page you agree to license your content under the following license: CC Attribution-Share Alike 4.0 International