离渊系列插件Wiki

配置说明 ​

配置文件位于 plugins/LyCore/config.yml，用于管理快捷运算公式和属性插件桥接。

修改快捷运算配置后，可使用 /lcore reload 重载。修改 attribute-plugin 后需要重启服务器，使属性桥接重新初始化。

配置文件 ​

文件用途
config.yml配置快捷运算公式和属性插件选择

配置项总览 ​

配置项类型默认值说明
quick-calculation节点见默认配置保存可通过 PlaceholderAPI 调用的快捷运算公式
quick-calculation.<公式 ID>.format整数3设置计算结果保留的小数位数
quick-calculation.<公式 ID>.formula字符串%player_level% * (1.5^3) / (1+1)设置需要计算的公式，可包含 PlaceholderAPI 变量
attribute-plugin字符串Auto选择 LyCore 使用的属性插件桥接

默认配置 ​

yaml
# 这是一款离渊系列插件用于各种功能杂项的配置
# 插件指令: /lcore
# 功能不多 后续会慢慢增加

#变量部分
# 四则/次方运算 %lcore_math_公式% 或 %lcore_math_位数_公式%(用法与format相同)
# 可用符号：()括号 ^次方 *乘 /除 +加 -减
# 这几个符号越靠前 计算的优先级越高
#  - 例如 %lcore_math_1*(5+2)^3%
#  - 例如 %lcore_math_1*#player_level#^3%  这里的##中代表papi变量 你可以调用papi变量进公式中+
#  - 例如 %lcore_math_0_1*(5+2)^3% #如果在公式之前写数字_  则是取小数点位数
# 取舍小数点 %lcore_format_位数_数字或变量%
#  - 例如 %lcore_format_3_1.31415926%  这里是取3位小数
#  - 例如 %lcore_format_0_#ap_damage:min#%  这里是对ap中的伤害变量取整

#快捷运算 你可直接在下方指定快捷运算的公式
quick-calculation:
  #此处为公式id 你可以使用【%lcore_calc_公式id%】快速获取结果 省去使用math变量四则运算写一大串
  公式id:
    #小数点位数
    format: 3
    #公式
    formula: '%player_level% * (1.5^3) / (1+1)'

#属性插件 可选:
# Auto  自动选择属性插件
# AttributePlus
# SX-Attribute2
# SX-Attribute3
# AttributeSystem
# ItemLoreOrigin
#修改属性插件需要重启
attribute-plugin: 'Auto'

快捷运算 ​

quick-calculation 用于把较长的数学公式保存为一个公式 ID，再通过 %lcore_calc_公式ID% 获取计算结果。

节点结构 ​

yaml
quick-calculation:
  公式ID:
    format: 3
    formula: '%player_level% * (1.5^3) / (1+1)'
节点说明
公式ID自定义公式名称，也是 %lcore_calc_公式ID% 中使用的 ID
format结果保留的小数位数
formula实际执行的数学公式

公式支持配置文件注释中列出的括号、次方、乘法、除法、加法和减法运算。公式内可以直接填写 PlaceholderAPI 变量，例如 %player_level%。

配置多个公式 ​

每个公式使用不同的 ID，放在 quick-calculation 节点下：

yaml
quick-calculation:
  等级权重:
    format: 2
    formula: '%player_level% * 12.5 + 100'
  等级立方:
    format: 0
    formula: '%player_level% ^ 3'

对应变量：

变量对应配置
%lcore_calc_等级权重%quick-calculation.等级权重
%lcore_calc_等级立方%quick-calculation.等级立方

以“等级权重”为例，玩家等级为 20 时，公式 %player_level% * 12.5 + 100 的结果为 350.00。

小数位数 ​

format 控制结果保留的小数位数：

yaml
quick-calculation:
  伤害倍率:
    format: 3
    formula: '%player_level% * 1.25'
format 值结果格式示意
0不保留小数位
2保留两位小数
3保留三位小数

formula 建议使用单引号包裹，避免 YAML 将公式中的特殊字符按其他类型解析。

属性插件选择 ​

attribute-plugin 用于指定 LyCore 将其他插件提供的属性内容提交到哪个属性插件。

yaml
attribute-plugin: 'Auto'

可选值 ​

配置值对应插件说明
Auto自动检测在服务器已启用的兼容属性插件中自动选择
AttributePlusAttributePlus指定使用 AttributePlus；代码会检查其版本是否以 2 或 3 开头
SX-Attribute2SX-Attribute指定使用 SX-Attribute 2.x 接口
SX-Attribute3SX-Attribute指定使用 SX-Attribute 3.x 接口
AttributeSystemAttributeSystem指定使用 AttributeSystem
ItemLoreOriginItemLoreOrigin指定使用 ItemLoreOrigin

配置值不区分大小写，但建议严格使用表格中的写法。

属性插件均为软依赖。只使用公式和格式化变量时，不需要安装属性插件；只有其他插件通过 LyCore 属性接口提交属性内容时，属性桥接才会参与处理。

自动选择 ​

服务器只安装一个兼容属性插件时，可以保持默认值：

yaml
attribute-plugin: 'Auto'

启动时，LyCore 会检查以下插件：

  • AttributePlus
  • SX-Attribute
  • ItemLoreOrigin
  • AttributeSystem

SX-Attribute 会根据插件版本选择 2.x 或 3.x 接口。AttributePlus 仅对版本号以 2 或 3 开头的版本显示兼容启动信息。

如果服务器同时安装多个兼容属性插件，建议不要使用 Auto。检测过程中后匹配的插件可能覆盖先匹配的插件，应手动指定当前玩法实际使用的属性插件。

手动指定 ​

例如指定 AttributeSystem：

yaml
attribute-plugin: 'AttributeSystem'

例如指定 SX-Attribute 3.x：

yaml
attribute-plugin: 'SX-Attribute3'

手动指定的插件必须已经安装并成功启用。指定值与实际安装的插件或版本不一致时，LyCore 无法建立对应的属性桥接。

重载与重启 ​

修改内容处理方式原因
quick-calculation使用 /lcore reload重新读取快捷运算配置
quick-calculation.<公式 ID>.format使用 /lcore reload更新结果的小数位数
quick-calculation.<公式 ID>.formula使用 /lcore reload更新公式内容
attribute-plugin重启服务器属性管理器和属性插件接口在插件启动阶段初始化

修改 YAML 后应保持节点层级和缩进正确。quick-calculation 下的每个公式都必须同时包含 format 和 formula。