PlayerPresents

!(https://cdn.modrinth.com/data/OJt1mpyf/images/14dd9b8bfe2c4dc7981b7a9a2497eb77985a6bc3.png)

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

For support or feature suggestions, contact me:

• (https://discord.com/users/771295264153141250)
• discord://-/users/771295264153141250 (App)

!(https://bstats.org/signatures/bukkit/Player%20Presents.svg)