MythicKeys（MythicEcreateKeysValut） ¥5
钥匙数量管理 + 使用执行命令 + MySQL 存储 + PAPI 显示（带缓存）
Paper 1.20+
MySQL
PAPI（可选）
插件介绍
MythicEcreateKeysValut（简称 MythicKeys）是一个“钥匙数量”管理插件：管理员给玩家发钥匙，玩家消耗钥匙后执行一组命令（例如打开某个抽奖箱）。钥匙数量使用 MySQL 存储，支持 PlaceholderAPI 查询钥匙数量与总数。
说人话：用 /eckey give 玩家 钥匙 1 发券，用 /eckey use 钥匙 扣 1 把并执行配置里的命令。
主要功能
- MySQL 存储 —— 钥匙数量持久化（支持表前缀）
- 钥匙定义 —— 每把钥匙可自定义显示名与“使用后执行的命令列表”
- 使用扣除 —— 玩家用钥匙时先扣数量再执行命令
- 查看我的钥匙 —— 一键查看自己所有钥匙与数量
- PAPI 占位符 —— 显示某把钥匙数量/总钥匙数（带 30 秒缓存，避免查库卡服）
命令列表
| 命令 | 说明 | 权限 |
|---|---|---|
/eckey give <玩家> <钥匙ID> <数量> | 给予钥匙（支持离线玩家名解析，若解析失败会提示） | mythickeys.admin |
/eckey take <玩家> <钥匙ID> <数量> | 回收钥匙 | mythickeys.admin |
/eckey use <钥匙ID> | 使用钥匙（扣 1 把并执行命令） | mythickeys.use |
/eckey reload | 重载配置 | mythickeys.admin |
/mykey | 查看“我的钥匙”列表 | mythickeys.mykey |
/eckey 有别名 /ek，/mykey 有别名 /mk。
权限节点
| 权限 | 说明 | 默认 |
|---|---|---|
mythickeys.admin | 管理员（give/take/reload） | OP |
mythickeys.use | 允许使用钥匙 | 所有人 |
mythickeys.mykey | 允许查看自己的钥匙列表 | 所有人 |
PlaceholderAPI 占位符
需要安装 PlaceholderAPI 才能使用。插件注册的占位符标识符为 mythickeys。
| 占位符 | 说明 |
|---|---|
%mythickeys_total% | 当前玩家所有钥匙总数（总和） |
%mythickeys_<钥匙ID>% | 当前玩家指定钥匙数量（钥匙ID=配置 keys 下的键名） |
PAPI 变量默认带 30 秒缓存，避免频繁查询 MySQL 造成卡顿。
配置文件
配置文件路径：plugins/MythicEcreateKeysValut/config.yml
数据库配置
YAMLconfig.yml
mysql:
host: "127.0.0.1"
port: 3306
database: "mythiceckeys"
username: "mythiceckeys"
password: "password"
table-prefix: "mythic_"钥匙配置
每个钥匙在 keys 下配置，键名就是“钥匙ID”。commands 为使用后执行的命令列表，支持 %player% 变量。
YAMLconfig.yml
keys:
帝国训练营:
display-name: "&6帝国训练营钥匙"
commands:
- "ecrates open 帝国训练营 %player% -f"依赖插件
| 插件/组件 | 是否必须 | 说明 |
|---|---|---|
| MySQL 5.7+ | 必须 | 钥匙数据存储 |
| PlaceholderAPI | 可选 | 启用 PAPI 变量显示 |
常见问题
可以。钥匙ID 就是
keys 下的键名，命令与 PAPI 都按这个键名匹配。为了减轻数据库压力，PAPI 变量带缓存（默认 30 秒）。这属于正常现象。