Download the PHP package porthou/dicebag without Composer
On this page you can find all versions of the php package porthou/dicebag. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package dicebag
DiceBag
Create dice roll results from standard dice notation
A Simple Example
Installation
Prerequisites
DiceBag Requires PHP 7.1 or greater.
Installation Through Composer
Installation through composer is simple, just require it through the command line with the following command:
Using DiceBag
DiceBag is designed to allow you to create results with as little as possible configuration, whilst being as random as
possible. By default it will use PHP7's default CSRNG generation using random_int.
If a custom RNG is desired then it can be passed in to the DiceBag::factory() method as the second parameter. This
will be passed through to any instances needing the RNG.
Dice Types
There are 3 types of "Dice"
Standard Dice NdX
This rolls N standard Numeric dice with X sides per die. If N is not specified it is assumed to be 1
Examples
d6Rolls a 6 Sided Die.4d6Rolls 4 6 Sided Dice.d20Rolls a 20 Sided Die.
Fate Dice NdF
This rolls N Fate (also known as fudge) dice. If N is not specified it is assumed to be 1. Fate dies can roll -1, 0 or 1.
Examples
fRolls a Fate die.4fRolls 4 Fate die.
Fixed Modifiers X
Fixed modifiers are most useful when combined with other dice formats. They add (or subtract) a fixed value
Examples
2d6+10Rolls 2 6 sided dice and adds 10 to the result.
Dice Pool Modifiers
Dice pool modifiers are used to change the results of a dice pool.
Keep Highest khX
This keeps the Highest X results from the dice pool.
Examples
4d6kh3Rolls 4 d6 and keeps the highest 3.
Drop Lowest dlX
This drops the Lowest X results from the dice pool.
Examples
4d6dl1Rolls 4 d6 and drops the lowest result.
Keep Lowest klX
This Keeps the Lowest X results from the dice pool.
Examples
4d6kl1Rolls 4 d6 and keeps the lowest result.
Drop Highest dhX
This Drops the Highest X results from the dice pool.
Examples
4d6dh1Rolls 4 d6 and drops the highest result.
Exploding Dice !cN
Exploding Dice add an additional dice to the pool if the maximum is rolled. These additional dice may also explode.
If only N is specified then the dice will explode on the value specified.
c is a conditional, which can be either <, > or unspecified. When specified with N dice will explode when the value is either
greater than or equal to, or less than or equal to, the value specified.
Examples
4d6!Rolls 4 d6 and and any results of 6 will add an additional die to the pool.4d6!1Rolls 4 d6 and and any results of 1 will add an additional die to the pool.4d6!>5Rolls 4 d6 and and any results of 5 or greater will add an additional die to the pool.4d6!<2Rolls 4 d6 and and any results of 2 or less will add an additional die to the pool.
