当玩家处于挂机(AFK)状态时,SnoozeLoot 会通过发放 SnoozePoints 来奖励他们——并允许他们在完全可自定义的商店中使用这些点数。
无需 Vault 或经济插件。你可以自行定义奖励的价格以及购买时执行的命令(如赋予权限组、物品、套装、权限等)。
- ? 游戏内奖励商店(可配置的 GUI)
- ?️ AFK SnoozePoints —— 动作栏、标题、粒子效果
- ? 世界与世界守卫(WorldGuard)区域限制
- ? 带有你自身排名的排行榜
- ? 玩家间转账、每日/每周及连续在线奖励
- ? PlaceholderAPI 占位符
- ?️ 防作弊机制(池检测、购买限制)
- ? YAML 或 SQLite 存储 · 支持英文/德文消息
? 快速开始
- 将 jar 文件放入
plugins/ 目录并启动服务器(Paper 1.20.5+,Java 21+)。
- 编辑
plugins/SnoozeLoot/config.yml —— 设置 AFK 计时器、商店物品和奖励。
- 执行
/snooze reload(或重启服务器)。玩家可使用 /snooze 和 /snooze shop。
可选:安装 PlaceholderAPI 和/或 WorldGuard —— SnoozeLoot 会自动检测它们。
?️ AFK 工作原理
- 玩家静止足够长的时间 → 进入 AFK 模式(显示标题、声音、Z 字符粒子)。
- 在 AFK 期间:动作栏显示余额和赚取速率,点数按固定间隔结算。
- 玩家再次移动 → AFK 结束,显示欢迎回归消息及本次会话的收益。
可在 config.yml 的 afk: 部分进行调整:
| 设置项 |
作用 |
afk-time-threshold-seconds |
触发 AFK 前的空闲时间 |
payout-interval-seconds |
发放点数的频率 |
points-per-interval |
每次发放的点数 |
min-active-seconds-before-afk |
首次进入 AFK 前必须活跃游玩的时间(防止加入服务器后立即刷 AFK) |
max-afk-seconds-per-day |
每日上限(-1 = 关闭) |
max-afk-seconds-per-session |
单次登录上限(-1 = 关闭) |
blocked-gamemodes |
例如 CREATIVE, SPECTATOR |
通知(AFK 开始/结束时的标题、副标题、音效)—— 在 afk.start-notification 和 afk.end-notification 下编辑。粒子效果:afk.particles.enabled。
? 商店设置
在 shop.items 下添加物品。每个物品需要一个唯一的键名(如 vip, diamonds…)、一个 slot(槽位)、material(材质)、price(价格)以及购买时运行的 commands(命令)。
shop:
size: 27
confirm-above-price: 50 # 在此价格或以上需要二次点击确认
transaction-log-max-entries: 500
items:
vip:
slot: 11
material: DIAMOND
name: "<aqua>VIP Rank</aqua>"
lore:
- "<gray>Cost: <gold><price></gold> points</gray>"
price: 100
purchase-limit: -1 # -1 = 无限制,3 = 最多购买 3 次
commands:
- "lp user %player% parent add vip"
命令占位符: %player% %uuid% %world% %points%
名称和描述使用 MiniMessage 格式(<gold>, <gray> 等)。在描述中放置 <price> —— SnoozeLoot 会自动填充该值。
? 世界与世界守卫(WorldGuard)
限制 AFK 仅限特定世界 —— 列出世界名称。列表为空 = 所有世界均允许。
afk:
allowed-worlds:
- world
- afk_world
限制 AFK 仅限 WorldGuard 区域 —— 安装 WorldGuard,然后列出区域 ID(你在 WorldGuard 中给区域起的名字)。列表为空 = 任何地方都允许 AFK。
afk:
allowed-regions:
- afk_zone
- spawn_afk
示例:你在 WorldGuard 中创建了一个区域 /rg define afk_zone。玩家只有站在 afk_zone 内部才能获得点数。在外部则无法获得 AFK 奖励。
这两种过滤器可以组合使用。如果未安装 WorldGuard,allowed-regions 将被忽略。
⚡ 权限倍率
给予 VIP 玩家更快的 AFK 收益。将权限映射到倍率 —— 最高权限生效。
multipliers:
snoozeloot.multiplier.vip: 1.5
snoozeloot.multiplier.mvp: 2.0
通过 LuckPerms 授予:/lp user Steve permission set snoozeloot.multiplier.vip true
? 玩家间转账
pay:
enabled: true
min-amount: 1
cooldown-seconds: 30
拥有 snoozeloot.pay 权限的玩家可使用 /snooze pay <player> <amount>。设置 enabled: false 以禁用此功能。
? 奖励与连击(Streaks)
每日和每周奖励会在玩家进入 AFK 时自动领取。如果玩家当天有足够的活跃游戏时间,连击(Streaks)会增加 AFK 收益。
bonuses:
daily:
enabled: true
points: 25
weekly:
enabled: true
points: 100
streak:
enabled: true
min-minutes-per-day: 30
multiplier-per-day: 0.05
max-multiplier: 1.5
?️ 防作弊机制
anti-exploit:
ignore-movement-when-in-water: true
ignore-movement-when-in-vehicle: true
ignore-movement-when-on-rails: true
untrusted-movement-input-grace-seconds: 4
afk:
pool-detection:
enabled: true
samples: 12
- 水域 / 载具 / 铁轨 —— 环境引起的移动不计为玩家活动
- 池检测 —— 忽略被困在循环 AFK 机器中的玩家
- 商店 —— 购买限制、高价物品确认点击、交易记录
玩家可使用 /snooze history 查看历史记录;拥有 snoozeloot.history.admin 权限的管理员可查看全服购买记录。
? PlaceholderAPI
安装 PlaceholderAPI。SnoozeLoot 会自动注册 —— 无需额外配置。
| 占位符 |
输出内容 |
%snoozeloot_points% |
点数余额 |
%snoozeloot_rank% |
排行榜排名(若未排名则显示 -) |
%snoozeloot_afk% |
true / false |
%snoozeloot_streak% |
连击天数 |
适用于 TAB 插件、记分板、聊天插件等。
? 排行榜
/snooze stats 显示排名前几的玩家 以及你自己的排名,即使你不在前列也能看到。
stats:
top-size: 10 # 排行榜中显示的玩家数量
? 存储与语言
storage:
type: yaml # 或 sqlite
language: en # messages_en.yml 或 messages_de.yml
- yaml →
players.yml, meta.yml, transactions.yml
- sqlite → 单个
snoozeloot.db(更适合大型服务器)
编辑 messages_en.yml / messages_de.yml 中的消息(支持 MiniMessage 标签)。执行 /snooze reload 以应用配置和消息更改。新配置键会在升级时自动合并(通过 config-version)。
切换存储方式(yaml ↔ sqlite):在全新服务器上更改 storage.type,或手动迁移数据——该插件没有内置转换器。
⌨️ 命令
| 命令 |
权限 |
功能 |
/snooze |
snoozeloot.use |
查看你的余额 |
/snooze shop |
snoozeloot.use |
打开商店 |
/snooze stats |
snoozeloot.use |
排行榜 + 你的排名 |
/snooze show <player> |
snoozeloot.use |
查看其他玩家的余额 |
/snooze pay <player> <amount> |
snoozeloot.pay |
发送积分 |
/snooze history [limit] |
snoozeloot.use |
查看你的购买记录 |
/snooze history [limit] |
snoozeloot.history.admin |
查看全服所有购买记录 |
/snooze help |
snoozeloot.use |
查看你可用的命令 |
/snooze admin |
snoozeloot.admin |
显示 AFK/发放设置 |
/snooze give <player> <amount> |
snoozeloot.admin |
添加积分 |
/snooze remove <player> <amount> |
snoozeloot.admin |
移除积分 |
/snooze set <player> <amount> |
snoozeloot.admin |
设定精确余额 |
/snooze reset <player> |
snoozeloot.admin |
将余额重置为 0 |
/snooze reload |
snoozeloot.admin |
重载配置 |
/snooze debug [player] |
snoozeloot.admin |
AFK 调试信息 |
? 依赖要求
- Paper 1.20.5+ (Java 21+)
- PlaceholderAPI —— 可选
- WorldGuard —— 可选
使用 bStats (ID 32608) 收集匿名服务器统计数据。不收集玩家名称或 IP。如需退出统计:在 config.yml 中设置 bstats.enabled: false,或在 plugins/bStats/config.yml 中全局禁用 bStats。
源码 · 问题反馈
SnoozeLoot rewards idle players with SnoozePoints while they AFK — and lets them spend those points in a fully configurable shop.
No Vault or economy plugin needed. You define what rewards cost and what commands run on purchase (ranks, items, kits, permissions).
- ? In-game reward shop (configurable GUI)
- ?️ AFK SnoozePoints — action bar, titles, particles
- ? World & WorldGuard region restrictions
- ? Leaderboard with your rank
- ? Player payments, daily/weekly & streak bonuses
- ? PlaceholderAPI placeholders
- ?️ Anti-exploit (pool detection, purchase limits)
- ? YAML or SQLite storage · EN/DE messages
? Quick start
- Drop the jar in
plugins/ and start the server (Paper 1.20.5+, Java 21+).
- Edit
plugins/SnoozeLoot/config.yml — set AFK timers, shop items, rewards.
/snooze reload (or restart). Players use /snooze and /snooze shop.
Optional: install PlaceholderAPI and/or WorldGuard — SnoozeLoot detects them automatically.
?️ How AFK works
- Player stands still long enough → AFK mode starts (title, sound, Z particles).
- While AFK: action bar shows balance and earn rate, points pay out on a timer.
- Player moves again → AFK ends, welcome-back message shows session earnings.
Tune in config.yml under afk::
| Setting |
What it does |
afk-time-threshold-seconds |
Idle time before AFK starts |
payout-interval-seconds |
How often points are awarded |
points-per-interval |
Points per payout |
min-active-seconds-before-afk |
Must play actively this long before first AFK (anti-AFK-farm on join) |
max-afk-seconds-per-day |
Daily cap (-1 = off) |
max-afk-seconds-per-session |
Per-login cap (-1 = off) |
blocked-gamemodes |
e.g. CREATIVE, SPECTATOR |
Notifications (title, subtitle, sounds on AFK start/end) — edit under afk.start-notification and afk.end-notification. Particles: afk.particles.enabled.
? Shop setup
Add items under shop.items. Each item needs a unique key (vip, diamonds, …), a slot, material, price, and commands to run on buy.
shop:
size: 27
confirm-above-price: 50 # second click required at this price or above
transaction-log-max-entries: 500
items:
vip:
slot: 11
material: DIAMOND
name: "<aqua>VIP Rank</aqua>"
lore:
- "<gray>Cost: <gold><price></gold> points</gray>"
price: 100
purchase-limit: -1 # -1 = unlimited, 3 = max 3 buys ever
commands:
- "lp user %player% parent add vip"
Command placeholders: %player% %uuid% %world% %points%
Names and lore use MiniMessage (<gold>, <gray>, …). Put <price> in lore — SnoozeLoot fills it in.
? Worlds & WorldGuard
Limit AFK to specific worlds — list world names. Empty list = all worlds.
afk:
allowed-worlds:
- world
- afk_world
Limit AFK to WorldGuard regions — install WorldGuard, then list region IDs (the name you gave the region in WorldGuard). Empty list = AFK allowed everywhere.
afk:
allowed-regions:
- afk_zone
- spawn_afk
Example: you create a region /rg define afk_zone in WorldGuard. Players only earn points while standing inside afk_zone. Outside = no AFK rewards.
Both filters can be combined. If WorldGuard is not installed, allowed-regions is ignored.
⚡ Permission multipliers
Give VIP players faster AFK earnings. Map a permission to a multiplier — highest permission wins.
multipliers:
snoozeloot.multiplier.vip: 1.5
snoozeloot.multiplier.mvp: 2.0
Grant with LuckPerms: /lp user Steve permission set snoozeloot.multiplier.vip true
? Pay between players
pay:
enabled: true
min-amount: 1
cooldown-seconds: 30
Players with snoozeloot.pay use /snooze pay <player> <amount>. Set enabled: false to disable.
? Bonuses & streaks
Daily and weekly bonuses are claimed automatically when a player enters AFK. Streaks boost AFK earnings if the player had enough active play time that day.
bonuses:
daily:
enabled: true
points: 25
weekly:
enabled: true
points: 100
streak:
enabled: true
min-minutes-per-day: 30
multiplier-per-day: 0.05
max-multiplier: 1.5
?️ Anti-exploit
anti-exploit:
ignore-movement-when-in-water: true
ignore-movement-when-in-vehicle: true
ignore-movement-when-on-rails: true
untrusted-movement-input-grace-seconds: 4
afk:
pool-detection:
enabled: true
samples: 12
- Water / vehicle / rails — environmental movement does not count as player activity
- Pool-farm detection — ignores players stuck in circular AFK pool machines
- Shop — purchase limits, confirm click for expensive items, transaction log
/snooze history for players · all server purchases with snoozeloot.history.admin
? PlaceholderAPI
Install PlaceholderAPI. SnoozeLoot registers automatically — no extra setup.
| Placeholder |
Output |
%snoozeloot_points% |
Point balance |
%snoozeloot_rank% |
Leaderboard rank (- if unranked) |
%snoozeloot_afk% |
true / false |
%snoozeloot_streak% |
Streak days |
Works in TAB, scoreboards, chat plugins, etc.
? Leaderboard
/snooze stats shows the top players and your own rank, even if you are not in the top list.
stats:
top-size: 10 # how many players appear in the top list
? Storage & language
storage:
type: yaml # or sqlite
language: en # messages_en.yml or messages_de.yml
- yaml →
players.yml, meta.yml, transactions.yml
- sqlite → single
snoozeloot.db (better for larger servers)
Edit messages in messages_en.yml / messages_de.yml (MiniMessage tags). /snooze reload applies config + message changes. New config keys are merged automatically on upgrade (config-version).
Switching storage (yaml ↔ sqlite): change storage.type on a fresh server or migrate data manually — there is no built-in converter.
⌨️ Commands
| Command |
Permission |
What it does |
/snooze |
snoozeloot.use |
Your balance |
/snooze shop |
snoozeloot.use |
Open shop |
/snooze stats |
snoozeloot.use |
Leaderboard + your rank |
/snooze show <player> |
snoozeloot.use |
Someone else's balance |
/snooze pay <player> <amount> |
snoozeloot.pay |
Send points |
/snooze history [limit] |
snoozeloot.use |
Your purchases |
/snooze history [limit] |
snoozeloot.history.admin |
All server purchases |
/snooze help |
snoozeloot.use |
Commands you can run |
/snooze admin |
snoozeloot.admin |
Show AFK/payout settings |
/snooze give <player> <amount> |
snoozeloot.admin |
Add points |
/snooze remove <player> <amount> |
snoozeloot.admin |
Remove points |
/snooze set <player> <amount> |
snoozeloot.admin |
Set exact balance |
/snooze reset <player> |
snoozeloot.admin |
Set balance to 0 |
/snooze reload |
snoozeloot.admin |
Reload config |
/snooze debug [player] |
snoozeloot.admin |
AFK debug info |
? Requirements
- Paper 1.20.5+ (Java 21+)
- PlaceholderAPI — optional
- WorldGuard — optional
Uses bStats (ID 32608) for anonymous server stats. No player names or IPs. Opt out: bstats.enabled: false in config.yml, or disable bStats server-wide in plugins/bStats/config.yml.
Source · Issues
评论 0
登录后参与评分
还没有评论,来抢沙发吧