# FreeCoreGacha

**Repository Path**: freecore-mc/FreeCoreGacha

## Basic Information

- **Project Name**: FreeCoreGacha
- **Description**: FreeCore 抽奖插件
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-30
- **Last Updated**: 2026-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FreeCoreGacha

面向 Paper 26.2 / Java 25 的可配置抽奖插件。

## 指令与权限

- `/gacha`：打开全部卡池菜单，权限 `freecoregacha.use`（默认所有人）。
- `/gacha reload`：重载 `config.yml`、语言与所有卡池，权限 `freecoregacha.reload`（默认 OP）。

## 卡池配置

插件首次运行会生成 `plugins/FreeCoreGacha/pools/`。每个 `.yml` 是一个独立卡池，增删文件后执行 `/gacha reload` 即可。`classic.yml` 演示 Vault 金币，`key.yml` 演示带 CustomModelData 的指定物品。

消费项 `type` 支持：

- `VAULT`：Vault 经济金币。
- `ITEM`：指定原版材质，可额外匹配 `custom-model-data` 和 `name`。
- `LEVEL`：玩家经验等级。
- `PLACEHOLDER`：用 PlaceholderAPI 变量检查余额，以控制台命令扣费。字段为 `name`、`balance-placeholder`、`amount`、`withdraw-commands`，可选 `refund-commands`。命令支持 `%player%` 与 `%amount%`。

奖品的 `chance` 是相对权重，不要求总和等于 100。奖励可同时包含 `items` 和 `commands`；奖励命令支持 `%player%`。