Skip to content

配置说明

MySQL 前置要求

只要启用 MySQL 存储,就必须先安装 LyMySQLCore,并确认它已成功连接数据库。LyMySQLCore 未加载或连接失败时,本插件的 MySQL 数据读取、保存、同步或相关记录不会生效。

修改 config.ymlcards/lottery/ 后,使用 /lykp reload 重载。涉及数据库开关、前置加载顺序时,建议重启服务器。

配置文件

文件 / 目录用途
config.yml数据保存、属性接入、界面按钮和消息文本。
cards/卡组、卡牌和共鸣配置。
lottery/翻牌卡池、消耗和抽取权重配置。

主配置

数据保存

yaml
mysql:
  enable: false
  databasename: mc2
  username: mc2
  password: mc1234
  port: 3306
  ip: 127.0.0.1

mysql.enablefalse 时使用本地保存。需要跨服共享卡牌数据时,可以启用 MySQL,并确认 LyMySQLCore 与数据库连接正常。

属性接入

yaml
attribute-plugin: 0

默认配置内标注的取值:

属性系统
1AttributePlus
2SX-Attribute 2.x
3SX-Attribute 3.x
5ItemLoreOrigin
6AttributeSystem
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