nuffleapp/nuffle

掷任何面数的骰子。

v1.0.4 2016-08-30 19:52 UTC

This package is not auto-updated.

Last update: 2024-09-18 19:59:27 UTC


README

MIT licensed Build Status codecov Gitter Packagist

Nuffle,PHP 库

Nuffle,PHP 库,是一个掷骰子计算库,提供执行复杂掷骰子和计算结果的功能(例如:5d6 + 1d20 / (1d6 - 2))。

安装

通过 Composer

要求库并通过 Composer 更新

composer require nuffleapp/nuffle
composer update

手动

下载 最新版本,解压到名为 nuffle 的目录中,并在您的脚本开头包含库

include_once('./nuffle/src/Nuffle.php');
use \Nuffle\Nuffle;

使用方法

Nuffle 是一个掷骰子计算器,允许您执行复杂的掷骰子并计算结果。要这样做,只需用您的等式调用 roll() 方法

Nuffle::roll('5d6 + 1d20 / (1d6 - 2)')

该方法将返回一个类似于以下的对象

{
   "rolls" : [
      {
         "notation" : "5d6",
         "rolls" : [
            2,
            1,
            2,
            4,
            5
         ]
      },
      {
         "notation" : "1d20",
         "rolls" : [
            11
         ]
      },
      {
         "rolls" : [
            4
         ],
         "notation" : "1d6"
      }
   ],
   "equation" : "(2 + 1 + 2 + 4 + 5) + (11) / ((4) - 2)",
   "result" : 19.5,
   "input" : "5d6 + 1d20 / (1d6 - 2)"
}

该对象包括每个单独的掷骰子表示的值、展开的等式、等式结果和原始输入。

贡献

请阅读我们的 贡献指南。其中包含打开问题、编码标准和开发注意事项的说明。

版本控制

为了使我们的发布周期透明并努力保持向后兼容性,Nuffle 在 语义化版本控制指南 下维护。有时我们会犯错误,但我们会尽可能遵守这些规则。

查看我们的 GitHub 项目的 发布部分,以获取每个 Nuffle 发布版本的更改日志。

支持

问题跟踪器 提交 错误报告功能请求提交拉取请求 的首选渠道。

对于个人支持请求,请使用 Gitter 来获取帮助。

版权和许可

代码和文档版权所有 2016 nuffleapp。代码在 MIT 许可证 下发布。