Description
Roll the Dice
Issue? Suggestion? Hate mail? File an issue on GitHub!
Just kidding about the hate mail ._.
Important info
RTD 1.1.0 BETA is now available for testing! (download)
The new beta introduces:
- {rtime} outcome variable
- a shiny new default config file
- a few code and speed optimizations (generally not as important)
Links
- How to Use RTD
- How to Set Up RTD (YouTube) - video embedded below
- View RTD on GitHub
Description
RTD was made to mimic dice-rolling plugins found on some custom multiplayer servers for other like Team Fortress 2. With these games and the user in mind, this plugin is the most customizable and user-friendly dice-rolling plugin available for Bukkit.
RTD's main functions (in more depth below) allow for the owner of the server to create and fully customize all potential outcomes of rolling the dice. In fact, the more outcomes, the better: more outcomes means more randomization. This can be exploited to a fault, of course: copying and pasting twenty copies of the same two outcomes still only gives each outcome a one-in-two shot, regardless of the number of copies.
Other plugins have preset outcomes out-of-the-box? Bah! RTD allows for easy customization, addition, and removal of outcomes.
Other plugins give you only numbers? What?! With RTD, you can replace all commands with "/say" followed by a number, and BAM!, you've just made RTD into one of those!
Got another plugin like CommandBook that you want to work with RTD? It already does! Just put the command you want into an outcome, and now your users are rolling for Thor's hammer (check that link back there).
What are outcomes?
"Outcomes", which refer to each outcome of having rolled the dice, are lists of player and console commands that will be executed should that outcome be selected by the plugin. For example, this config.yml...
# config.yml outcomes: suicide: - say $(player) rolled for SUICIDE! - kill diamond: - say $(player) rolled for a diamond! - give $(player) diamond 1
...could either give the player a diamond, or slaughter them and scatter their inventory like shredded paper. And it's totally random!
Setting up RTD
There's a bit of a guide here (link) on how to set up RTD, but it's really not that difficult.
There are three basic steps to setting up RTD:
- Download
- Download RTD from BukkitDev: just click that link up there on the right.
- Configure
- Place RTD in the plugins folder of your server
- Modify the configuration file to your heart's content
- Deploy
- Start or reload the server, and RTD is ready to go!
Basic info
Major functions
- Allows for total customization of outcomes using config.yml
- Features full bug and error reporting support
- If a command fails, RTD notifies the user and logs in the console
Commands (1)
/rtd
- Rolls the dice (selects one outcome from many defined outcomes at random)
Permissions
None yet as of initial release (1.0.0).
Planned permissions:
- Permission to execute the command
Changelog
1.0.1
- Added cooldown timer
- Added a bit of color cosmetics
1.0.0
- Initial release



