インストール手順

  1. GachaPlugin.jar をサーバーの plugins/ フォルダに入れる
  2. サーバーを起動する(plugins/GachaPlugin/ フォルダが自動生成されます)
  3. 生成されたファイルを確認する
plugins/
└── GachaPlugin/
    ├── config.yml        ← グローバル設定
    └── gachas/
        └── gacha1.yml    ← サンプルガチャ(デフォルトで生成)

config.yml の設定

global:
  cooldown_seconds: 5   # ガチャの再発動までの待機秒数
  max_queue: 3          # 同時にキューに入れられるリクエスト数

最初のガチャを作る(クイックスタート)

ステップ1: gachas/ フォルダに新しいYAMLファイルを作成する

例:gachas/mygacha.yml

ステップ2: 最小構成のYAMLを書く

name: "テストガチャ"
enabled: true

spin:
  duration_ticks: 200
  interval_start: 2
  interval_end: 10
  sound: SLOT_NORMAL

suspense:
  enabled: true
  count: 3
  interval: 30

announce:
  on_start:
    enabled: true
    message: "&e{nickname} &fがガチャを発動!"

items:
  - name: "大当たり!"
    rarity: 1
    weight: 10
    spin_label: "★★★"
    commands:
      - "give {player} diamond 1"
  - name: "ゾンビ召喚"
    rarity: 2
    weight: 90
    commands:
      - "execute at @a[name={player},limit=1] run summon zombie ~ ~ ~"

ステップ3: /gacha reload でガチャを読み込む

ステップ4: /gacha spin mygacha で動作確認


権限の付与

権限ノード 用途
gachaplugin.use /gacha spin の実行権限(STEアカウントに付与)
gachaplugin.admin 全コマンドの実行権限(管理者用)