配置说明
MySQL 前置要求
只要启用 MySQL 存储,就必须先安装 LyMySQLCore,并确认它已成功连接数据库。LyMySQLCore 未加载或连接失败时,本插件的 MySQL 数据读取、保存、同步或相关记录不会生效。
修改 config.yml、cards/、lottery/ 后,使用 /lykp reload 重载。涉及数据库开关、前置加载顺序时,建议重启服务器。
配置文件
| 文件 / 目录 | 用途 |
|---|---|
config.yml | 数据保存、属性接入、界面按钮和消息文本。 |
cards/ | 卡组、卡牌和共鸣配置。 |
lottery/ | 翻牌卡池、消耗和抽取权重配置。 |
主配置
数据保存
yaml
mysql:
enable: false
databasename: mc2
username: mc2
password: mc1234
port: 3306
ip: 127.0.0.1mysql.enable 为 false 时使用本地保存。需要跨服共享卡牌数据时,可以启用 MySQL,并确认 LyMySQLCore 与数据库连接正常。
属性接入
yaml
attribute-plugin: 0默认配置内标注的取值:
| 值 | 属性系统 |
|---|---|
1 | AttributePlus |
2 | SX-Attribute 2.x |
3 | SX-Attribute 3.x |
5 | ItemLoreOrigin |
6 | AttributeSystem |
0 | 不启用属性接入 |
状态符号
yaml
status-format-collect: "&a√"
status-format-not-collect: "&c×"这两个文本会用于卡牌收集状态变量,也会在卡牌介绍中替换 {collect}。
界面与消息
yaml
gui:
main-title: "§c卡牌收集"
fill-item: "160:0"
fill-name: "&7封锁"
last-item: "341:0"
last-name: "&6上一页"
next-item: "341:0"
next-name: "&6下一页"
message:
not-condition: "条件不足!"
not-eco: "金币不足!"
not-point: "点券不足!"
lottery-empty: "奖池已清空, 无法重复抽取."gui 控制卡牌界面的标题、填充物品和翻页按钮。message 用于抽卡条件不足、金币不足、点券不足和奖池已空等提示。
卡组配置
卡组文件放在 cards/ 目录。示例文件为 cards/四圣卡组.yml。
| 节点 | 说明 |
|---|---|
id | 卡组 ID,用于 /lykp open [卡组id]。 |
index | 卡组排序。 |
show-name | 卡组展示名称。 |
main-info | 主界面内显示的卡组说明。 |
card | 卡牌列表。 |
resonance | 卡组共鸣列表。 |
卡牌节点
yaml
card:
"朱雀":
show-name: "&c天地四圣 · 朱雀"
item: "BOOK:0"
use: false
can-it-be-reused: true
report-command: []
first-command:
- "bc &f%player_name%获得了 &c天地四圣 · 朱雀 &f卡牌!"
info:
- "&7当前收集状态: {collect}"
attribute:
- "攻击力1"| 节点 | 说明 |
|---|---|
show-name | 卡牌展示名,也用于右键使用时匹配物品名称。 |
item | 界面展示物品,支持 ID:子ID。 |
use | 是否允许玩家右键同名物品获得卡牌。 |
can-it-be-reused | 已拥有时是否允许重复使用同名物品。 |
report-command | 重复获得时执行的控制台指令。 |
first-command | 首次获得时执行的控制台指令。 |
info | 卡牌界面说明,{collect} 会替换为收集状态。 |
attribute | 收集该卡牌后提供的属性。 |
共鸣节点
yaml
resonance:
"水火双圣":
show-name: "&c水火双圣"
item: "BOOK:0"
first-command:
- "bc &f%player_name%激活了 &c天地四圣 · 水火双圣 &f共鸣!"
cards:
- "朱雀"
- "玄武"
attribute:
- "攻击力5"| 节点 | 说明 |
|---|---|
show-name | 共鸣展示名称。 |
item | 共鸣展示物品。 |
first-command | 第一次激活共鸣时执行的控制台指令。 |
info | 共鸣说明,支持 {collect}。 |
cards | 激活该共鸣需要收集的卡牌 ID。 |
attribute | 共鸣激活后提供的属性。 |
卡池配置
卡池文件放在 lottery/ 目录。示例文件为 lottery/四圣卡池.yml。
| 节点 | 说明 |
|---|---|
id | 卡池 ID,用于 /lykp lottery [卡池id]。 |
title | 翻牌界面标题。 |
can-repeat | 是否允许重复抽取已拥有卡牌。 |
condition | 抽卡条件。 |
take-item | 每次翻牌消耗的指定名称物品。 |
vault | 每次翻牌消耗金币。 |
point | 每次翻牌消耗 PlayerPoints 点券。 |
lyshop | 每次翻牌消耗离渊商店货币。 |
default-item | 未翻开时的卡牌物品。 |
repeat-status | 重复抽中时替换 {status} 的文本。 |
card | 卡池可抽取的卡牌列表。 |
条件格式
yaml
condition:
- "papi:{%player_level% > 0}"
- "permission:{lykp.lottery.四圣}"| 格式 | 说明 |
|---|---|
papi:{%player_level% > 0} | PlaceholderAPI 表达式条件。 |
permission:{权限} | 玩家需要拥有指定权限。 |
消耗格式
| 节点 | 格式 | 说明 |
|---|---|---|
take-item | 物品名#数量 | 按背包物品显示名扣除。 |
vault | 数字 | 扣除 Vault 金币。 |
point | 数字 | 扣除 PlayerPoints 点券。 |
lyshop | 货币id#数量 | 扣除 LyShop 或 LyShopReload 货币。 |
卡池卡牌
yaml
card:
"朱雀":
show-item: "160:1"
show-name: "&c天地四圣 · 朱雀{status}"
weight: 10
command:
- "bc &f%player_name%翻牌获得了&c顶级卡牌!"
repeat-command:
- "bc &f%player_name%重复翻牌到了&c顶级卡牌!"| 节点 | 说明 |
|---|---|
show-item | 翻开后显示的物品。 |
show-name | 翻开后显示的名称,重复时可用 {status}。 |
weight | 抽取权重。 |
command | 抽中后执行的控制台指令。 |
repeat-command | 已拥有后再次抽中时执行的控制台指令。 |
can-repeat: false 时,已经拥有的卡牌不会再进入本次权重池。全部抽完后会提示 message.lottery-empty。