Repository files navigation

diceroll is a Python library that provides API functionality (dicerollAPI) for simulating dice rolls and performing dice-related operations.

It includes classes for rolling dice, tracking & saving roll results, and animating dice rolls using Pygame (optional)

API documentation starts here:https://github.com/ViciousSquid/diceroll/blob/main/Docs/dicerollAPI.md

• Roll various types of dice (e.g., 2d6, 1d20, 3d8+1d4) and get the roll results
• Console printing and logging
• Save the last 5 roll results to a file (.txt or .json)
• Retrieve the last 5 roll results
• Saving throws and skillchecks
• Set/Get the dice/font color (red, white, blue, black, green, custom)
• Animations (optional, requires Pygame)

https://github.com/ViciousSquid/diceroll/tree/main/Docs

Run the example files:roll_dice_example.py (console based) androll_dice_example_GUI.py (GUI based, uses Pygame)

This API was custom-designed for use in theAdventure!Interactive story engine :https://github.com/ViciousSquid/Adventure

How to integrate the API into your own projects is demonstrated by the above game engine