****** EnderChestVault - 完整插件文档
? 概述
EnderChestVault 是一款高品质、开源的 Minecraft 插件,它完全替换并增强了原版末影箱系统,提供强大、可定制且持久化的存储解决方案。
| 属性 | 值 |
|---|---|
| 插件名称 | EnderChestVault |
| 版本 | 1.0.0 |
| Minecraft 版本 | 1.21.1 - 1.21.11 |
| 服务端软件 | Paper, Spigot, Purpur |
| Java 版本 | Java 21+ |
? 此插件的功能
EnderChestVault 拦截原版末影箱交互,并将其替换为基于 自定义 GUI 的金库系统,具备以下特性:
- 根据玩家权限提供 可变存储容量
- 支持多种 数据库后端 以实现数据持久化
- 通过 MySQL 实现 跨服务器兼容
- 允许管理员访问 离线玩家的金库
- 对超过 54 格的金库支持 分页显示
┌─────────────────────────────────────────────────────────────┐
│ VANILLA ENDER CHEST → ENDERCHESTVAULT │
├─────────────────────────────────────────────────────────────┤
│ • 固定 27 格 → • 27 至 54 格 │
│ • 无权限控制 → • 基于权限的大小设置 │
│ • 仅本地存储 → • PDC/SQLite/MySQL │
│ • 无管理员访问 → • 查看离线金库 │
└─────────────────────────────────────────────────────────────┘
✨ 主要功能
- ?️ 多种存储后端
| 存储类型 | 描述 | 最佳适用场景 |
|---|---|---|
| PDC | PersistentDataContainer(存储在玩家身上) | 小型服务器,追求简单性 |
| SQLite | 本地数据库文件 | 中型服务器,单实例部署 |
| MySQL | 远程数据库服务器 | 网络架构,BungeeCord/Velocity |
- ? 可变金库大小
权限 格子数 行数
─────────────────────────────
ecvault.size.9 9 1
ecvault.size.18 18 2
ecvault.size.27 27 3
ecvault.size.36 36 4 1
ecvault.size.45 45 5
ecvault.size.54 54 6
- ? 末影金库
金库最大支持 54 格:
┌─────────────────────────────────────────────────────┐
│ Ender Vault │
├─────────────────────────────────────────────────────┤
│ [Item] [Item] [Item] [Item] [Item] [Item] [Item] │
│ [Item] [Item] [Item] [Item] [Item] [Item] [Item] │
│ [Item] [Item] [Item] [Item] [Item] [Item] [Item] │
│ [Item] [Item] [Item] [Item] [Item] [Item] [Item] │
│ [Item] [Item] [Item] [Item] [Item] [Item] [Item] │
│ [Item] [Item] [Item] [Item] [Item] [Item] [Item] │
├─────────────────────────────────────────────────────┤
- ? 在线/离线服务器支持
config.yml
server:
use-uuids: true 在线模式 (正版)
use-uuids: false 离线模式 (盗版)
- ?️ 管理员金库访问
管理员可以查看和修改任何玩家的金库,即使该玩家处于离线状态:
/ec open Notch → 打开 Notch 的金库(即使离线)
/ec open Steve → 打开 Steve 的金库进行检查
- ? 异步数据库操作
所有数据库读写操作均为 异步,以防止服务器卡顿:
// 非阻塞式金库加载
CompletableFuture<VaultData> loadVault(Player player);
// 非阻塞式金库保存
CompletableFuture<Void> saveVault(Player player, VaultData data);
- ? 完全可定制的 GUI
gui:
title: "&5&lEnder Vault"
admin-title: "&c&l{player}'s Vault"
sounds:
open:
sound: "BLOCK_ENDER_CHEST_OPEN"
page-turn:
sound: "ITEM_BOOK_PAGE_TURN"
? 命令
| 命令 | 描述 | 权限 |
|---|---|---|
/ec |
打开自己的金库 | ecvault.use |
/enderchest |
/ec 的别名 | ecvault.use |
/ec open <player> |
打开其他玩家的金库 | ecvault.admin |
/ec reload |
重新加载配置 | ecvault.admin.reload |
? 权限
玩家权限
| 权限 | 描述 | 默认值 |
|---|---|---|
ecvault.use |
使用末影金库 | true |
ecvault.size.27 |
27 格金库(3 行) | true |
ecvault.size.54 |
54 格金库(6 行) | false |
管理员权限
| 权限 | 描述 | 默认值 |
|---|---|---|
ecvault.admin |
打开其他玩家的金库 | op |
ecvault.admin.reload |
重新加载插件配置 | op |
ecvault.admin.bypass |
绕过限制 | op |
ecvault.* |
所有权限 | op |
? 应用场景
- ? 生存服务器
问题:玩家希望拥有更多存储空间,但原版末影箱容量有限。
解决方案:将更大的金库容量作为特权授予捐赠者或特定等级。
默认玩家 → 27 格(免费)
VIP 等级 → 54 格
- ? 服务器网络 (BungeeCord/Velocity)
问题:末影箱内容无法在多个服务器间同步。
解决方案:使用 MySQL 后端实现跨服务器金库同步。
┌─────────┐ ┌─────────┐ ┌─────────┐
│ Lobby │ │ Survival│ │ Skyblock│
│ Server │────▶│ Server │────▶│ Server │
└────┬────┘ └────┬────┘ └────┬────┘
│ │ │
└───────────────┼───────────────┘
▼
┌─────────────┐
│ MySQL │
│ Database │
└─────────────┘
- ?️ 管理员审核
问题:需要检查玩家是否存储了违规物品。
解决方案:使用 /ec open <player> 检查任何金库。
/ec open SuspiciousPlayer
→ 打开其金库进行检查
→ 即使玩家离线也有效
→ 可以移除违禁物品
- ? 经济服务器
问题:希望出售游戏内货币的存储升级。
解决方案:与权限插件和经济系统集成。
/buy vault-upgrade 54 → 授予 ecvault.size.54 权限
- ? 适用于所有服务器
问题:基于 UUID 的存储方式在离线服务器中无法正常工作。
解决方案:切换为基于玩家名称的身份识别模式。
server:
use-uuids: false # 使用玩家名称代替 UUID
? 对比:原版末影箱 vs EnderChestVault
| 功能 | 原版末影箱 | EnderChestVault |
|---|---|---|
| 存储容量 | 固定 27 格 | 27-54 格(可选) |
| 权限控制 | ❌ 无 | ✅ 完全可控 |
| 数据库选项 | 仅世界文件 | PDC / SQLite / MySQL |
| 跨服同步 | ❌ 不支持 | ✅ 通过 MySQL 实现 |
| 管理员查看 | ❌ 不可见 | ✅ 完全访问权限 |
| 离线访问 | ❌ 不支持 | ✅ 支持 |
| 分页功能 | ❌ 无 | ✅ 自动分页 |
| 自定义 GUI | ❌ 无 | ✅ 高度可定制 |
| 异步操作 | ❌ 无 | ✅ 支持 |
| 音效反馈 | ❌ 基础 | ✅ 可定制 |
?️ 技术架构
┌──────────────────────────────────────────────────────────────────┐
│ EnderChestVault │
├──────────────────────────────────────────────────────────────────┤
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────────────────┐ │
│ │ Command │ │ Listener │ │ VaultManager │ │
│ │ Handler │ │ Layer │ │ (核心逻辑 + 缓存) │ │
│ └──────┬──────┘ └──────┬──────┘ └────────────┬────────────┘ │
│ │ │ │ │
│ └────────────────┼──────────────────────┘ │
│ ▼ │
│ ┌───────────────────────┐ │
│ │ StorageManager │ ← 接口层 │
│ │ (抽象层) │ │
│ └───────────┬───────────┘ │
│ │ │
│ ┌────────────────┼────────────────┐ │
│ ▼ ▼ ▼ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ PDC │ │ SQLite │ │ MySQL │ │
│ │ 存储模块 │ │ 存储模块 │ │ 存储模块 │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │ │ │
│ ▼ ▼ │
│ ┌─────────────┐ ┌─────────────┐ │
│ │ vaults.db │ │ 远程数据库 │ │
│ └─────────────┘ └─────────────┘ │
└──────────────────────────────────────────────────────────────────┘
? 性能特性
| 指标 | 数值 |
|---|---|
| 内存占用 | ~5-15 MB(取决于缓存大小) |
| 宝箱加载时间 | <50ms(缓存命中),<200ms(数据库读取) |
| 保存操作 | 异步,非阻塞 |
| 最大并发用户数 | 无上限(受连接池限制) |
| 缓存命中率 | 活跃玩家 >95% |
MySQL 连接池配置
mysql:
pool:
maximum-pool-size: 10 # 最大数据库连接数
minimum-idle: 2 # 保持 2 个空闲连接就绪
connection-timeout: 5000 # 超时时间 5 秒
? 安装指南
步骤 1:下载并安装
将 JAR 文件放入 plugins 文件夹
cp EnderChestVault-1.0.0.jar /server/plugins/
启动服务器以生成配置文件
java -jar paper.jar
步骤 2:配置存储类型
plugins/EnderChestVault/config.yml
storage:
type: "SQLITE" # 或 "PDC" 或 "MYSQL"
步骤 3:设置权限
使用 LuckPerms:
# 给予 VIP 组 54 格权限
/lp group vip permission set ecvault.size.54 true
# 给予 Staff 组管理员权限
/lp group staff permission set ecvault.admin true
步骤 4:重载并测试
/ec reload # 重载配置
/ec # 打开你的宝箱
? 功能摘要卡片
╔═══════════════════════════════════════════════════════════╗
║ ENDERCHESTVAULT ║
╠═══════════════════════════════════════════════════════════╣
║ ✓ 可变大小的宝箱(9/27/54 格) ║
║ ✓ 三种后端存储(PDC / SQLite / MySQL) ║
║ ✓ 基于权限的访问控制 ║
║ ✓ 大型宝箱的智能分页 ║
║ ✓ 异步数据库操作(无卡顿) ║
║ ✓ 管理员查看宝箱(在线/离线均可) ║
║ ✓ 支持在线与离线服务器 ║
║ ✓ 通过 MySQL 实现跨服同步 ║
║ ✓ 自定义 GUI 和音效 ║
║ ✓ 完整保留 NBT/component 数据 ║
║ ✓ HikariCP 连接池管理 ║
║ ✓ Caffeine 内存缓存优化 ║
╠═══════════════════════════════════════════════════════════╣
║ 适用版本:Minecraft 1.21.1 - 1.21.11 | Paper/Spigot API ║
╚══════════════════════════════════════════════════════════╝
此文档提供了对 EnderChestVault 插件的全面概述,包括其功能、用例和技术细节。**
你是这个资源的作者?登录后可认领此资源。
相似资源
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
ExyliaPlugins 的库。
通过对话框或铁砧界面帮助你的 Anthme
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧