原创 娱乐 CyuInvite | 玩家邀请插件 | 阶段成长奖励 | 离线待领箱 | 支持Folia [1.16-26.x] 1.0

---

做拉新活动时，通常希望老玩家能真正带新玩家一起玩，而不是自己开小号领完就走

要么就是新人进服领完礼包扭头就走，老玩家拉来人也拿不到后续激励

CyuInvite 是一套专门给 Minecraft 服务器做的玩家邀请与留存插件

新人进服绑定先拿一份起跑基础包，等真正留在服里玩、时长和等级达标后再给双方发放转正大奖

支持同 IP 和同网段检测拦截，防止同设备或同局域网多开重复绑定

发奖励时老玩家如果离线或者背包满了，系统会自动把物品放进待领箱，上线后输入指令随时领走

---

主要功能

● 个人专属邀请码：每位玩家自动生成 6 位防混淆专属邀请码，支持服主手动指定自定义码
● 一键点击快捷分享：聊天栏直接输出带点击事件的分享文本，好友点击即可自动填入绑定指令
● 同网多开检测拦截：精准识别相同 IP 地址与同 /24、/64 网段，拦截同设备小号刷奖励
● 严格环路防互套：自动检测并拦截互绑与闭环邀请，杜绝小号互相绑定套取物资
● 新人进服资格把控：灵活限制新玩家进服时效与经验等级门槛，老玩家无法回炉充当新人
● 双阶段好友成长奖励：绑定先领新手起步包，等好友活跃时长与等级达标再领转正大奖
● 累计拉新阶梯里程碑：按总邀请人数与有效达标人数自由配置多档里程碑奖励指令链
● 离线奖励安全待领箱：玩家离线或背包已满时物品不丢地，自动存入安全待领箱防吞物
● 待领箱上线即时提醒：玩家上线时若待领箱存有未领奖励，聊天栏自动推送高亮提醒
● 9 字符直观配置菜单：内置邀请中心、好友进度与里程碑界面，单行 9 字符可视化排版
● 好友实时档案透视：分页直观查看名下好友在线状态、绑定时间、累计时长与考核进度
● 外部材质与模型全兼容：菜单与奖励物品全面支持 ItemsAdder、Oraxen、CraftEngine 与 Nexo
● 单服与跨服群组互通：单服内置轻量 SQLite 开箱即用，群组服支持 MySQL 与 Redis 实时同步
● 多核心原生调度适配：源码分流原生适配 Paper 1.21+、Folia 区域多线程与 Spigot 经典核心
● 全流程指令管理运维：支持实时查码、档案透视、解除绑定、数据清空与指定补发奖励
● 全文本提示自主配置：全部交互提示、语言文案与菜单内容支持服主自主汉化修改

---

专属邀请码与点击分享

让玩家拉好友进服，操作越顺手越好：

玩家输入 /invite code 就能看到自己的专属邀请码
聊天栏会输出带有点击事件的分享文本，受邀玩家点一下就能把指令填进输入框
新人进服后输入 /invite bind 邀请码 即可完成绑定
服主也可以输入 /invite lookup 邀请码 查看某个邀请码属于谁以及当前邀请了多少人

---

防同网多开与小号风控

为了避免同一玩家通过同台电脑或同局域网重复绑定，插件提供了实用的基础校验机制：

同 IP 地址拦截：同一个外网 IP 的两个账号禁止绑定，防止单台电脑开小号刷礼包
同子网多开拦截：自动识别 IPv4 同 /24 与 IPv6 同 /64 网段，防止切换局域网相近 IP 伪装
严格环路防互套：A 邀请了 B，B 就不能再绑定 A，同时检测多账号循环链条，防止互相套取奖励
进服时间与等级门槛：可设置只有进服未超过指定时长(比如 24 小时内)、等级未超过门槛(比如 10 级内)的新玩家才能绑定

---

双阶段好友成长激励

拉新不仅要人来，更要能留住人：

第一阶段：绑定起步礼包
好友输入邀请码成功绑定时，新人马上领到一份基础生存物资，邀请人也能收到一份感谢奖励

第二阶段：有效达标转正大奖
受邀好友在服内实际游玩达到指定时长(例如 120 分钟)，且等级达到指定门槛(例如 20 级)
达标时，新人自动转正并获得更丰厚的阶段大奖
同时邀请人名下的有效达标人数 +1，并获得专属的老带新达标奖励

---

长期阶梯里程碑大奖

想让老玩家持续拉朋友进服，可以给他们设置长线目标：

在 milestones.yml 里服主可以自由配置多个档位的累积奖励：

支持按累计邀请总人数解锁，也支持按有效达标的好友人数解锁，或者两者结合
从拉到 1 个人的初级伙伴，到拉到 3 人、5 人、10 人的宣传达人
每个档位达成后，系统都会自动执行服主配好的指令链：发装备、给游戏币、给专属称号或发全服广播

---

离线待领箱与防爆仓保护

好友达标或者发大奖的时候邀请人刚好不在服怎么办？玩家背包满了物品会掉在地上被别人捡走吗？

CyuInvite 自带了离线待领箱：

发放奖励时如果玩家不在线，奖励指令与物品会自动存入数据库待领箱
如果玩家背包空间不够，装不下的物品也不会掉在地上，同样安全存进待领箱
玩家上线后聊天栏会收到待领提醒
输入 /invite claim 或在菜单里点击待领箱图标，就能随时把奖励取回背包

---

自带管理菜单

插件自带 3 个支持 9 字符直观排版的菜单配置：

main.yml(邀请中心主界面)：查看个人邀请码、达标情况、待领箱入口与好友列表入口
invites.yml(受邀好友列表)：分页展示名下所有好友的头颅、绑定时间、在线时长与达标状态
milestones.yml(阶段里程碑界面)：展示各个档位的达成进度、要求人数与领奖状态

支持原版箱子单行 9 字符布局，按钮动作支持打开子菜单、翻页、发消息、播音效与执行指令

---

单服与跨服支持

根据服务器规模灵活切换存储方式：

单服模式：默认使用本地 SQLite 存储，不装额外数据库软件，解压放进 plugins 文件夹就能跑
跨服群组模式：支持连接外部 MySQL 数据库，跨服网络支持原版跨服消息通道与 Redis 实时同步
服务端兼容：适配 Paper 1.21+、Folia 区域多线程与 Spigot 1.16.5-1.20.x 经典核心

---

指令手册速查

/invite 打开邀请中心主菜单
/invite me 查看个人邀请数据与达标情况
/invite code 查看自己的邀请码与点击分享文本
/invite bind <邀请码> 绑定邀请人(限符合资格的新人使用)
/invite list 打开受邀好友列表与进度界面
/invite claim 提取待领箱里的暂存奖励
/invite info [玩家名] 查看自己或指定玩家的邀请明细
/invite reload 重载配置文件、语言包与菜单
/invite reset <玩家名> 清除指定玩家的所有邀请与绑定数据
/invite unbind <玩家名> 解除指定玩家绑定的邀请人关系
/invite lookup <邀请码> 查询某个邀请码属于谁以及邀请数据
/invite setcode <玩家名> <新邀请码> 手动给玩家修改或指定邀请码
/invite give <玩家名> <档位ID> 手动为玩家补发指定档位的里程碑奖励
/invite adminbind <受邀人> <邀请码> 管理员强制绑定邀请关系(无视时限与 IP 限制)

---

服主怎么配与怎么排查

怎么配：
把插件 jar 丢进 plugins 文件夹重启服务器即可，单服无需配置外部数据库
基础规则在 config.yml 里修改，可调整新人绑定时限、经验等级门槛与达标所需游玩分钟数
里程碑奖励在 milestones.yml 里修改，按需增加档位并配置发放指令与全服公告
改完配置后在游戏内输入 /invite reload 即可热重载生效

怎么排查：
玩家反映无法绑定：通常是因为新玩家进服时间或等级已超过限制，或者处于同 IP / 同子网，查看聊天栏红色提示即可定位原因
查看玩家档案：输入 /invite info 玩家名 可查阅该玩家的绑定对象、名下受邀名单及达标状态
反查邀请码：输入 /invite lookup 邀请码 查看所属玩家名与累计拉新人数
数据异常排查：检查 plugins/CyuInvite/storage.db 数据库文件是否存在，单服 SQLite 零配置即可稳定读写

---

适合什么服务器

● 刚开荒需要老带新聚人气的生存服
● 追求长线留存、希望玩家结伴一起玩的 RPG 与冒险服
● 空岛、家园等好友互助型玩法服
● 子服较多、需要统一统计拉新数据的 BungeeCord / Velocity 跨服群组
● 希望有基础多开限制、避免同网刷绑定的服主

---