配置说明

LySoulJade 的主要配置文件位于插件数据目录中。修改 config.yml、souljade/ 或界面文件后，可以使用 /lsj reload 重载配置。

配置文件

文件 / 目录	用途
config.yml	数据库、提示消息、强度显示、词条排版、熔铸规则、公告和音效
souljade/	魂玉类型、鉴定与熔铸规则、材料、金币和词条池
鉴定界面.yml	魂玉鉴定界面
熔炼界面.yml	魂玉熔炼界面

配置文件名称区分大小写。鉴定界面.yml 和 熔炼界面.yml 的文件名不可修改。

config.yml

数据库

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

配置项	说明
mysql.enable	是否启用 MySQL 存储。默认值为 false。
mysql.databasename	数据库名称。
mysql.username	数据库用户名。
mysql.password	数据库密码。
mysql.port	数据库端口。示例值为 3306。
mysql.ip	数据库地址。示例值为 127.0.0.1。

MySQL 前置要求

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

切换 mysql.enable 后建议重启服务器。

消息

message 用于设置鉴定、熔铸和物品操作过程中的提示文本。消息支持 Minecraft 颜色代码，例如 &c、&7 和 &6。

配置项	说明
message.无法熔铸	物品无法进行熔铸时的提示。
message.禁止熔铸	物品存在防误熔标记，无法放入熔铸副槽时的提示。
message.材料不足	熔铸所需材料不足时的提示。
message.金币不足	熔铸或相关操作所需金币不足时的提示。
message.鉴定失败	魂玉鉴定失败时的提示。
message.不是魂玉	放入的物品不是未鉴定魂玉时的提示。
message.鉴定成功	魂玉鉴定成功时的提示。
message.熔铸成功	熔铸成功并替换词条时的提示。
message.熔铸保留	本次熔铸保留原词条时的提示。

message.熔铸成功 支持以下占位符：

占位符	说明
{entry_a}	被替换前的词条。
{entry_b}	熔铸后替换进去的词条。
{count}	当前熔铸次数。
{count_max}	最大熔铸次数。

强度显示

强度数值范围为 1-100。strengthen-replace-enable 控制是否使用自定义标签替换强度数字。

strengthen-replace-enable: true
strengthen-replace-text:
  1-5: '&a|&7|||||||||||||||||||'
  6-10: '&a||&7||||||||||||||||||'
  11-15: '&a|||&7|||||||||||||||||'
  16-20: '&a||||&7||||||||||||||||'
  21-25: '&a|||||&7|||||||||||||||'
  26-30: '&a||||||&7||||||||||||||'
  31-35: '&a||||||&e|&7|||||||||||||'
  36-40: '&a||||||&e||&7||||||||||||'
  41-45: '&a||||||&e|||&7|||||||||||'
  46-50: '&a||||||&e||||&7||||||||||'
  51-55: '&a||||||&e|||||&7|||||||||'
  56-60: '&a||||||&e||||||&7||||||||'
  61-65: '&a||||||&e||||||&6|&7|||||||'
  66-70: '&a||||||&e||||||&6||&7||||||'
  71-75: '&a||||||&e||||||&6|||&7|||||'
  76-80: '&a||||||&e||||||&6||||&7||||'
  81-85: '&a||||||&e||||||&6|||||&7|||'
  86-90: '&a||||||&e||||||&6||||||&7||'
  91-95: '&a||||||&e||||||&6||||||&c|&7|'
  96-100: '&a||||||&e||||||&6||||||&c||'

配置项	说明
strengthen-replace-enable	为 true 时，使用 strengthen-replace-text 中的文本显示强度；为 false 时直接显示 1-100 的强度数字。
strengthen-replace-text	强度区间与替换文本的映射。键使用 最小值-最大值 格式。

词条排版

entry-format:
  - '{entry}'
  - '&7已熔铸次数: &6{count}/{count_max}'

entry-format 为鉴定后词条的显示格式，每一项代表一行文本。

占位符	说明
{entry}	生成后的词条内容。
{count}	当前熔铸次数。
{count_max}	最大熔铸次数。

熔铸控制

prevent-mishandling-lore:
  - '已绑定'

smelt-reroll-strength-enable: false
smelt-keep-strength-high-priority-enable: false
strength-average-three-enable: false

配置项	说明
prevent-mishandling-lore	防误操作关键词列表。物品描述中包含任意关键词时，禁止将该物品放入被熔铸魂玉槽位。
smelt-reroll-strength-enable	熔铸时是否为提取到的词条重新随机强度。
smelt-keep-strength-high-priority-enable	当 smelt-reroll-strength-enable 为 false 时，是否优先保留强度较高的数值。该配置在重新随机强度关闭时生效。
strength-average-three-enable	是否降低随机到极高或极低强度的概率，使强度更接近中间区间。

全服公告

entry-message-enable: true
entry-message-min-value: 90
entry-message-text: '&7恭喜玩家 &a{player}&7 的 {item} &7获得了 &e{value}强度&7 的词条: {entry}'

配置项	说明
entry-message-enable	是否启用鉴定或熔铸时的全服公告。
entry-message-min-value	触发公告的最低词条强度。示例值为 90。
entry-message-text	全服公告文本。

entry-message-text 支持以下占位符：

占位符	说明
{player}	玩家名称。
{item}	物品名称。
{value}	词条强度。
{entry}	词条内容。

音效

sound:
  appraisal-success: 'ENTITY_EXPERIENCE_ORB_PICKUP'
  appraisal-failed: 'BLOCK_GLASS_BREAK'
  smelt-success: 'ENTITY_EXPERIENCE_ORB_PICKUP'
  pick-or-upload-success: 'BLOCK_CLOTH_PLACE'

配置项	说明
sound.appraisal-success	鉴定成功时播放的音效。
sound.appraisal-failed	鉴定失败时播放的音效。
sound.smelt-success	熔铸成功时播放的音效。
sound.pick-or-upload-success	取回或放入物品时播放的音效。

不同 Minecraft 版本的音效名称可能不同。示例配置中提供了部分旧版本名称注释，修改时应使用目标服务器版本支持的音效名称。

souljade/ 魂玉配置

每个 souljade/ 下的 YAML 文件可以定义一种魂玉。示例文件为 souljade/示例魂玉.yml。

魂玉基础配置

'神器魂玉':
  match-name:
    - '&c神器魂玉'
  init-lore: '&7尚未解封魂玉之力'
  appraisal-chance: 0.8
  appraisal-eco: '10000'

配置项	说明
魂玉 ID	顶层键，例如 神器魂玉。该 ID 用于区分魂玉类型。
match-name	匹配可鉴定物品名称的列表，支持填写多个名称。
init-lore	未鉴定魂玉的初始描述。
appraisal-chance	鉴定成功率，取值范围为 0-1。
appraisal-eco	鉴定所需金币，支持 PlaceholderAPI 变量和四则运算。

鉴定成功指令

appraisal-success-commands: []

鉴定成功后执行 appraisal-success-commands 中的指令。指令支持以下占位符：

占位符	说明
{player}	玩家名称。
{item}	物品名称。
{souljade}	魂玉 ID。
{count}	当前熔铸次数。
{count_max}	最大熔铸次数。

熔铸成功指令

smelt-success-commands: []

熔铸成功后执行 smelt-success-commands 中的指令。该配置支持的占位符与 appraisal-success-commands 相同。

熔铸材料与金币

smelet-material:
  'MM@魂玉精粹': '5*{count}'
smelet-eco: '10000*(1+{count})'
max-smelet-count: 100

配置项	说明
smelet-material	熔铸所需的基础材料。键格式为 插件缩写@物品ID，值为所需数量。
smelet-eco	熔铸所需的基础金币，支持 PlaceholderAPI 变量和四则运算。
max-smelet-count	最大熔铸次数。设置为 -1 表示不限制熔铸次数。

sm e l e t-material 和 smelet-eco 使用项目中的实际键名 smelet-*，不要改成其他拼写。

材料插件缩写支持以下值：

缩写	说明
MM	支持的材料来源缩写。
NI	支持的材料来源缩写。
SI	支持的材料来源缩写。
ZAP	支持的材料来源缩写。

词条数量

spawn-entry-count: 3

配置项	说明
spawn-entry-count	魂玉生成时抽取的词条数量。

熔铸时会从两个魂玉内各抽取一条词条，因此熔铸时重新抽取的词条数量为 spawn-entry-count - 2。该配置不能小于 2，否则会报错。

词条池

entry:
  物理伤害:
    lore: '&e物理伤害 {10-20-%.0f}-{20-40-%.0f} &7(强度{strength}&7)'
    weight: 10
  伤害加成:
    lore: '&e伤害加成 +{1-10-%.1f}% &7(强度{strength}&7)'
    weight: 10

entry 下的每个键都是词条 ID。词条 ID 一旦开始投入使用，不要随意修改。

配置项	说明
entry.<词条ID>.lore	词条生成后的描述文本。
entry.<词条ID>.weight	词条抽取权重。权重越高，在随机抽取中的相对概率越高。

词条描述中的 {strength} 会替换为词条强度。示例配置中的范围和格式用于生成词条数值。

示例文件当前定义了以下词条 ID：

词条 ID
物理伤害
伤害加成
暴击几率
暴击伤害
护甲防御
生命上限
吸血几率
吸血倍率
闪避几率
护甲穿透

鉴定界面.yml

界面结构

title: "魂玉鉴定"

layout:
  - "#########"
  - "####A####"
  - "####Y####"

button:
  jade: 'A'
  button: 'Y'

配置项	说明
title	鉴定界面标题。
layout	界面布局。每个字符对应一个槽位配置。
button.jade	放置待鉴定魂玉的槽位字符。
button.button	执行鉴定操作的按钮字符。

槽位

槽位字符	说明
#	界面装饰和背景槽位。
A	待鉴定魂玉槽位。
Y	鉴定按钮槽位。

鉴定按钮的物品描述支持以下占位符：

占位符	说明
{chance}	鉴定成功率。
{need_eco}	鉴定所需货币。
{has_eco}	玩家当前拥有的货币。

熔炼界面.yml

界面结构

title: "魂玉熔炼"

layout:
  - "#mmmmmmm#"
  - "#XXXXXXX#"
  - "#a#b#{#}#"
  - "#A#B#<#>#"
  - "####Y####"

button:
  jade-a: 'A'
  jade-b: 'B'
  keep-result: '<'
  replace-result: '>'
  button: 'Y'
  material: 'X'

配置项	说明
title	熔炼界面标题。
layout	界面布局。每个字符对应一个槽位配置。
button.jade-a	需要熔炼魂玉的槽位字符。
button.jade-b	被熔铸魂玉的槽位字符。
button.keep-result	保留旧词条的结果选择字符。
button.replace-result	替换为新词条的结果选择字符。
button.button	执行熔铸操作的按钮字符。
button.material	熔铸材料槽位字符。

槽位

槽位字符	说明
#	界面装饰和背景槽位。
m	熔铸材料展示槽位。
X	熔铸材料槽位。
a	需要熔炼的魂玉提示槽位。
b	被熔铸魂玉提示槽位。
A	需要熔炼的魂玉槽位。
B	被熔铸魂玉槽位。
r	两个魂玉熔铸成功后的产物展示槽位。
{	保留旧词条按钮槽位。
}	替换为新词条按钮槽位。
<	保留旧词条结果选择槽位。
>	替换新词条结果选择槽位。
Y	熔铸按钮槽位。

材料槽位模板支持以下占位符：

占位符	说明
{need}	当前材料需求数量。
{current}	玩家当前拥有数量。

熔铸按钮的物品描述支持以下占位符：

占位符	说明
{chance}	熔铸成功率。
{need_eco}	熔铸所需金币。
{has_eco}	玩家当前拥有的金币。

配置注意事项

• souljade/ 中的词条 ID 一旦投入使用，不要随意修改，否则可能影响已有魂玉数据。
• spawn-entry-count 不得小于 2。
• 启用 MySQL 前，先安装并配置好 LyMySQLCore，确认数据库连接成功后再启用 mysql.enable。
• 使用 PlaceholderAPI 变量前，需要安装并启用 PlaceholderAPI。
• 鉴定界面.yml 和 熔炼界面.yml 的文件名不可修改。
• 配置修改后可使用 /lsj reload 重载；数据库开关变更后仍建议重启服务器。