PlayerPresents

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

- Customizable colors for creating gifts in 5 steps - Customizable colors - various gift templates to choose from - Customizable colors - customizable gift name and lore - Customizable colors - choose how many slots (items fit inside) - Customizable colors - support for color codes, HEX colors, and MiniMessage

🔒 Lock System

- Countdown to opening - gift is locked for a specified number of minutes - Countdown to opening - gift opens at a specific date and time - Countdown to opening - gift creator can always open it without restrictions - Countdown to opening - administrators can bypass any lock - Countdown to opening - players see the exact remaining time (e.g., "5d 2h 30m")

💰 Economy

- Free gifts - support for any economy plugin - Free gifts - fixed price per gift - Free gifts - price based on number of slots - Free gifts - option to disable prices

📊 Logging

- Readable format - all information about gift contents is recorded - Readable format - who opened what and what they received - Readable format - names, lore, enchantments, and custom model data are logged - Readable format - 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

- Security - correct time calculations based on location - Security - customizable gift templates in YAML - Security - 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

- Vault 1.21+ - Vault 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)