ВЕРСИИ (11)

- Disabled gift lock (mode: none) no longer stores creation time in the gift's NBT data.

# 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

## 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

- ✅ **Bugfix:** Gifts opened from the offhand are now properly removed, fixing the infinite open exploit.

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

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

✅ 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 ```

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

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

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

# 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.log` file ### 🌍 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 ```yaml # 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 gifts - `playerpresents.open` - Open gifts - `playerpresents.open.locked` - Bypass gift locks - `playerpresents.admin` - Admin commands ## 📝 Usage Examples ### Example 1: Christmas Gifts ``` /present create John ``` 1. Choose appearance (Christmas wrapping) 2. Type name: "🎄 Christmas Surprise" 3. Type description: "Merry Christmas!" 4. Choose 5 slots 5. Add diamonds, emeralds, and books 6. Confirm and gift is sent! ### Example 2: Time-Limited Gift ```yaml 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 ```yaml 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)](https://discord.com/users/771295264153141250) - discord://-/users/771295264153141250 (App)