New Posting Features - Diceroller

Diceroller by PointSingularity, originally written for 2d4.org

Version 1.002

This feature adds the functionality to post dice rolls. The rolls are associated with posts but cannot be edited even if the post can.

No longer supported.

WARNING!!
It has been brought to my attention that a bug causes a MySQL error when using the pm system!
To fix this, edit the plugin that's connected to the postbit display complete hook and add at the very top:

if (!empty($post['postid'])) {

then add at the very bottom:

}

CHANGELOG

1.002
*Moved the dice roller itself into a more discreet area. Now works well with either postbit or postbit_legacy!
*Added user option in the user cp for appearance (forum default, full, compatibility mode). Appearance can be enforced in the settings, disabling the user cp options and overriding any personal settings already set.
*Added settings variable for main width.
*Changed the font-size in a few places to make it look a bit more discreet.
*Made the separate rolls lists collapsable.
*Removed the nevershowfulllist function since it was completely pointless due to the newly collapsable lists.
*Fixed bug that would claim description title was too long even if it wasn't when certain characters were entered.
*Design fixes and reorganizing. The border now looks like the rest of the postbit's.
*Added "roll" button.
*Added code for clearing up memory after database queries.
*Dice are now sorted by result (rolls are still sorted by id).
*Connected to template hooks to further simplify the installation process.
*Moved all of diceroller.php into the main plugin.

1.001
*Fixed counter error when dice list is in tooltip mode.
*Added complete vBulletin Language/Phrase support.
*Added low-profile mode. This will display entries as plain text, which is excellent if you want an uber-lite look or want better browser support since this turns off the java features.
*Sorting sorted out. ;p Lists now sort with the newest entry on top in vertical lists and the newest at the end in horizontal (tooltips and low-profile mode).
*Reorganized data and simplified installation process.
--Notes: If upgrading, remove everything except the database and reinstall, following the new installation process.



UPGRADE INSTRUCTIONS
From v1.001
Upgrade within vBulletin using the new product-diceroller.xml. Be sure to check "allow overwrite" or upgrade won't work. Then upload the roll.gif image into the /buttons directory. Finally revert your template changes you made for the last version (they are no longer needed) and delete diceroller.php (it's not needed anymore either).

From v1.0
Do NOT upgrade from v1.0. Instead delete the old templates, uninstall the plugins, etc. manually! You can keep the database if you'd like as that has not been changed.
Version 1.001 comes with a proper installer and is upgradable.


INSTALLATION INSTRUCTIONS
1. Upload and put roll.gif to your theme's "button" folder on the webserver (or make your own button ).
2. Import the product file product-diceroller.xml.
DONE!


CHANGE SETTINGS:
There's no addition to the admin cp, instead you can edit the settings by adjusting the values in the plugin called "Diceroller Settings". Be careful though!

ALSO IMPORTANT: Be sure to have plugins enabled in vBulletin or this won't work.


KNOWN ISSUES

v1.002
*Quote-box gets dropped down, leaving the title where it should be, if the dice roller is in the way.

[PGAmerica]

As long as we are requesting features for the next version (and I understand that you have very little time):

• Show individual die rolls
• Allow for pre-selected rolls for rolling rpg character stats (4d6 throw away lowest die, 3d6 and re-roll 1s and 2s)
• Usergroup permissions to allow certain groups to change die rolls
• Usergroup permissions to allow only certain usergroups to roll dice (I know I already said this)
• Usergroup permissions to allow only certain usergroups to see rolled dice values
• Modifiers per dice
• Modifiers per entire die roll
• Forum permissions to allow the dice in specified forums only (or at least the reverse, specify which forums cannot use the dice) (I know I already said this)
• Be able to roll dice when making a new post instead of having to do it after the fact.

[PntSingularity]

Originally Posted by PGAmerica

As long as we are requesting features for the next version (and I understand that you have very little time):[LIST]
Show individual die rolls

Wasn't that in 1.002? Hmm, well that will definitely be included.

Allow for pre-selected rolls for rolling rpg character stats (4d6 throw away lowest die, 3d6 and re-roll 1s and 2s)

This wouldn't work in conjunction with the ability to roll strings with multiple rolls of different dice. Well, unless the options applied to all of the rolls or if options were to be added within the syntax eg. "(r1(k1(2d4))+5)*r3(3d6)+k2(4d4)" where rx would mean reroll these and lower dice and kx would mean to not use the x number of lowest results. But this would mean clumpsy looking strings and a difficulty for the user. Not the mention the PitA for me to actually code this.

Usergroup permissions to allow certain groups to change die rolls

To reroll or edit them manually?

Usergroup permissions to allow only certain usergroups to roll dice (I know I already said this)

Indeed you did.

Usergroup permissions to allow only certain usergroups to see rolled dice values

Alot of permssion settings you're after. It will most likely prove tricky to get all this to work, but I'l give it a shot when time allows me.

Modifiers per dice

Umm, why?
Well, if I do implement the feature to roll an entire string you could always enter something like "1d20*2+1d20*3+1d20+5+1d20-3", or do you mean adding the same multiplier to each roll?
I can't see many reasons for this but the latter wouldn't be very hard to implement whether I implement string rolling or stick with single rolls. The only problem is that with the string system the modifier would affect all rolls within the string.

It seems most of your ideas revolve around not using the string roll system. Perhaps single rolls with modifiers is a better idea. Perhaps I'll add the optional ability to roll using a string syntax at a later time since it would need extensive work to work along with all these specifications.

Modifiers per entire die roll

Already done, just not released yet.

Forum permissions to allow the dice in specified forums only (or at least the reverse, specify which forums cannot use the dice) (I know I already said this)

I've actually thought about this, but I decided it wasn't important enough. Well, maybe I was just being lazy, I don't know. I'll have a look into this as well.

Be able to roll dice when making a new post instead of having to do it after the fact.

I thought about ways to do this as well, but I couldn't quite figure out a good way to do this. I had originally planned on adding the rolls in a list just like the attachments feature.


I'll put these things on my to do list. But as I've said my time is very limited atm.
I'll see if I have time to take a peek into it this weekend, but I have no idea when I'll be done with the list.

[PGAmerica]

Originally Posted by PntSingularity

This wouldn't work in conjunction with the ability to roll strings with multiple rolls of different dice. Well, unless the options applied to all of the rolls or if options were to be added within the syntax eg. "(r1(k1(2d4))+5)*r3(3d6)+k2(4d4)" where rx would mean reroll these and lower dice and kx would mean to not use the x number of lowest results. But this would mean clumpsy looking strings and a difficulty for the user. Not the mention the PitA for me to actually code this.

You are right, that sounds real messy.

Originally Posted by PntSingularity

To reroll or edit them manually?

To edit them, As an admin, I reserve the right to cheat.

Originally Posted by PntSingularity

Umm, why? Well, if I do implement the feature to roll an entire string you could always enter something like "1d20*2+1d20*3+1d20+5+1d20-3", or do you mean adding the same multiplier to each roll? I can't see many reasons for this but the latter wouldn't be very hard to implement whether I implement string rolling or stick with single rolls. The only problem is that with the string system the modifier would affect all rolls within the string.

As an RPGer, if a user has an item that automatically adds 2 to every damage roll and adds 2 to every attack roll, you would want a roll of something like "1d20+2" for the attack roll and "1d8+2" for the damage roll for each dice. Now, with the modifiers you are adding, I can always have them roll the attacks individually (if they get multiple attacks) and the same for damage.

They would have top roll individually anyway (at least for the attack roll) as that roll is not one that can be added to more dice.

Originally Posted by PntSingularity

It seems most of your ideas revolve around not using the string roll system. Perhaps single rolls with modifiers is a better idea. Perhaps I'll add the optional ability to roll using a string syntax at a later time since it would need extensive work to work along with all these specifications.

I love the rolling system on your site. Is it possible to do both? Allow the user to choose the string method or the single roll method?

Originally Posted by PntSingularity

I thought about ways to do this as well, but I couldn't quite figure out a good way to do this. I had originally planned on adding the rolls in a list just like the attachments feature.

Not mission critical. However, I am already fending off questions from my users because they have to go in after posting and roll the dice. I say "let them remain confused until they grow a brain". They will get used to it soon enuf.

Originally Posted by PntSingularity

I'll put these things on my to do list. But as I've said my time is very limited atm.

That, I understand.

Originally Posted by PntSingularity

I'll see if I have time to take a peek into it this weekend, but I have no idea when I'll be done with the list.

Thank you. I love the mod so far. This looks like it has the potential to be a huge aspect to an rpg forum.

[DL_Ashe]

The additions in relation to the modifier and other changes sound great. Whenever you get the time to get a later version up would be wonderful, and I'm sure greatly appreciated by less able folks in the scripting/coding realm (such as myself!).

Originally Posted by PntSingularity

Though this WILL take time. I've got to read The Nicomachean Ethics this weekend and it's 300+ pages...

Ouch... just ouch.

Originally Posted by PntSingularity

Btw, it's funny that my mod seems to get so much more attention now that I have less time to work with it...

That's Murphy's Law, my friend. I only came across your mod a few days ago, and immediately fell in love with it. I *wish* I had've known about it the day you released it... so I had more opportunity to bug you about modifiers then!

Seriously though, your work is fabulous and whenever you are willing and able to get an updated one done would be brilliant. But work and school come first... and the Nicomachean Ethics is no light read, particularly doing it in one weekend.

[Ralf vd Enden]

I'm interested in the latest version of this mod (which includes the modifiers, etc.).
Any ETA on when it'll be available ?

Thanks in advance for any information.

[PntSingularity]

Originally Posted by Ralf vd Enden

I'm interested in the latest version of this mod (which includes the modifiers, etc.).
Any ETA on when it'll be available ?

Thanks in advance for any information.

It's not looking like it's going to happen soon I'm afraid. Lately I've been too busy to do any actual work on it at all. I have been contemplating some ideas for it but that's about it.

But I'll make sure to post any updates here.

[PGAmerica]

I appreciate you watching this thread. So many times I see threads ignored and it really irritates me

[PntSingularity]

Originally Posted by PGAmerica

I appreciate you watching this thread. So many times I see threads ignored and it really irritates me

No problem, it's in my subscriptions so I receive an e-mail each time there's an update.

[PGAmerica]

You might want to re-post this (with the "Security Token" addition) in the the 3.7 mods just to make it clear it is available for them as well. This is the best dice roller I have ever seen on this site.

[jeremycards]

Hello, im really needing this plugin to work, but after installing everything when i click to add the roll dice i get the message "sorry this can't be processed as a security token couldn't be found" well something like that (my forum is in spanish), so there's any way to fix that?

btw my version is 3.7.3