Custom EnderChest - 自定义末影箱

CustomEnderChest 是一款允许你自定义玩家末影箱大小的插件，可以存储比原版更多或更少的物品。它的操作方式与原版末影箱相同，只需点击末影箱即可打开，同时还提供了命令访问功能。所有内容均可自定义，包括完整的颜色支持、末影箱标题和聊天消息。

💡主要特性

• 支持 Premium UUID 和 Offline UUID。
• 支持 FlatFile 数据存储（类似于 Essentials 插件）。
• 支持 MySQL 数据存储（可选择清理不活跃玩家数据）。
• 使用 MySQL 存储意味着可以在多个服务器间共享末影箱数据。
• 执行命令或打开末影箱时拥有音效。
• 支持控制台命令。
• 可通过命令和权限打开末影箱（可用于 VIP 玩家）。
• 管理员命令可以打开、删除其他玩家的末影箱。
• 完整的末影箱标题自定义，支持颜色和占位符。
• 可为不同大小的末影箱设置不同的标题。
• 提供 6 种末影箱大小，从 1 行 9 格到 6 行 54 格。
• 可自定义聊天消息，支持颜色代码。
• 支持任何物品数据（描述、名称、附魔）。
• 支持模组物品的 NBT 数据！（需在配置中启用）。
• 插件尽可能保持轻量化。

❓依赖项

• (可选) MySQL 数据库 - 仅在插件配置中启用 MySQL 时需要。
• (可选) ProtocolLib - 仅在需要支持模组物品的 NBT 数据时需要。

🔧安装说明

• 将插件放入服务器的 plugins 文件夹。
• 启动服务器以生成配置文件，然后关闭服务器。
• 打开配置文件并根据你的需求进行设置。
• 启动服务器。安装完成，请记得给玩家分配权限。

✨权限

设置末影箱大小通过权限实现。默认情况下，玩家没有打开末影箱的权限。

• CustomEnderChest.level.0 - 对应 9 格（1 行）的末影箱大小。
• CustomEnderChest.level.1 - 对应 18 格（2 行）的末影箱大小。
• CustomEnderChest.level.2 - 对应 27 格（3 行）的末影箱大小。
• CustomEnderChest.level.3 - 对应 36 格（4 行）的末影箱大小。
• CustomEnderChest.level.4 - 对应 45 格（5 行）的末影箱大小。
• CustomEnderChest.level.5 - 对应 54 格（6 行）的末影箱大小。
• CustomEnderChest.commands - 允许玩家使用命令 /customec open 打开末影箱。
• CustomEnderChest.admin - 授予管理员权限，可以打开、编辑或删除其他玩家的末影箱，以及重载插件配置和导入数据命令。

🎮命令

主命令是 /customenderchest、/customec 或 /ec。

• /ec 或 /ec help - 打开帮助页面。
• /ec open - 打开你自己的末影箱。
• /ec open <玩家名> - 打开其他玩家的末影箱。
• /ec delete <玩家名> - 删除一个玩家的末影箱数据。
• /ec reload - 重载插件配置文件。
• /ec importFromFlatFile - 将数据从 FlatFile 导入到 MySQL 数据库，跳过数据库中已存在的玩家数据。
• /ec importFromFlatFile overwrite - 将数据从 FlatFile 导入到 MySQL 数据库，覆盖数据库中已存在的玩家数据。

⭐配置示例

数据库设置

#数据库设置
database:
  #数据库类型，选项：FlatFile 或 MySQL
  typeOfDatabase: FlatFile
  #MySQL 数据库连接详情。
  mysql:
    host: 127.0.0.1
    port: 3306
    databaseName: 'mydatabase'
    tableName: 'cec_enderchests'
    user: 'admin'
    password: 'cheesecake'
    ssl: false

清理不活跃玩家

#此任务将扫描 MySQL 数据库中的不活跃玩家并移除他们。
#扫描在服务器启动后延迟 2 分钟进行，在异步线程中运行，不会影响服务器性能。
removeOldUsers:
  #启用或禁用 MySQL 数据库维护。| (true 或 false)
  enabled: false
  #不活跃天数。默认 60 天。
  inactive: 60

额外插件设置

settings:
  #为模组物品添加 NBT 数据支持。需要 MySQL 存储和 ProtocolLib 依赖。
  #注意！！！更改此设置需要重启服务器！
  modded-NBT-data-support: false
  #禁用点击末影箱来打开自定义末影箱。（如果只想用命令打开，此选项很有用）
  disable-enderchest-click: false
  #禁用此插件触发的所有音效。
  disable-sounds: false

自定义末影箱标题

enderChestTitle:
  #末影箱文件夹名称。支持颜色和格式代码。
  #Minecraft 颜色和格式代码：http://minecraft.gamepedia.com/Formatting_codes
  #警告！最大长度为 32 个字符（包括颜色和格式代码）。
  enderChestName: '&5&lEnderChest &7- %level'
  #占位符 %player 将被替换为玩家名。
  #%level 占位符将替换为下面的文本。因此你可以根据末影箱大小自定义每个标题。
  level0: '&dLevel 0' # 对应 9 格末影箱。
  level1: '&dLevel 1' # 对应 18 格末影箱。
  level2: '&dLevel 2' # 对应 27 格末影箱。
  level3: '&5Level 3' # 对应 36 格末影箱。
  level4: '&5Level 4' # 对应 45 格末影箱。
  level5: '&5Level 5' # 对应 54 格末影箱。

聊天消息

chatMessages:
  #聊天消息前缀。
  #要禁用前缀，请将其设置为 ''；例如：prefix: ''
  prefix: '&5&l[CustomEC] '
  #通过设置为 '' 来禁用任何聊天消息 | 例如：noPermission: ''
  noPermission: '&dYou do not have permission!'
  openCmdUsage: '&dUsage example: &7/customec open John &dor &7/customec open f694517d-d6cf-32f1-972b-dfc677ceac45'
  # ... 其他消息配置

🔧实用信息

MySQL 数据存储

默认情况下，插件使用 FlatFile 存储。你需要在配置中启用 MySQL 并设置数据库详细信息。注意，你需要先创建数据库，插件会在服务器启动时创建表。你还可以启用维护任务来从数据库中移除旧的不活跃玩家。

FlatFile 数据存储

采用与流行的 Essentials 插件类似的 FlatFile 存储系统。插件会在配置文件附近创建一个名为 PlayerData 的文件夹，每个玩家都有一个文件来存储其数据。

服务器重载

服务器重载可能会破坏插件，因此我们不推荐使用。如果在服务器重载后出现问题，请不要将此插件与重载功能一起使用。

最佳数据存储

推荐的存储类型是 MySQL，如果条件允许请使用它。FlatFile 有更多限制。

从 FlatFile 存储导入数据到 MySQL 数据库

如果出于某种原因你想将插件存储类型更改为 MySQL，可以使用两个命令导入现有数据：

• /ec importFromFlatFile - 导入数据，跳过 MySQL 数据库中已存在的玩家。
• /ec importFromFlatFile overwrite - 导入数据，覆盖 MySQL 数据库中已存在的玩家。

要导入数据，你首先需要进入插件配置，将插件存储类型更改为 mysql，并确保插件已连接到数据库。

---

关联插件推荐：

• MySQL Player Data Bridge：如果你想将玩家数据（库存、末影箱、金钱、生命值、经验等）保存到 MySQL 数据库，或在服务器间同步玩家数据，请查看此插件。
• Essentials MySQL Storage Extension：如果你想将 Essentials 数据保存到 MySQL 数据库，或在服务器间同步 Essentials 数据，请考虑查看此插件。

致谢：

• 本插件由 CraftersLand Minecraft Community 制作。欢迎访问：www.craftersland.net
• 如果你喜欢这个资源并想通过捐赠表示感谢，请使用 PayPal 按钮。谢谢！