- 版权类型
- 原创
- 插件中文名称
- RPT签到
- 插件英文名称
- RPTCheckIn
- 原帖地址
- #
- 支持的核心(服务端)
- Paper
- Folia
- 语言支持
- 中文(简体)
- 适配版本(Java)
- 26.x
- 1.21
关于这个插件
RPTCheckIn 是一个「让人愿意每天上线点一下」的签到插件。
每日奖励、连续签到奖励、月度全勤奖励、节日彩蛋四套奖励可以叠加;所有签到进度都用图形月历呈现,玩家点格子就能领奖,谁坚持了多久一目了然。数据存在插件自带的 SQLite 里,不需要 MySQL,装上就能用。
功能说明
1. 四种签到方式
| 方式 | 指令 |
说明 |
| 快速签到 | /签到(也可 /qd、/qiandao、/checkin、/簽到) | 直接领取今天的奖励 |
| 子命令 | /rptc 签到 | 同上 |
| 月历点击 | /rptc 菜单 打开月历后点今天的日期 | 纯图形界面操作,不用记指令 |
| 控制台代签 | /rptc 签到 <玩家名> | 在控制台 / RCON 为玩家补签 |
2. 签到月历界面
- 一张整月日历,已签到 / 未签到 / 未来日期三种状态一眼分清。
- 今天的格子可以直接点击签到,不用记指令。
- 节日当天的格子显示为钻石图标,悬停即可看到节日名称。
- 可以翻看上个月 / 下个月,回顾自己哪天漏签了。
- 侧边信息栏展示:连续签到天数、累计天数、最长连续、本月已签天数、本月全勤是否达成、上次签到日期。
- 界面内自带图例说明和关闭按钮。
3. 四套可叠加的奖励
| 奖励类型 | 触发条件 | 配置项 |
| 每日奖励 | 每天签到 | rewards.daily |
| 连续签到奖励 | 连签达到指定天数(默认 3 / 7 / 30 天) | streak-bonus |
| 月度累计奖励 | 本月累计达到指定天数(默认 10 / 20 天,以及 full 表示全勤) | monthly-bonus |
| 节日奖励 | 在配置的节日当天签到 | festivals |
- 断签会重置连续天数,月历上断掉的那天显示为未签到。
- 月度奖励每档每月只发一次,不会重复领取。
- 连续签到达到指定天数时(默认 7 / 30 天)会全服广播,给坚持的人一点排面。
4. 奖励支持四种发放方式
| 写法 | 效果 | 离线玩家 |
command:eco give %player% 100 | 执行任意控制台指令(常用于发金币) | 可以发放 |
item:DIAMOND 3 | 直接发物品 | 跳过 |
exp:10 | 增加经验等级 | 跳过 |
message:文字 | 只给玩家发一条私聊(支持 MiniMessage 着色) | 跳过 |
四种可以混用,例如「发 100 金币 + 3 颗钻石 + 一句祝福」一次给到。
5. 节日签到
- 节日日期支持两种写法:
"01-01" —— 每年重复(适用于元旦、儿童节这类固定日期的节日)
"2026-10-01" —— 只在这一年(春节、中秋等农历节日每年日期不同,按年写即可)
- 节日当天签到,除每日与连签奖励外额外再发一份节日奖励。
- 节日在月历上是钻石图标,玩家看得见、有期待。
6. 时区与「今天」的定义
timezone 可设置服务器时区(默认 Asia/Shanghai)。
reset-hour 可设置每日重置小时:设为 4 时,凌晨 0:00-3:59 的签到仍算作前一天,照顾熬夜玩家,不会因为跨零点就断签。
7. 签到排行榜
/rptc 排行 打开排行榜界面,支持三种维度切换:累计签到 / 连续签到 / 本月签到。
- 榜首有特殊标记,玩家能一眼看到自己当前在第几页。
- 每页显示数量可配置(默认 45 条)。
8. 数据存储
- 使用插件自带的 SQLite(内嵌 JDBC 驱动,随插件一起发布,无需另装)。
- 数据文件为
plugins/RPTCheckIn/checkin.db,拷走这个文件就等于备份了全部签到记录。
- 连续 / 累计 / 最长连续 / 每次签到的日期全部持久化,重启不丢。
支持版本与环境
| 项目 | 说明 |
| Minecraft 版本 | 1.21 ~ 26.2(实测通过:1.21 / 1.21.4 / 1.21.11 / 26.1.2 / 26.2) |
| 服务端核心 | Paper、Folia(已声明 folia-supported: true) |
| Java 运行环境 | Java 21 及以上 |
| 不支持 | 1.20.x 及以下(插件 api-version 为 1.21,低版本核心会拒绝加载) |
| 数据库 | 无外部依赖,使用内嵌 SQLite,不需要 MySQL |
| 经济插件 | 可选。只有奖励写成 command:eco give 时才需要服务器装有提供 eco 指令的经济插件(如 EssentialsX);用 item: / exp: / message: 发奖则完全不需要 |
目标用户
- 想让玩家每天都上线的生存服 / 长期服服主 —— 签到是成本最低的日常留存手段。
- 正在使用 Folia 核心的服主 —— 市面上不少签到插件不支持 Folia,本插件从设计之初就双端兼容。
- 不想为了签到功能额外维护 MySQL 的服主 —— 数据就是一个本地文件。
- 需要做节日运营的服主 —— 节日表可自由配置,每个节日配不同的名字与奖励。
- 需要帮玩家补签的管理员 —— 控制台一条指令即可为任意玩家代签。
是否付费
完全免费。 不需要授权、不需要联网校验,下载即用。
获取作者帮助
| 途径 | 内容 |
| 交流群 | QQ 群 1124248111 |
| 作者 QQ | 2221899680 |
| 游戏内 | 输入 /rptc 帮助 查看全部指令与说明 |
使用教程
安装
- 将
RPTCheckIn-1.0.0.jar 放入服务端 plugins/ 目录。
- 重启服务端,首次启动会生成
plugins/RPTCheckIn/config.yml、messages.yml 与数据库文件。
- 按需修改
config.yml(奖励、节日、时区等),然后执行 /rptc 重载 生效,不需要重启服务端。
指令列表
| 指令 | 权限 | 说明 |
/签到 | rptc.use | 快速签到(别名 /qd、/qiandao、/checkin、/簽到) |
/rptc 签到 | rptc.use | 领取今天的签到奖励 |
/rptc 菜单 | rptc.use | 打开签到月历界面 |
/rptc 排行 | rptc.rank | 查看签到排行榜 |
/rptc 帮助 | 默认 | 显示指令帮助 |
/rptc 重载 | rptc.admin | 重载配置文件 |
/rptc 签到 <玩家名> | rptc.admin | 控制台 / RCON 为指定玩家代签 |
主指令为 /rptc,/rptcheckin 为别名。
权限节点
| 权限 | 默认值 | 说明 |
rptc.use | 所有玩家 | 使用签到与月历界面 |
rptc.rank | 所有玩家 | 查看签到排行 |
rptc.admin | 仅 OP | 重载配置、控制台代签 |
主要配置项(config.yml)
| 配置项 | 默认值 | 说明 |
timezone | Asia/Shanghai | 决定「今天」是哪一天的时区 |
reset-hour | 0 | 每日重置小时;设为 4 则凌晨 0-3 点仍算前一天 |
rewards.daily | 100 金币 | 每日基础奖励 |
streak-bonus | 3 / 7 / 30 天 | 连续签到额外奖励 |
monthly-bonus | 10 / 20 / full | 本月累计达标奖励(每档每月一次) |
festivals | 元旦 / 儿童节 / 国庆节 | 节日名称与额外奖励 |
broadcast-streak | [7, 30] | 连续达到这些天数时全服广播 |
database-file | checkin.db | SQLite 数据文件名 |
rank-size | 45 | 排行榜每页条数(最多 45) |
messages.yml 里所有提示文案 —— 包括月历与排行榜界面上的每一行 —— 都支持 MiniMessage 格式,可自由改色改字。
常见问题
- 奖励没发出来? 检查
rewards 里 command: 写的指令能否在控制台直接执行成功;发金币需要服务器装有提供 eco 指令的经济插件。
- 玩家签到了,连续天数却被重置? 说明中间漏签了一天。可以用
reset-hour 把重置点挪到凌晨 4 点,避免熬夜玩家跨零点断签。
- 节日日期怎么写?
"MM-dd" 是每年重复,"yyyy-MM-dd" 只在这一年生效。农历节日每年日期不同,按年写 yyyy-MM-dd 即可。
- 数据在哪、怎么备份?
plugins/RPTCheckIn/checkin.db,复制该文件即可备份或迁移全部签到数据。
声明
- 本插件为原创作品,保留所有权利,默认不允许转载与整合。如需转载或整合进服务端整合包,请先通过上方交流群或作者 QQ 联系获取授权。
- 本插件未使用任何混淆手段,欢迎安全审查。
- 本插件不含任何后门、病毒或远程控制代码,所有数据仅保存在服务器本地
plugins/RPTCheckIn/ 目录中。