Перейти к содержимому
Mineforgian

Claim Kickstart

Gives new players a golden shovel when they place their first chest — a simple starter kit for servers (supports GriefPrevention).

Загрузки
143
Подписчики
0
Обновлён
19 марта 2026 г.
Лицензия
All-Rights-Reserved

Опубликован 15 февраля 2026 г.

Claim Kickstart

Automatically gives new players a Golden Shovel when they place their first chest, helping them get started with GriefPrevention land claims right away.

Features

  • Automatic reward — places a configurable item in the player's inventory on first chest placement
  • Configurable delivery mode — choose between instant AUTO delivery or opt-in CLAIM_CHAT with a clickable chat prompt
  • Click-to-claim flow — in CLAIM_CHAT mode, players receive a clickable [Claim] message and only get the reward when they click it
  • Secure claim tokens — tokens are bound to the player's UUID and expire after a configurable duration, preventing theft or exploits
  • GriefPrevention-aware — optionally skips players who already have existing claims
  • Handles full inventories — in AUTO mode, drops the item at the player's feet; in CLAIM_CHAT mode, prompts the player to make space and retry
  • Admin commands — grant, reset, and check reward status for any player
  • Fully configurable — customize the reward item, amount, delivery mode, and all messages with color codes
  • Lightweight — no dependencies other than GriefPrevention (optional), flat-file data storage

Commands

Admin commands require the claimkickstart.admin permission (default: op).

Command Description
/ck reload Reload config from disk
/ck grant <player> Manually give the reward to a player
/ck reset <player> Reset a player so they can receive the reward again
/ck status <player> Check if a player has been rewarded
/ck claim <token> Claim a pending reward (player-facing, no permission required)

Compatibility

  • Paper, Purpur, or any Paper fork
  • Minecraft 1.20+
  • Java 21+
  • Works with LuckPerms and any permissions plugin
  • GriefPrevention integration is optional — works without it too

Ченджлог

1.2.0Релиз1.21.9, 1.21.10, 1.21.11 · 19 марта 2026 г.

[1.2.0] - 2026-03-19

Fixed

  • inventory-full-drop message not displaying — the entry had lost its indentation in config.yml, placing it at the YAML root instead of under messages:. Players with a full inventory were seeing §cMissing message: inventory-full-drop instead of the intended drop notification.
  • Removed spam message on GP claims check — players who already had GriefPrevention claims were receiving a chat message on every chest placement. The plugin now silently skips ineligible players.

Added

  • enabled config toggle — set enabled: false in config.yml to fully disable the chest-place reward trigger without uninstalling the plugin. Reloadable via /ck reload.
1.1.0Релиз1.21.9, 1.21.10, 1.21.11 · 16 февраля 2026 г.

[1.1.0] - 2026-02-16

Added

  • Configurable reward delivery mode (reward-delivery-mode in config.yml)
    • AUTO (default): original behavior — grant immediately, drop at feet if inventory full
    • CLAIM_CHAT: sends a clickable chat message; reward only granted when player clicks it
  • Claim token system for CLAIM_CHAT mode:
    • Tokens are bound to the player's UUID — cannot be used by other players
    • Tokens expire after a configurable duration (claim-token-expiry-minutes, default 10)
    • Full inventory on click shows an error and allows retry (no drop, no grant)
    • Already-claimed tokens are invalidated
  • /ck claim <token> internal command (used by clickable chat, not for manual use)
  • New config messages: claim-chat-prompt, claim-chat-success, claim-chat-full-inventory, claim-chat-already-claimed, claim-chat-expired, claim-chat-invalid
  • Periodic expired token cleanup (every 5 minutes)

Added (1.1.0 extras)

  • Project icon for Modrinth/launcher display (golden shovel in hexagonal frame)
  • Icon embedded in jar as icon.png for future Paper plugin metadata support

Changed

  • Compiled against Paper API 1.21.1 (previously Spigot API)
  • Java target updated to 21

Unchanged

  • AUTO mode behavior is identical to 1.0.0 — no breaking changes for existing servers
  • All existing config keys, commands, and permissions remain the same

[1.0.0] - 2026-02-15

Added

  • Initial release
  • Automatic golden shovel reward on first chest placement
  • GriefPrevention integration (optional soft dependency)
  • Full inventory handling (drop at feet)
  • Admin commands: /ck reload, /ck grant, /ck reset, /ck status
  • Configurable reward item, amount, and messages
  • Flat-file data storage (data.yml)
1.0.0Релиз1.21.9, 1.21.10, 1.21.11 · 15 февраля 2026 г.

Initial release — automatically rewards new players with a golden shovel on first chest placement. Includes (optional)GriefPrevention integration, full inventory handling, admin commands, and configurable messages.

Комментарии

Загружаем…