抽選箱 - LotteryBox.js

シェア用テキスト：

▼抽選箱（奏ねこま（おとぶきねこま）様作） - LotteryBox.js
https://plugin.fungamemake.com/archives/13104
ランダムでアイテムや装備、お金が手に入る抽選箱を提供します。

ふりがな：ちゅうせんばこ

機能概要： ランダムでアイテムや装備、お金が手に入る抽選箱を提供します。

利用規約（ライセンス）：
・著作権：保持
・商用利用：許可
・追加改変：許可
・再配布：禁止 （素材を利用した作品の配布は再配布に当たりません。）
・詳細はダウンロードページ・プラグイン内を確認

作者：奏ねこま（おとぶきねこま）

作者サイト：https://x.com/koma_neko

解説ページ：https://makonet.sakura.ne.jp/rpg_tkool/Old/

ファイル名：LotteryBox.js

プラグインのヘルプ：

/*:
 * @plugindesc ランダムでアイテムや装備、お金が手に入る抽選箱を提供します。
 * @author こま
 *
 * @param Result Variable Number
 * @desc 抽選の結果を保存する変数を、番号で指定してください。
 * （0：保存しない）
 * @default 0
 *
 * @param Name Variable Number
 * @desc 入手品の名前（お金の場合、金額）を保存する変数を、番号で指定してください。（0：保存しない）
 * @default 0
 *
 * @param Auto Empty Mode
 * @desc 抽選後、抽選箱を自動的に空にするかどうかを指定してください。
 * （ON：空にする / OFF：空にしない）
 * @default ON
 *
 * @help
 * 重要：「追加したチケットの有効範囲について」は必ずご一読ください。
 *
 * プラグインコマンド
 *  LotteryBox add item 1       # アイテムが当たるチケットを1枚追加します。
 *  LotteryBox add weapon 5     # 武器が当たるチケットを5枚追加します。
 *  LotteryBox add armor 10     # 防具が当たるチケットを10枚追加します。
 *  LotteryBox add gold:100 15  # 100Gが当たるチケットを15枚追加します。
 *  LotteryBox add lose 20      # ハズレチケットを20枚追加します。
 *
 *  LotteryBox add item:1 1     # ID=1のアイテムが当たるチケットを1枚追加します。
 *  LotteryBox add weapon:5 1   # ID=5の武器が当たるチケットを1枚追加します。
 *                                  *IDについては後述
 *
 *  LotteryBox add gold:100;200 1    # 100～200Gが当たるチケットを1枚追加します。
 *  LotteryBox add gold:100;200;10 1 # 100～200Gが当たるチケットを1枚追加します。
 *                                      *前者は1G単位、後者は10G単位
 *
 *  LotteryBox draw             # 抽選を実施します。
 *  LotteryBox empty            # 抽選箱を空にします。
 *
 * ------------
 *  IDについて
 * ------------
 *  アイテムや武器、防具にIDを割り振ることで、抽選対象を限定することができます。
 *  IDを割り振りたい対象のメモ欄に、
 *  <lotterybox_id:1>
 *  のように記述してください。
 *  例えば上記をポーションとマジックウォーターのメモ欄に記述し、
 *  「Lottery Box add item:1 1」とすると、ポーションかマジックウォーターが当たる
 *  チケットを1枚追加したことになります。
 *
 * ------------------
 *  抽選結果について
 * ------------------
 *  抽選結果は以下のようになります。
 *  ・ID未指定のチケット当選時
 *      入手品の所持数が+1されます。
 *      Result Veriable Numberで指定した変数には「1」が設定されます。
 *      Name Variable Numberで指定した変数には、入手品の名前が設定されます。
 *  ・ID指定のチケット当選時
 *      入手品の所持数が+1されます。
 *      Result Veriable Numberで指定した変数にはIDが設定されます。
 *      Name Variable Numberで指定した変数には、入手品の名前が設定されます。
 *  ・お金のチケット当選時
 *      当選金額が所持金にプラスされます。
 *      Result Veriable Numberで指定した変数には金額（数値）が設定されます。
 *      Name Variable Numberで指定した変数には「金額＋単位」が設定されます。
 *  ・ハズレチケットの場合
 *      Result Variable Numberで指定した変数には「0」が設定されます。
 *
 * ------------------------------------
 *  追加したチケットの有効範囲について
 * ------------------------------------
 *  「LotteryBox add」で追加したチケットは、「LotteryBox empty」で明示的に抽選箱
 *  を空にするか、Auto Empty Modeで「LotteryBox draw」とともに空にされないかぎり
 *  箱に追加されたままの状態になっています。また、箱の中の状態はセーブ時に保存さ
 *  れ、セーブデータをロードした際に復元されます。空にしないまま追加のみを行うと
 *  チケットが際限なく増えていくことになりますのでご注意ください。
 */