New Posting Features - Dice Roll

This product is in response to the request posted by Tri@de here:

Bbcode dice roller with image and customizable

Overview:

This product is designed to allow your users to roll virtual dice in their posts. Included are two sets of dice face image sets, one for the standard six-faced regular hexahedral (cube) dice, and one for regular dodecahedral (12-sided) dice.



A numeric roll is also allowed, where the number of dice and faces can be specified, and the dice are shown in a tabular format as numbers rather than as images.

Upon installation, a custom BBCode ([DICE][/DICE]) is added for displaying the dice face images. THis way CSS can be added via a class selector, and there will be no interference with your default [img]https://vborg.vbsupport.ru/[/img] tags.

Images:

In the product settings, in the setting labeled "Dice Set Indentifiers" you can give each image set a unique identifier, which is used within the [ROLL=X][/ROLL] tags, where "X" is the identifier of the set to be used. Using this setting, you can specifiy an indetifier for any image set you upload to be used as dice faces. These sets need to be uploaded to your "images/dice" folder. There is a setting that allows you to add your own custom CSS to the images.

In its simplest form, a user may enter something like [ROLL=1]5[/ROLL] to get five randomaly generated dice faces from set "1". If the user wishes to only use, for example the first 4 faces, then they would enter [ROLL=1]5d4[/ROLL]. If the number entered for the number of faces to be used is greater than the total number of faces you specify in the settings, or less than 1, then this will be set to that maximum value.

For example, if a user enters [ROLL=1]5[/ROLL], then their post will look something like:

Numbers:

Your users can also use numeric sets with as many faces as desired using the tags [NROLL][/NROLL], and these dice will simply be shown as numbers within a table. For example, if a user wishes to roll six 17-faced dice, then they would enter [NROLL]6d17[/ROLL].

In all cases, the sum of the faces is shown and if the number of dice specified is not greater than zero, no replacement will be carried out.

For example, if a user enters [NROLL]5d50[/NROLL], then their post might look something like:

Tamper Resistance:

When dice are rolled, above the output will be the text "Legitimate Dice Roll" (which you can alter via the phrase for that text). If a user edits their post for any reason, then this phrase will be replaced by another phrase which states "Illegitimate Dice Roll!"



If they have removed the legitimate phrase, then nothing will appear there. If they try to manually construct a dice roll using the appropriate BBCodes, and have added the legit phrase themselves, it will be replaced with the illegit phrase. So, unless a dice roll has the legit phrase above it, you know it could have been tampered with by the OP. If an admin/mod edits a user's post, then the legit phrase will remain intact. You may also specify users by usergroup who are allowed to edit their own posts with the legit phrase left intact.

Active Forums:

In the product settings, you can designate forums where this product is active as you will likely wish to restrict the dice rolls to your gaming area(s) only.

Compatibility:

Tested and working on VB 4.2.x and may work on all 4.x versions of vBulletin.

Backup/Warning:

This product alters the structure of your database, however it is always good practice to make regular backups and you should make a backup before installing ANY new product.

As always, products are USE AT YOUR OWN RISK. I will provide support and do my best to help but no absolute guarantee is offered.

To Install:

1. Download and extract the attached .zip file.
2. Upload the contents of the "upload" folder to your forum's root directory.
3. Follow AdminCP -> Plugins & Products -> Manage Products -> Add/Import Product.
4. Click on "Choose File" and browse to the product .xml file that was packaged in the .zip file.
5. Click "Import."
6. You MUST enable the product in the settings before it will function.
7. Configure the remaining settings to your liking. Each setting has a detailed explanation of its use.

Support for this product can be found here:

• MHB - Dice Roll
• TAZ - Dice Roll