原创 闭源 HangPointsReward - 航式累充奖励 1.2.0

[MD] # HangPointsReward - 累计充值奖励插件 ## 📖 插件简介 一款轻量级的累计充值奖励插件，支持自动监听后台充值命令，玩家累计充值达标后自动发放阶梯奖励。支持自动发放和手动领取两种模式，配备精美的GUI界面和多页翻页功能。 --- ## ✨ 核心功能 - ✅ **自动监听充值** - 监听后台充值命令，自动累计玩家充值金额 - ✅ **阶梯奖励系统** - 支持无限档位的累计充值奖励配置 - ✅ **双模式发放** - 支持自动发放 / 手动领取两种模式 - ✅ **精美GUI界面** - 可自定义的奖励展示界面，支持多页翻页 - ✅ **PlaceholderAPI支持** - 提供变量用于其他插件调用 - ✅ **命令管理** - 支持手动增减玩家累计充值数据 --- ## 📋 命令列表 | 命令 | 别名 | 权限 | 说明 | |------|------|------|------| | `/pointsreward reload` | `/pr reload` | `pointsreward.admin` | 重载配置文件 | | `/pointsreward gui [玩家]` | `/pr gui` | `pointsreward.admin` | 打开指定玩家的奖励界面 | | `/pointsreward check [玩家]` | `/pr check` | `pointsreward.admin` | 查询玩家累计充值 | | `/pointsreward reset <玩家>` | `/pr reset` | `pointsreward.admin` | 重置玩家累计充值 | | `/pointsreward set <玩家> <数量>` | `/pr set` | `pointsreward.admin` | 设置玩家累计充值 | | `/pointsreward add <玩家> <数量>` | `/pr add` | `pointsreward.admin` | 增加玩家累计充值 | | `/pointsreward remove <玩家> <数量>` | `/pr remove` | `pointsreward.admin` | 减少玩家累计充值 | | `/czjl` | `/充值奖励` | `pointsreward.gui` | 打开自己的奖励界面 | --- ## 🎮 使用教程 ### 1️⃣ 安装插件 1. 下载插件 jar 文件 2. 将插件放入服务器 `plugins` 文件夹 3. 重启服务器 4. 插件会自动生成配置文件 ### 2️⃣ 配置充值监听 编辑 `plugins/HangPointsReward/config.yml`，配置你的充值系统命令格式： ```yaml listen-commands: - "points give {player} {amount}" - "playerpoints give {player} {amount}" ``` **说明：** - `{player}` - 玩家名的位置 - `{amount}` - 充值金额的位置 - 支持配置多条命令，任意一条匹配即可 ### 3️⃣ 配置奖励档位 ```yaml rewards: 1: require: 100 # 需要累计充值100点券 commands: - "give %player% diamond 5" broadcast: "&6[充值奖励] &e%player% &a累计充值达到 &c%require% &a点券!" message: "&6恭喜你累计充值达到 &c%require% &6点券, 奖励已发放!" 2: require: 500 commands: - "give %player% diamond_block 10" broadcast: "&6[充值奖励] &e%player% &a累计充值达到 &c%require% &a点券!" message: "&6恭喜你累计充值达到 &c%require% &6点券, 奖励已发放!" ``` ### 4️⃣ 自定义GUI界面 编辑 `plugins/HangPointsReward/gui.yml` 自定义奖励展示界面： ```yaml title: "&6&l充值奖励 &7- &e累计: %total% &7(&f%page%&7/&f%maxpage%&7)" size: 54 items: 1: page: 1 slot: 20 display: material: DIAMOND name: "&b&l初级奖励" lore: - "&7需要累计充值: &e%require% &7点券" - "&7你的累计充值: &e%total% &7点券" - "%status%" ``` --- ## 🔧 配置说明 ### 奖励发放模式 ```yaml auto-claim: true # true=自动发放 false=手动领取 ``` - **自动模式：** 玩家充值达标后自动执行奖励命令 - **手动模式：** 玩家需要打开GUI界面手动点击领取 ### 可用变量 **config.yml 中：** - `%player%` - 玩家名 - `%require%` - 奖励所需充值金额 - `&` - 颜色代码 **gui.yml 中：** - `%player%` - 玩家名 - `%total%` - 玩家累计充值 - `%require%` - 奖励所需充值金额 - `%status%` - 奖励状态（未达标/可领取/已领取） - `%remaining%` - 距离达标还差多少 - `%page%` - 当前页码 - `%maxpage%` - 总页数 --- ## 🎯 PlaceholderAPI 变量 安装 PlaceholderAPI 后可使用以下变量： - `%pointsreward_total%` - 玩家累计充值点券数 - `%pointsreward_require%` - 下一个未领取档位所需点券数 - `%pointsreward_remaining%` - 距离下一个档位还差多少点券 --- ## 📦 依赖插件 **必需：** 无 **可选：** PlaceholderAPI（用于变量支持） --- ## 💡 使用场景 1. **充值返利系统** - 玩家累计充值达标自动发放奖励 2. **VIP升级系统** - 充值达标自动升级玩家权限组 3. **活动奖励** - 配合充值活动发放限时奖励 4. **贵族系统** - 类似王者荣耀的贵族积分系统 --- [/MD]
Q群361919269 禁广 有报错或者想添加的可以跟我说