配置说明
LyArmourersWardrobe 的配置分为主配置 config.yml 和时装配置目录 armourers/。主配置控制数据库、显示、试穿、筛选、品质和提示文本;时装文件定义每件时装的名称、类型、品质、描述和属性。
重要兼容设置
如果穿戴时装经常失败,或者穿戴后客户端没有正确显示,检查 DragonCore 配置中的 DragonAmourers。DragonCore 自带槽位逻辑可能和本插件的穿戴逻辑冲突,遇到显示异常时可尝试把它设为 false 后再测试。
数据库
MySQL 前置要求
只要启用 MySQL 存储,就必须先安装 LyMySQLCore,并确认它已成功连接数据库。LyMySQLCore 未加载或连接失败时,本插件的 MySQL 数据读取、保存、同步或相关记录不会生效。
| 节点 | 说明 |
|---|---|
mysql.enable | 是否启用数据库。启用后需要正确配置连接信息。 |
host、port、database、user、password | 数据库连接信息。 |
params | JDBC 参数,通常保持默认即可。 |
数据库开关改变后建议重启服务器,避免新旧存储方式混用。
属性读取
| 节点 | 说明 |
|---|---|
attribute-plugin | 选择属性读取方式,例如 AttributePlus、AttributeSystem、ItemLoreOrigin 等。 |
时装文件中的 attribute 通常作为收藏属性,equip-attribute 作为穿戴属性。具体是否生效取决于当前服端使用的属性插件。
显示与同步
| 节点 | 说明 |
|---|---|
packet-interval | 界面数据包刷新间隔。 |
debug-skin-update | 是否输出时装刷新调试信息。 |
show-item-armourers | 是否以物品形式展示时装。 |
file-armourers-amount | 单个文件读取时装数量。 |
auto-give-armourers | 玩家满足条件时是否自动发放时装。 |
试穿
| 节点 | 说明 |
|---|---|
try-on-time | 单次试穿持续时间,单位为秒。 |
next-try-on-cooldown | 下一次试穿冷却,单位为秒。 |
未拥有时装的状态变量会显示剩余试穿秒数,已拥有和未拥有则显示对应文本。
品质配置
quality 用来配置时装品质显示。默认品质范围为 0 到 4,可以写成普通、稀有、史诗等文本。时装文件中的 quality 应填写对应编号。
类型显示
display-type 用来配置时装类型显示名。常见类型如下:
| 类型 | 说明 |
|---|---|
sword | 武器剑类。 |
bow | 弓类。 |
outfit | 套装或整体外观。 |
head | 头部。 |
chest | 胸甲。 |
legs | 护腿。 |
feet | 鞋子。 |
wings | 翅膀。 |
筛选按钮文本
filter-button-text 控制 DragonCore 界面中品质、类型、拥有状态筛选按钮的显示文本。若新增品质或类型,建议同步补充这里的显示名。
时装文件
yaml
离渊时装示例:
quality: 1
name: "&b示例时装"
lore:
- "&7这是一件示例时装"
attribute:
- "生命力: 100"
equip-attribute:
- "攻击力: 10"| 节点 | 说明 |
|---|---|
| 顶层 ID | DragonArmourers 时装 ID,必须全局唯一。 |
quality | 品质编号。 |
name | 界面显示名。 |
lore | 时装描述。 |
attribute | 收藏后提供的属性。 |
equip-attribute | 穿戴时提供的属性。 |
提示文本
message 节点包含试穿成功、试穿过期、下次试穿冷却、显示隐藏、切换方案、给予和移除等提示。正式使用前建议把提示改成服务器统一风格。