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
作者 QQ2221899680
游戏内输入 /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）
配置项默认值说明
timezoneAsia/Shanghai决定「今天」是哪一天的时区
reset-hour0每日重置小时；设为 4 则凌晨 0-3 点仍算前一天
rewards.daily100 金币每日基础奖励
streak-bonus3 / 7 / 30 天连续签到额外奖励
monthly-bonus10 / 20 / full本月累计达标奖励（每档每月一次）
festivals元旦 / 儿童节 / 国庆节节日名称与额外奖励
broadcast-streak连续达到这些天数时全服广播
database-filecheckin.dbSQLite 数据文件名
rank-size45排行榜每页条数（最多 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/ 目录中。
页: [1]