eSaveItem - eSaveItem

eSaveItem 是一款来自 ePlugins 的免费、现代且高度优化的插件。它通过提供一种特殊物品，确保玩家在死亡时不会丢失物品和经验等级，让玩家感到更安全。所有功能均可完全自定义，配置简单易用。

💡核心功能

当 SaveItem 在玩家背包中时

• 保存玩家的物品。
• 保存玩家的经验等级。

高度自定义

• 可在配置文件中自定义 SaveItem 的物品名称、材质和描述文本。
• 支持无限行的描述文本。
• 可为 SaveItem 设置发光效果（隐藏附魔）。
• 可设置 SaveItem 仅在玩家死亡时手持才生效。
• 可设置玩家死亡后是否删除其 SaveItem。
• 可设置返还玩家背包物品的百分比。
• 可轻松编辑插件消息前缀。

商店与合成

• 插件内置商店功能（可启用/禁用）。
• 可编辑商店中 SaveItem 的售价。
• 支持自定义合成配方（可启用/禁用）。
• 可完全编辑 SaveItem 的合成配方。

其他特性

• 支持 RGB 颜色和渐变系统。
• 可在配置文件中设置禁用 SaveItem 功能的世界。

🎮命令列表

• /saveitem - 在聊天栏显示基本命令。
• /saveitem give - 给予自己一个 SaveItem。
• /saveitem give <player> - 给予指定玩家一个 SaveItem。
• /saveitem buy - 购买一个 SaveItem（GUI 即将推出）。
• /saveitem reload - 重载插件。

✨权限节点

• saveitem.use - 允许玩家使用 SaveItem（默认为 true）。
• saveitem.give - 允许玩家使用给予命令。
• saveitem.giveothers - 允许玩家将 SaveItem 给予其他玩家。
• saveitem.infinity - 玩家死亡时不会丢失 SaveItem。
• saveitem.reload - 允许玩家重载插件。
• saveitem.keeplevel - 死亡时不丢失经验等级。

🔧配置示例 (config.yml)

以下为部分核心配置选项

# 插件是否启用
enabled: true

# 插件前缀，支持颜色代码和渐变
prefix: "<BOLD><GRADIENT:17FFD5:17AEFF>eSaveItem</BOLD></GRADIENT> &7»&r"

# SaveItem 的材质
material: PRISMARINE_SHARD

# SaveItem 的显示名称
display-name: "<BOLD><GRADIENT:17FFD5:00FF93>❤ SAVEITEM ❤</BOLD></GRADIENT>"

# SaveItem 的描述文本
item-lore:
  - " "
  - "&b- &7You can die with me!"
  - "&b- <GRADIENT:17FFD5:00FF93>gradients support</GRADIENT>"

# 返还物品的百分比
items-percentage: 100

# 是否保留背包、等级和盔甲
keep-inventory: true
keep-level: true
keep-armor: true

# 是否启用购买功能及价格（需要 Vault）
enable-buying: false
price: 500

🔧消息配置示例 (messages.yml)

消息文件支持使用 %prefix% 和 PlaceholderAPI。

# 给予自己物品时的消息
give-self-msg: "%prefix% &7You gave yourself a SaveItem!"

# 购买成功/失败消息
successful-purchase-msg: "%prefix% &7Successfully purchased a SaveItem for &b%price%$!"
failed-purchase-msg: "%prefix% &7You don't have enough money! You need &b%price%$!"

# 插件重载消息
plugin-reloaded: "%prefix% &7Plugin reloaded!"

⭐安装与设置

• 将 eSaveItem 插件文件拖入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 根据需求编辑 config.yml 和 messages.yml 文件。
• 使用 /saveitem reload 重载插件。
• 享受游戏！

❓兼容性与支持

• 兼容平台：支持 Spigot、Paper、Folia 及其他主流服务端核心。
• 支持与更新：如需帮助，请加入我们的 Discord 社区。
• 反馈：我们非常重视您的每一次下载、反馈和评分！

介绍

ESaveItem 是一个简单而强大的插件，允许玩家将物品栏中的物品安全地保存到文件中，并在需要时重新加载回来。它非常适合用于服务器活动、备份珍贵物品或在不同世界间转移物品。

💡功能

• 将玩家当前物品栏（包括盔甲、副手和背包）保存到文件中。
• 从文件加载物品到玩家的物品栏。
• 支持为每个玩家创建多个不同的保存文件。
• 简单的基于权限的命令系统。
• 轻量级，对服务器性能影响极小。

🎮命令

管理员命令

• /esaveitem save <玩家名> <文件名> - 将指定玩家的物品栏保存到以 <文件名> 命名的文件中。
• /esaveitem load <玩家名> <文件名> - 从以 <文件名> 命名的文件中加载物品到指定玩家的物品栏。
• /esaveitem reload - 重载插件配置文件。

玩家命令

• /esaveitem save <文件名> - 将自己的物品栏保存到以 <文件名> 命名的文件中。
• /esaveitem load <文件名> - 从以 <文件名> 命名的文件中加载物品到自己的物品栏。

🔧权限

• esaveitem.use - 允许玩家使用 /esaveitem save 和 /esaveitem load 命令（默认拥有）。
• esaveitem.admin - 允许使用管理员命令，如保存/加载其他玩家的物品以及重载插件。

✨安装与使用

安装步骤

• 将下载的 ESaveItem.jar 文件放入服务器的 plugins 文件夹。
• 重启或重载服务器。
• 插件会自动生成配置文件和数据文件夹。

基本使用

• 保存物品：玩家输入 /esaveitem save mygear。这会将他们当前的物品栏保存到名为 mygear 的文件中。
• 加载物品：之后，玩家可以输入 /esaveitem load mygear 来取回这些物品。加载操作会覆盖玩家当前的物品栏。

管理员使用

• 管理员可以使用 /esaveitem save Notch backup1 来保存玩家 Notch 的物品到文件 backup1。
• 管理员可以使用 /esaveitem load Notch backup1 来为玩家 Notch 加载文件 backup1 中的物品。

❓常见问题

• 文件保存在哪里？

玩家数据文件保存在 plugins/ESaveItem/playerdata/ 目录下，每个玩家有独立的文件夹。

• 加载物品时会怎样？

加载操作会完全替换玩家当前的物品栏、盔甲和副手物品。请谨慎操作。

• 支持跨版本吗？

物品数据以NBT形式存储，但不同Minecraft版本间的物品ID或NBT结构若有重大变化，可能导致兼容性问题。建议在相同核心版本的服务器间使用。

• 可以保存末影箱物品吗？

不可以。本插件仅保存和加载玩家随身物品栏（包括背包、盔甲栏和副手）。

⭐配置

首次运行插件后，会在 plugins/ESaveItem/ 目录下生成 config.yml 文件。你可以配置以下选项：

• 语言设置。
• 是否在保存/加载时向玩家发送提示消息。
• 是否允许玩家使用该功能（可通过权限节点精细控制）。

修改配置后，请使用 /esaveitem reload 命令（需权限）或重启服务器使更改生效。

🔧支持与下载

• 支持版本： 本插件适用于 Spigot、Paper 及其衍生服务端。建议在 1.13.x 及以上版本使用。
• 下载与更新：请访问官方发布页面或指定的插件下载平台获取最新版本。
• 问题反馈：如有问题或建议，请访问项目的GitHub仓库提交Issue。