
PlayerPresents
This plugin allows players to send gifts to each other in a simple and secure way, encouraging positive interactions and a stronger community.
Автор: kulihrasek11014162обновлён 3 окт. 2026 г.
ЭкономикаМеханики игрыОбщение
Описание

PlayerPresents 🎁
PlayerPresents is a Spigot/Paper plugin that allows players to create and send each other gifts with a comprehensive lock system, customization, and logging.
✨ Key Features
🎀 Gift Creation
- Intuitive GUI system for creating gifts in 5 steps
- Appearance selection - various gift templates to choose from
- Custom name and description - customizable gift name and lore
- Flexible slots - choose how many slots (items fit inside)
- Customizable colors - support for color codes, HEX colors, and MiniMessage
🔒 Lock System
- Minute-based lock - gift is locked for a specified number of minutes
- Scheduled lock - gift opens at a specific date and time
- Creator bypass - gift creator can always open it without restrictions
- Admin bypass - administrators can bypass any lock
- Countdown to opening - players see the exact remaining time (e.g., "5d 2h 30m")
💰 Economy
- Vault integration - support for any economy plugin
- Static prices - fixed price per gift
- Dynamic prices - price based on number of slots
- Free gifts - option to disable prices
📊 Logging
- Detailed creation records - all information about gift contents is recorded
- Opening logs - who opened what and what they received
- Item information - names, lore, enchantments, and custom model data are logged
- Disableable - can be disabled in config.yml
- Readable format - easy to read in
log.logfile
🌍 Language Support
- 🇨🇿 Czech
- 🇬🇧 English
- 🇩🇪 German
- 🇪🇸 Spanish
- 🇷🇺 Russian
- 🇯🇵 Japanese
⚙️ Server Management
- Automatic timezone detection - correct time calculations based on location
- Custom template support - customizable gift templates in YAML
- Configurable content - all messages can be edited in config.yml
- Security - forbidden items (Shulker boxes, etc.)
🎮 Commands
Main Command
/present create <recipient>
Opens the GUI for creating a gift for the specified player.
Example
/present create John
Creates a gift for player John.
Admin Command
/present reload
Reloads configuration, languages, and templates.
📋 Configuration
config.yml - Basic Settings
# Choose language
language: "en"
# Vault economy
vault: true
# Gift lock system
gift-lock:
mode: "minutes" # "none", "minutes", "scheduled"
duration-minutes: 1 # Lock duration in minutes
scheduled-open-date: "2025-12-25 10:00:00"
timezone: "auto" # "auto" or specific timezone
# Logging
logging:
enabled: true # Enable/disable logging
gift.yml - Gift Templates
Define custom gift templates with name, default contents, and price.
🔧 Permissions
playerpresents.create- Create giftsplayerpresents.open- Open giftsplayerpresents.open.locked- Bypass gift locksplayerpresents.admin- Admin commands
📝 Usage Examples
Example 1: Christmas Gifts
/present create John
- Choose appearance (Christmas wrapping)
- Type name: "🎄 Christmas Surprise"
- Type description: "Merry Christmas!"
- Choose 5 slots
- Add diamonds, emeralds, and books
- Confirm and gift is sent!
Example 2: Time-Limited Gift
gift-lock:
mode: "minutes"
duration-minutes: 60
Gift can be opened in 60 minutes. Player will see: "Gift opens in 59m 45s!"
Example 3: Scheduled Gift
gift-lock:
mode: "scheduled"
scheduled-open-date: "2025-12-25 10:00:00"
timezone: "Europe/Prague"
Gift opens exactly on December 25th at 10:00 AM CET.
🐛 Requirements
- Spigot/Paper 1.21+
- Java 21+
- Vault (if using economy)
- Economy plugin (if you want prices)
📊 Log.log Format
When creating a gift:
[2025-12-20 15:30:45] CREATED | Creator: PlayerA | Recipient: PlayerB | Name: Christmas Gift | Lore: Merry Christmas | Items: DIAMONDx5 | Name: Quality Diamond | Enchantments: fortune:3 | Model: 1001
When opening a gift:
[2025-12-20 15:35:20] OPENED | Player: PlayerB | Creator: PlayerA | Recipient: Unknown | Name: Christmas Gift | Received Items: DIAMONDx5 | Name: Quality Diamond | Enchantments: fortune:3
🎨 Features
- ✅ Intuitive GUI with multilingual support
- ✅ Flexible lock system (minute/date)
- ✅ Detailed logging of all actions
- ✅ Economy through Vault
- ✅ Custom gift templates
- ✅ Color and formatting codes (MiniMessage)
- ✅ Admin bypass for administrators
- ✅ Disableable logging
SUPPORT
For support or feature suggestions, contact me:
- Discord (Web)
- discord://-/users/771295264153141250 (App)
Галерея
Последние версии
Все версии →release
PlayerPresents 1.1.2
1.1.23 окт. 2026 г.58Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2, 26.2, 26.3bukkit, paper, purpur, spigot
Что нового
- Disabled gift lock (mode: none) no longer stores creation time in the gift's NBT data.
release
PlayerPresents 1.1.1
1.1.115 июн. 2026 г.43Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2bukkit, paper, purpur, spigot
Что нового
# PlayerPresents - Security Patch
## 🔒 Fixed: Item Duplication Exploit
Fixed an exploit where players could duplicate items using cheat clients or UI utils mods by saving and reloading the gift creation GUI.
- ✅ Locked all items in gift selection menus to prevent extraction
- ✅ Automatically detected and closed unauthorized GUI instances
- ✅ Prevented command abuse during active gift creation
release
PlayerPresents 1.1.0
1.1.014 июн. 2026 г.37Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2bukkit, paper, purpur, spigot
Что нового
## Version 1.1.0
### ✨ New Features
#### 🎨 Full MiniMessage Support
Lang files now support all MiniMessage tags:
- **Colors:** `<red>`, `<blue>`, `<gold>`, `<green>` and more
- **Formatting:** `<bold>`, `<italic>`, `<underlined>`, `<strikethrough>`, `<obfuscated>`
- **Hex colors:** `<color:#FF9100>`
- **Gradients:** `<gradient:#FF9100:#EA1205>text</gradient>`
- **Rainbow:** `<rainbow>text</rainbow>`
- **Reset:** `<reset>`
#### 🔄 Backward Compatibility with Legacy Formatting
All legacy formats still work simultaneously:
- `&c`, `&l`, `&n` - classic color codes
- `&#FF9100` - legacy hex format
- `§c`, `§l`, `§6` - section (§) format
- `§x§F§F§9§1§0§0` - § hex format
#### 📋 PlaceholderAPI Integration
Placeholders are now automatically expanded when a player is provided:
- `%player_name%`, `%player_health%` - standard PAPI placeholders
- `%nexo_shift_-48%`, `%nexo_size_36%` - Nexo placeholders
- `{from}`, `{for}` - custom plugin placeholders
#### 🎁 Gift Creation with MiniMessage + Placeholders
Created gifts now support:
- MiniMessage tags in name and lore
- Legacy color codes
- PlaceholderAPI placeholders that remain dynamic
- Custom formatting combinations like:
```yml
"<b><gradient:#FF9100:#EA1205>gradient</gradient></b> %nexo_shift_-48%§6Select Gift Appearance"
```
---
### 🔧 Bug Fixes & Improvements
#### 🛠️ Gift.yml Auto-Update
- No longer warns about missing `base64` for non-PLAYER_HEAD items
- No longer warns about missing `model-data` for PLAYER_HEAD items
- Automatically adds missing Present sections (Present15, Present16, etc.)
- Preserves user settings and comments during updates
#### 📝 Message Formatting Pipeline
Messages are now processed in this order:
1. Expand PlaceholderAPI placeholders (`%placeholder%`)
2. Replace custom placeholders (`{from}`, `{for}`)
3. Convert `§` hex to `&#RRGGBB`
4. Convert `§` codes to `&` equivalents
5. Convert `&` hex to MiniMessage `<color:#RRGGBB>`
6. Convert `&` codes to MiniMessage tags
7. Parse everything with MiniMessage
8. Convert to legacy `§` format for Minecraft
#### 🎯 GUI Improvements
- All GUI titles now support MiniMessage + legacy colors + PlaceholderAPI
- Preview items show expanded placeholders
- Final gifts keep placeholders dynamic for real-time display
- Text input hints updated with MiniMessage examples
release
PlayerPresents 1.0.7
1.0.727 апр. 2026 г.42Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11, 26.1, 26.1.1, 26.1.2bukkit, paper, purpur, spigot
Что нового
- ✅ **Bugfix:** Gifts opened from the offhand are now properly removed, fixing the infinite open exploit.
release
PlayerPresents 1.0.6
1.0.63 янв. 2026 г.50Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
✅ Added a privacy-focused enhancement to tab completion for `/present creater <player>` automatically hiding the names of players who are currently in vanish mode, ensuring a cleaner and more secure admin experience.
release
PlayerPresents 1.0.5
1.0.522 дек. 2025 г.34Minecraft: 1.17, 1.17.1, 1.18, 1.18.1, 1.18.2, 1.19, 1.19.1, 1.19.2, 1.19.3, 1.19.4, 1.20, 1.20.1, 1.20.2, 1.20.3, 1.20.4, 1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
✅ Added full version compatibility support from Minecraft 1.17 up to the latest release 1.21.10+, ensuring seamless operation across all modern server versions.
✅ Fixed skull texture rendering by implementing modern Paper API integration (PlayerProfile and ProfileProperty) compatible with all supported versions.
✅ Replaced legacy reflection-based texture injection with official Bukkit/Paper API methods for improved compatibility and stability across version range.
✅ Ensured custom skull textures display correctly in both GUI previews and created gift items on all supported server versions.
✅ Implemented proper URL extraction from Base64-encoded texture data for seamless texture application across Minecraft 1.17+.
✅ Improved long-term maintainability by using future-proof API methods that align with Minecraft's evolving server architecture and ensure continued support for upcoming versions.
✅ Verified performance and reliability across the entire supported version range (1.17 - 1.21.10+) for production environments.
release
PlayerPresents 1.0.4
1.0.420 дек. 2025 г.32Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
✅ Added particle and sound effects for gift creation and opening with customizable settings.
✅ Implemented separate configuration for creation and opening effects via **create-particle-count** and **open-particle-count**.
✅ Fixed bug preventing gifts from being placed into containers (chests, barrels, shulker boxes, etc.).
✅ Gifts can now be stored in containers without restrictions.
✅ Fixed asynchronous gift creation process for more stable and optimized custom name and custom lore functionality.
✅ Prevented players from accidentally clicking existing gifts when selecting gift names and lore.
✅ Config auto-updates on plugin startup with missing keys and values.
---
## Effects Configuration Example
```yaml
# =====================================
# EFFECTS SETTINGS - SOUNDS AND PARTICLES
# =====================================
# Configure sound and particle effects for gift creation and opening
# All players will experience these unified effects for all gifts
effects:
# Sound played when a gift is created
# List of available sounds: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
# Examples: ENTITY_PLAYER_LEVELUP, BLOCK_NOTE_BLOCK_XYLOPHONE, ENTITY_FIREWORK_ROCKET, BLOCK_AMETHYST_BLOCK_CHIME
# Set to "NONE" to disable sound
create-sound: "ENTITY_PLAYER_LEVELUP"
# Sound played when a gift is opened
# Examples: ENTITY_ITEM_PICKUP, BLOCK_CHEST_OPEN, UI_TOAST_CHALLENGE_COMPLETE, ENTITY_FIREWORK_LAUNCH
# Set to "NONE" to disable sound
open-sound: "BLOCK_CHEST_OPEN"
# Particle effect displayed when a gift is created
# List of available particles: https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Particle.html
# Examples: FIREWORKS, HAPPY_VILLAGER, EXPLOSION_NORMAL, SPELL_WITCH, CLOUD, DRAGON_BREATH, TOTEM
# Set to "NONE" to disable particles
create-particle: "HAPPY_VILLAGER"
# Particle effect displayed when a gift is opened
# Examples: FIREWORK, CRIT, EXPLOSION_LARGE, SPELL_INSTANT, CLOUD, TOTEM
# Set to "NONE" to disable particles
open-particle: "FIREWORK"
# Number of particles to spawn for creation effect
# Recommended: 10-30
create-particle-count: 25
# Number of particles to spawn for opening effect
# Recommended: 20-50
open-particle-count: 25
```
release
PlayerPresents 1.0.3
1.0.320 дек. 2025 г.31Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
✅ Implemented content filter system with regex-based pattern matching to prevent toxic, offensive, and inappropriate content in gift names and lore.
✅ Added `filter.yml` with pre-configured filter categories: profanity, racism, homophobia, sexism, religious intolerance, spam, and advertising.
✅ Content filter is fully configurable - enable/disable in `config.yml` with `content-filter.enabled` and `content-filter.log-violations` settings.
✅ Improved logging system: separated logs into three dedicated files in `logs/` folder:
- `create.log` - Gift creation events with full item details
- `open.log` - Gift opening events with received items
- `filter.log` - Content filter violations with player info and flagged content
✅ Plugin no longer hard-blocks specific item types in code; only items explicitly listed in `blacklist-items` are blocked.
✅ Removed hard-coded blocking of armor and other materials — all blocking is now solely controlled by configuration.
✅ Added multi-language support for all filter violation messages in all 6 supported languages (English, Czech, German, Spanish, Japanese, Russian).
✅ Fixed Maven shade plugin configuration to properly handle bstats library merging without MANIFEST conflicts.
release
PlayerPresents 1.0.2
1.0.220 дек. 2025 г.32Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
✅ Fixed missing keys in config.yml and language files - plugin now automatically fills in missing settings without overwriting user changes and comments.
✅ Added support for custom lore and custom name for gifts - players can now fully customize the appearance and description of their gifts with support for color codes.
✅ Fixed returning to GUI after entering text in chat.
✅ Multi-line lore with empty lines - custom gift descriptions now support `\n` for new lines and `\n\n` to create gaps.
✅ Improved placeholder system - placeholders (`{from}`, `{for}`) now work correctly in custom names and descriptions.
✅ Added sync warnings in config.yml.
✅ Fixed duplicate sections in gift.yml - prevented creation of multiple `Cost:` sections that caused YAML parsing errors.
✅ Better gift.yml validation without risky auto-fixes - plugin now only reports errors instead of attempting automatic fixes that could corrupt data.
release
PlayerPresents 1.0.1
1.0.120 дек. 2025 г.29Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11bukkit, paper, purpur, spigot
Что нового
- ✅ Removed unnecessary generation of names and lore for menu items in the gift selection.
- ✅ Optimized gift appearance selection.
- ✅ Fixed bug with inserting armor into gifts.