Present Now with optional MySql support! - Present礼物插件

这款插件为你的服务器增添了礼物系统！玩家可以挑选礼物盒样式，放入物品，然后赠送给好友开启。我见过许多礼物插件的实现，但它们要么功能不符需求，要么已经过时。这也是我发布的第一个公开插件！

💡核心功能

礼物插件允许你创建无需合成材料的礼物盒，其中可以存放任何物品。

• 礼物盒将以物品形式存在于世界中。
• 可以存放在箱子中、扔进岩浆（请小心！）、戴在头上、放入其他礼物盒内，或者最常用的——赠送给其他玩家！
• 礼物盒无法被放置在地上（尝试放置会直接将其打开）。

礼物插件会创建完全持久化的礼物盒，用于存储物品堆。

🔧快速开始

• 输入命令 /present。
• 在弹出的界面中选择你喜欢的礼物盒外观。
• 将物品放入礼物盒中。
• 将礼物盒交给一位朋友。
• 手持礼物盒右键点击即可打开！

❓要求与依赖

• 本插件需要我的核心库插件 ABCore 才能运行。
• 插件基于 Java 17 构建。
• 可选软依赖：Vault（用于经济功能）。

🎮命令与权限

命令

• /present

- **描述**：创建一个礼物盒。

- **用法**：`/<command>`

- **权限**：`abpresent.present`

权限

• abpresent.present

- **描述**：允许玩家创建礼物盒。

- **默认**：`true`（所有玩家拥有）

• abpresent.*

- **描述**：允许使用所有礼物插件命令。

- **默认**：`op`（仅OP拥有）

- **子权限**：包含 `abpresent.present: true`

✨配置与自定义

配置文件概览

所有GUI标题、聊天消息、礼物名称和外观材质都可以在配置文件中更新，不仅完全可定制，也支持多语言。

主要配置选项包括

• delete-present-data-before-date：设置一个日期，启动时会清理此日期之前创建的礼物数据，帮助管理服务器存储空间。
• blocked-slot-material：设置GUI中不可用槽位的显示材质（默认：GRAY_STAINED_GLASS_PANE）。
• blacklist-materials：禁止放入礼物盒的物品材料列表。默认已禁止 SHULKER_BOX，以防止玩家通过“盒中盒”获得无限存储空间。
• enable-vault：是否启用Vault经济系统。
• sql-enabled：是否启用MySQL数据库支持。

语言文件

你可以自定义礼物盒的物品名（present-item-name）、提示信息（如 present-receive-message）和所有GUI的标题。

礼物类型

在配置文件中，你可以定义多种礼物类型（如 present_1），并为每种类型设置：

• cost：价格（需启用Vault）。
• size：可容纳的物品数量。
• texture：礼物盒的材质。
• name：显示名称。

⭐高级功能

MySQL 数据库支持

插件现已支持MySQL！

• 将配置中的 sql-enabled 设为 true 并填写正确的数据库连接信息。
• 插件会自动将现有文件存储的礼物数据迁移到数据库中，无需额外设置。
• 这使得礼物可以在多服务器网络中转移和使用。
• 所有数据库的插入、查询、删除操作均为异步执行，不影响服务器性能。

配置重载

无需重启服务器或插件即可重载配置。使用核心库插件 ABCore 提供的 /ab-reload 命令即可。

---

欢迎查看我的其他插件！如有问题或需要支持，请随时加入我的 Discord 社区。