TimerPlugin
为你的服务器活动、挑战和游戏会话带来结构化的时间控制。
TimerPlugin 提供简单但功能强大的玩家本地计时器,并可选“超时踢出”模式——非常适合速通、每日游戏时长限制、小游戏或社区活动。
✨ 特性
• 玩家本地计时器:每位玩家可通过 /timer <minutes> 运行自己的倒计时。
• 踢人计时器:/tmk <minutes> 启动个人计时器,到期后踢出该玩家(消息可配置)。
• 清晰的反馈:实时 Actionbar 倒计时(mm:ss)。
• 音效提示:开始/停止/完成以及可配置的最终倒计时音效(来自 config.yml)。
• 每日游戏时长追踪:轻量级记录每位玩家每天的分钟数,数据存储在 plugins/TimerPlugin/data.yml。
• 轻量且无依赖:无需外部库;专为 Paper/Purpur/Spigot 设计。
? 命令
/timer <minutes> # 启动带有 actionbar 倒计时的个人计时器
/timer stop # 停止你正在运行的计时器
/tmk <minutes> # 启动“超时即踢”的个人计时器
• 如果玩家已有正在运行的计时器,则优雅地失败处理。
• 包含使用提示和无效数字处理。
timer:
sound:
finalCountdown: BLOCK_NOTE_BLOCK_HAT
finished: ENTITY_ENDER_DRAGON_GROWL
start: ENTITY_PLAYER_LEVELUP
stop: ENTITY_VILLAGER_NO
messages:
kickMessage: "你的游戏时间已结束!明天再来吧!"
expiredMessage: "计时器已过期!"
• 自定义:开始/停止/完成/最终倒计时的音效,以及踢出/过期的提示信息。
• A limits: 部分用于未来的扩展。
? 数据存储方式
• 每位玩家的每日游戏分钟数存储在 config.yml 旁边的 data.yml 文件中。
• 插件在玩家加入/退出时自动更新日期字段和分钟计数器。
✅ 兼容性
• 专为 Minecraft 1.21.9 构建(插件版本:1.5.1,api-version:1.20)
• 适用于 Paper / Purpur / Spigot
• 编译目标为 Java 21
? 安装步骤
1. 将 TimerPlugin-1.5.1-1.21.9.jar 放入 /plugins 文件夹。
2. 启动服务器以生成 config.yml。
3. 调整音效/消息(可选)。完成。
? 使用场景
• 速通与挑战——带有音频提示的清晰个人倒计时。
• 每日游戏时长限制——结合 /tmk 命令与规则来强制执行休息。
• 活动——让玩家自行管理限时阶段,无需全局计时器。
⸻
简短描述 (DE)
使用 /timer <分钟> 启动个人计时器(在动作栏显示,并伴有音效),或使用 /tmk <分钟> 启动踢出计时器,到期后会根据自定义消息将玩家踢出服务器。游戏时长(每天/每位玩家的分钟数)会记录在 data.yml 中。无依赖项,专为 1.21.9 构建,需 Java 21。
TimerPlugin
Bring structured time control to your server events, challenges and play sessions.
TimerPlugin offers simple but powerful player-local timers and an optional “kick when time is up” mode – perfect for speedruns, daily play limits, minigames or community events.
✨ Features
• Player-local timers: Each player can run their own countdown via /timer <minutes>.
• Kick timer: /tmk <minutes> starts a personal timer that kicks the player when it expires (message configurable).
• Clean feedback: Live Actionbar countdown (mm:ss).
• Sound cues: Start/stop/finished and a configurable final countdown sound (from config.yml).
• Daily playtime tracking: Lightweight tracking of minutes per player & day in plugins/TimerPlugin/data.yml.
• Lightweight & dependency-free: No external libs; designed for Paper/Purpur/Spigot.
? Commands
/timer <minutes> # Start a personal timer with actionbar countdown
/timer stop # Stop your running timer
/tmk <minutes> # Start a “time’s up = kick” personal timer
• Fails gracefully if the player already has a running timer.
• Usage hints and invalid number handling included.
timer:
sound:
finalCountdown: BLOCK_NOTE_BLOCK_HAT
finished: ENTITY_ENDER_DRAGON_GROWL
start: ENTITY_PLAYER_LEVELUP
stop: ENTITY_VILLAGER_NO
messages:
kickMessage: " Your playtime is over! Come back tomorrow!"
expiredMessage: "Your timer has expired!"
• Customize: sounds for start/stop/finish/final countdown, and the kick/expired messages.
• A limits: section is present for future expansion.
? How it stores data
• Per-player daily minutes are stored in data.yml next to your config.
• The plugin updates the date field and minutes counter automatically on join/quit.
✅ Compatibility
• Built for Minecraft 1.21.9 (plugin version: 1.5.1, api-version: 1.20)
• Works on Paper / Purpur / Spigot
• Compiled targeting Java 21
? Installation
1. Drop TimerPlugin-1.5.1-1.21.9.jar into /plugins.
2. Start the server to generate config.yml.
3. Adjust sounds/messages (optional). Done.
? Use cases
• Speedruns & challenges – clean personal countdowns with audio cues.
• Daily play caps – combine /tmk with your rules to enforce breaks.
• Events – let players self-manage timed stages without global timers.
⸻
Kurzbeschreibung (DE)
Starte persönliche Timer mit /timer <Minuten> (Actionbar-Anzeige, Sounds) oder einen Kick-Timer mit /tmk <Minuten>, der dich nach Ablauf mit eigener Nachricht vom Server trennt. Spielzeit (Minuten pro Tag/Spieler) wird in data.yml mitgeloggt. Keine Abhängigkeiten, für 1.21.9 gebaut, Java 21.
评论 0
登录后参与评分
还没有评论,来抢沙发吧