🎁 Player Gifts Datapack

Player Gifts is a lightweight datapack that allows players to send items to each other using simple trigger commands.

Perfect for SMP survival worlds, roleplay servers, and community events.

---

✨ Features

• Send the item in your hand to any online player
• No dropped items lost to lag or void (gifts are stored safely until opened)
• Receiver gets a notification showing who sent the gift (with team formatting)
• Gifts are not delivered instantly — players must use /trigger open_gift
• Lightweight and SMP-friendly (minimal tick usage, no entity spam)
• Fully multiplayer compatible (supports multiple simultaneous gifts without conflict)

---

🎮 Commands

Command	Description
/trigger gp_help	Shows general help info
/trigger list_players	Shows a numbered list of online players (updates dynamically with joins & leaves)
/trigger send_gift set <number>	Sends your held item to the player with that index
/trigger open_gift	Opens a pending gift and drops it at your feet

---

🔔 Notifications

• Sender is told who received the gift
• Receiver is told who sent the gift (with correct team formatting, colors & prefixes)
• Periodic gift reminder (every 5 minutes) to open pending gifts

---

🛡 Safety

• Items are stored using NBT — never duped, never voided
• Cannot send gifts with an empty hand
• Cannot target offline or invalid players
• Fails safely and returns the item if delivery is not possible

---

📦 Installation

1. Download PlayerGifts.zip
2. Place into: world/datapacks/
3. Run /reload in game

---

🧩 Supported Versions

Minecraft Java 1.21.10

---

📘 How to Use

1. Player Gifts Help Use the command below to display the Player Gifts Help text:

/trigger gp_help

---

2. List players online Use the command below to display a numbered list of all online players:

/trigger list_players

---

3. Select who to send the gift to With the item you want to send in your hand, chose the target player from the list:

/trigger send_gift set <number>

If the delivery was successful, you'll see a confirmation message showing who received the gift

If the delivery was unsuccessful, you'll see an error message showing why it cannot be sent

---

4. Open a received gift If another player has sent you a gift, you'll see a confirmation message showing who sent it

If the gift isn't opened after 5 minutes a message will be sent reminding you of the unopened gift

To open the gift, run:

/trigger open_gift

and the gift will drop as an item at your feet

If you have not received a gift, but try and open a gift, an error message will appear

---

If you encounter any issues or have feature requests, feel free to open an Issue or Pull Request.