RPTCheckIn —— 每日签到 · 月历界面 · 连续与节日奖励 · 签到排行 [1.21 ~ 26.2]

关于这个插件​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/ 目录中。