
PlayerPresents ?
PlayerPresents 是一款 Spigot/Paper 插件,允许玩家通过完善的锁定系统、自定义选项和日志记录功能创建并互赠礼物。
✨ 主要功能
? 礼物创建
- 直观的 GUI 系统:分 5 个步骤创建礼物
- 外观选择:提供多种礼物模板供选择
- 自定义名称和描述:可自定义礼物名称和物品 lore(描述)
- 灵活的槽位:可选择礼物包含的槽位数量(即内部能装多少物品)
- 可自定义颜色:支持颜色代码、HEX 颜色以及 MiniMessage
? 锁定系统
- 基于分钟的锁定:礼物将在指定的分钟数后被解锁
- 定时锁定:礼物将在特定的日期和时间开启
- 创建者豁免:礼物创建者始终可以无限制地打开它
- 管理员豁免:管理员可以绕过任何锁定
- 倒计时显示:玩家可以看到精确的剩余时间(例如:“5天 2小时 30分”)
? 经济系统
- Vault 集成:支持任何经济类插件
- 固定价格:每个礼物有固定价格
- 动态价格:价格根据槽位数量而定
- 免费礼物:可选择禁用价格功能
? 日志记录
- 详细的创建记录:记录关于礼物内容的全部信息
- 开启日志:记录谁打开了什么以及收到了什么
- 物品信息:记录名称、lore、附魔和自定义模型数据
- 可禁用:可在
config.yml中禁用 - 易读格式:在
log.log文件中易于阅读
? 语言支持
- ?? 捷克语
- ?? 英语
- ?? 德语
- ?? 西班牙语
- ?? 俄语
- ?? 日语
⚙️ 服务器管理
- 自动时区检测:根据位置进行正确的时间计算
- 自定义模板支持:可在 YAML 中自定义礼物模板
- 可配置内容:所有消息均可在
config.yml中编辑 - 安全性:禁止特定物品(如潜影盒等)
? 命令
主命令
/present create <recipient>
为指定玩家打开用于创建礼物的 GUI。
示例
/present create John
为玩家 John 创建礼物。
管理员命令
/present reload
重新加载配置、语言和模板。
? 配置
config.yml - 基本设置
# 选择语言
language: "en"
# Vault 经济
vault: true
# 礼物锁定系统
gift-lock:
mode: "minutes" # "none", "minutes", "scheduled"
duration-minutes: 1 # 锁定持续时间(分钟)
scheduled-open-date: "2025-12-25 10:00:00"
timezone: "auto" # "auto" 或特定时区
# 日志记录
logging:
enabled: true # 启用/禁用日志记录
gift.yml - 礼物模板
定义自定义礼物模板,包括名称、默认内容和价格。
? 权限
playerpresents.create- 创建礼物playerpresents.open- 打开礼物playerpresents.open.locked- 绕过礼物锁定playerpresents.admin- 管理员命令
? 使用示例
示例 1:圣诞礼物
/present create John
- 选择外观(圣诞包装)
- 输入名称:“? Christmas Surprise”
- 输入描述:“Merry Christmas!”
- 选择 5 个槽位
- 添加钻石、绿宝石和书
- 确认,礼物发送!
示例 2:限时礼物
gift-lock:
mode: "minutes"
duration-minutes: 60
礼物可在 60 分钟后打开。玩家将看到:“礼物将在 59m 45s 后开启!”
示例 3:定时礼物
gift-lock:
mode: "scheduled"
scheduled-open-date: "2025-12-25 10:00:00"
timezone: "Europe/Prague"
礼物将在 12 月 25 日上午 10:00 CET 准时开启。
? 依赖要求
- Spigot/Paper 1.21+
- Java 21+
- Vault(如果使用经济功能)
- 经济插件(如果需要价格功能)
? Log.log 格式
创建礼物时:
[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
打开礼物时:
[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
? 功能亮点
- ✅ 支持多语言的直观 GUI
- ✅ 灵活的锁定系统(按分钟/日期)
- ✅ 详细记录所有操作
- ✅ 通过 Vault 实现经济功能
- ✅ 自定义礼物模板
- ✅ 颜色和格式化代码(MiniMessage)
- ✅ 管理员可绕过锁定
- ✅ 可禁用的日志记录
SUPPORT
如需支持或功能建议,请联系我:
- discord://-/users/771295264153141250 (App)

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.logfile
🌍 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 giftsplayerpresents.open- Open giftsplayerpresents.open.locked- Bypass gift locksplayerpresents.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://-/users/771295264153141250 (App)
下载 PlayerPresents
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerPresents
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerPresents
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerPresents
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerPresents
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerPresents
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerPresents
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerPresents
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerPresents
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PlayerPresents
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
- 新增
/present create all命令——创建一个没有固定接收者的礼物,任何收到该礼物的人都可以打开它。 - 新增权限:
playerpresents.create.all
(默认值:true)
all已加入 Tab 补全和/present help的帮助信息中。- 在所有 6 种语言(cs、en、de、es、ru、ja)中新增了语言键。
1.2.0 - 礼物制作大改
本次更新使礼物制作更加清晰和安全,新增了礼物设计模板和确认摘要界面,并修复了打开礼物及物品处理的问题。
亮点
- 创建前的摘要界面 - 点击“创建礼物”后,你将看到礼物的预览、接收者、槽位数量、物品数量、价格及余额。使用返回回到内容编辑界面,取消以中止操作,或创建礼物完成制作。仅在确认后才会扣除金钱。
- 礼物设计模板 - 保存礼物外观、名称和描述作为可复用的设计。模板从不存储物品。从外观或内容界面加载设计;加载会将当前所有内容返还至你的背包,并将你带至槽位选择界面,从而防止物品复制。按住 Shift 键点击模板可将其删除。
- 更清晰的五步流程 - 标题中显示步骤编号(1/5 … 5/5),每一步都有取消按钮,槽位选择界面布局更简洁,聊天提示也更简短。
- 声音反馈 - 可配置的菜单导航、禁止物品及余额不足时的点击和错误音效。
- 内容 GUI 中的返回按钮 - 旧的“退回物品”漏斗功能现已改为返回按钮,用于退回物品并进入槽位选择界面。
修复
- 礼物可再次打开 - 即使其他插件或服务器将交互事件标记为已取消,与礼物交互现在也能正常工作。在空气中右键点击以及右键点击方块均有效,包括由煤炭、砖块或命名牌制作的礼物。
- 无物品丢失 - 禁止物品无法插入。如果此类物品意外进入了 GUI,则在确认时会将其退回。关闭 GUI、退出游戏或插件关闭时,所有物品都会被退回。
- 可堆叠的礼物 - 当
gift-lock.mode: "none"时,相同的礼物(相同的内容、接收者、创建者、名称、描述和外观)可以堆叠。锁定模式minutes和scheduled仍会存储创建时间戳,因此不会堆叠。 - 接收者追踪 - 新礼物会存储接收者的 UUID 和名称。只有接收者、创建者、管理员或拥有
playerpresents.open.any权限的玩家才能打开它们。没有接收者数据的老版本礼物仍对所有人开放。 - 更安全的经济系统 - 仅在所有验证和创建成功后才收取费用;如果任何环节失败,物品将被退回。
- 锁定时区修复 - 创建时间以毫秒级时间戳存储,因此分钟锁和定时锁能正确配合配置的时区工作。
- 更安全的打开机制 - 空礼物不会打开,满背包遵循
inventory-full-action设置,且仅在物品交付完成后才会移除礼物。 - 语言和配置修复 - 缺失的翻译回退到英文,新的键值被添加到现有的语言文件中,消息只格式化一次,且配置文件按正确的顺序加载。
- 礼物数据 - 新版本实现了稳定的礼物内容序列化格式,并支持由旧版本创建的礼物。
新增配置
recipient-only: true
allow-offline-recipients: true
templates:
enabled: true
max-per-player: 9
effects:
ui-click-sound: "UI_BUTTON_CLICK"
ui-error-sound: "ENTITY_VILLAGER_NO"
现有配置保留其原有值;新增的可选键使用内置默认值。
升级说明
- 更新前请备份
plugins/PlayerPresents/目录。 - 现有礼物仍可读取。没有接收者数据的老版本礼物对所有人开放。
- 设置
language: "cs"可使用捷克语,或其他受支持的语言。 - 如果你希望恢复旧的“任何人都可以打开”的行为,请设置
recipient-only: false。
兼容性
需要 Paper/Spigot 1.17+。已在 Paper 26.2 和 Leaf 1.21.11 上测试通过。
- 禁用礼物锁(模式:无)后,不再将创建时间存储在礼物的 NBT 数据中。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧