Player Gifts

Minecraft 版本： 1.21.10

平台： datapack

标签： game-mechanics social utility

🎁 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

🔔 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.