apiverve_diceroller 1.2.3
apiverve_diceroller: ^1.2.3 copied to clipboard
Dice Roller is a dice API that simulates RPG dice rolls using standard notation like 3d6 or 2d20 with optional modifiers. It outputs the individual die outcomes, die count, and the sum of all rolls.
Dice Roller API - Dart/Flutter Client #
Dice Roller is a dice API that simulates RPG dice rolls using standard notation like 3d6 or 2d20 with optional modifiers. It outputs the individual die outcomes, die count, and the sum of all rolls.
This is the Dart/Flutter client for the Dice Roller API.
Installation #
Add this to your pubspec.yaml:
dependencies:
apiverve_diceroller: ^1.2.3
Then run:
dart pub get
# or for Flutter
flutter pub get
Usage #
import 'package:apiverve_diceroller/apiverve_diceroller.dart';
void main() async {
final client = DicerollerClient('YOUR_API_KEY');
try {
final response = await client.execute({
'dice': '1d6',
'modifier': 5
});
print('Status: ${response.status}');
print('Data: ${response.data}');
} catch (e) {
print('Error: $e');
}
}
Response #
{
"status": "ok",
"error": null,
"data": {
"dice_notation": "3d6",
"num_dice": 3,
"num_sides": 6,
"modifier": 5,
"rolls": [
6,
4,
4
],
"total": 14,
"total_with_modifier": 19,
"min_roll": 4,
"max_roll": 6,
"average_roll": 4.67,
"theoretical_min": 3,
"theoretical_max": 18,
"theoretical_average": 10.5,
"expression": "3d6+5"
}
}
API Reference #
- API Home: Dice Roller API
- Documentation: docs.apiverve.com/ref/diceroller
Authentication #
All requests require an API key. Get yours at apiverve.com.
License #
MIT License - see LICENSE for details.
Built with Dart for APIVerve