EP-XPcheckin
一款简洁、公平、易管理且支持多语言的 Minecraft 每日经验签到插件。
兼容多种服务器版本,配置灵活,启用便捷,设置简单。
功能特性
-
公平的经验分配
随机发放 1 到 10 段经验(每段覆盖 10% 的概率区间)。大额奖励稀有但合理,兼顾趣味性与公平性。
-
连续签到加成
每次连续签到天数都会额外增加 10% 的经验。若中断一天,连签计数重置,鼓励玩家每日参与。
-
加入提醒
当玩家登录服务器时,自动提醒尚未签到的玩家。玩家可自由开启或关闭此提醒功能。
-
多语言支持
默认内置中文 (zh-CN) 和英文 (en) 语言包。可通过配置文件轻松切换语言,并支持添加更多语言。
-
灵活配置
冷却时间、广播阈值、连签倍率等均可在 config.yml 中自定义修改,无需更改代码。
-
玩家指令
/checkin – 完成今日签到并获取随机经验
/checkin on/off – 开启/关闭签到提醒
/checkin info – 查看个人签到记录、连签天数及累计获得经验
/checkin top – 查看累计经验排行榜(前 10 名玩家)
-
OP 管理员指令
/checkin reload – 热重载配置文件与语言文件(替代旧版 redata 命令)
/checkin record <player> <date> – 删除指定玩家在特定日期的签到记录(支持用户名/UUID)
/checkin look <player/UUID> – 查看任意玩家(包括离线状态)的签到信息
-
完整的 TAB 补全
子命令、在线玩家及历史签到日期均支持智能补全,提升使用体验。
-
安全持久化数据
所有签到数据(含每日详情)均存储于 player.yml。异步保存机制确保数据不丢失、不损坏;支持手动重载。
-
全局广播惊喜
当玩家的签到经验达到配置的阈值时,将发送全局广播以增强服务器氛围。
权限说明
- 玩家指令 (
/checkin, /checkin on/off, /checkin info, /checkin top) – 无需任何权限;所有玩家默认均可使用。
- 管理员指令 (
/checkin reload, /checkin record, /checkin look) – 仅限 OP 使用;无需额外权限节点。
文件结构
所有文件自动生成于:
plugins/EP-XPcheckin/
├─ config.yml # 主配置文件(冷却时间、倍率、语言等)
├─ player.yml # 玩家签到数据(核心数据,自动保存)
└─ lang/ # 语言文件目录
├─ zh-CN.yml # 中文语言包(默认)
└─ en.yml # 英文语言包(可随时切换)
数据格式 (player.yml)
包含每位玩家的完整签到数据:
lastCheckInDate – 上次签到日期
streak – 当前连续签到天数
totalTimes – 总签到次数
totalXP – 累计获得经验
records – 每日详情(当日获得的经验、当时的连签数)
remind – 提醒开关状态(on/off)
版本支持
- Minecraft 版本: 1.12+ – 1.21+(兼容主流版本)
- 服务器软件: Spigot, Paper 及其衍生版本(推荐使用 Paper 以获得更佳性能)
- 插件版本: v1.2(正式发行版,完整双语支持)
使用方法
- 将编译好的
EP-XPcheckin-1.2.jar 放入服务器的 plugins 文件夹。
- 重启服务器——插件会自动生成配置文件、语言文件和数据文件。
- (可选)修改
config.yml 以自定义插件参数,然后运行 /checkin reload 进行热重载。
- 在游戏中输入
/checkin 开始每日签到。所有指令均支持 TAB 补全。
配置说明 (config.yml 关键参数)
语言(默认 zh-CN,改为 en 可切换为英文)
language:
default: zh-CN
功能设置
settings:
command-cooldown: 5 # 指令冷却时间(单位:刻,20 刻 = 1 秒)
join-remind-delay: 20 # 加入提醒延迟(单位:刻)
streak-multiplier: 0.1 # 连签加成倍率(0.1 = 每天 +10%)
broadcast-above-xp: 1000000 # 触发全局广播的经验阈值
作者
EndlessPixel Studio – system_mini
该插件正在积极维护中。如需报告错误或提出功能建议,请联系作者。
EP-XPcheckin
A clean, fair, manageable, multilingual daily XP check-in plugin for Minecraft.
Compatible with multiple server versions, flexible configuration, and quick to enable with minimal setup.
Features
-
Fair XP Distribution
Random XP between 1 and 10 segments (each segment covers a 10% probability range). Large rewards are rare yet reasonable, balancing fun and fairness.
-
Streak Bonus
Each consecutive check-in day grants an additional 10% XP. The streak resets upon missing a day, encouraging daily participation.
-
Join Reminder
Automatically reminds players who haven’t checked in when they join the server. Players can enable/disable this reminder freely.
-
Multi-language Support
Includes Chinese (zh-CN) and English (en) language packs by default. Easily switch between languages via the config file, with support for adding more languages.
-
Flexible Configuration
Cooldown, broadcast threshold, streak multiplier, and more can be customized in config.yml – no code changes required.
-
Player Commands
/checkin – Complete today’s check-in and receive random XP
/checkin on/off – Enable/disable check-in reminders
/checkin info – View personal check-in record, streak, and total XP earned
/checkin top – View leaderboard of total XP earned (top 10 players)
-
OP Admin Commands
/checkin reload – Hot-reload config & language files (replaces legacy redata command)
/checkin record <player> <date> – Delete a specific player’s check-in record for a given date (supports name/UUID)
/checkin look <player/UUID> – View any player’s (including offline) check-in information
-
Full TAB Completion
Smart completion for subcommands, online players, and historical check-in dates – enhanced usability.
-
Safe & Persistent Data
All check-in data (including daily details) is stored in player.yml. Asynchronous saving ensures no loss or corruption; manual reload is supported.
-
Global Broadcast Surprise
When a player’s check-in XP reaches a configured threshold, a global broadcast is sent to enhance server atmosphere.
Permissions
- Player Commands (
/checkin, /checkin on/off, /checkin info, /checkin top) – No permission required; all players can use them by default.
- Admin Commands (
/checkin reload, /checkin record, /checkin look) – OP only; no extra permission nodes needed.
File Structure
All files are auto-generated at:
plugins/EP-XPcheckin/
├─ config.yml # Main configuration (cooldown, multiplier, language, etc.)
├─ player.yml # Player check-in data (core data, auto-saved)
└─ lang/ # Language files directory
├─ zh-CN.yml # Chinese language pack (default)
└─ en.yml # English language pack (ready to switch)
Data Format (player.yml)
Contains full check-in data for each player:
lastCheckInDate – Last check-in date
streak – Current consecutive days count
totalTimes – Total number of check-ins
totalXP – Total XP earned
records – Daily details (XP earned that day, streak at that time)
remind – Reminder toggle state (on/off)
Version Support
- Minecraft Versions: 1.12+ – 1.21+ (compatible with mainstream versions)
- Server Software: Spigot, Paper, and derivatives (Paper recommended for better performance)
- Plugin Version: v1.2 (official release, full bilingual support)
How to Use
- Place the compiled
EP-XPcheckin-1.2.jar into your server’s plugins folder.
- Restart the server – the plugin automatically generates configuration, language, and data files.
- (Optional) Modify
config.yml to customize plugin parameters, then run /checkin reload to hot-reload.
- In-game, type
/checkin to start your daily check-in. All commands support TAB completion.
Configuration (config.yml Key Parameters)
Language (default zh-CN, change to en for English)
language:
default: zh-CN
Feature Settings
settings:
command-cooldown: 5 # Command cooldown in ticks (20 ticks = 1 second)
join-remind-delay: 20 # Join reminder delay in ticks
streak-multiplier: 0.1 # Streak bonus multiplier (0.1 = +10% per day)
broadcast-above-xp: 1000000 # XP threshold for global broadcast
Author
EndlessPixel Studio – system_mini
The plugin is actively maintained. For bug reports or feature suggestions, please contact the author.
评论 0
登录后参与评分
还没有评论,来抢沙发吧