✨ Key Features

Gift Creation

• Intuitive GUI system - 5 steps to create the perfect gift
• Appearance selection - various gift templates to choose from
• Custom name and description - customizable gift name and lore
• Flexible slots - choose how many slots (how many items fit)
• 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 remaining time (e.g., "5d 2h 30m")

Economy

• Vault integration - support for any economy plugin
• Static and dynamic prices - fixed or slot-based pricing
• Free gifts - option to disable prices

Logging & Filters

• Three separate log files - create.log, open.log, filter.log
• Detailed records - all gift contents and transactions logged
• Content filter - prevents toxic content in names and lore using regex patterns
• Filter violations logged - moderation and pattern analysis

Language Support

• Czech, English, German, Spanish, Russian, Japanese
• Customizable messages

Commands

- Create a gift
- Reload configuration (admin only)

⚙️ Configuration

config.yml settings:

• language - Choose your language
• vault - Enable/disable economy
• gift-lock - Lock mode (none, minutes, scheduled)
• logging - Enable/disable logging
• content-filter - Enable/disable content filter with regex patterns
• blacklist-items - Items that cannot be placed in gifts

filter.yml - Content filter categories:

• Profanity, Racism, Homophobia, Sexism
• Religious Intolerance, Spam, Advertising

Permissions

• playerpresents.create - Create gifts
• playerpresents.open - Open gifts
• playerpresents.open.locked - Bypass gift locks
• playerpresents.admin - Admin commands

Quick Examples

Create a gift:
Time-locked gift (1 hour):
Scheduled gift (Christmas morning):
Logging

Three log files in plugins/PlayerPresents/logs/:

• create.log - Gift creation with full item details
• open.log - Gift opening events
• filter.log - Content filter violations

Content Filter

Built-in regex-based content filter that:

• Blocks toxic, offensive, and inappropriate content
• Scans gift names and descriptions
• Logs violations to filter.log
• Configurable via config.yml
• Shows translated messages to players

⚙️ Requirements

• Spigot/Paper 1.21+
• Java 21+
• Vault (optional, for economy)
• Economy plugin (optional, if using prices)

✅ Features at a Glance

• ✅ GUI-based gift creation with 5 steps
• ✅ Flexible lock system (time or date)
• ✅ Detailed logging to separate files
• ✅ Content filter with regex patterns
• ✅ Economy integration (Vault)
• ✅ 6 languages supported
• ✅ Admin bypass for all locks
• ✅ Custom gift templates
• ✅ Color and MiniMessage support

Support

For support or feature suggestions, contact me:

• Discord (Web)
• discord://-/users/771295264153141250 (App)