logo

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

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)

bStats

PlayerPresents