原创 闭源 HxInvitePoints 星牌邀请玩家返利 | 邀请码 | MySQL多服同步 | 增加营收 | 下级充值返利 | 支持 1.12-1.21.10 V1.01

[MD] # HxInvitePoints `HxInvitePoints` 是一款面向 `Paper/Spigot 1.12.2-1.21.10` 的邀请返利插件。 当新玩家使用邀请码绑定邀请人后，后续后台执行加点命令时，插件会先给该玩家本人发放点券，再根据配置比例为邀请人发放返利点券，并同时记录统计数据与流水。 ！如果你使用其他的点券/经济插件同样可以使用本插件，因为我们的货币调用是通过config设置的命令实现。 ## 优势 - 支持 `SQLite` 与 `MySQL` - 支持 `PlaceholderAPI` - 支持后台加点返利命令 - 支持管理员改绑、解绑 - 支持自动补全 `config.yml` 与 `messages.yml` 缺失键位 - 面向中文服主使用，默认配置与消息均为中文 ## 使用方法 1. 将插件放入服务器 `plugins` 目录。 2. 首次启动后，修改 `plugins/HxInvitePoints/config.yml`。 3. 将 `reward.commands.self` 改为你实际使用的点券发放命令。 4. 将 `reward.commands.inviter` 改为你实际使用的邀请返利命令。 5. 重启服务器或执行 `/hip admin reload`。 ## 命令 - `/hip help` 查看帮助 - `/hip code` 查看自己的邀请码 - `/hip stats` 查看自己的邀请统计 - `/hip bind <邀请码>` 绑定邀请人 - `/hip admin info <玩家>` 查看玩家邀请数据 - `/hip admin grant <玩家> <点券> [备注]` 后台加点并结算返利 - `/hip admin rebind <玩家> <邀请人>` 管理员改绑邀请关系 - `/hip admin unbind <玩家>` 管理员解绑邀请关系 - `/hip admin reload` 重载配置 ## 权限 - `hxinvitepoints.use` 使用基础命令 - `hxinvitepoints.bind` 使用邀请码绑定 - `hxinvitepoints.code` 查看邀请码 - `hxinvitepoints.stats` 查看统计 - `hxinvitepoints.admin` 管理员总权限 - `hxinvitepoints.admin.info` 查看玩家数据 - `hxinvitepoints.admin.grant` 后台发点与返利 - `hxinvitepoints.admin.rebind` 管理员改绑 - `hxinvitepoints.admin.unbind` 管理员解绑 - `hxinvitepoints.admin.reload` 重载插件 ### 命令模板占位符 - `{player}` 被充值玩家名称 - `{player_uuid}` 被充值玩家 UUID - `{amount}` 本次给玩家发放的点券数量 - `{inviter}` 邀请人名称 - `{inviter_uuid}` 邀请人 UUID - `{commission}` 本次返利给邀请人的点券数量 - `{reason}` 本次备注 ## PlaceholderAPI 标识符固定为 `hxinvitepoints`。 所有变量都使用前缀 `hxinvitepoints`，即 `%hxinvitepoints_xxx%`。 - `%hxinvitepoints_code%` 显示玩家自己的邀请码，例如 `A8K2M9QX`。 - `%hxinvitepoints_inviter_name%` 显示该玩家的邀请人名称；如果未绑定，则显示 `messages.yml` 中的 `placeholder.undefined`，默认 `无`。 - `%hxinvitepoints_has_inviter%` 显示该玩家是否已绑定邀请人；已绑定显示 `是`，未绑定显示 `否`。 - `%hxinvitepoints_invited_count%` 显示该玩家当前已邀请成功的人数，例如 `12`。 - `%hxinvitepoints_self_grant_total%` 显示该玩家历史累计获得的充值点券总数，例如 `6480`。 - `%hxinvitepoints_self_grant_count%` 显示该玩家历史累计被后台加点的次数，例如 `7`。 - `%hxinvitepoints_commission_total%` 显示该玩家作为邀请人累计获得的返利点券总数，例如 `980`。 - `%hxinvitepoints_commission_count%` 显示该玩家作为邀请人累计拿到返利的次数，例如 `5`。 - `%hxinvitepoints_team_grant_total%` 显示该玩家所有直属下级累计充值点券总数，例如 `9800`。 - `%hxinvitepoints_bind_time%` 显示该玩家绑定邀请人的时间，格式为 `yyyy-MM-dd HH:mm:ss`，例如 `2026-04-17 18:30:00`；如果未绑定，则显示 `无`。 ### PAPI 空值说明 - 当玩家数据尚未缓存、玩家从未进服、或该字段本身没有值时，变量会回退为 `messages.yml` 中的 `placeholder.undefined`。 - 当前默认回退文本是 `无`。 - `has_inviter` 这个变量例外，它显示的是 `placeholder.yes` 或 `placeholder.no`，默认分别是 `是` 和 `否`。 ## 使用说明 - 本插件类似于分销平台，那种上下游返利，被邀请人充值点券后，邀请人会获得自定义的分成点券 - 使用指令/hip admin grant <玩家> <点券> [备注] 后台加点并结算返利 进行点券增加和自动分成结算 [/MD]​