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.