Smart-rtp

[2.0.0] — 2025-02-21

✨ New Features

Custom Player-Head Icons in GUI

• Each world GUI slot now supports displaying a player skull instead of a plain block.
• Set icon: PLAYER_HEAD in any world section and provide head-uuid with the target player's UUID.
  • Overworld → ddb0f735-90ac-44e2-8578-a7dd5a1abfc5
  • Nether → 69c131a6-2d52-4d64-9076-8820a996e93e
  • The End → fc5ab4ef-022c-48f6-9499-f2d2d7ef64ea
• Head resolution is handled by Paper's native PlayerProfile API (no external texture libraries required).

Blindness During Teleportation

• Players now receive a Blindness potion effect for the full countdown duration plus a configurable number of ticks after landing.
• Configurable under teleport.blindness:
  • enabled — toggle on/off.
  • post-teleport-duration — ticks of blindness applied after landing (default 40 = 2 s).
• Blindness is removed instantly if the teleport is cancelled (move, damage, disconnect).
• Effect shows no particles and no icon to keep the UI clean.

LuckPerms Integration (Group-Based Cooldowns & Uses)

• Full native LuckPerms API integration (soft-dependency — server runs normally without it).
• Cooldown and daily-use limits are now resolved via LuckPerms primary group → inherited groups → permission fallback, in that priority order.
• Each world can define per-group cooldowns and daily uses separately:

cooldown:
  default-seconds: 300
  groups:
    admin: 0
    elite: 60
    vip: 120
    default: 300
uses:
  default-uses: 3
  groups:
    admin: 0
    elite: 10
    vip: 5
    default: 3

• 0 always means unlimited.
• When LuckPerms is absent the plugin falls back to the legacy group.<name> permission node check.

Daily Use Limits System

• New UsesManager tracks how many times each player has used RTP per world, per day.
• Counters automatically reset at midnight (server timezone). The reset is server-restart-safe — the date is persisted in uses.yml.
• GUI lore displays current usage:
  • &7Daily uses: &f2&7/&f5 when limited.
  • &7Daily uses: &aUnlimited for groups/players with 0 or rtp.bypass.uses.
• New admin sub-command: /rtpadmin uses reset <player> — resets all daily counters for the target player.
• New permission: rtp.bypass.uses — skips the daily limit entirely.

Hidden Admin Tab-Completion

• /rtpadmin tab-completion is completely invisible to players without the rtp.admin permission — an empty suggestion list is returned, so the command is not discoverable.
• /rtp tab-completion is unchanged (still shows enabled worlds and online players when permitted).

---

🔧 Improvements

• All user-facing messages are fully in English and have been reworded for a more professional tone.
• Action bar during countdown updated: "Teleporting in Xs — Do not move!".
• GUI lore now shows both cooldown status and daily use count side by side.
• pom.xml targets paper-api:1.21.4-R0.1-SNAPSHOT (compatible with all Paper 1.21.x builds via the stable API surface).
• plugin.yml correctly declares softdepend: [Vault, LuckPerms].
• Admin stats header uses a more polished separator line.
• uses.yml is written to the plugin data folder alongside stats.yml.

---

🗺️ Compatibility

Software	Versions
Paper	1.21.0 — 1.21.11 (and future 1.21.x)
Java	21+
LuckPerms	5.x (soft-depend)
Vault	Any (soft-depend, for economy)

Note: This plugin targets Paper only. Spigot is not supported.