SnoozeLoot

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6

平台： paper

标签： economy game-mechanics social

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

1. Drop the jar in plugins/ and start the server (Paper 1.20.5+, Java 21+).
2. Edit plugins/SnoozeLoot/config.yml — set AFK timers, shop items, rewards.
3. /snooze reload (or restart). Players use /snooze and /snooze shop.

Optional: install PlaceholderAPI and/or WorldGuard — SnoozeLoot detects them automatically.

?️ How AFK works

1. Player stands still long enough → AFK mode starts (title, sound, Z particles).
2. While AFK: action bar shows balance and earn rate, points pay out on a timer.
3. Player moves again → AFK ends, welcome-back message shows session earnings.

Tune in config.yml under afk::

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.

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

? 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