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

# 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

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)