🎁 Gift | Enterprise Zero-Dupe Player Gifting System

The Ultimate Zero-Dupe Player Gifting & Inbox Solution for Modern Minecraft Servers.

Gift is a modern, lightweight, and completely tamper-resistant Minecraft plugin that allows players to seamlessly send and receive items through interactive GUIs. Designed with atomic data persistence and an ironclad zero-dupe engine, Gift guarantees that no items can be lost, cloned, or corrupted—even during server crashes, sudden disconnects, or inventory desyncs.

---

✨ Key Features

• 📦 Interactive Send GUI (/gift <player>)

  • Dedicated 21-slot deposit box.
  • Real-time recipient player skull display with instant delivery.
  • One-click Cancel button to reclaim all deposited items immediately.

• 📬 Universal Gift Inbox (/gift)

  • Displays all incoming gifts along with the sender's username and delivery timestamp.
  • Claim gifts individually or use the "Claim All" button to collect everything your inventory can hold.

• 🌐 Full Offline Delivery Support

  • Send gifts to friends even if they are offline. Items wait securely in their inbox until they log in.

• 📜 Visual Transaction History (/gift history)

  • Paginated records (45 entries per page) tracking every SENT and RECEIVED transaction.

• 🛡️ Ironclad Anti-Dupe Engine

  • Anti-Creative / Middle-Click Clone: Blocks creative pick-block and duplicate actions.
  • Anti-Hotbar Swap: Completely disables hotbar swap number-key exploits on GUI frames.
  • Anti-Drag Abuse: Prevents dragging items across unauthorized slots.
  • Fail-Safe Auto-Refund: Any unconfirmed items are automatically returned to the player or safely dropped at their feet if the GUI is closed, the player disconnects, or the server restarts.

• 🎨 Deep Customization & Hex Colors

  • 100% configurable messages, prefix, GUI titles, and sound effects.
  • Native support for standard color codes (&a, &b, &e) and MiniMessage / RGB Hex formatting (&#00E5FF).

• 🔔 Login Reminder Alerts

  • Displays a customizable title and plays a chime sound when a player joins with uncollected gifts.

• 🚫 Item Blacklist System

  • Blacklist specific items (e.g., Bedrock, Barriers, Command Blocks, custom tokens) from ever being gifted.

---

🎮 How It Works

1. Sending a Gift:
   • Type /gift <player> to open the Send GUI.
   • Place the items you want to gift into the center 21 slots.
   • Click the ✔ Confirm & Send button. Items are delivered instantly!
2. Receiving & Claiming:
   • When someone sends you a gift, you will receive an in-game notification sound and message.
   • Type /gift to open your Inbox.
   • Click any item to claim it into your inventory, or click ✔ Claim All.
3. Checking Logs:
   • Type /gift history anytime to inspect your delivery receipts and timestamps.

---

⌨️ Commands & Permissions

Command	Permission	Default	Description
/gift	gift.use	Everyone	Opens your personal Gift Inbox GUI.
/gift <player>	gift.send	Everyone	Opens the 21-slot Send GUI for an online or offline player.
/gift history	gift.history	Everyone	Opens the paginated Transaction History GUI.
/gift info	gift.use	Everyone	Displays plugin version, official author, and license status.
/gift reload	gift.admin	OP	Reloads config.yml on the fly without a server restart.

Command Aliases: /gifts, /inbox, /sendgift

---

⚙️ Configuration Preview (config.yml)

# Global message prefix
prefix: "&#00E5FF&l🎁 Gift &8» &7"

settings:
  send-cooldown-seconds: 3
  click-cooldown-ms: 250
  max-inbox-capacity: 45
  join-notification-enabled: true
  join-notification-delay-ticks: 40
  blacklisted-materials:
    - "BEDROCK"
    - "BARRIER"
    - "COMMAND_BLOCK"
    - "STRUCTURE_BLOCK"

gui:
  inbox-title: "&#00E5FF&l🎁 YOUR GIFT INBOX"
  send-title-prefix: "&8Send Gift to: &#00E5FF"
  history-title-prefix: "&8📜 Gift History (Page "

sounds:
  open-gui:
    enabled: true
    sound: "BLOCK_CHEST_OPEN"
    volume: 1.0
    pitch: 1.0
  send-success:
    enabled: true
    sound: "ENTITY_PLAYER_LEVELUP"
    volume: 1.0
    pitch: 1.5
  claim-success:
    enabled: true
    sound: "ENTITY_ITEM_PICKUP"
    volume: 1.0
    pitch: 1.2

---

📥 Installation

1. Download Gift-1.0.0.jar.
2. Drop the .jar file into your server's plugins/ directory.
3. Restart your server or run /plugman load Gift.
4. Customize messages and settings in plugins/Gift/config.yml.
5. Enjoy a safe, seamless gifting experience!

---

👤 Developer & Credits

• Author / Developer: Rafi-vai43
• License: Official Verified Release (All Rights Reserved)
• Compatibility: Tested on Paper, Purpur, Spigot, and Leaf (1.20 - 1.21+)