Player Gifts

🎁 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 sent 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 — returns the item - 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`

---

in your hand 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

---

who sent it 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.